Como usar hooks e filters do WordPress

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.php e 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 🌟