Os desenvolvedores da JoomUnited trabalham sempre para que seus plugins funcionem da melhor maneira possível. Claro que, em alguns casos, podem ocorrer falhas, como, por exemplo, incompatibilidades causadas por plugins de terceiros. E o que queremos quando esses problemas acontecem? Que sejam resolvidos rapidamente...    

Neste post, vamos ensinar como fornecer as informações corretas ao desenvolvedor para que ele possa entender e resolver o erro rapidamente. Este post será dividido em 3 etapas que seguiremos para fornecer as informações corretas a um desenvolvedor quando um problema ocorrer:

• Ative o registro de depuração
• Instale o Plugin de Solução de Problemas
• Verifique se há erros de JavaScript

Ative o sistema de depuração e registro do WordPress

Primeiramente, precisamos saber o que WP_DEBUG ; como podemos ver na Wikipédia, “ WP_DEBUG é uma do PHP (uma variável global permanente) que pode ser usada para ativar o modo de depuração em todo o WordPress. Assume-se que seja falso por padrão e geralmente é definido como verdadeiro no arquivo wp-config.php em cópias de desenvolvimento do WordPress.”

Como podemos ver, WP_DEBUG é uma constante que, por padrão, está desativada , mas podemos ativá-la temporariamente para fins de depuração.

Além disso, existe outra constante do PHP chamada WP_DEBUG_LOG que nos ajudará a criar automaticamente um arquivo de texto com todos os erros dos seus plugins, e é isso que enviaremos aos desenvolvedores.

Vamos ensinar exatamente como ativar o recurso e como ele se comporta caso haja algum erro com o seu plugin. Usaremos WP Meta SEO WP Meta SEO , mas poderia ser qualquer problema. Então, vamos abrir o wp-config.php. Você pode usar o seu editor de texto preferido, como o Bloco de Notas, o Visual Studio Code ou o Brackets, por exemplo. Basta abrir wp- .

O arquivo está localizado na raiz do seu servidor, onde seu site WordPress está instalado.

Abra o arquivo com o editor de texto e pressione CTRL + F ou clique em Editar > Localizar… Você verá uma caixa onde poderá digitar a palavra que deseja encontrar. Neste caso, vamos digitar “WP_DEBUG” e pressionar Enter até encontrar:
“define( 'WP_DEBUG', false )”

Agora que estamos nessa linha, remova o “false” e digite true, clique em Enter e na próxima linha copie define( 'WP_DEBUG_LOG', true ); e salve o arquivo, ele deverá ficar como na próxima imagem.

Se essas duas linhas forem alteradas, um arquivo chamado “debug.php” aparecerá em /wp-content/

Pronto… concluímos a primeira etapa. Este é um dos arquivos que nossos desenvolvedores precisarão para agilizar o processo de correção do seu problema. Todos os erros serão monitorados e registrados neste arquivo de texto.

Instale o plugin de resolução de problemas do WordPress

O plugin Health Check & Troubleshooting permite realizar uma verificação de conflitos sem afetar os visitantes normais do seu site. É muito fácil de usar e instalar, e neste exemplo usaremos WP Meta SEO . Siga estes passos para instalar e executar uma verificação de conflitos com o Health Check & Troubleshooting:

• Faça login no seu site WordPress e você estará no painel de controle do seu site
• Clique em “Plugins”, na seção à esquerda da sua página
• Clique em “Adicionar novo”
• Digite “Verificação de integridade e solução de problemas” na barra de pesquisa, conforme mostrado abaixo

• Clique em “Instalar agora” . A lista de plugins será atualizada automaticamente. Localize o plugin desejado, clique em “Instalar agora” e, em seguida, em “Ativar”.

• Clique em “Saúde do Site” . No menu à esquerda, há uma seção chamada “Ferramentas”. Clique nela e, em seguida, em “Saúde do Site”.

• Clique na “Solução de problemas” , leia as informações de aviso e clique em “Entrar no modo de solução de problemas”. 

O modo de resolução de problemas desativa automaticamente todos os plugins e alterna para um tema padrão. O modo de resolução de problemas não afeta os visitantes normais do seu site.  

• Reproduza o problema que você estava enfrentando.

Em um ambiente padrão, sem plugins ativos e com um tema padrão, se o problema ocorrer, significa que nosso plugin não está causando o comportamento inesperado.

• Clique em “Plugins” > “Plugins instalados”

  O menu “Plugins” será expandido, oferecendo opções adicionais. Clique em “Plugins instalados”

• Clique em “Ativar durante a resolução de problemas” ao lado de WP Meta SEO

• Reproduza o problema que você estava enfrentando com apenas WP Meta SEO ativo e um tema padrão. Se o problema ocorrer, ele é causado pelo nosso plugin.

De certa forma, isso é uma boa notícia, pois você já identificou parte do problema. Agora, precisamos que o desenvolvedor acesse seu site e corrija o problema antes de lançarmos uma nova versão! Caso contrário, repita os passos para ativar o próximo plugin desativado no qual você consiga reproduzir o erro.

Verificação e depuração de erros de Javascript em plugins do WordPress

Vamos procurar erros de Javascript no console do Chrome ou do Firefox. Dependendo do navegador, o nome pode variar um pouco, mas, seguindo a nomenclatura do Chrome e do Firefox, vamos chamá-lo de "Console". Para abrir o console, basta seguir estes passos:  

• Clique com o botão direito do mouse em "Inspecionar" na interface do usuário, em qualquer parte do site.

• Selecione "Console ". Isso abrirá as ferramentas de desenvolvedor no lado direito da página. Clique em "Console".

Verifique se há erros. Com o console aberto, reproduza o erro esperado e observe o texto em vermelho no console. Os erros indicam onde está o conflito de JavaScript.

Se você encontrou um erro de JavaScript, faça uma captura de tela da versão expandida do erro para incluí-la em seu ticket/postagem.

Envie/Compartilhe seu Relatório de Problemas

Agora que você tem todas essas informações, ajudará o desenvolvedor a agilizar o processo. Basta reunir todas as informações coletadas e adicioná-las ao seu ticket/postagem. Lembre-se, os itens são:  

• debug.log
• Atenção aos plugins que causam conflitos
• Uma captura do console JavaScript com o erro

Se você seguir esses passos e nos enviar as informações corretas, o desenvolvedor poderá realizar a depuração mais rapidamente e agradecemos muito desde já :)    

Criar e compartilhar uma nova conta de usuário do WordPress para fins de suporte

Criar um novo usuário administrador às vezes é uma maneira rápida de mostrar à equipe de suporte qual é o seu problema. Antes de iniciar esse processo, um breve lembrete de que:

• Não armazenamos credenciais antigas após a resolução do problema (por motivos de segurança)
• Recomendamos remover as contas de usuário administrador criadas para fins de suporte
• Todas as informações compartilhadas com nossa equipe são seguras e permanecerão privadas

Para criar um novo usuário, primeiro você precisa acessar o painel de administração do seu site. Após o login bem-sucedido, você estará no painel do WordPress.

Em seguida, você deve ir ao Menu à esquerda > Usuários .

Em seguida, navegue até a tela superior, clique no Adicionar novo ou acesse o Adicionar novo no menu à esquerda.

Em seguida, o Adicionar Novo Usuário aparecerá na sua tela. Há dois campos obrigatórios para preenchimento: Nome de usuário e E-mail .

No Senha , você pode usar um gerador de senhas aleatórias ou definir a sua própria. E você pode marcar Enviar Notificação ao Usuário se quiser enviar um e-mail ao novo usuário sobre a sua conta.

Em seguida, selecione uma função para o usuário na caixa suspensa. Esta é uma etapa importante para definir as permissões dos usuários em seu site. "Administrador" é o nível mais alto e concede ao usuário acesso a todos os recursos do seu site. Você pode definir outras funções se desejar limitar o acesso do usuário.

Por fim, clique no Adicionar novo usuário na parte inferior. Pronto! Boa sorte!