20.01.2025

Ações no WordPress

No WordPress, as ações fazem parte da API Hooks, que permite aos desenvolvedores injetar código personalizado em pontos específicos durante a execução do WordPress. As ações permitem que você realize tarefas ou execute funções em determinados eventos ou estágios, como quando um post é publicado, uma página é carregada ou um tema é ativado.

As ações são particularmente úteis para ampliar a funcionalidade do WordPress sem alterar os arquivos principais, tornando seu site mais sustentável e preparado para o futuro.

Como funcionam as ações do WordPress

Uma ação é acionada quando ocorre um evento específico no WordPress, como o carregamento de uma postagem ou a publicação de um comentário. Quando uma ação é acionada, todas as funções vinculadas a essa ação são executadas.

Por exemplo:

Quando um usuário faz login, o WordPress aciona a ação wp_login, que permite executar um código personalizado sempre que um usuário faz login.
Quando uma postagem é salva, a ação save_post é acionada, permitindo que você adicione uma funcionalidade personalizada, como o envio de um e-mail quando uma postagem é publicada.

Registro de ações com add_action()

Para vincular uma função a uma ação, use a função add_action(). Essa função informa ao WordPress para executar uma função específica quando uma ação for acionada.

Sintaxe:

add_action( $hook, $function_to_add, $priority, $accepted_args );

$hook: O nome do gancho da ação (por exemplo, wp_login, save_post).
$function_to_add: O nome da função que você deseja executar quando a ação for acionada.
$priority (opcional): Usado para especificar a ordem em que as funções devem ser executadas. Números menores significam maior prioridade. O padrão é 10.
$accepted_args (opcional): O número de argumentos que a função aceita. O padrão é 1.

Exemplo:

function my_custom_function() { // Código personalizado aqui echo “User has logged in!”; } add_action( ‘wp_login’, ‘my_custom_function’ );

Neste exemplo, quando um usuário fizer login, a função my_custom_function() será executada, exibindo uma mensagem.

Ações comuns do WordPress

Aqui estão algumas ações comumente usadas no WordPress:

wp_enqueue_scripts: Usada para enfileirar scripts e estilos no front-end.
init: Acionada depois que o WordPress termina de carregar, mas antes que qualquer cabeçalho seja enviado. Geralmente usado para registrar tipos de post personalizados ou taxonomias.
wp_head: Acionado na seção de cabeçalho do tema, útil para adicionar meta tags, estilos ou scripts.
save_post: Acionado quando uma postagem é salva. Pode ser usado para executar ações adicionais, como atualizar os metadados da postagem.
admin_init: Disparado quando um usuário acessa o painel de administração, útil para adicionar configurações personalizadas ou inicializar recursos para a área de administração.

Criação de ações personalizadas

Você também pode criar suas próprias ações personalizadas. Isso permite que outros desenvolvedores (ou você mesmo) conectem funções a pontos específicos em seu tema ou plug-in personalizado.

Exemplo:

function my_custom_action() { // Faça algo echo “Ação personalizada acionada!”; } do_action( ‘my_custom_action’ );

Nesse caso, você aciona o gancho my_custom_action onde quer que do_action( ‘my_custom_action’ ); seja colocado, e você pode conectar funções a ele desta forma:

add_action( ‘my_custom_action’, ‘my_custom_function’ );

Compreensão de do_action() e do_action_ref_array()

do_action(): Essa função aciona a execução de funções associadas a uma determinada ação.

Exemplo:

do_action( ‘wp_footer’ );

do_action_ref_array(): Essa função passa uma matriz de argumentos por referência para as funções hooked, o que é útil ao trabalhar com objetos ou matrizes que você deseja modificar diretamente.

Exemplo:

$my_data = array( ‘key’ => ‘value’ ); do_action_ref_array( ‘my_custom_action’, array( &$my_data ) );

Conclusão

As ações do WordPress oferecem uma maneira poderosa de ampliar a funcionalidade do WordPress, vinculando funções personalizadas a eventos específicos. Ao usar as ações, os desenvolvedores podem personalizar temas, plug-ins e recursos principais sem modificar o núcleo do WordPress, garantindo atualizações fáceis e facilidade de manutenção. Entender como usar e criar ações é essencial para qualquer desenvolvedor do WordPress que queira criar sites mais dinâmicos e ricos em recursos.