Documentação do Auto Updater

1. Introdução

O Auto Updater ajuda a instalar e atualizar itens no WordPress. Comece grátis para proteger atualizações do WordPress.org. Com um plano, use também o catálogo premium. Antes de atualizar, ele salva os arquivos do item.

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

A lista atualizada de itens compatíveis está na página de itens suportados.

2. Instalação

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

Método 1: pelo painel do WordPress

1. Envie o ZIP

   Vá em Plugins → Adicionar novo → Enviar plugin e selecione o .zip baixado.

2. Instale

   Clique em "Instalar agora".

3. Ative

   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

   Por 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. Conectar o site

Para usar o catálogo premium, conecte o plugin à sua conta com o token, o código disponível em Gerenciar sites. No modo grátis, essa conexão não é necessária.

1. Gere o token

   Em Gerenciar sites, na sua conta, gere e copie o seu token.

2. Cole e salve

   No cartão Conexão do site, cole o valor no campo do token e clique em Salvar token. O cartão passa a mostrar Conectado, e o domínio do site aparece logo abaixo com o estado dele.

3. Autorize o domínio, se for preciso

   Se o domínio não aparecer como autorizado, registre-o em Gerenciar sites (veja Registrar e limite de sites, logo abaixo), copiando a URL do site direto do navegador. Volte ao painel e recarregue a tela.

Cartão	O que mostra
Conexão do site	O token (mascarado, com o olho para conferir), o domínio e se ele está autorizado. Desconectar tira o token deste site.
Leve suas preferências com você	Exportar configurações gera um arquivo com os ajustes deste site, e Importar configurações aplica esse arquivo em outro. O token e a senha de SMTP não entram no arquivo.
Sua licença	Plano, conta, validade, estado do domínio e os downloads do catálogo usados hoje. Gerenciar minha conta abre a sua conta no site.
Ambiente	Versões do WordPress, do PHP e do plugin, e se a recuperação automática está ativa. É o que o suporte pede primeiro.

Registrar e limite de sites

Cada domínio precisa ser autorizado antes de receber atualizações. O UAU conta por domínio ativo, e cada plano tem um limite próprio. Sites comuns e redes WordPress Multisite contam em limites separados. Quantas vagas você já usa aparece em Meu plano, e tudo se gerencia em Gerenciar sites.

O sistema também identifica sozinho quando um domínio registrado como site comum é uma rede Multisite. A linha ganha um aviso e o botão Migrar para Multisite. Se a identificação estiver errada, use Contestar e a equipe revisa; enquanto isso a linha mostra "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

   Em "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

   Com o site Autorizado e a proteção ativa, escolha no plugin os itens e a agenda de atualização.

4. Conhecendo o painelNovo

Depois de ativado, o plugin ganha um item próprio no menu do WordPress, Ultrapack Auto Updater. Tudo acontece dentro dele, num painel com menu lateral. Trocar de tela não recarrega a página, e uma tela que você já abriu volta na hora, com a busca e os filtros onde estavam.

Onde	O que tem
Lateral: Seu site	Gerenciador, Catálogo, Template Kits e Auto Updates.
Lateral: Preferências	Configurações, Snapshots, White Label e Logs.
Pé da lateral	O cartão do seu plano, que abre Meu plano; o cartão Proteção ativa, que diz se a recuperação automática está ligada; Central de ajuda, que abre o suporte no idioma do painel; e a versão do plugin.
Cabeçalho	O caminho da tela, o estado da conexão com a Ultrapack, o sino de notificações e o botão que alterna entre tema claro e escuro.
Rodapé	Reportar problema abre um ticket de suporte já preenchido com os dados do site. Com o White Label ligado, ele leva ao contato que você configurou.

Tema escuro

O botão de lua no cabeçalho troca o painel para o tema escuro, e a escolha fica guardada no navegador. Os relatórios de Logs acompanham as cores na tela e continuam saindo em fundo branco na impressão.

Notificações

O sino do cabeçalho abre as notificações. Elas trazem as versões novas dos itens que você acompanha (botão Acompanhar na ficha de um item do Catálogo) e as respostas às suas Solicitações. Um ponto no sino indica que há notificação não lida. Os filtros Tudo, Acompanhando e Solicitações separam os dois tipos, e Marcar como lidas limpa o ponto.

5. Gerenciador

O Gerenciador mostra os itens do catálogo instalados, suas versões e o que precisa ser atualizado. Escolha quais o UAU pode atualizar.

1. Encontre o item

   Use os filtros Todos, Atualizações e Em dia, ou a busca. Verificar, no alto da tela, consulta o servidor na hora.

2. Clique em "Atualizar"

   O plugin salva os arquivos do item, atualiza e verifica se o site responde. Se detectar falha, restaura a cópia anterior.

3. Ligue o automático por item

   O interruptor da coluna Auto Updates decide se aquele item entra nas atualizações automáticas.

Detalhes do item e versões anteriores

Atualizar vários de uma vez

Itens com versão nova ganham uma caixa de seleção. Marcados, aparece Atualizar selecionados: eles são atualizados um por vez, na ordem da lista, com o progresso na tela. Mantenha a tela aberta enquanto a fila anda. Itens com licença original ficam fora da seleção em massa de propósito, porque cada um pede confirmação.

Selo de verificação de segurança

Itens cujo pacote passou pela nossa verificação de vírus mostram o selo Verificado. Clicando nele você vê arquivos analisados, quantos foram apontados como suspeitos, o motor usado, a data e o SHA-256 do pacote. Quando a verificação disponível é de outra versão, o selo muda para Outra versão e diz de qual versão ele fala.

Proteção de licença original

Se um item está instalado 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 avisa e deixa você decidir:

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

Cada item tem três estados, ajustáveis pelo cadeado da linha ou pelos detalhes do item:

Estado	Efeito
Automático	A proteção automática está desativada por padrão. Use Sempre proteger nos itens com licença original do desenvolvedor.
Sempre proteger	Protege o item contra atualizações do UAU até você autorizar explicitamente a substituição.
Nunca proteger	Permite que o UAU atualize o item. Use apenas quando quiser substituí-lo pela versão do catálogo.

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, tira a atualização da lista e mostra um botão de contato com o suporte, já com a mensagem do erro. As duas checagens que barram o pacote acontecem antes de instalar, então a versão no ar continua intacta:

• Divergência de versão: o item é anunciado numa versão e o pacote traz outra.
• Arquivo diferente do anunciado: o SHA-256 do arquivo baixado não bate com o publicado. O pacote é descartado e a recusa nos é comunicada.
• A espera cresce a cada falha seguida na mesma versão: 1 hora, depois 6 horas, e na terceira a versão entra em quarentena. Uma versão nova libera o item sozinha.
• Com White Label ligado, o contato aponta para o canal de suporte do revendedor.

6. CatálogoNovo

O Catálogo traz o catálogo Ultrapack para dentro do painel: buscar, filtrar e instalar plugins e temas sem baixar ZIP. Ele tem quatro abas, Explorar, Favoritos, Coleções e Solicitações.

• Plugins e temas: as abas Todos os itens, Plugins e Temas mostram quantos itens cada uma tem. O filtro de segmentos acompanha a aba e só lista categorias com itens daquele tipo.
• Desenvolvedores: o filtro tem busca e aceita vários desenvolvedores ao mesmo tempo.
• Ordenar por: últimos adicionados, últimos atualizados, mais baixados ou nome. Ao lado, grade ou lista. Cada página mostra 24 itens.
• Categoria no cartão: é um link, e filtra o Catálogo por ela.
• Pacotes completos: temas e plugins entregues como pacote do autor, como Avada, Betheme e Flatsome, também instalam pelo Catálogo.

Ficha do item

Instalar vários de uma vez

Favoritos

O coração no cartão salva o item nos Favoritos. Por padrão eles ficam neste site, separados por usuário. Ligando Sincronizar com favoritos do site, a aba passa a usar os favoritos da sua conta Ultrapack, os mesmos da página de Favoritos do site.

Coleções

Uma coleção é um conjunto com nome de plugins e temas, como "Loja virtual" ou "Site institucional", para montar o próximo site de uma vez. Dá para criar, editar, duplicar e instalar a coleção inteira. Em Compartilhar, a coleção sai como código ou arquivo, e Importar coleção a traz para outro site ou outro usuário.

Solicitações

7. Template KitsNovo

Em Template Kits você instala kits de páginas prontas para o Elementor direto do catálogo, com as imagens, os plugins que o kit exige, as cores e as fontes. Não precisa do plugin Template Kit Import. Instalar um kit usa 1 download da cota do dia.

Kits	Quem tem
Elementorism (CSSIgniter)	Qualquer plano ativo
Envato Elements	Fazem parte dos Extras, que vêm nestes planos: Desenvolvedor e Agência. Em outro plano, a tela mostra o que o seu plano inclui e o que os Extras liberam, com o botão de upgrade

Na aba Instalados, cada kit abre com os templates dele e três ações: Importar todos leva os templates para a biblioteca do Elementor; a lista Plugins que o kit usa instala e ativa o que falta; e Aplicar estilos do kit transforma as cores e as fontes do kit nas globais do Elementor do site, o que dá para desfazer depois. Excluir kit tira o kit do site. O coração no cartão salva o kit nos favoritos.

8. Auto Updates

O UAU tem atualização automática própria, independente das configurações do WordPress: mesmo com as automáticas do WordPress desligadas, os itens do Ultrapack continuam sendo atualizados. Tudo fica na tela Auto Updates, que se salva com Salvar preferências.

Avisos por e-mailNovo

Os avisos por e-mail têm dois níveis: o de cada site, no plugin, e o da sua conta, em Gerenciar sites.

Na conta: em Gerenciar sites, o cartão Avisos por e-mail escolhe como você recebe os avisos de todos os sites:

• Um e-mail a cada atualização ou erro, enviado por cada site (padrão): cada site segue o próprio interruptor, acima.
• Resumo de todos os sites, 1, 2, 3, 4, 6, 8 ou 12 vezes por dia, ou a cada hora: a Ultrapack junta num só e-mail o que foi atualizado e o que falhou em todos os seus sites, e os sites param de mandar o aviso de cada atualização. O primeiro resumo do dia sai às 8h (horário de Brasília) e os outros em intervalos iguais. Período sem atividade não gera e-mail.

WP Recovery Agent

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

A versão instalada aparece em Proteção em cada etapa, na tela Auto Updates. No cartão Auto-reparo fica o interruptor Desativar o plugin defeituoso, ligado por padrão: quando um erro fatal aparece, o plugin causador é desativado para o site voltar. Temas não são desativados, apenas avisados por e-mail. Com o interruptor desligado, o agente ainda recupera o site, mas não desativa nada sozinho.

9. Snapshots

Cópias deste site guardam os arquivos antes de uma atualização. Versões anteriores do catálogo são arquivos para baixar ou reinstalar, conforme seu acesso.

Uma snapshot é a cópia de um plugin ou tema guardada antes de cada atualização. A tela Snapshots lista as cópias disponíveis, da mais recente para a mais antiga, com versão, tamanho e origem (atualização manual ou automática), e mostra quanto espaço elas ocupam. Restaurar volta o item àquela versão, e Remover apaga a cópia.

Preferência	O que faz	Padrão
Snapshots obrigatórias	Nenhuma atualização começa sem a cópia pronta. Desligar exige dupla confirmação, porque o site perde o rollback automático	Ligado
Versões legadas remotas	Oferece versões anteriores guardadas no nosso servidor, além das cópias deste site	Ligado
Retenção (dias)	Por quantos dias as cópias são guardadas	4
Máximo por item	Quantas cópias de cada item ficam guardadas	2

10. White Label

Para revendas e agências: o White Label troca a identidade do painel pela sua, e uma prévia em tempo real ao lado mostra o resultado enquanto você edita. Ligue em Ativar White Label e salve com Salvar identidade; Restaurar padrão desfaz tudo. Com ele ligado, nenhuma marca Ultrapack aparece no painel, nem no ícone do menu do WordPress, e o aviso de renovação do plano some, porque quem administra o site do cliente final não gerencia a assinatura.

Aba	O que personaliza
Identidade	Nome da marca e do plugin, descrição, versão exibida (a técnica continua valendo para as atualizações), site da marca, página do produto, e-mail e página de suporte
Aparência	Cores (tema de cores e destaque da marca), botões e rodapé, com logo próprio, logo monocromático ou sem logo
Navegação	Quais telas o cliente enxerga, e o ícone de cada uma. A tela desmarcada some do menu e não abre pelo endereço direto; quem administra o White Label continua vendo todas
Login e barra	A marca fora do painel: o logo, o link e as cores da tela de login do WordPress, e a marca no canto da barra do admin
Avançado	Restringir esta página a um usuário, para só ele ver e editar o White Label, e CSS próprio com escopo no plugin

11. Logs

A tela Logs tem duas abas. Em Atividade, a Linha do tempo registra atualizações, versões restauradas, recuperações automáticas, instalações pelo Catálogo, template kits e mudanças de configuração, com quem fez e quando. Os filtros separam sucesso, avisos e falhas, e há busca por evento ou item.

• Registro técnico: as mensagens detalhadas das últimas 24 horas, abaixo da linha do tempo, para o suporte. Elas só são gravadas com Logs detalhados ligado. Limpar registro técnico pede confirmação.
• Copiar logs e Baixar logs levam o registro com o site e a versão no cabeçalho, prontos para mandar ao suporte.
• Compartilhar diagnóstico, em Preferências de registro, envia dados técnicos sobre falhas de atualização, sem nada do conteúdo do site. Vem ligado e pode ser desligado ali.

Relatórios para o cliente

A aba Relatórios monta um resumo para o cliente final: atualizações concluídas, cópias de segurança feitas, próximas atualizações e as últimas melhorias, com a sua marca no cabeçalho. Escolha o mês ou os últimos 7 ou 30 dias e use Imprimir / salvar PDF.

12. Meu planoNovo

O cartão do plano, no pé da lateral, abre Meu plano: o seu acesso, o que ele inclui e quanto já foi usado hoje.

• Sua conta Ultrapack: plano, conta conectada e até quando o acesso vale, com Gerenciar minha conta e Detalhes da conexão.
• Downloads do catálogo hoje: a cota diária usada pelo Catálogo e pelos Template Kits.
• Sites da conta: quantas vagas de site da sua conta estão em uso, só em números, com o atalho para Gerenciar sites. Este site mostra se o domínio está autorizado.
• O que protege este site e Próxima verificação: os recursos ligados aqui e quando o plugin procura atualizações de novo.

13. Compatibilidade

O UAU é compatível com a grande maioria dos plugins e temas do WordPress e é testado até o WordPress 7.1. Não recomendamos usar outro plugin de atualização de terceiros junto, 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ê, pela proteção de licença original.
• Plugins com texto depois do número da versão, como os da tagDiv, não são mais oferecidos de novo logo depois de atualizados (corrigido na 1.7.4).
• 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.
• Idioma: o plugin acompanha o idioma do WordPress, em 17 idiomas. Frase sem tradução aparece no idioma original, e o resto da tela continua traduzido.

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 ticket no suporte.

Site "Bloqueado"

Acontece quando é detectado uso indevido (por exemplo, excesso de domínios). Use Reportar problema, no rodapé do painel, para contestar.

"Atingiu o limite de sites"

Você registrou mais sites do que o plano permite; o uso aparece em Meu plano. Remova um site que não usa, contrate o add-on Sites Extras 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 painel; (2) se as Atualizações automáticas estão ligadas em Auto Updates; (3) se não há uma pausa ativa; (4) se o domínio está Autorizado em Configurações; (5) se o item tem o interruptor de Auto Updates ligado no Gerenciador.

Não recebo mais os e-mails de cada atualização

Desde a versão 1.7.5 o interruptor Enviar relatório por e-mail vale de verdade, e ele vem desligado. Ligue-o em Auto Updates → Notificações por e-mail em cada site, ou escolha o resumo de todos os sites em Gerenciar sites. Se a conta estiver no resumo, os sites não mandam o aviso de cada atualização: é o esperado.

O Catálogo diz que a cota de downloads acabou

Instalações pelo Catálogo e template kits usam a cota diária de downloads do seu plano, a mesma do site. Ela volta no dia seguinte; o uso aparece em Meu plano. As atualizações automáticas têm um teto próprio e não gastam essa cota.

Um plugin instalado pelo Catálogo ficou desativado

Três motivos possíveis: foi instalado em lote (plugins em lote ficam desativados até você ativar); ele derrubou o site ao ser ativado e foi desativado sozinho; ou ele depende de outro plugin que falta. Nos dois últimos casos o painel diz qual plugin, e o evento fica na linha do tempo.

Um item sumiu da lista de atualizações

Provavelmente ele foi bloqueado por erro no pacote e fica fora da lista por um tempo, que cresce a cada falha seguida. Veja Item bloqueado por erro de atualização e use o botão de contato, que já leva a descrição do erro.

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

É a proteção de licença original. Se você usa a licença oficial do autor nesse item, mantenha a proteção. Se a marcação está errada, mude para "Nunca proteger".

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, ou Contestar se a identificação estiver errada.

Apareceu "limite diário de downloads atingido"

É o teto diário do auto-updater (até 25 itens por site e 50 por conta, por dia), separado da cota de downloads do seu plano. Não é falha de atualização e nada foi perdido: os itens pendentes entram nos próximos ciclos, depois que o dia virar.

A atualização parou dizendo que o arquivo não confere

O UAU comparou o arquivo baixado com o que o servidor anunciou e descartou o pacote antes de instalar, então o item continua na versão em que estava. A recusa nos é comunicada sozinha. Se ela se repetir, use o botão de contato do item.

Uma atualização falhou

Confira a falha e o resultado da reversão na aba Logs. Se necessário, use Versões para restaurar manualmente um snapshot disponível do item. Mudanças no banco de dados podem precisar de atenção separada.