Como ajudar com a depuração de plug-in do WordPress

Os desenvolvedores do JoomUnited sempre trabalham para que seus plug-ins funcionem da melhor maneira possível, é claro que em alguns casos pode ocorrer algum tipo de falha, por exemplo, uma incompatibilidade gerada por causa de um terceiro plug-in e o que queremos quando esses tipos de falhas acontecem? Claro, eles são resolvidos rapidamente ...    

Neste post, ensinaremos como passar as informações corretas ao desenvolvedor para que ele entenda e resolva o erro rapidamente. Esta postagem será dividida em 3 etapas que iremos seguir para fornecer as informações corretas a um desenvolvedor quando ocorrer um problema:

• Ativar log de depuração
• Instale o plug-in de solução de problemas
• Verifique se há erros de javascript

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

Antes de mais nada, temos que saber o que WP_DEBUG ; Como podemos ver na Wikipedia, “ WP_DEBUG é uma PHP (uma variável global permanente) que pode ser usada para acionar o modo "debug" em todo o WordPress. Supõe-se que seja falso por padrão e geralmente é definido como verdadeiro no arquivo wp-config.php nas cópias de desenvolvimento do WordPress.”

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

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

Vamos ensinar como exatamente podemos ativá-lo e como ficará se houver um erro com o seu plugin. WP Meta SEO será usado para este exemplo, mas você pode seguir os mesmos passos para todos os nossos plugins. Neste caso, temos um problema com WP Meta SEO , pode ser qualquer problema, então o que vamos fazer é abrir o arquivo wp-config.php, isso pode ser feito com seu software editor de texto preferido, com o Notepad, Visual Studio Código, colchetes, por exemplo, basta ir e abrir wp-config.php .

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

Abra-o com o editor de texto e pressione CTRL + F ou clique em Editar > Localizar… você poderá ver uma caixa onde poderá digitar a palavra que vai encontrar, neste caso, vamos digitar “ WP_DEBUG” e clique em 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 deve se parecer com a próxima imagem.

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

E pronto ... concluímos a primeira etapa, esse é um dos arquivos que nossos desenvolvedores precisarão para acelerar o processo de correção do seu problema. Todos os erros serão monitorados e gravados neste mesmo arquivo de texto.

Instale o plug-in de solução de problemas do WordPress

O plug-in Health Check & Troubleshooting é um plug-in que permite executar uma verificação de conflito sem afetar os visitantes normais do seu site, é realmente fácil de usar e instalar, ainda usaremos o WP Meta SEO para este exemplo. Siga estas etapas para instalar e executar uma verificação de conflito com Verificação de integridade e solução de problemas:

• Faça o login no seu site Wordpress, você estará no painel 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, como mostrado abaixo

• Clique em “Instalar agora” , a lista de plugins será cobrada automaticamente, procure a direita e clique em “Instalar agora” e depois em “Ativar”

• Clique em “Site Health” , No menu à esquerda há uma seção chamada “Tools” Clique nele e depois em “Site Health”

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

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

• Reproduza o problema que você estava enfrentando

No ambiente padrão sem plug-ins ativos e um tema padrão, se o problema ocorrer, significa que nosso plug-in 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 “Ativar durante a solução de problemas” ao lado de WP Meta SEO

• Reproduza o problema que você estava enfrentando apenas com o WP Meta SEO ativo e um tema padrão; se o problema ocorrer, o problema é causado por nosso plug-in.

De certa forma, essa é uma boa notícia, porque você já identificou uma parte do problema. Agora, é necessário que o desenvolvedor faça login no seu site e corrija o problema antes de lançarmos uma nova versão! Caso contrário, repita as etapas para ativar o próximo plug-in desativado, para reproduzir o erro.

Verificando e depurando erros de Javascript em plugins do WordPress

Vamos procurar erros de Javascript no console do Chrome ou Firefox. Dependendo do seu navegador a nomenclatura é um pouco diferente, mas seguindo o Chrome e o FireFox, vamos chamá-lo de “Console”. Para abrir o console basta seguir estes passos:  

• Clique com o botão direito em inspecionar, no frontend em qualquer parte do site

• Selecione console , ele abrirá as ferramentas do desenvolvedor no lado direito da página, clique em “Console”

Verifique se há erros , com o console aberto, reproduza o erro que você esperava e dê uma olhada no console, os erros são textos em vermelho que descrevem onde está localizado 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í-lo em seu ticket/postagem.

Enviar / compartilhar seu relatório de problemas

Agora que você tem todas essas informações, você vai ajudar o desenvolvedor a agilizar o processo, basta ir buscar todas as informações que você coletou e enviar para seu ticket/post, vamos lembrar, os itens são:  

• debug.log
• Observe com os plugins que causam conflitos
• Uma captura do console javascript com o erro

Se você seguir estas etapas e nos enviar as informações corretas, o desenvolvedor poderá executar um trabalho de depuração mais rápido e agradecemos desde já :)    

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

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

• Não armazenamos credenciais antigas após a soluçã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 protegidas e permanecerão privadas

Para criar um novo usuário, primeiro faça login no seu site de administração. Após fazer login com sucesso, você está no painel do Wordpress.

Em seguida, você deve ir para o menu esquerdo > Usuários .

Depois disso, navegue até a tela superior, clique no botão Adicionar Novo ou vá para o botão Adicionar Novo no Menu à esquerda.

Em seguida, o formulário Adicionar Novo Usuário aparecerá na tela. Existem 2 campos obrigatórios para preencher as informações: Nome de usuário, Email .

No campo Senha , você pode usar o gerador de senha aleatória ou definir o seu próprio. E você pode marcar a opção Enviar Notificação ao Usuário se desejar enviar ao novo usuário um e-mail sobre sua conta.

Depois, você escolhe uma função para o usuário na caixa suspensa. Esta é uma etapa importante para definir a permissão para usuários em seu site. "Administrador" é o nível mais alto e dá ao usuário acesso a todos os recursos do seu site. Você pode definir outras funções se quiser limitar o acesso do usuário.

Por fim, clique no botão Adicionar novo usuário na parte inferior. Já está feito, boa sorte!