1. Introdução

O Ultrapack Auto Updater (UAU) centraliza e simplifica a atualização dos itens do catálogo Ultrapack (plugins e temas) direto no seu WordPress, sem baixar ZIP e reinstalar item por item. Você define o que o Ultrapack gerencia, sem interferir em plugins e temas de terceiros.

Requisito	Versão mínima
WordPress	6.0.3 (testado até o 7.0)
PHP	7.4
Multisite	Suportado, com ativação na rede

A lista atualizada de itens compatíveis pode ser consultada na página de itens suportados.

2. Instalação

Baixe o plugin na página do produto: Ultrapack Auto Updater. Em seguida, escolha um dos métodos abaixo.

Método 1: pelo painel do WordPress

1. Envie o ZIP

   No painel do seu site, vá em Plugins → Adicionar novo → Enviar plugin e selecione o arquivo .zip baixado.

2. Instale

   Clique em "Instalar agora".

3. Ative

   Após a instalação, clique em "Ativar". Em Multisite, use "Ativar na rede".

Método 2: instalação manual (FTP)

1. Extraia o ZIP

   Descompacte o arquivo baixado.

2. Envie a pasta

   Via FTP ou gerenciador de arquivos, envie a pasta ultrapack-auto-updater para wp-content/plugins.

3. Ative

   No painel, vá em Plugins e ative o Ultrapack Auto Updater.

3. Configuração e token

Depois de instalar e ativar, o plugin passa a ter item próprio no menu lateral do WordPress: Ultrapack Auto Updater, com o ícone de atualização. Todas as abas ficam dentro dele, e a primeira é a Configurações. Atalho: na tela Plugins, a linha do UAU tem os links Configurações e Forçar verificação. O token de API conecta o plugin à sua conta e é gerado na página Gerenciar sites.

1. Gere o token

   Acesse Gerenciar sites na sua conta Ultrapack e gere o seu token.

2. Cole e salve

   No plugin, cole o valor no campo Token Ultrapack e clique em "Salvar Token".

3. Autorize o site

   Se aparecer "Site não autorizado!", vá em "Sites Autorizados", copie a URL completa do seu site direto do navegador, cole no campo e autorize. Volte ao plugin e clique no ícone de recarregar. O selo deve ficar Autorizado.

4. Registrar e limite de sites

Cada domínio precisa ser autorizado antes de receber atualizações. O UAU usa limitação por domínio ativo, e cada plano tem um limite diferente de autorizações. Sites comuns e redes WordPress Multisite contam em limites separados. Confira e gerencie tudo em Gerenciar sites.

O sistema também identifica sozinho quando um domínio registrado como site comum é, na verdade, uma rede Multisite. Nesse caso a linha ganha um aviso e o botão Migrar para Multisite, para acertar o cadastro. Se a identificação estiver errada, use Contestar na mesma linha e a equipe revisa. Enquanto a contestação está em análise, a linha mostra o selo "Contestação pendente".

Status do site	O que significa	Ação
Autorizado	Pronto para receber atualizações	Nenhuma
Pendente	Aguardando aprovação do domínio	Aguardar
Bloqueado	Uso indevido detectado, ou a cota do plano estourou no momento do registro	Contatar suporte

1. Informe o domínio

   Na página "Gerenciar sites", digite o domínio e marque "É um Multisite?" se for uma rede.

2. Envie para autorização

   Clique em "Registrar novo site". O site entra como Pendente.

3. Aguarde a autorização

   Após aprovado, o status muda para Autorizado e as atualizações começam.

5. Atualizações automáticas

O UAU tem um sistema próprio de atualização automática, independente das configurações do WordPress: mesmo com as atualizações automáticas do WordPress desativadas, os itens do Ultrapack continuam sendo atualizados. Defina o intervalo e o nível de risco na aba Ultrapack Auto Updater → Auto Updates, que é dividida em seis seções: Auto Updates, Agendamento, Notificações, Controle Manual, Sobre e WP Recovery Agent.

6. Gerenciador de itens

A aba Gerenciador (em Ultrapack Auto Updater → Gerenciador) lista seus temas e plugins do Ultrapack com a versão instalada e a disponível. Nela você define o que o Ultrapack gerencia e o que fica com o WordPress, sem afetar itens de terceiros. O ícone do Ultrapack em cada linha funciona como uma chave: alterna o item entre ser atualizado pelo Ultrapack ou pelo WordPress. Itens sob o Ultrapack exibem a mensagem "Gerenciado por Ultrapack Auto Updater".

1. Abra a aba Gerenciador

   Busque pelo item ou navegue pela lista paginada.

2. Clique em "Atualizar"

   O plugin cria a snapshot, aplica a nova versão e roda um smoke check: uma visita ao próprio site por HTTP para confirmar que ele continua respondendo. Se o site acusar erro crítico, a versão anterior volta sozinha.

3. Ative o auto por item

   Use o botão de alternância de cada item para deixá-lo em automático ou manual.

7. Proteção de licença original

Se um item já está instalado no seu site com a licença oficial do autor, trocá-lo pela versão do catálogo pode invalidar essa licença e derrubar os updates oficiais. Por isso o UAU trata esses itens de forma diferente: ele avisa e deixa você decidir.

• Na atualização automática, um item protegido nunca é substituído. Ele é pulado e o motivo fica registrado nos logs.
• Na lista de updates do WordPress, a versão do Ultrapack não é oferecida, então o update oficial do autor continua aparecendo normalmente.
• No Gerenciador, o item mostra o selo Licença original e a atualização pelo Ultrapack só acontece depois de uma confirmação explícita sua.

Cada item tem três estados, ajustáveis pelo próprio selo no Gerenciador:

Estado	Efeito
Automático	Padrão. A detecção decide, e ela reconhece o item quando existe um update do próprio autor pendente ou uma licença ativa registrada no site
Sempre proteger	Força a proteção, mesmo sem a detecção acusar nada
Nunca proteger	Libera o item para o Ultrapack atualizar. Use quando a detecção errou

8. Item bloqueado por erro de atualização

Quando uma atualização falha por defeito no pacote, o UAU não fica tentando de novo em loop. Ele bloqueia aquele item por 1 hora, tira a atualização da lista e mostra um botão de contato com o suporte, com a mensagem do erro já montada.

O caso mais comum é a divergência de versão: o item é anunciado numa versão e o pacote traz outra. A checagem acontece antes de instalar, então a versão que está no ar continua intacta, o item não é substituído nem desativado.

• Passada 1 hora o bloqueio cai sozinho e o item é testado de novo.
• Se o problema persistir, ele volta a ser bloqueado. Nesse caso use o botão de contato: o defeito é na origem e precisa ser corrigido por nós.
• Com White Label ligado, o contato aponta para o canal de suporte que o revendedor configurou.

9. Snapshots e versões legadas

O sistema de Snapshots vem habilitado por padrão e cria uma cópia do item antes de cada atualização. Se algo falhar, você restaura o último estado funcional em 1 clique. Gerencie em Ultrapack Auto Updater → Snapshots. Pelas Snapshots e pelo Gerenciador também dá para instalar versões legadas (anteriores) dos itens, que vêm do nosso catálogo e não do seu servidor.

Padrões de fábrica: retenção de 4 dias, no máximo 2 snapshots por item e um piso de 24 horas que protege a snapshot mais recente de cada item, mesmo que a retenção já tenha vencido. Os três valores são ajustáveis na própria aba. Desligar as snapshots é possível, mas exige dupla confirmação, porque sem elas o site perde o rollback automático.

Recurso	Descrição	Recomendação
Snapshot automático	Backup criado antes de cada atualização	Manter ativo ✓
Rollback	Reverte o item para a versão anterior	Use se algo quebrar
Versão anterior	Instala qualquer versão do catálogo	Para compatibilidade

1. Abra "Versões"

   Na aba Gerenciar, clique em "Versões" no item desejado.

2. Escolha a versão

   A lista mostra snapshots locais e versões do catálogo, com data e tamanho.

3. Clique em "Restaurar"

   O UAU reinstala a versão escolhida com segurança.

10. WP Recovery Agent

É a camada extra de segurança. Se uma atualização deixar o site inacessível, o agente recupera o site e, no modo Auto-reparo, desativa o item defeituoso, mesmo quando o próprio WordPress travou. O administrador recebe um e-mail explicando o que aconteceu e o que foi recuperado.

Os controles ficam em Ultrapack Auto Updater → Auto Updates → WP Recovery Agent, com o status (instalado e versão) e o interruptor Auto-reparo, que vem ligado por padrão. Com o Auto-reparo desligado, o agente ainda recupera o site, mas não desativa nada sozinho.

11. White label

Voltado a revendas e administradores, o white label permite personalizar quase todo o plugin (logo, nome, cores e CSS próprio) no estilo desejado. Ative e configure em Ultrapack Auto Updater → White Label. Com ele ligado, o nome e o logo trocam inclusive no item do menu do WordPress, e o aviso de renovação do plano deixa de aparecer, já que quem administra o site do cliente final não gerencia a assinatura.

Item	Personalizável
Logo e nome	Cabeçalho e rodapé do plugin
Cores	Presets prontos ou cor personalizada
CSS	CSS próprio com escopo no plugin
Acesso	Restrição opcional por usuário: só o usuário dono enxerga e edita as opções de White Label
Suporte	O canal de contato dos itens bloqueados passa a ser o seu, não o da Ultrapack

12. Logs e telemetria

Todas as tentativas de atualização são registradas em logs, disponíveis por 24 horas em Ultrapack Auto Updater → Logs. Se uma atualização falhar, verifique os logs e encaminhe as informações ao suporte. A aba tem botão de copiar e de baixar os logs, já com site, URL e usuário do token no cabeçalho, e um botão para limpar. Há ainda a opção logs detalhados, que registra o passo a passo de cada atualização e ajuda quando o erro é difícil de reproduzir.

O plugin também tem telemetria de produto ativa por padrão, usada apenas para identificar problemas e melhorar o Ultrapack Auto Updater. Você pode desativá-la na mesma aba de Logs. Os dados coletados seguem a Política de Privacidade do Ultrapack.

13. Compatibilidade

O UAU é compatível com a grande maioria dos plugins e temas do WordPress, e é testado até o WordPress 7.0. Não recomendamos usar mais de um plugin de atualização de terceiros junto ao Ultrapack Auto Updater, para evitar conflito no sistema de updates.

• Child themes não são oferecidos para atualização automática, para não sobrescrever as suas customizações.
• Itens com o atualizador do próprio autor embutido continuam funcionando. Quem decide quem atualiza é você, pelo selo de licença original da seção 7.
• Multisite é suportado com ativação na rede. As opções ficam no painel da rede e a cota de multisites do plano é separada da de sites comuns.

14. Solução de problemas

Meu site está "Pendente" e não atualiza

Sites entram como Pendentes até a autorização do domínio. Confira em "Gerenciar sites"; se demorar, abra um chamado no suporte.

Site "Bloqueado"

Acontece quando é detectado uso indevido (ex.: excesso de domínios). Clique em "Contatar suporte" no próprio plugin para contestar.

"Atingiu o limite de sites"

Você registrou mais sites do que o plano permite. Remova um site não usado, contrate o add-on Sites Extras (1, 3 ou 5 sites adicionais, sem trocar de plano) ou faça upgrade.

As atualizações não rodam, e nada aparece

Confira nesta ordem: (1) o aviso de WP Recovery Agent não instalado no topo do plugin, porque sem ele as atualizações ficam desativadas; (2) se os Auto Updates estão ligados na aba Auto Updates; (3) se não há uma pausa ativa em Controle Manual; (4) se o selo do domínio está Autorizado.

Um item sumiu da lista de atualizações

Provavelmente ele foi bloqueado por erro no pacote e fica fora da lista por 1 hora. Veja a seção 8 e use o botão de contato com o suporte, que já leva a descrição do erro.

O item pede confirmação e fala em licença original

É a proteção da seção 7. Se você usa a licença oficial do autor nesse item, mantenha a proteção. Se a detecção errou, mude o selo para "Nunca proteger" no Gerenciador.

Meu site é Multisite e apareceu um aviso na linha dele

O sistema identificou uma rede Multisite num domínio cadastrado como site comum. Use Migrar para Multisite em Gerenciar sites para acertar o cadastro, ou Contestar se a identificação estiver errada.

Uma atualização falhou

O UAU reverte sozinho para a versão anterior. Verifique a aba de logs e, se persistir, use "Versões" para restaurar manualmente.