Como adicionar código personalizado com segurança a sites WordPress

Os usuários geralmente procuram maneiras de ajustar seus sites, plugins e temas ou adicionar algumas modificações a uma funcionalidade existente. Na maioria desses casos, você pode fazer isso adicionando código personalizado ao seu site WordPress.

Não há nada de errado em adicionar código personalizado ao seu site. No entanto, há algumas coisas que você precisa observar ao fazer essas alterações no seu site WordPress.

Este artigo destaca o que procurar e as melhores práticas para adicionar código personalizado ao seu site WordPress.

O que procurar antes de adicionar trechos de código personalizados no WordPress

A maneira mais fácil de adicionar trechos de código que os autores sugerem em seus tutoriais é adicionar o trecho de código ao arquivo functions.php do tema. No entanto, há uma série de restrições e desvantagens quando você adiciona trechos de código ao arquivo functions.php do tema.

Cada vez que você atualizar seu tema, os trechos de código personalizados adicionados ao seu arquivo functions.php serão substituídos, a menos que você atualize manualmente o tema ou copie manualmente os trechos de código de um arquivo functions.php para o outro. Tendo em mente que a maioria dos desenvolvedores lança atualizações com bastante frequência, especialmente ao usar temas premium, adicionar trechos de código ao arquivo functions.php do tema torna-se muito difícil de manter.

Além disso, se você quiser alterar o tema, também precisará migrar o código, o que definitivamente não é bom para o longo prazo.

Outra desvantagem é que os arquivos do tema são executados em todas as páginas e ao adicionar os trechos de código ao arquivo functions.php do tema, os riscos de quebrar todo o seu site são muito maiores.

Vamos conferir as melhores práticas sobre como adicionar trechos de código personalizados ao seu site WordPress, para que você não precise se preocupar novamente em perder algum trecho de código, esquecer de migrá-lo ou quebrar uma funcionalidade ao atualizar seu tema.

Adicionando trechos de código personalizados a sites WordPress

O código personalizado pode ser adicionado usando um dos seguintes métodos:

• Usando um plug-in (consulte nossa introdução aos plug-ins do WordPress para saber mais sobre o que são os plug-ins do WordPress)
• Criando um plug-in personalizado
• Criando um tema filho

Agora, vamos discutir cada um dos métodos em detalhes.

1. Usando o plug-in de trechos de código

Os trechos de código ¹ plugin é uma ótima maneira de adicionar código personalizado ao site WordPress e, se você não é fã de escrever algum código, essa maneira é mais fácil do que criar seu próprio plugin.

Depois de instalar o plugin, uma nova seção Snippets é adicionada ao seu menu WordPress, que permite adicionar novos snippets. Cada snippet terá espaço para o código e uma descrição para informações adicionais sobre o que o código faz.

Dica: se você estiver usando um snippet de código útil de um site, adicione o URL na descrição para lembrar de onde veio o código.

Assim como os plugins, você pode ativar e desativar seus trechos de código personalizados, bem como exportá-los para arquivos PHP. Em alguns casos, os snippets personalizados causam conflitos com outros plugins ou temas, portanto, desativar todo o código personalizado é útil para problemas de segmentação.

2. Criando seu próprio plugin específico do site

Criar seu próprio plug-in específico de site personalizado é a melhor maneira de adicionar código personalizado aos sites do WordPress, porque você tem controle total do código.

O que é um plugin WordPress específico para um site?

Um plug-in WordPress específico do site é usado para adicionar código de personalização a um site que não depende do tema. Isso significa que não importa qual tema você use, ou se você alternar entre temas, o código personalizado do seu plug-in sempre será executado, desde que o plug-in esteja ativado.

Por que é melhor criar um plugin WordPress específico para o site?

Se você adicionar o código personalizado ao arquivo de funções do seu tema, ele desaparecerá se você atualizar ou alternar seu tema.

Um plugin WordPress específico do site permite que você adicione facilmente trechos de código personalizados ao seu site WordPress e garanta que eles sejam independentes do tema. É um plugin WordPress autônomo, o que significa que não depende do seu tema, o que significa que você pode atualizar ou alternar livremente seu tema sem perder o código personalizado.

Você não precisa ser um guru do PHP para criar um plugin WordPress específico para o site. Basta seguir os passos fáceis abaixo.

1. Crie o diretório de plug-ins

Primeiro, você precisará criar um diretório para o plugin e nomeá-lo. Pode ser qualquer nome, como o site do site. O diretório do plugin deve ser criado no diretório /wp-content/plugins/ do seu site. Para este exemplo, estamos chamando o plugin wpwhitesecurity-shortcodes . Nota: sempre use traços e não espaços em nomes de diretórios.

2. Crie o arquivo de plug-in

Em seguida, você precisará de um arquivo principal para o seu plugin. Embora não haja regras sobre qual deve ser o nome do arquivo, a prática recomendada é que o nome do arquivo seja o mesmo que o nome do plug-in. Então, em nosso exemplo, o nome do arquivo do plugin é wpwhitesecurity-shortcodes.php .

Este arquivo deve incluir pelo menos um título e uma descrição.

Crie este arquivo usando um editor de texto, como NotePad ++ ou TextEdit. Não use o Microsoft Word ou editores semelhantes, pois ele adiciona dados de formatação ao texto e pode atrapalhar seu arquivo. Todos os editores listados acima são gratuitos.

Aqui está tudo o que você precisa adicionar ao arquivo:

<?php
/*
* Plugin Name: WP White Security Shortcodes
* Plugin URL: https://www.wpwhitesecurity.com
* Description: Site-specific plugin for custom code snippets in wpwhitesecurity.com
*/

Isso é tudo. Agora é hora de adicionar o código personalizado.

3. Adicione os snippets de código personalizados

Agora você pode copiar e colar os trechos de código de tutoriais etc. neste arquivo. Se você criou o arquivo de plug-in offline, compacte a pasta do plug-in como um arquivo .zip e faça o upload para seu site a partir do painel do WordPress.

A partir de agora você não precisa se preocupar em perder algum trecho de código, esquecer de migrá-lo ou quebrar alguma funcionalidade ao atualizar seu tema ou seu WordPress. Da próxima vez que você encontrar um trecho de código do WordPress e quiser adicioná-lo ao seu site, adicione-o ao arquivo de plug-in específico do site.

4. Adicione um arquivo index.php (opcional)

Este é um passo opcional. Para evitar a listagem de diretórios, você deve adicionar um arquivo de índice no diretório do plugin. Tudo que você precisa fazer é:

Crie um arquivo chamado index.php
Adicione o seguinte conteúdo a ele:

<?php
/**
* Nothing to see here.

3. Use o tema filho functions.php

Anteriormente, dissemos para não usar o arquivo functions.php do seu tema. No entanto, esta é uma boa alternativa para certas alterações, por exemplo, para alterações específicas do tema. Dessa forma, o código personalizado específico do tema está disponível quando seu tema estiver disponível, pois não será mais necessário.

No entanto, as alterações de tema devem sempre ser adicionadas ao tema filho, e não ao pai, por isso é seguro para atualização.

Se você adicionar código ao seu functions.php , sempre procure por tags PHP de fechamento. É assim que eles se parecem: ?> . Se o seu arquivo de tema terminar em um desses, você deve colocar o código personalizado acima disso.

Conclusão

Como acabamos de ver, existem algumas maneiras diferentes de adicionar código personalizado ao seu site WordPress, mas nem todas são boas a longo prazo. No entanto, alguns deles são melhores do que outros em coisas específicas. Por exemplo, para alterações específicas do tema (aparência e comportamento do site), adicione código personalizado ao arquivo functions.php . Para quaisquer outras alterações, idealmente, você deve criar seu plug-in personalizado específico do site

Apenas certifique-se de adicionar código personalizado ao WordPress de forma segura e que facilite a depuração se algo der errado.
Esperamos que este artigo tenha ajudado você a aprender como adicionar facilmente trechos de código personalizados em seus sites WordPress.