WPML

Compartilhar informações de depuração do WPML com o suporte

A equipe de suporte do WPML pede as mesmas informações na maioria das dúvidas de suporte: o bloco de Informações de depuração de WPMLSuporteVerificação do sistema, uma cópia do site ou do seu banco de dados, a saída do console do navegador e alguns outros itens. Esta página descreve cada um deles e onde obtê-los, para que você possa colar os detalhes corretos na sua dúvida de suporte logo de início. Para tudo o que você deve verificar antes de pedir suporte – requisitos mínimos, atualizações, verificações de conflitos, a lista de verificação de autoatendimento – consulte Antes de pedir suporte.

Copie o bloco de informações de depuração da verificação do sistema

Abra WPMLSuporteVerificação do sistema. A página mostra um bloco de Informações de depuração: versão do PHP, versão do WordPress, cada plugin do WPML e sua versão, ambiente do servidor, configuração de idiomas e valores de configuração que o WPML lê do wp-config.php. Clique em Copy system info to clipboard na parte superior do bloco e, em seguida, cole-o na sua dúvida de suporte.

Este bloco informa ao suporte qual versão de cada componente você está executando e como está a configuração atual do site. É a base antes de qualquer investigação mais profunda.

Copie a lista de plugins instalados

Role até a parte inferior de WPMLSuporte. A seção Plugins instalados lista todos os plugins do site, sua versão e se ele está ativo ou inativo. Clique em Copy list to clipboard e cole-a na sua dúvida de suporte.

Os conflitos de plugins são uma das causas mais comuns de sintomas no WPML. O suporte usa essa lista para identificar incompatibilidades conhecidas e fazer as perguntas de acompanhamento corretas.

Copie o log relevante

Para sintomas que envolvem serviços de tradução, o WPMLSuporteLog de comunicação captura o tráfego da API entre o seu site e o backend de tradução. Se as traduções estiverem falhando de uma maneira não óbvia, copiar as entradas recentes do log na dúvida de suporte fornece ao suporte a resposta exata do lado do servidor.

Para sintomas dentro do Editor de tradução avançado, os Logs de erro do Editor de tradução avançado capturam os erros do lado do servidor que o ATE encontrou.

Para sintomas com trabalhos de tradução (trabalhos que não iniciam, trabalhos que não são concluídos, trabalhos que desaparecem), os Logs de trabalhos do gerenciamento de tradução mostram o ciclo de vida de cada trabalho.

Consulte Logs para saber qual log usar em cada situação.

Compartilhe o acesso de diagnóstico ao vivo com o suporte (opcional)

A página WPMLSuporte tem uma caixa de seleção Share diagnostic information with WPML Support na parte superior. Marque-a para permitir que a equipe de suporte do WPML leia as informações de depuração do seu site diretamente. Nenhuma senha ou dado pessoal é compartilhado – apenas o bloco de informações de depuração.

Isso é mais rápido do que colar blocos em uma pergunta, porque o suporte pode ler novamente os dados atualizados à medida que a conversa avança. Você pode desativar isso a qualquer momento na mesma caixa de seleção.

Quando o suporte pede logs de depuração

Para problemas mais profundos (comportamento estranho do ATE, condições de corrida, falhas intermitentes), o suporte às vezes pede o log completo de depuração do WPML, que é mais detalhado do que o bloco de Informações de depuração.

Para ativar o log de depuração:

  1. Adicione define( 'WP_DEBUG', true ); e define( 'WP_DEBUG_LOG', true ); ao wp-config.php antes da linha “That’s all, stop editing!”. O WordPress começará a gravar erros e avisos do PHP em wp-content/debug.log.
  2. Reproduza o sintoma no site.
  3. Abra ou baixe o wp-content/debug.log e copie a seção relevante (filtre pelo carimbo de data/hora de quando o sintoma ocorreu).
  4. Cole na sua dúvida de suporte ou anexe como um arquivo.
  5. Desative o WP_DEBUG depois. Deixá-lo ativado em produção é um risco de segurança, porque os erros incluem informações de caminho.

Para ver o procedimento completo, incluindo a filtragem de entradas específicas do WPML, consulte a referência de depuração do WPML.

Quando o suporte pede uma cópia do site

Para problemas que o suporte não consegue reproduzir apenas com os logs, eles podem pedir uma cópia do site para investigar. A maneira padrão é usar uma ferramenta de backup ou de staging para empacotar todo o site e compartilhá-lo por meio do formulário de upload seguro do WPML (o suporte fornecerá o link quando pedir).

Ferramentas recomendadas para a etapa de empacotamento:

  • Duplicator. Empacota o banco de dados e os arquivos em um único arquivo compactado, além de um script de instalação.
  • All-in-One WP Migration. Empacotamento semelhante, formato ligeiramente diferente.
  • A ferramenta de staging/clonagem integrada do seu provedor de hospedagem (se ela produzir um arquivo portátil).

Antes de compartilhar a cópia:

  • Certifique-se de que você está compartilhando uma cópia do site, não o acesso ao próprio site ativo.
  • Remova os dados pessoais do banco de dados se o seu site tiver dados de clientes (o Duplicator e o AIOWP têm opções de exportação para isso).
  • Confirme que você tem um backup funcional da produção antes de fazer alterações com base no que o suporte encontrar na cópia.

O WPML lida com o caso de mudança de site entre servidores automaticamente; o caso de enviar uma cópia para o suporte é aquele em que você está empacotando o site para que alguém fora do seu ambiente de hospedagem o execute localmente.

Como encontrar as credenciais da sua conta do WPML

Se o suporte perguntar em qual conta do WPML este site está registrado e você não se lembrar:

  • A chave do site mascarada em WPMLActivate & Update identifica qual chave o site usa (por exemplo, ******abcd). Compare-a com os sites listados na sua conta do WPML.
  • Se você perdeu o acesso ao e-mail da conta, pesquise na sua caixa de entrada por mensagens de accounts@wpml.org. O e-mail original de criação da conta contém as credenciais.