No desenvolvimento do WordPress, uma ação pode ser usada para modificar o funcionamento de um site WordPress ou adicionar novos recursos. O WordPress tem muitas ações predefinidas que permitem que os desenvolvedores adicionem seu próprio código em pontos específicos do núcleo do WordPress.
As ações são um dos grandes recursos que tornam o WordPress tão personalizável. Elas são partes de código PHP que são “conectadas” a um evento do WordPress. Quando o evento é acionado, a ação é executada.
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 ações.
O que é uma ação no WordPress?
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.
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 uma postagem ou adicionar um menu a um cabeçalho. Elas também podem enviar um e-mail ao autor após a publicação de um post, carregar um script personalizado no rodapé ou fornecer aos seus leitores instruções sobre como preencher um formulário.
As ações são adicionadas usando a função add_action(). O WordPress tem várias funções que permitem o uso de ações, mas essas são as mais comumente usadas:
add_action(): anexa uma função a um gancho que você especificou naação do_actionremove_action(): remove uma função anexada a um gancho de ação especificadodo_action(): é aqui que as funções “hooked” serão executadashas_action(): verifica se uma ação foi registrada
As ações são usadas por desenvolvedores de plugins e temas para adicionar funcionalidades extras ao WordPress. Você também pode usar ações para personalizar seu tema, adicionando trechos de código de tutoriais on-line.
Somente usuários experientes que se sintam à vontade para editar o arquivo functions.php e que tenham algum conhecimento de PHP devem tentar isso.
Os iniciantes devem usar um plug-in para realizar a tarefa que desejam 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.
Também recomendamos que você não adicione o código diretamente aos arquivos do tema, ou perderá suas personalizações na próxima vez que atualizar o tema.
Em vez disso, você deve usar um plug-in de trechos de código para adicionar código personalizado no WordPress, criar um plug-in específico para o site ou criar um tema filho e modificá-lo em vez do tema pai.
Consulte nosso guia sobre como atualizar um tema do WordPress sem perder a personalização.
Qual é a diferença entre Hooks, Actions e Filters?
Para entender melhor as ações no WordPress, é útil ver como elas se relacionam com dois outros termos, hooks e filtros. Compreender esses três termos juntos tornará o termo “ação” um pouco mais fácil de entender.
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.
Há dois tipos de ganchos.
- Os ganchos de ação permitem que você faça algo. Eles permitem que você adicione funcionalidades extras e são executados quando ocorrem eventos como a ativação de um tema ou plugin ou a publicação de um post. Depois que a ação é executada, eles não precisam passar nenhuma informação de volta ao WordPress.
- Os hooksde filtro permitem que você altere algo. Eles interceptam os dados que estão sendo processados e permitem que você os modifique e, em seguida, os passe de volta. São usados para filtrar a saída quando ela é enviada a um banco de dados ou ao navegador de um usuário.
Esses ganchos de ação e filtro são a base do funcionamento do núcleo, dos temas e dos plug-ins do WordPress. Eles trabalham juntos para permitir que os desenvolvedores tenham grande flexibilidade para modificar eventos, filtros e ações padrão do WordPress.
Os desenvolvedores também podem criar suas próprias ações e filtros personalizados para que outros desenvolvedores possam ampliar seus plug-ins ou temas.
Exemplos de filtros do WordPress
Como é uma ação? Aqui estão alguns exemplos.
Digamos que você queira adicionar um aviso de direitos autorais ao seu rodapé. Para fazer isso, você poderia modificar diretamente o modelo do rodapé. Mas, em geral, é mais fácil e mais prático vincular seu código a uma ação predefinida que já esteja sendo executada no rodapé.
Para fazer isso, você pode adicionar o código de direitos autorais a uma função em seu arquivo functions.php. Em seguida, você pode adicionar essa função a uma ação que esteja no local em que você gostaria que o código de direitos autorais fosse executado.
function copyright_notice() {
echo "Copyright All Rights Reserved";
}
add_action('wp_footer','copyright_notice');
Neste exemplo, copyright_notice é uma ação conectada ao gancho wp_footer. A função copyright_notice será executada sempre que o gancho wp_footer() aparecer no código de um tema do WordPress.
Você pode aprender mais estudando nossos guias do WordPress que usam ações. Por exemplo, aqui estão alguns guias que mostram a você como realizar algo prático usando as ações do WordPress:
- Como criar menus de navegação personalizados em temas do WordPress
- Como adicionar widgets do WordPress ao cabeçalho do seu site
- Como adicionar campos personalizados automaticamente na publicação do post
- Como adicionar avisos de administração personalizados no WordPress
- Como desativar a barra de administração para todos os usuários, exceto os administradores
As ações no WordPress oferecem uma maneira de gerar conteúdo em praticamente qualquer lugar do seu tema. É provável que já exista um gancho padrão que faça exatamente o que você precisa. O WordPress oferece uma lista de ações em sua API de plug-in/referência de ações.
Esperamos que este artigo tenha ajudado você a saber mais sobre ações 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.
