Neste tutorial, nosso foco será aprender o que o funções.php arquivo é, alguns de seus usos comuns e quando você deve usá-lo em vez de criar plugins. Vamos começar.
O que é funções.php Arquivo?
O funções.php arquivo no WordPress é usado para adicionar novas funcionalidades ou recursos ao seu site WordPress. Você pode escrever código PHP neste arquivo. Esse código pode definir suas próprias funções personalizadas ou fazer chamadas para funções existentes do WordPress. Aprenderemos como adicionar novos recursos ao seu site WordPress por meio do funções.php arquivo na próxima seção.
É totalmente possível que uma instalação do WordPress tenha vários temas. Cada um desses temas terá seu próprio funções.php arquivo. No entanto, apenas o código dentro do funções.php O arquivo do seu tema ativo realmente é executado quando alguém carrega seu site.
Você vai precisar encontrar o seu funções.php arquivo antes de poder editá-lo. Você pode encontrá-lo no /wp-content/themes/theme-name/ diretório. Aqui, nome do tema é o nome de qualquer tema que você instalou e ativou.
Quaisquer temas filhos que você instalou em seu site também podem ter seus próprios funções.php arquivos. Ao contrário de outros temas, o funções.php arquivo do tema filho não substituirá o funções.php arquivo do tema pai. Na verdade, ele aumentará a funcionalidade fornecida pelo tema pai.
Usos do funções.php Arquivo
Há muitas coisas que você pode fazer com o funções.php arquivo. Vamos aprender sobre algumas dessas coisas aqui.
Enfileirando Scripts e Estilos
Você pode querer incluir scripts e estilos adicionais com seu site para carregar em seu front-end. A melhor maneira de conseguir isso é com a ajuda do wp_enqueue_scripts gancho. Ao contrário do nome, esse gancho é útil para enfileirar scripts e estilos. Aqui está um exemplo de como usá-lo em seu funções.php arquivo.
1 |
function monty_scripts_styles() { |
2 |
wp_enqueue_style( 'my-style', get_template_directory_uri() . '/css/custom-style.css', array(), '1.2.0', 'all' ); |
3 |
wp_enqueue_script( 'my-script', get_template_directory_uri() . '/js/custom-script.js', array( 'jquery' ), '1.5.6', true ); |
4 |
}
|
5 |
|
6 |
add_action( 'wp_enqueue_scripts', 'monty_scripts_styles' ); |
Usando o wp_enqueue_scripts gancho para adicionar seus estilos e scripts melhora o desempenho garantindo que os arquivos não sejam carregados várias vezes, entre outras coisas. Você pode ler este tutorial sobre como carregar seu CSS no WordPress da maneira certa para aprender mais.
O wp_enqueue_style() e wp_enqueue_script() funções aceitam vários parâmetros para especificar coisas como fonte, versão, dependências, etc.
Criando códigos de acesso personalizados
Os shortcodes do WordPress ajudam as pessoas a adicionar conteúdo dinâmico ou estático ao site sem a necessidade de escrever códigos complexos. Pense em coisas como uma lista de postagens mais recentes, algumas imagens da galeria, a data atual ou uma simples saudação.
Você pode escrever um pouco de código no funções.php arquivo para adicionar um shortcode personalizado.
1 |
function monty_greeting_shortcode() { |
2 |
$current_user = wp_get_current_user(); |
3 |
|
4 |
if($current_user) { |
5 |
$name = $current_user->display_name; |
6 |
} else { |
7 |
$name = 'Guest'; |
8 |
}
|
9 |
|
10 |
$greeting = 'Hello, '.$name.'!'; |
11 |
|
12 |
return $greeting; |
13 |
}
|
14 |
|
15 |
add_shortcode( 'greet_readers', 'monty_greeting_shortcode' ); |
Este é um exemplo muito simples onde você pode usar o greet_readers shortcode em qualquer lugar no front-end para adicionar a saudação Olá, nome de exibição! para usuários logados e Olá, Convidado! para todos os outros.
Agora tente escrever seu próprio shortcode que retorne o conteúdo que você deseja exibir.
Remova o número da versão do WordPress
Você pode estar interessado em verificar a versão WordPress do seu site por vários motivos.
No entanto, essas informações não devem ser visíveis publicamente. O WordPress adiciona uma metatag do gerador que exibe publicamente a versão do WordPress atualmente instalada em seu site no código-fonte HTML. Você pode remover a tag do gerador simplesmente adicionando a seguinte linha ao seu funções.php arquivo.
1 |
add_action( 'wp_head', 'wp_generator'); |
Você pode considerar o uso da linha a seguir se quiser remover as informações de outros locais, como feeds RSS.
1 |
add_filter('the_generator', '__return_empty_string'); |
o embutido __return_empty_string() A função retornará uma string vazia e impedirá que as informações de sua versão sejam exibidas no front-end.
Desativar a barra de ferramentas de administração do WordPress
O WordPress adiciona uma barra de ferramentas de administração na parte superior do front-end para todos os usuários conectados por padrão. Você pode adicionar a seguinte linha em seu funções.php arquivo para desativá-lo para todos de uma vez.
1 |
add_filter( 'show_admin_bar', '__return_false' ); |
Lembre-se de que a barra de ferramentas de administração do WordPress não pode ser desativada no back-end.
Desativar atualizações automáticas do WordPress
Embora geralmente não seja recomendado desabilitar as atualizações automáticas do WordPress em seu site, há vários motivos pelos quais você pode querer fazer isso, como evitar falhas inesperadas. Você deve ler este tutorial para saber mais sobre as atualizações automáticas do WordPress.
Adicione as seguintes linhas ao seu funções.php arquivo se tiver certeza de que deseja desativar as atualizações automáticas do WordPress.
1 |
add_filter('auto_update_core', '__return_false'); |
2 |
add_filter('auto_update_theme', '__return_false'); |
3 |
add_filter('auto_update_plugin', '__return_false'); |
Essas três linhas desabilitarão atualizações principais, atualizações de tema e atualizações de plug-in, respectivamente.
Pensamentos finais
Neste tutorial, aprendemos muitas coisas sobre o funções.php arquivo. Agora sabemos o que é esse arquivo, onde está localizado e como podemos usá-lo para adicionar novas funcionalidades ao nosso site. Também é possível adicionar funcionalidade ao seu site com plugins. Então, qual é a melhor maneira de fazer isso?
Você deve considerar o uso do funções.php arquivo se a funcionalidade que você está adicionando for específica do tema ou se você quiser apenas adicionar um pouquinho de nova funcionalidade. Criar e instalar novos plugins para cada pequena coisa será prejudicial para o desempenho do seu site.
