Se a sua instalação WordPress não está aparecendo no WP Toolkit ou está aparecendo, mas retornando algum tipo de erro, isso pode estar acontecendo por alguns motivos, desde questões simples até situações mais delicadas. Neste artigo vamos te explicar porque essas coisas podem acontecer, e algumas possíveis soluções.
Instalação não aparece no WP Toolkit
Abaixo listamos os dois principais motivos para que podem resultar no WP Toolkit não identificar as suas instalações WordPress:
- Pastas faltando
Um dos motivos mais comuns ocorre quando a ferramenta não consegue localizar ou identificar pastas padrão do WordPress, como a wp-includes e a wp-content, ou arquivos essenciais, como o wp-config.php.
A estrutura das pastas e arquivos do WordPress é algo perceptível e único, isso torna a validação bem mais fácil para o WP Toolkit, logo, se ele faz uma varredura na sua hospedagem e não localizar essas pastas e/ou arquivos, a instalação não será identificada, e consequentemente, não aparecerá na ferramenta. - Arquivo para ignorar instalação
O WP Toolkit permite a configuração para que diretórios sejam ignorados pela varredura da ferramenta. Isso significa que, se o arquivo .wp-toolkit-ignore existir na raiz da página do diretório onde seu site WordPress está instalado, ele não aparecerá na lista de instalações do WP Toolkit.
Embora você possa fazer essa configuração diretamente via WP Toolkit, se você apenas criar esse arquivo, sem qualquer conteúdo dentro dele, a ferramenta já passará a ignorar o diretório em novas varreduras. Por isso, esse é outro motivo que pode levar o seu site a não aparecer na ferramenta.
Note que esse arquivo começa com um ponto no nome, isso significa que ele é um arquivo oculto, se você não sabe como visualizar arquivos ocultos na sua hospedagem cPanel, recomendamos que acesse este artigo.
Instalação aparece, mas não consigo gerenciar
Por outro lado, se você já tinha a sua instalação WordPress no WP Toolkit, e agora, por algum motivo ela aparece como “quebrada” ou apresenta erros, arquivos essenciais do seu WordPress podem ter sido modificados. Abaixo te mostramos alguns exemplos:
- Arquivo functions.php
Para o funcionamento correto do WordPress, ele precisa de um tema funcional e ativo, e todo tema tem o seu arquivo principal, que é o functions.php. Se esse arquivo conter espaços ou pontuação em locais inadequados, o arquivo pode quebrar no momento de ser codificado a JSON (usado pelo WP Toolkit), resultando no erro:
Note que o site pode seguir acessível, mas na ferramenta WP Toolkit ele pode apresentar erros, e não ser possível gerenciar a instalação à partir dele.
Ao consultar o arquivo functions.php do tema ativo do seu site WordPress, você pode verificar se há algum tipo de espaçamento ou caractere especial. O arquivo fica dentro da pasta do tema, que normalmente fica no caminho “/wp-content/themes”. Abaixo um exemplo desse arquivo com um ponto no início, o que quebra a instalação no WP Toolkit:
Para resolver, é só remover o ponto e salvar o arquivo. Claro que se você estiver passando por algo semelhante, no seu caso pode não ser exatamente um ponto, mas sim um espaçamento, que também pode gerar o mesmo comportamento. - Plugins
Assim como os temas, os plugins também são essenciais para que o WP Toolkit consiga reconhecer, exibir e tornar possível o gerenciamento do seu site. Por isso, caso algum plugin esteja apresentando algum comportamento incomum ou impedindo o funcionamento correto do site, a ferramenta pode não reconhecer a instalação.
Diferente de temas, caso algum plugin seja o problema, pode ser que o site pare de funcionar, o que é um indicativo e um caminho que você pode seguir para identificar o problema mais rapidamente. Também podem haver arquivos de error_log sendo gerados, sendo mais uma alternativa para identificar a possível causa do problema.
E pronto, agora você já consegue entender melhor a causa de possíveis erros no seu WP Toolkit, e alguns exemplos de como resolver, claro, se for algo semelhante ao que viu aqui neste artigo. Esperamos que essa publicação tenha te ajudado, e te aguardamos em uma próxima.