Actions / Ações

Uma ação é uma função no código do WordPress que é executada em determinados pontos do núcleo do WordPress. No código do WordPress, existem inúmeras ações ou hooks (ganchos) predefinidos que permitem que os desenvolvedores adicionem seu próprio código nesses pontos. Isso faz parte do que torna o WordPress tão extensível e a maioria dos plugins depende de ações para sua operação.

Para dar um exemplo de como eles podem ser usados para adicionar código a um site, suponhamos que você queira adicionar um aviso de direitos autorais ao rodapé. Para fazer isso, você pode modificar seu template na seção do rodapé diretamente. Em alguns casos, isso seria preferível, mas muitas vezes é muito mais fácil e melhor prática vincular seu código a uma ação predefinida que já está sendo executada no rodapé.

Para fazer isso, você pode adicionar seu código de direitos autorais em uma função no seu tema, mas atente-se a algumas boas práticas antes de adicionar um código:

  • Se for um tema desenvolvido por você (ou equipe contratada para tal), adicione o código abaixo no arquivo functions.php;
  • Se for um tema comprado e você estiver utilizando um tema filho, pode também adicionar no arquivo functions.php do tema filho;
  • Se for um tema comprado e sem um tema filho, ou se você não tem certeza de nenhuma dessas coisas mencionadas até aqui, adicione o código através do plugin Code Snippets, assim atualizações do tema não farão você perder as funções adicionadas manualmente em seu site.

Vamos a um exemplo: Você pode adicionar a função abaixo para ter um texto mostrando os código de direitos autorais no rodapé de seu site.

function guga_copyright_notice() {
   echo '<p>Copyright - Todos os direitos reservados</p>';
}
add_action('wp_footer','guga_copyright_notice');

Neste exemplo, guga_copyright_notice é uma função que executa uma ação conectada ao gancho wp_footer. A função será executada sempre que o wp_footer () aparecer em um código de tema do WordPress (o que é o padrão mesmo).

O WordPress oferece uma lista de ações disponíveis em sua documentação de API para plugins.

Artigos Relacionados: