Não tem certeza do que é o arquivo functions.php do WordPress ou do que pode ser feito com ele?

Em poucas palavras, o arquivo functions.php do WordPress lhe dá uma maneira de adicionar snippets de código ao seu site. Você pode usar esses snippets de várias maneiras úteis, então entender como o arquivo functions.php funciona pode ajudá-lo a construir um site WordPress melhor.

Em nosso guia completo sobre o arquivo functions.php do WordPress, você aprenderá tudo o que precisa saber sobre este arquivo.

Assim que você souber tudo sobre o arquivo functions.php, também vamos compartilhar 17 snippets de código úteis para ajudar você a começar a personalizar seu site.

O que o arquivo functions.php do WordPress faz?

O arquivo functions.php do WordPress é um arquivo do tema que você pode usar para adicionar snippets de códigos personalizados ao seu site. Você pode usar estes snippets de código para modificar como diferentes áreas do seu site funcionam ou adicionar novo conteúdo/código ao seu site.

Apesar de estar incluído no seu tema, o arquivo functions.php do WordPress não se limita a fazer personalizações apenas no seu tema.

Você pode fazer ajustes em qualquer parte do seu site, assim como funcionam os plugins.

Aqui estão alguns tipos comuns de ajustes que você pode fazer usando o arquivo functions.php do WordPress:

  • Alterar o comportamento principal do WordPress, como quantos artigos mostrar na página de resultados de pesquisa ou qual conteúdo incluir no feed RSS do seu site.
  • Criar seus próprios códigos de acesso personalizados.
  • Adicionar novo conteúdo ou scripts ao seu site, como injetar um script do seu serviço de chat em tempo real em determinadas páginas ou editar o rodapé do seu site.

Como o arquivo functions.php permite que você adicione snippets de código PHP personalizados ao seu site ao invés de HTML estático, o céu é o limite quando se trata dos tipos de modificações que você pode fazer.

Onde está localizado o arquivo functions.php do WordPress?

O arquivo functions.php do WordPress está localizado na pasta do seu tema ativo, junto com outros arquivos de temas. Para encontrar o arquivo, você pode se conectar ao seu servidor usando FTP ou uma ferramenta de gerenciamento de arquivos e navegar até …/wp-content/themes/[nome-do-tema-ativo]/functions.php

Por exemplo, se você estiver usando o popular tema OceanWP, o arquivo functions.php estaria localizado em …/wp-content/themes/oceanwp/functions.php

Como trabalhar com segurança com o arquivo functions.php

Como trabalhar com o arquivo functions.php do WordPress envolve adicionar código ao seu site, é importante seguir algumas práticas recomendadas antes de começar a fazer edições.

Mesmo algo tão simples como uma vírgula ou apóstrofe em falta pode acionar erros em seu site, como a Tela Branca da Morte do WordPress.

Nas versões recentes do WordPress, a plataforma se tornou mais eficiente ao lidar com esses erros de maneira mais elegante, como mostrando a mensagem “Houve um erro crítico em seu site” ou verificando erros de PHP antes de salvar as alterações.

Mas ainda assim – para evitar que qualquer problema aconteça, sempre recomendamos seguir estas melhores práticas.

Teste seu código functions.php em um site de teste

Antes de adicionar qualquer snippet de código functions.php ao seu site WordPress de produção, recomendamos sempre testá-los em uma versão de teste do seu site primeiro. Isso permite que você verifique se há erros potenciais e verifique se o snippet de código está funcionando como pretendido.

Se você hospedar com Kinsta, Kinsta oferece uma ferramenta de teste fácil com 1 clique em todos os planos, que é um dos benefícios de usar a hospedagem gerenciada de WordPress.

Se você está hospedando em outro lugar, você pode conferir nosso guia sobre como configurar um site de teste de WordPress.

Faça o backup do seu site antes de fazer alterações no functions.php

Além de testar em um site de teste, você também deve fazer backup do seu site antes de adicionar o snippet de código no arquivo functions.php do seu site de produção.

Esta é uma boa prática a ser seguida ao editar qualquer arquivo WordPress.

Se algo der errado com o snippet de código, você pode restaurar para este ponto de backup para fazer seu site funcionar novamente.

Se você hospedar com Kinsta, Kinsta automaticamente faz backup do seu site todos os dias e você também pode criar um backup manualmente a qualquer momento. Se você hospedar em outro lugar, você pode ler nosso guia sobre como fazer o backup de um site WordPress.

Use sempre um child theme se você estiver editando o arquivo functions.php

Como o arquivo functions.php do WordPress está localizado no código do seu tema WordPress, seu tema irá substituir o arquivo functions.php quando você atualizar seu tema.

Para evitar que as alterações que você fez no arquivo functions.php do seu tema sejam substituídas, você deve sempre usar um Child theme de WordPress e adicionar seus snippets de código ao arquivo functions.php no Child theme.

Ao usar um child theme, você ainda consegue atualizar o tema principal quando necessário, mas todas às suas personalizações no functions.php nunca serão sobrescritas.

Para saber mais, confira nosso guia completo sobre como criar um child theme WordPress.

2 alternativas de arquivo functions.php que podem ser melhores

Enquanto o arquivo functions.php do WordPress oferece uma maneira fácil de adicionar snippets de código ao seu site, existem algumas alternativas functions.php que oferecem uma solução melhor na maioria das situações:

  1. Usando um plugin de gerenciador de código
  2. Armazenamento de snippets de código em um plugin personalizado

Estas alternativas podem ter algumas vantagens sobre o uso do arquivo functions.php:

  • Não estão vinculados ao seu tema – isso significa que se você mudar de tema, suas personalizações de functions.php ainda estarão lá.
  • Melhor organização – estas alternativas facilitam organizar seus snippets de código, o que pode ser útil se você planeja adicionar um monte de snippets de código ao seu site.
  • Mais controle – no caso de um plugin de gerenciador de código, você obtém opções úteis como habilitar/desabilitar um snippet usando um botão de alternância, executando apenas snippets no frontend ou backend, e muito mais.

Use um plugin gerenciador de código

Um plugin gerenciador de código é um plugin que lhe dá uma interface amigável para adicionar e editar snippets de código que de outra forma entrariam no arquivo functions.php.

Uma das opções mais populares é o plugin gratuito Code Snippets, mas você pode encontrar outros plugins que oferecem funcionalidade similar.

Com o Code Snippets, você pode adicionar seus snippets de código functions.php do painel do WordPress, completos com opções para..

  • Adicione um título e uma descrição.
  • Organize seus snippets usando tags.
  • Somente execute o snippet em uma determinada parte do seu site.
Adicionando um snippet de código no plugin Code Snippets.
Adicionando um snippet de código no plugin Code Snippets.

Você pode então ver todos os seus snippets em uma lista e facilmente habilitá-los/desabilitá-los conforme necessário.

Como gerenciar snippets de código no Code Snippets.
Como gerenciar snippets de código no Code Snippets.

Como o Code Snippets é um plugin, todos os seus snippets de código ainda estarão lá, mesmo se você mudar os temas.

Crie um plugin de recurso personalizado

Outra alternativa para o arquivo functions.php do WordPress é apenas criar seu próprio plugin personalizado para abrigar os snippets de código.

Embora Isso possa parecer complicado, na verdade, é muito mais simples do que pode parecer.

Aqui está como funciona:

  1. Crie uma pasta em seu computador local para seu plugin.
  2. Crie um único arquivo .php dentro dessa pasta e edite com seu editor de texto favorito.
  3. Adicione o modelo de código abaixo ao arquivo.
  4. Adicione seus snippets de código ao arquivo functions.php
<?php

/**
* Plugin Name: My Custom Code Snippets
* Description: This is a custom plugin to house code snippets.
* Author: Kinsta
* Version: 1.0
*/

/* Add the first code snippet below this comment - use the comment to explain what it does. */
[CODE]

/* Add the second code snippet below this comment. */
[CODE]

/* Continue as needed. */
[CODE]

?>

Então, você só precisa instalar e ativar o plugin no WordPress. Aqui estão duas maneiras de fazer isso:

  1. Conecte-se ao seu servidor via FTP/SFTP e faça o upload da pasta plugin personalizada para a pasta wp-content/plugins. Então, vá para a lista de Plugins e ative o plugin.
  2. Use seu computador para criar um arquivo .zip da pasta. Depois, vá para Plugins → Add New e faça o upload do arquivo .zip para instalá-lo como qualquer outro plugin.

Como acessar o arquivo functions.php do WordPress: 2 opções

Existem diferentes maneiras de acessar e editar o arquivo functions.php do WordPress. Aqui estão 2 dos métodos mais versáteis que irão funcionar em qualquer provedor de hospedagem WordPress:

  1. Editor de código do tema no painel do WordPress.
  2. SFTP e seu próprio editor de código.

1. Use o editor de código do tema no painel de controle WordPress

Por padrão, o WordPress permite que você edite todo o código do seu tema a partir do seu painel de controle do WordPress, incluindo o arquivo functions.php:

  1. Abra seu painel de controle do WordPress.
  2. Vá para Appearance → Theme File Editor.
  3. Selecione o arquivo Theme Functions (functions.php) na lista Theme Files no lado direito.
  4. Adicione suas edições no editor de código.
  5. Clique no botão Update File para salvar suas alterações.
Como editar o arquivo functions.php a partir do seu painel de controle do WordPress.
Como editar o arquivo functions.php a partir do seu painel de controle do WordPress.

Dito isto, muitas pessoas gostam de desativar a edição de arquivos do WordPress no painel de controle para melhorar a segurança. Nesse caso, você pode usar o próximo método.

2. Use SFTP + Seu próprio editor de código

Para outra maneira de editar o arquivo functions.php do WordPress, você pode se conectar ao seu servidor via FTP/SFTP e editar o arquivo dessa maneira.

Veja como:

  1. Baixe um cliente FTP se você ainda não o fez – nós usaremos o cliente gratuito FileZilla para as capturas de tela.
  2. Conecte-se ao seu servidor usando suas credenciais FTP – aqui está como usar o SFTP para se conectar.
  3. Use a estrutura de pastas para navegar até …/wp-content/themes/[seu-child-theme-ativo]
  4. Clique com o botão direito do mouse no arquivo functions.php e selecione Edit.
Como editar o arquivo functions.php com FileZilla.
Como editar o arquivo functions.php com FileZilla.

Isso deve baixar o arquivo para seu computador local e abri-lo automaticamente em um editor de texto. Agora você pode adicionar seus snippets de código ao arquivo.

FileZilla abrirá o arquivo em um editor de texto local -- por exemplo, Texto Sublime.
FileZilla abrirá o arquivo em um editor de texto local — por exemplo, Texto Sublime.

Quando você terminar, salve suas alterações e feche o arquivo.

FileZilla deve então mostrar um prompt para re-enviar a versão editada para o seu servidor.

Certifique-se de carregar novamente o arquivo functions.php uma vez que você tenha feito suas alterações.
Certifique-se de carregar novamente o arquivo functions.php uma vez que você tenha feito suas alterações.

Principais funções úteis para adicionar ao seu arquivo functions.php do WordPress

Agora que você já sabe como editar o arquivo functions.php do WordPress, vamos rever alguns dos snippets de código functions.php mais úteis que você pode adicionar ao seu site.

Mostrar última data modificada nos artigos do blog

Por padrão, a maioria dos temas mostra a data em que você publicou um artigo no blog. No entanto, se você estiver atualizando regularmente o conteúdo antigo, pode querer mostrar também a data da última modificação (ou substituir a data de publicação pela data da última modificação).

Isso não só permite que seus visitantes humanos saibam que você ainda está atualizando o conteúdo, mas também mostra ao Google que o seu conteúdo está atualizado.

function show_last_updated( $content ) {
$u_time = get_the_time('U');
$u_modified_time = get_the_modified_time('U');
if ($u_modified_time >= $u_time + 86400) {
$updated_date = get_the_modified_time('F jS, Y');
$updated_time = get_the_modified_time('h:i a');
$custom_content .= '<p class="last-updated-date">Recently updated on '. $updated_date . ' at '. $updated_time .'</p>';
}
$custom_content .= $content;
return $custom_content;
}
add_filter( 'the_content', 'show_last_updated' );

Para mais detalhes, confira nosso artigo completo mostrando a data da última modificação no WordPress.

Desabilite a barra de ferramentas do WordPress para certos usuários

Por padrão, o WordPress mostra a barra de ferramentas do WordPress para todos os usuários logados usando as funções de usuário padrão do WordPress. Isso não é necessariamente o caso para funções personalizadas, como a função de usuário de Cliente para Lojas WooCommerce.

Se você quiser mudar isso, você pode usar um snippet de código functions.php para ocultar a barra de ferramentas do WordPress para certas funções do usuário.

Este exemplo ocultaria a barra de ferramentas do administrador para usuários com a função de usuário de autor.

add_filter( 'show_admin_bar', function( $show ) {
if ( current_user_can( 'author' ) ) {
return false;
}
return $show;
} );

Atrase o envio de RSS

Por padrão, o conteúdo aparece no seu feed RSS assim que você o publica. Isso pode dar aos raspadores de conteúdo uma chance de copiar o seu conteúdo e indexá-lo no Google antes mesmo de o Google indexar o seu artigo original.

Para evitar que outra pessoa receba o crédito pelo seu conteúdo, você pode atrasar a publicação de artigos no seu RSS feed.

Embora isso não pare completamente a raspagem de conteúdo, significa que você pode dar tempo ao Google para indexar seu conteúdo primeiro.

Aqui está o snippet de código – você pode mudar o número – “30” neste exemplo – para o número de minutos que você quer que o atraso seja:

function kinsta_delay_feed_content($where) {

global $wpdb;

if ( is_feed() ) {
// timestamp in WP-format
$now = gmdate('Y-m-d H:i:s');

// value for wait; + device
$wait = '30'; // integer

// http://dev.mysql.com/doc/refman/5.0/en/date-and-time-functions.html#function_timestampdiff
$device = 'MINUTE'; //MINUTE, HOUR, DAY, WEEK, MONTH, YEAR

// add SQL-sytax to default $where
$where .= " AND TIMESTAMPDIFF($device, $wpdb->posts.post_date_gmt, '$now') > $wait ";
}
return $where;
}

add_filter('posts_where', 'kinsta_delay_feed_content');

Exclua determinadas categorias do Feed RSS

Além de atrasar o conteúdo de aparecer no feed RSS, você também pode ter situações em que você queira excluir categorias inteiras de artigos de blogs de aparecer no feed RSS do seu site.

Para isso, você pode usar o seguinte snippet de código functions.php:

function kinsta_exclude_category_rss($query) {
if ($query->is_feed) {
$query->set('cat','-38');
}
return $query;
}
add_filter('pre_get_posts','kinsta_exclude_category_rss');

Certifique-se de substituir o ID de categoria de exemplo – “38” – pelos IDs de categoria reais que você deseja excluir (e não remova o sinal de menos)

Veja aqui como encontrar o número de identificação:

  1. Vá para Posts → Categories para ver uma lista de todas as categorias em seu site.
  2. Clique em Edit sob a categoria que você deseja excluir.
  3. Veja a URL da página de edição na barra de endereços do seu navegador. O ID da categoria é o número que vem depois de ?taxonomy=category&tag_ID=X.

Por exemplo, se a URL é https://yoursite.com/wp-admin/term.php?taxonomy=category&tag_ID=38&post_type=post, então a ID da categoria é 38.

Limite as revisões do WordPress por tipo de artigos

Para evitar o aumento excessivo do banco de dados do seu site, você pode querer limitar quantas revisões de artigos são salvas.

Enquanto uma maneira de limitar as revisões de artigos do WordPress em todo o site é editar o arquivo wp-config.php do seu site, você pode querer armazenar diferentes números de revisões para diferentes tipos de artigos – por exemplo, artigos de blogs vs produtos do WooCommerce.

Este snippet de código do functions.php permite que você faça exatamente isso. Para torná-lo seu, mude o tipo de artigo – “post” neste exemplo – para o tipo de artigo real que você quer controlar e o número – “5” neste exemplo – para o número de revisões que você quer armazenar.

function kinsta_post_revisions_by_type( $revisions, $post ) {

if( 'post' == $post->post_type ) {
$revisions = 5;
}

return $revisions;

}

add_filter( 'wp_revisions_to_keep', 'kinsta_post_revisions_by_type', 10, 2 );

* Nota – você está editando o “post” que vem imediatamente após a declaração “if”. Por exemplo, para produtos-alvo, essa linha seria parecida com esta:

if( 'product' == $post->post_type ) {

Desativar a função de pesquisa do WordPress

Se o seu site não precisa da funcionalidade de pesquisa, você pode querer desativar a função de busca do WordPress para prevenir possíveis abusos.

Por exemplo, mesmo que você não mostre uma caixa de pesquisa em seu site, os bots ainda podem usar a função de pesquisa adicionando ?s=[termo de busca] à sua URL.

Para fazer isso, você pode adicionar o seguinte snippet de código:

function kinsta_disable_wp_search( $query, $error = true ) {

if ( is_search() ) {
$query->is_search = false;
$query->query_vars[s] = false;
$query->query[s] = false;

// to error
if ( $error == true )
$query->is_404 = true;
}
}

add_action( 'parse_query', 'kinsta_disable_wp_search' );
add_filter( 'get_search_form', create_function( '$a', "return null;" ) );

Se alguém tentar usar a função de pesquisa diretamente, seu site retornará uma página 404.

Crie seus próprios shortcodes de acesso personalizado (por exemplo, ano atual)

Os shortcodes do WordPress são atalhos realmente úteis que permitem que você incorpore conteúdo dinâmico em seu site.

Enquanto muitos plugins WordPress dependem de shortcodes para potencializar suas funcionalidades, você também pode criar seus próprios shortcodes personalizados usando o arquivo functions.php do WordPress e a função add_shortcode().

Por exemplo, um caso de uso comum é a criação de um shortcode que exibe o ano atual. Isso permite que você mostre automaticamente o ano atual em todo o seu conteúdo sem a necessidade de atualizar tudo manualmente a cada 1º de janeiro.

Para criar um shortcode, você pode usar o seguinte código:

function year_shortcode() {
$year = date('Y');
return $year;
}
add_shortcode('currentyear', 'year_shortcode');

Então, quando você adicionar o shortcode [currentyear] ao seu conteúdo, ele será automaticamente substituído pelo ano atual – por exemplo, 2023.

Permitir shortcodes nos títulos dos artigos

Por padrão, o WordPress não executará nenhum shortcode que você colocar no campo de título do seu artigo. Se você quiser usar os shortcodes nos títulos dos artigos do WordPress, você pode habilitar esta funcionalidade adicionando um simples snippet de código ao arquivo functions.php do WordPress.

Por exemplo, quando combinado com o snippet de código anterior, isso permitiria que você incluísse automaticamente o ano atual no título do artigo, adicionando o shortcode [currentyear].

add_filter( 'the_title', 'do_shortcode' );

Ocultar erros de login para melhorar a segurança

Por padrão, o WordPress mostrará uma mensagem explicativa nas tentativas de login falhadas. Esta mensagem pode dar algumas informações, como se um determinado endereço de e-mail está ou não registrado no seu site (mesmo se a senha estiver incorreta).

Para evitar vazamento de informações potencialmente sensíveis, você pode ocultar estes erros de login adicionando o seguinte snippet de código ao seu arquivo functions.php.

function kinsta_hide_login_errors(){
return 'These are not valid credentials';
}
add_filter( 'login_errors', 'kinsta_hide_login_errors' );

Este snippet substitui o texto de erro de login padrão pela seguinte mensagem – These are not valid credentials.

Você pode personalizar o texto de acordo com suas preferências – mas tente evitar o uso de traços, barras ou outros caracteres, pois isso pode causar um erro.

Alterar o comprimento do resumo

Por padrão, o resumo do WordPress mostra as primeiras 55 palavras de um artigo.

Se você quiser ajustar isso, você pode adicionar o seguinte snippet de código ao arquivo functions.php.

function kinsta_change_excerpt_length($length) {
return 90;
}
add_filter('excerpt_length', 'kinsta_change_excerpt_length');

O snippet de código acima mudará o comprimento do resumo para 90 palavras. Se você preferir um número diferente, você pode mudar “90” para o número exato de palavras que você quer usar.

Remova o número da versão do WordPress

Para tornar mais difícil para os agentes mal-intencionados detectar qual versão do WordPress você está usando, alguns usuários gostam de remover o número da versão do WordPress de aparecer em qualquer lugar no código do frontend do seu site.

Para fazer isso, você pode adicionar os seguintes snippets de código ao seu arquivo functions.php.

function kinsta_hide_version() {
return '';
}
add_filter('the_generator', 'kinsta_hide_version');

Configure a paginação do WordPress

Se você não está satisfeito com o funcionamento da paginação em seu tema, você pode usar um snippet de código functions.php para ajustar o comportamento de paginação ou mesmo criar seu próprio sistema de paginação.

Se você estiver interessado neste tipo de modificação, temos um guia completo de paginação WordPress que inclui alguns exemplos de snippets de código functions.php para você.

Altere quantos resultados incluir na página de listagem de pesquisa

O WordPress lhe dá uma opção no painel para controlar quantos artigos serão listados nas páginas de arquivo (Settings → Reading).

No entanto, isso altera o número de todas as páginas do arquivo. E se você quiser apenas usar um número diferente para a página de resultados de pesquisa?

Para isso, você pode adicionar este snippet ao seu arquivo functions.php – certifique-se de alterar o número (“12” neste exemplo) para o número real de resultados que você deseja exibir antes de paginar resultados adicionais.

function kinsta_search_results_list() {
if ( is_search() )
set_query_var('posts_per_archive_page', 12);
}

add_filter('pre_get_posts', 'kinsta_search_results_list');

Inclua imagens em destaque no Feed RSS do WordPress

Se você quiser incluir as imagens de seus artigos no conteúdo do seu feed RSS, você pode adicionar o seguinte snippet ao seu arquivo functions.php

function kinsta_featured_image_rss($content) {
global $post;
if ( has_post_thumbnail( $post->ID ) ){
$content = '<div>' . get_the_post_thumbnail( $post->ID, 'full', array( 'style' => 'margin-bottom: 15px;' ) ) . '</div>' . $content;
}
return $content;
}

add_filter('the_excerpt_rss', 'kinsta_featured_image_rss');
add_filter('the_content_feed', 'kinsta_featured_image_rss');

Como escrito, o snippet de código acima irá inserir a imagem em tamanho real. Para usar um tamanho de miniatura diferente, você pode mudar “full” para um tamanho de miniatura diferente – por exemplo, “large” ou “medium”.

Adicione suporte para upload de tipos de arquivo (por exemplo, SVG)

Por padrão, o WordPress bloqueia o upload de certos tipos de arquivos, tais como arquivos SVG.

Para ativar o suporte a estes tipos de arquivo bloqueados, você pode adicionar o seguinte snippet de código ao arquivo functions.php do WordPress:

function kinsta_myme_types($mime_types){
$mime_types['svg'] = 'image/svg+xml';
return $mime_types;
}
add_filter('upload_mimes', 'kinsta_myme_types', 1, 1);

Este snippet de código só permite o upload de SVG, mas você pode modificá-lo para adicionar suporte a outros tipos de arquivo, se necessário.

Oculte notificações de atualização do WordPress para não administradores

Por padrão, o WordPress mostrará mensagens no painel de controle para todos os usuários com acesso ao painel quando houver uma nova atualização disponível.

Mesmo que a função do usuário não permita que ele aplique a atualização, a mensagem do painel de controle dirá a esse usuário para entrar em contato com o administrador.

Para ajustar isso, você pode usar este snippet de código para esconder notificações de atualização para todos os usuários não administradores:

function kinsta_hide_update_nag() {
if ( ! current_user_can( 'update_core' ) ) {
remove_action( 'admin_notices', 'update_nag', 3 );
}
}

add_action('admin_menu','kinsta_hide_update_nag');

Para algumas outras variações, confira nosso guia sobre como desativar as notificações de atualização do WordPress.

Alterar a qualidade de otimização automática do JPEG

Embora nem todos saibam sobre este recurso, o WordPress comprime automaticamente imagens JPEG ao criar miniaturas para o seu site depois que você carrega as imagens.

Desde o WordPress 4.5, o WordPress definiu o nível de qualidade padrão para 82 (com 100 sendo compressão zero).

Se você quiser fazer este nível de qualidade maior ou menor, você pode adicionar o seguinte snippet de código ao seu arquivo functions.php – certifique-se de alterar o número (“90” neste exemplo) para o nível de qualidade real que você quer usar:

add_filter( 'jpeg_quality', create_function( '', 'return 90;' ) );

Melhores práticas para organizar seu arquivo functions.php do WordPress

Se você está apenas usando o arquivo functions.php do WordPress para adicionar alguns snippets de código, você provavelmente não precisa se preocupar com a organização.

Mas se você estiver adicionando muitos snippets de código ao seu site, ele pode ficar rapidamente pesado e complexo se você não estiver seguindo algumas das melhores práticas de organização de arquivos do functions.php.

Aqui estão algumas das melhores práticas para manter seus snippets de código organizados..

Adicione comentários de código para explicar tudo

Quando você adiciona um snippet de código ao seu arquivo functions.php, você sabe exatamente o que o snippet faz e porque você o adicionou. Mas quando você olha para o arquivo functions.php um ano depois, as coisas podem não estar tão claras.

Para evitar isso, é importante adicionar comentários de código a cada snippet que explique o que ele faz e por que foi adicionado.

Comentários de código são textos que não são executados pelo WordPress, mas que os usuários humanos podem ler para entender o que o snippet de código está fazendo.

Para adicionar um comentário de código em uma única linha, você pode usar o seguinte formato:

// This is a single-line code comment

Para adicionar um comentário de código de múltiplas linhas, você pode usar este formato:

/**
* This is a code comment that spans multiple lines
* This text is also in the same comment
* This is the last line in the code comment
*/

Aqui está um exemplo de como você pode usar comentários de código – você pode ver que o comentário antes de cada snippet de código explica o que o snippet faz.

Um exemplo de uso de comentários de código para documentar snippets do arquivo functions.php.
Um exemplo de uso de comentários de código para documentar snippets do arquivo functions.php.

Use arquivos de inclusão para separar snippets em diferentes arquivos

Se você realmente tem muitos snippets de código, você pode armazená-los em arquivos separados ao invés de usar apenas o arquivo functions.php.

Então, você pode incluir esses snippets de código no arquivo functions.php usando include ou require. Mike Schinkel tem um bom exemplo de como você pode fazer isso no StackExchange.

Considere uma das alternativas ao functions.php acima

Se você encontrar seu arquivo functions.php ficando um pouco confuso, você pode preferir uma das alternativas do functions.php que detalhamos anteriormente.

Por exemplo, o plugin gratuito Code Snippets torna muito fácil organizar tudo porque você pode adicionar cada snippet de código separadamente, completo com seu próprio título e descrição. Você também pode usar tags para organizar seus snippets.

Resumo

A função do arquivo functions.php do WordPress é permitir adicionar trechos de código PHP ao seu site.

Se você quiser adicionar snippets de código ao arquivo functions.php, você deve sempre usar um Child Theme para que suas alterações não sejam sobrescritas quando você atualizar seu tema. Também recomendamos fazer backup do seu site antes de adicionar snippets e testá-los em um site de teste sempre que possível.

Como uma alternativa ao uso do arquivo functions.php, você também pode considerar um plugin gerenciador de código ou criar seu próprio plugin personalizado para armazenar seus snippets.

Agora que você sabe como funciona o arquivo functions.php do WordPress, você pode começar a personalizar seu site de todos os tipos de maneiras úteis.

O exemplo do snippets functions.php acima dão alguns bons pontos de partida, mas o céu é o limite quando se trata do que você pode fazer.

Jeremy Holcombe Kinsta

Content & Marketing Editor at Kinsta, WordPress Web Developer, and Content Writer. Outside of all things WordPress, I enjoy the beach, golf, and movies. I also have tall people problems ;).