Trusted WordPress tutorials, when you need them most.
Beginner’s Guide to WordPress
Copa WPB
25 Million+
Websites using our plugins
16+
Years of WordPress experience
3000+
WordPress tutorials
by experts

O que é: Ganchos

Nota editorial: Ganhamos uma comissão de links de parceiros no WPBeginner. As comissões não afetam as opiniões ou avaliações de nossos editores. Saiba mais sobre Processo editorial.

No desenvolvimento do WordPress, os hooks são funções que podem ser aplicadas a uma ação ou filtro no WordPress. Eles são um dos grandes recursos que tornam o WordPress tão personalizável.

Os ganchos permitem que os desenvolvedores alterem ou ampliem a funcionalidade do WordPress sem a necessidade de editar o próprio código principal do WordPress. Eles fazem isso executando ações e filtros, que são funções PHP que executam tarefas e fazem alterações nos dados.

Eles são amplamente usados por desenvolvedores de plugins e temas. Entretanto, se você não for um desenvolvedor, poderá colar trechos de código da Web para adicionar novos recursos ao seu site. Muitos deles incluem hooks.

What Are Hooks in WordPress?

O que é um gancho?

Os ganchos são a base do desenvolvimento de plug-ins e temas do WordPress. Eles são locais onde os desenvolvedores podem “enganchar” seu código personalizado no WordPress em locais específicos e alterar a forma como o WordPress opera sem editar os arquivos principais.

Os desenvolvedores usam hooks para alterar ou ampliar a funcionalidade do WordPress. Você também pode usar ações para personalizar seu tema, adicionando trechos de código de tutoriais on-line.

Observação: se você for um iniciante, recomendamos enfaticamente que não edite nenhum arquivo do WordPress. Somente usuários experientes que se sintam à vontade para editar o arquivo functions.php e tenham algum conhecimento de PHP devem tentar isso.

Os iniciantes devem usar um plug-in para realizar a tarefa que desejam executar ou consultar profissionais para editar o código para eles.

Antes de editar qualquer código em seu site do WordPress, recomendamos que você faça um backup do site, caso ocorra um erro de codificação. Se você não tiver um plug-in de backup, não deixe de ler nosso artigo em que comparamos os melhores plug-ins de backup do WordPress.

Há dois tipos de hooks: filtros e ações.

O que é um gancho de filtro?

Um filtro modificará o comportamento padrão de uma função específica. Ele faz isso manipulando os dados que recebe e retornando esses dados ao WordPress antes de serem exibidos no navegador.

Por exemplo, os filtros podem ser usados para truncar texto, alterar a formatação do conteúdo, anexar links a publicações, modificar blocos em uma página e alterar opções recuperadas do banco de dados.

Aqui está um exemplo de um gancho usado com um filtro no WordPress:

function wpb_custom_excerpt( $output ) {
  if ( has_excerpt() && ! is_attachment() ) {
    $output .= wpb_continue_reading_link();
  }
  return $output;
}
add_filter( 'get_the_excerpt', 'wpb_custom_excerpt' );

O código de exemplo acima cria uma função wpb_custom_excerpt que é conectada ao filtro get_the_excerpt.

O que é um gancho de ação?

Uma ação modificará o comportamento padrão de uma função específica. Ela faz isso pegando algumas informações do WordPress e depois fazendo algo com elas. Uma vez que a ação tenha sido executada, não há necessidade de passar nenhuma informação de volta ao WordPress.

Por exemplo, as ações podem ser usadas para colocar uma mensagem promocional em uma página, ativar um plug-in, adicionar widgets extras a uma barra lateral, publicar um post ou adicionar um menu a um cabeçalho.

Aqui está um exemplo de um gancho aplicado a uma ação no WordPress:

function mytheme_enqueue_script() {
    wp_enqueue_script( 'my-custom-js', 'custom.js', false );
}
add_action( 'wp_enqueue_scripts', 'mytheme_enqueue_script' );

O código de exemplo acima cria uma função mytheme_enqueue_script que é conectada à ação wp_enqueue_scripts.

Esperamos que este artigo tenha ajudado você a saber mais sobre hooks no WordPress. Talvez você também queira ver nossa lista de Leitura adicional abaixo para obter artigos relacionados sobre dicas, truques e ideias úteis do WordPress.

Se você gostou deste guia, considere a possibilidade de se inscrever em nosso canal do YouTube para receber tutoriais em vídeo sobre o WordPress. Você também pode nos encontrar no Twitter e no Facebook.

Leitura adicional

Avatar

Editorial Staff at WPBeginner is a team of WordPress experts led by Syed Balkhi with over 16 years of experience in WordPress, Web Hosting, eCommerce, SEO, and Marketing. Started in 2009, WPBeginner is now the largest free WordPress resource site in the industry and is often referred to as the Wikipedia for WordPress.

O kit de ferramentas definitivo WordPress

Obtenha acesso GRATUITO ao nosso kit de ferramentas - uma coleção de produtos e recursos relacionados ao WordPress que todo profissional deve ter!