No desenvolvimento do WordPress, uma ação pode ser usada para modificar como um site WordPress funciona ou adicionar novos recursos. O WordPress tem muitas ações predefinidas que permitem aos desenvolvedores adicionar 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. São trechos de código PHP que são 'conectados' a um evento do WordPress. Quando o evento é acionado, a ação será executada.
Elas são amplamente utilizadas por desenvolvedores de plugins e temas. No entanto, se você não é um desenvolvedor, pode 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, em seguida, fazendo algo com elas.
Por exemplo, ações podem ser usadas para colocar uma mensagem promocional em uma página, ativar um plugin, adicionar widgets extras a uma barra lateral, publicar um post ou adicionar um menu a um cabeçalho. Elas também podem enviar um e-mail para o autor após a publicação de um post, carregar um script personalizado no rodapé ou dar 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 usar ações, mas estas são as mais comumente usadas:
add_action(): anexa uma função a um hook que você especificou emdo_actionremove_action(): remove uma função anexada a um hook de ação especificadodo_action(): é aqui que as funções 'conectadas' serão executadashas_action(): verifica se uma ação foi registrada
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 online.
Apenas usuários experientes que se sentem confortáveis com a edição do arquivo functions.php e têm algum conhecimento de PHP devem tentar isso.
Iniciantes devem usar um plugin 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 WordPress, recomendamos que você faça backup do seu site em caso de erro de codificação. Se você não tiver um plugin de backup, certifique-se de ler nosso artigo onde comparamos os melhores plugins de backup WordPress.
Também recomendamos que você não adicione o código diretamente aos arquivos do tema, ou você perderá suas personalizações na próxima vez que atualizar o tema.
Em vez disso, você deve usar um plugin de trechos de código para adicionar código personalizado no WordPress, criar um plugin específico para o site, ou criar um tema filho e modificá-lo em vez do tema pai.
Veja nosso guia sobre como atualizar um tema WordPress sem perder personalizações.
Qual é a Diferença Entre Hooks, Ações e Filtros?
Para entender melhor as ações no WordPress, é útil ver como elas se relacionam com outros dois termos, hooks e filtros. Entender esses três termos juntos tornará o termo 'ação' um pouco mais fácil de compreender.
Hooks são a base do desenvolvimento de plugins e temas do WordPress. São locais onde os desenvolvedores podem ‘enganchar’ seu código personalizado no WordPress em locais específicos e alterar como o WordPress opera sem editar arquivos principais.
Existem dois tipos de hooks.
- Hooks de ação permitem que você faça algo. Eles permitem adicionar funcionalidades extras e são executados quando eventos como a ativação de um tema ou plugin, ou quando uma postagem é publicada. Uma vez que a ação foi realizada, eles não precisam passar nenhuma informação de volta para o WordPress.
- Hooks de filtro permitem que você mude algo. Eles interceptam dados que estão sendo processados e permitem que você os modifique, depois os devolvem. Eles são usados para filtrar a saída quando ela é enviada para um banco de dados ou para o navegador de um usuário.
Esses ganchos de ação e filtro são a base de como o núcleo do WordPress, temas e plugins funcionam. Eles trabalham juntos para permitir aos desenvolvedores 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 estender seus plugins 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 seu template de rodapé diretamente. Mas é frequentemente mais fácil e uma prática melhor conectar 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 a uma função em seu arquivo functions.php. Você pode então adicionar essa função a uma ação que está no local onde você gostaria que seu 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 WordPress.
Você pode aprender mais estudando nossos guias do WordPress que usam ações. Por exemplo, aqui estão alguns guias que mostram como alcançar algo prático usando 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 de posts
- Como adicionar avisos administrativos personalizados no WordPress
- Como desativar a barra de administração para todos os usuários, exceto administradores
As ações no WordPress fornecem uma maneira de você exibir conteúdo em quase qualquer lugar do seu tema. Provavelmente, já existe um hook padrão que fará exatamente o que você precisa. O WordPress oferece uma lista de ações em sua Referência de Ações da API de Plugins.
Esperamos que este artigo tenha ajudado você a aprender mais sobre ações no WordPress. Você também pode consultar nossa lista de Leitura Adicional abaixo para artigos relacionados sobre dicas, truques e ideias úteis do WordPress.
Se você gostou deste guia, considere se inscrever em nosso Canal do YouTube para tutoriais em vídeo sobre WordPress. Você também pode nos encontrar no Twitter e no Facebook.
