# Ver todos os WordPress desatualizados da revenda no WHM

A tela do WP Toolkit no WHM lista as instalações de todas as contas cPanel. Como lê-la, como aplicar política de atualização no nível do servidor e o que fazer com o staging esquecido.

> abra o WHM em Plugins » WP Toolkit: a tela lista todas as instalações WordPress do servidor, de todas as contas cPanel, com versão, vulnerabilidade conhecida e estado das atualizações automáticas. Rode o scan antes para incluir instalações feitas fora do Toolkit.

João Rizzon · 2026-10-07 · Revenda

---

## Por que o cPanel de cada cliente nunca mostra o inventário inteiro

Numa revenda com dezenas de contas, a pergunta "quais sites estão rodando uma versão antiga do WordPress" não tem resposta rápida se você entrar conta por conta. Cada login no cPanel mostra só o que aquele usuário tem. Você acaba com uma planilha que envelhece no mesmo dia em que foi preenchida.

O **WP Toolkit for WHM** resolve isso por um caminho diferente: ele enxerga o servidor inteiro. A documentação oficial do cPanel descreve a interface do WHM como o lugar onde o administrador gerencia as instalações WordPress de todas as contas, aplica políticas e roda varreduras. É a diferença entre inventariar domínios (o que uma lista de subdomínios faz) e inventariar **aplicações**, com versão, estado de atualização e vulnerabilidade conhecida.

Se você é revendedor e não administra o WHM, pule para a última seção: a parte que você consegue fazer é diferente, e vale pedir a coisa certa ao provedor.

## Três coisas para conferir antes de abrir o WP Toolkit no WHM

Antes de prometer o relatório ao cliente, confira três coisas.

- **Acesso ao WHM com a função de administrador do servidor.** A interface do WP Toolkit para WHM fica em *WHM » Plugins » WP Toolkit*. Se o item não aparece no menu de plugins, o plugin não está instalado ou seu usuário não tem a função habilitada.
- **A edição do WP Toolkit disponível no servidor.** O cPanel distribui o WP Toolkit em edições diferentes, e nem todo recurso (varredura de vulnerabilidade, políticas de atualização em massa, clonagem) está presente em todas. Consulte a [documentação do WP Toolkit for WHM](https://docs.cpanel.net/whm/plugins/wp-toolkit-for-whm/) para confirmar o que a edição instalada expõe antes de desenhar o processo.
- **Permissões no pacote de revenda.** O que o seu cliente final vê no cPanel dele depende do pacote e das permissões atribuídas. Se você quer que o cliente possa clicar em "atualizar" sozinho, o recurso precisa estar liberado no pacote; se você quer o contrário (ninguém mexe, a política é sua), isso também se decide no pacote.

Não assuma que o WP Toolkit já está lá porque o cPanel está. Em servidor gerenciado por terceiro, a instalação e a edição são decisão do provedor.

## Como separar site desatualizado de site vulnerável na lista

A lista do WP Toolkit no WHM traz as instalações WordPress detectadas no servidor, agrupadas por conta cPanel/domínio. As colunas e rótulos variam com a versão e a edição, mas o que você procura é sempre o mesmo conjunto de sinais. Trate a tabela abaixo como um mapa de leitura, não como um print literal da sua tela:

| Sinal na tela | O que significa na prática | Ação típica |
|---|---|---||
| Versão do core abaixo da atual | Site com atualização pendente de núcleo | Agendar update; se for major, testar antes |
| Alerta de vulnerabilidade conhecida | Core, tema ou plugin com falha catalogada | Prioridade máxima, acima de versão "só antiga" |
| Instalação marcada como detectada/não gerenciada | WordPress instalado fora do Toolkit (upload manual, migração) | Passar a instalação detectada para gerenciada pelo Toolkit |
| Atualizações automáticas desligadas | O site não segue a política do servidor | Aplicar política em massa ou investigar override local |
| Data da última atualização muito antiga | Candidato a site abandonado | Confirmar com o cliente antes de qualquer coisa |

Dois critérios diferentes se confundem o tempo todo: **desatualizado** e **vulnerável**. Um site pode estar uma versão menor atrás e não ter nenhuma falha conhecida. Outro pode estar numa versão recente e ter um plugin com vulnerabilidade publicada. Quando for priorizar a fila de trabalho, ordene por vulnerabilidade primeiro e por versão depois. Quando for explicar ao cliente, explique nessa ordem também.

### O site existe no disco e não aparece na lista: rode o scan

O caso mais comum de "sumiço" é instalação feita fora do Toolkit: cópia por FTP, restauração de backup, migração de outro servidor. Ela existe no disco, mas o Toolkit só passa a conhecê-la depois de uma varredura. O WP Toolkit oferece a ação de **scan** justamente para localizar instalações ainda não registradas; rode-a antes de declarar que o inventário está completo, e rode de novo depois de qualquer migração em lote. Depois do scan, a instalação detectada precisa passar a ser gerenciada pelo Toolkit para receber a configuração de atualização; o rótulo do botão varia com a versão e a edição, confira na documentação da sua.

Se mesmo após o scan o site não aparece, verifique se o WordPress está de fato na docroot esperada daquela conta e se a instalação não está quebrada a ponto de não ser reconhecida como WordPress (`wp-includes/version.php` ausente, por exemplo).

## Política de atualização no nível do servidor, em vez de site a site

A mudança de patamar não é atualizar os sites atrasados hoje. É fazer com que amanhã eles não voltem a atrasar. A [documentação do WP Toolkit for WHM](https://docs.cpanel.net/whm/plugins/wp-toolkit-for-whm/) descreve a configuração de atualizações no nível do servidor pela própria interface do WHM, em vez de site a site. Confirme na documentação da edição instalada o alcance exato dessa configuração antes de prometer cobertura total ao cliente.

O desenho que costuma funcionar em revenda:

- **Core:** atualizações menores e de segurança automáticas. Esse é o tipo de release que o próprio projeto WordPress trata como correção, e o risco de quebra é baixo comparado ao risco de ficar vulnerável.
- **Plugins e temas:** automático para quem tem backup automatizado e site simples; manual com janela semanal para sites com customização pesada, loja ou integração.
- **Instalações novas:** não assuma que elas nascem cobertas. Confirme na documentação da sua edição se a configuração do servidor alcança instalações criadas depois; se não alcançar, inclua a checagem de sites novos no ciclo mensal.

Antes de aplicar em massa, defina a exceção. Sempre existe o site que não pode atualizar sozinho. Documente quais são e por quê, porque daqui a seis meses ninguém lembra.

### Quatro motivos para o site não atualizar mesmo com a política ligada

Um site pode continuar sem atualizar mesmo com a política ligada. As causas mais frequentes:

- Constantes definidas no `wp-config.php` que desligam atualização automática no nível da aplicação.
- Plugin de gerenciamento ou de segurança que controla updates por conta própria.
- Permissões de arquivo que impedem a escrita na docroot.
- Disco cheio ou cota da conta estourada: a atualização baixa o pacote e falha ao extrair.

Para checar o primeiro caso rapidamente numa conta via SSH:

```bash
grep -nE "AUTOMATIC_UPDATER_DISABLED|WP_AUTO_UPDATE_CORE|DISALLOW_FILE_MODS" \
  /home/USUARIO/public_html/wp-config.php
```

Se `DISALLOW_FILE_MODS` estiver como `true`, nenhuma atualização pela interface vai funcionar, venha ela do painel do WordPress ou do Toolkit. E vale checar espaço e cota antes de culpar o Toolkit por um update que falhou:

```bash
df -h /home
quota -s -u USUARIO
```

Troque `USUARIO` pelo nome da conta cPanel. Os caminhos acima são exemplos de layout comum; confirme a docroot real da conta antes de rodar.

## Desativar o staging abandonado sem criar briga com o cliente

Toda revenda tem eles: `teste.cliente.com.br`, `novo.cliente.com.br`, `homolog.cliente.com.br`. WordPress instalado, nunca atualizado, sem conteúdo relevante e com um plugin de formulário de 2019. É o ponto de entrada mais barato que um atacante encontra no seu servidor, porque ninguém olha.

Processo que fecha o assunto sem criar briga com o cliente:

- Liste no inventário tudo que está sob subdomínio com cara de staging e sem atualização recente.
- Verifique se o subdomínio responde publicamente e se está indexado. Ambiente de teste exposto e indexado é problema duplo: segurança e conteúdo duplicado.
- Avise o cliente por escrito, com prazo. Guarde o aviso.
- Passado o prazo, faça um backup completo da docroot e do banco, e então desative: bloqueio de acesso, remoção da instalação ou arquivamento, conforme o combinado.
- Registre a decisão no mesmo lugar onde você guarda as exceções de política.

Frase pronta para o e-mail ao cliente: "Encontramos uma instalação do WordPress em `teste.seudominio.com.br` sem atualização desde [data]. Ela não é usada pelo site principal, mas fica acessível na internet e pode ser usada para invadir a hospedagem. Com sua autorização, fazemos um backup completo e desativamos esse endereço. Se não houver retorno até [data], seguimos com o backup e a desativação."

## Ciclo mensal de quatro semanas que mantém o inventário vivo

Um relatório que você gera uma vez não muda nada. O ganho vem da repetição barata. Um ciclo mensal que cabe em pouco tempo:

- **Semana 1:** rodar o scan no WP Toolkit, conferir instalações novas e não gerenciadas, anexar as que ficaram de fora.
- **Semana 2:** tratar a fila de vulnerabilidades conhecidas, da mais crítica para a menos.
- **Semana 3:** revisar quem está fora da política de atualização automática e por quê.
- **Semana 4:** limpar staging abandonado e enviar o resumo aos clientes com contrato de manutenção.

Para o cliente, o entregável não é a tela do WHM. É uma linha por site: versão atual, pendências, vulnerabilidades tratadas no mês, data do último backup verificado. Quem vende manutenção e não mostra esse resumo está trabalhando de graça.

## Revendedor sem acesso ao WHM: o que pedir ao provedor

Nem toda revenda dá acesso de administrador de servidor. Sem WHM, a tela global de instalações não é sua, e não adianta procurar equivalente no cPanel de um cliente: lá você vê apenas aquela conta.

O que pedir ao provedor, nessa ordem:

- Confirmação de que o WP Toolkit está instalado e qual edição, porque a varredura de vulnerabilidade depende disso.
- Que o recurso esteja habilitado nos pacotes das suas contas, para você gerenciar instalação por instalação dentro de cada cPanel.
- Qual é a política de atualização automática padrão aplicada no servidor, para você não desenhar uma rotina que conflita com ela.

Com isso, você reconstrói boa parte do processo acima conta a conta: o inventário fica mais lento de montar, mas a decisão sobre política, staging abandonado e comunicação ao cliente continua idêntica. E o fluxo que você documentar agora continua valendo no dia em que migrar para um servidor com WHM próprio.

