Como usar Hooks e Filters do WordPress (Guia para Iniciantes)
Olá, querido(a) cliente da GeHost! Seja bem-vindo(a) ao seu primeiro passo rumo ao poder total do WordPress. Aqui, você vai aprender, de forma simples e prática, como usar hooks e filters — dois dos pilares mais importantes para personalizar seu site sem tocar no código principal.
Imagine que o WordPress é uma casa. Os hooks são como portas e janelas: você pode entrar e sair, mas não precisa quebrar a parede. Os filters são como ajustes de luz: você pode mudar o tom, mas a estrutura da casa permanece intacta.
Com esse guia, você vai aprender a fazer coisas incríveis — como alterar mensagens de erro, adicionar botões, modificar textos, e muito mais — tudo sem precisar mexer nos arquivos do WordPress diretamente. Vamos lá?
O que são Hooks e Filters?
Antes de tudo, vamos entender o que são esses "mágicos" do WordPress:
- Hook (gancho): É um ponto no código onde você pode "pendurar" uma função. Existem dois tipos principais: actions (ações) e filters (filtros).
- Filter (filtro): É um hook que altera um valor antes de ele ser usado. Por exemplo, mudar o texto de um botão ou o título de um post.
Imagine que você quer mudar o texto "Comentar" para "Escrever sua opinião" nos comentários. Com um filter, você faz isso em segundos — sem tocar no tema original.
Como usar Hooks e Filters no seu site (passo a passo)
Para usar hooks e filters, você vai precisar editar o arquivo functions.php do seu tema. Ele está localizado na pasta do seu tema no Gerenciador de Arquivos do cPanel.
Passo 1: Acesse o Gerenciador de Arquivos
Entre no seu cPanel — sua central de controle da GeHost.
Na seção Arquivos, clique em Gerenciador de Arquivos.
Passo 2: Localize o arquivo functions.php
No Gerenciador de Arquivos, navegue até a pasta public_html, depois até wp-content/themes.
Escolha o tema que você está usando (por exemplo, twentynineteen ou generatepress).
Dentro da pasta do tema, procure o arquivo functions.php. Ele é o coração do seu tema.
Passo 3: Edite o arquivo functions.php
Clique com o botão direito no arquivo functions.php e selecione Editar (ou "Code Editor").
Uma nova janela abrirá com o código do arquivo. Não apague nada — só vamos adicionar nosso código no final.
Dica do Sensei: Sempre faça um backup antes de editar arquivos. Use o Backup no cPanel para salvar sua conta inteira.
Passo 4: Adicione um Filter (exemplo prático)
Vamos mudar o texto do botão "Comentar" para "Escrever sua opinião". Copie e cole este código no final do arquivo functions.php:
add_filter('comment_submit_button', 'mudar_texto_comentar');
function mudar_texto_comentar($text) {
return 'Escrever sua opinião';
}
Salve o arquivo com o botão Salvar (ou "Save Changes").
Passo 5: Teste no seu site
Abra seu site no navegador e vá até uma página com comentários.
Veja só! O botão agora diz “Escrever sua opinião” — sem precisar alterar o tema original!
Outros exemplos úteis de Filters
Aqui vão algumas ideias que você pode usar no seu site:
- Alterar o título do site:
add_filter('bloginfo', 'mudar_titulo_site', 10, 2); function mudar_titulo_site($output, $show) { if ($show == 'name') { return 'Meu Site Incrível'; } return $output; } - Mostrar mensagem personalizada no rodapé:
add_filter('wp_footer', 'mostrar_mensagem_rodape'); function mostrar_mensagem_rodape() { echo '© 2025 Meu Site. Todos os direitos reservados.'; }
Atenção: Cuidado com erros de sintaxe
Se você digitar algo errado no functions.php, seu site pode parar de funcionar. Se isso acontecer:
- Entre no cPanel novamente.
- Abra o
functions.phpe corrija o erro. - Se não souber como, reinstale o arquivo original (ou use o backup).
Importante: Sempre faça backups antes de editar arquivos críticos. O cPanel tem um botão Backup que salva tudo — inclusive o
functions.php.
Conclusão: Você está no controle!
Com hooks e filters, você não precisa ser um programador para personalizar seu WordPress. É como ter um kit de ferramentas mágicas — só você decide como usá-las.
Se precisar de ajuda, nosso suporte está sempre aqui. É só chamar, que a GeHost te ajuda com carinho.
Até a próxima, e que seu site cresça com propósito!
Sensei da GeHost
Seu parceiro no mundo do WordPress 🌟