Mais de 24 razões pelas quais o código não funciona e como corrigi-lo

Publicados: 2013-08-21

Eu sempre testo o código primeiro para ter certeza de que funciona, no entanto, há muitas razões pelas quais ele não funciona às vezes, tanto para mim quanto para outras pessoas que o usam, mesmo que não esteja quebrado.

Aqui está uma lista de alguns dos motivos pelos quais o código não funciona:

  1. Esqueceu-se de limpar o cache do navegador: você pode fazer alterações CSS e achar que elas não funcionam quando realmente funcionam porque o navegador está exibindo uma versão mais antiga de páginas que incluem o código mais antigo. Limpe o cache do seu navegador para ter certeza.
  2. Não limpou o cache do servidor: alguns provedores de hospedagem gerenciada usam cache do lado do servidor muito agressivo. Eu sei que o WPEngine significa que pode levar dias até que as alterações de CSS apareçam em seu site. Você pode fazer essas alterações que realmente funcionam, mas acha que não, porque você não pode ver as alterações no front-end. Limpe o cache do servidor e teste o código localmente usando o cache do lado do servidor ou um plug-in de cache.
  3. Código CSS colado no arquivo de funções: O código CSS não funciona corretamente no arquivo de funções que inclui uma tag PHP de abertura, o que significa que é lido por um processador PHP instalado no servidor.
  4. PHP colado na folha de estilo : O código PHP não funciona em um arquivo .css que é lido por um navegador e não por um processador PHP instalado no servidor.
  5. PHP ou CSS colado nos scripts de cabeçalho e rodapé: os temas que incluem uma caixa para scripts de cabeçalho e rodapé fazem isso para facilitar a adição de Javascript para rastreamento do Google Analytics e scripts de bate-papo ao vivo, não scripts PHP.
  6. Copiei de uma página da web e colei no editor de temas: Erro muito comum que pode fazer com que os apóstrofos girem, resultando na tela branca da morte que quebra seu site. Sempre copie o código bruto e cole-o no final do arquivo usando um editor de texto como o Notepad++.
  7. Não copiou todo o código: Copiar um bloco de código CSS que não inclui a classe ou perder um colchete fará com que o código não funcione. Então você pode pensar que o código não é geed quando o único problema é que você deixou um colchete ou ponto e vírgula para trás.
  8. Não colou todo o código : O mesmo que acima e acontece às vezes.
  9. Use os novos ganchos quando seu tema usa os antigos: Usar código que inclui ganchos de loop para sites que ainda executam a marcação XHTML antiga em novos sites não funciona. O código funcionará em sites mais antigos para que não seja quebrado, mas não funcionará em HTML 5 que habilita temas filhos.
  10. Usou os ganchos antigos quando seu tema usa os novos: O mesmo que acima
  11. Usando um navegador antigo que não suporta as classes no código: Alguns navegadores mais antigos não suportam certas classes CSS, o que significa que o código não fará o que foi escrito. Você pode instalar vários navegadores para testar o código ou usar ferramentas online gratuitas para compatibilidade entre navegadores.
  12. Usando a versão mais recente do navegador que ainda não suporta as classes no código: Alguns navegadores novos não suportam algumas classes CSS, o que significa que o código funcionará em navegadores mais antigos, mas você pode pensar que não porque está usando uma versão beta versão ou a versão mais recente que acabou de ser lançada.
  13. Copiou a tag PHP de abertura e colou em seu arquivo de funções: snippets PHP geralmente incluem uma tag PHP de abertura, mas isso não deve ser colado em um arquivo de funções que já inclui essa tag. Você receberá uma mensagem de erro e interromperá seu site se isso acontecer, o que é fácil de corrigir simplesmente removendo a tag. Esta é a razão pela qual é sempre uma prática recomendada usar um editor de texto para colar o código no arquivo real, em vez de usar o editor de texto do WordPress. Se você adicionar o código ao arquivo real, poderá reabri-lo facilmente e remover o problema rapidamente, o que não é o caso se estiver usando o editor de temas, pois você será bloqueado do site quando sofrer um erro de programação.
  14. Copiou e colou ambas as soluções em vez de escolher uma: Muitas postagens e fóruns incluem vários trechos de código que resolvem os mesmos problemas. Se você colar 2 snippets de código que fazem a mesma coisa, isso pode quebrar seu site, então você pode pensar que o código está quebrado, o que não é o caso. Use apenas um trecho de cada vez.
  15. Código de funções copiado em um arquivo de modelo: Às vezes você encontrará código PHP que foi escrito para ser usado em um arquivo de modelo em vez de um arquivo de funções de temas filhos. O código do modelo nem sempre funciona em um arquivo de funções, pois geralmente está envolvido em tags de abertura e fechamento do PHP. As funções personalizadas geralmente não significam que geralmente não funcionarão em um arquivo de placa, dependendo do tema. Apenas certifique-se de saber exatamente em qual arquivo colar o código, caso contrário, você pode receber um erro pensando que o código não funciona quando funciona.
  16. Você tem um plugin instalado que sobrepõe o código: Alguns plugins sobrepõem o código PHP, o que significa que o código com filtros e ganchos pode não funcionar. Um exemplo disso é o plugin Genesis Simple Edits. Se você tiver este plugin instalado, que permite personalizar as informações do post e o meta do post, adicionar código PHP para fazer a mesma coisa que inclui um filtro do post meta ou do post info não funcionará. Você pode pensar que o código não funciona quando na verdade funciona e tudo o que você precisa fazer para resolver o problema e fazer o código funcionar é desativar o plugin.
  17. Usando código PHP para alterar o layout condicionalmente Este código não funcionará em alguns temas usando o bbPress que também usa o plug-in Genesis bbPress connect. Este plugin se conecta aos filtros do Genesis, que é a mesma coisa que o código PHP faz para alterar os layouts condicionalmente para que não funcione, pois sobrepõe o código.
  18. Usando classes CSS XHTML em tema filho HTML 5 – Exemplo: #content não funcionará em um tema filho HTML 5 que usa .entry-content.
  19. Usando marcação HTML em um tema XHTML – .site-header não funcionará em um site executando marcação XHTML, então você precisa usar #header.
  20. Código do modelo de primeira página – Qualquer código em seu modelo de primeira página só funciona quando você usa as configurações de leitura padrão. Se você alterar essas configurações e selecionar uma página estática como sua primeira página, o código em seu modelo de primeira página não funcionará.
  21. Adicionado CSS após consultas de mídia – É melhor adicionar CSS personalizado antes de suas consultas de mídia, caso contrário, pode não funcionar.
  22. Adicionado CSS para modificar a classe já estilizada – Você adicionou CSS no final da sua folha de estilo para alterar o estilo de um elemento existente que já está estilizado por padrão. Um exemplo disso é quando você modifica uma área de widget para usar o widget de postagens em destaque do Genesis quando está estilizado por padrão para usar o widget de página em destaque. Seu CSS pode ser diferente, mas você está usando uma classe diferente. O que você precisa fazer é modificar o CSS padrão para que ele estilize mais o widget de página em destaque e estilize apenas o widget de postagem em destaque.
  23. Código de modelo de página inicial – Qualquer código em seu arquivo de modelo home.php funcionará apenas na página inicial quando você usar as configurações de leitura padrão. Se você usar uma página estática como sua página inicial, o código só funcionará em sua página de postagens (como uma página de blog) se você não tiver selecionado o modelo de página de blog no menu suspenso. (Aplica-se apenas a temas que incluem um modelo de página de blog).
  24. CSS modificado incorretamente faz outra quebra de CSS – Um membro instalou algum código para criar um layout personalizado, mas não funcionou porque o CSS para modificar a largura do conteúdo não funcionou. Eles descobriram que outro CSS que eles adicionaram anteriormente usando !important impediu que o novo CSS funcionasse.

O código acima NÃO funcionará se você também tiver o plug-in Genesis Simple Edits ativado, pois ele substitui o filtro de informações do post.

Isso é tudo em que posso pensar no momento, mas tenho certeza de que há muitas outras razões pelas quais o código não funciona (mas realmente funciona) que poderia ser adicionado a esta lista.

Postagens relacionadas

  • 5 pontos importantes a serem considerados antes de republicar o código