Um guia para ganchos, ações e filtros do WordPress

Bem-vindo ao "Guia de ganchos, ações e filtros do WordPress". No vasto domínio do desenvolvimento do WordPress, compreender os hooks, as ações e os filtros é essencial para liberar todo o potencial dessa plataforma poderosa.

Os ganchos funcionam como a espinha dorsal da personalização do WordPress, permitindo que você modifique e amplie sua funcionalidade sem problemas. As ações permitem que você execute tarefas específicas em pontos-chave durante o tempo de execução, enquanto os filtros permitem que você manipule dados e retorne resultados modificados. Independentemente de você ser um desenvolvedor iniciante ou experiente, este guia abrangente fornecerá insights valiosos e exemplos práticos para aproveitar a verdadeira flexibilidade e os recursos de personalização oferecidos pelos hooks, ações e filtros do WordPress. Vamos nos aprofundar e desbloquear as possibilidades ilimitadas do desenvolvimento do WordPress.

Ganchos

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 do WordPress: Ações e filtros

Os Hooks do WordPress consistem em dois tipos fundamentais conhecidos como Ações e Filtros. As ações permitem que você execute tarefas específicas em pontos predefinidos durante o tempo de execução do WordPress, enquanto os filtros permitem que você modifique e retorne quaisquer dados processados pelo WordPress.

Ações:

Ao empregar uma ação, você pode personalizar o comportamento padrão de uma determinada função, extraindo informações do WordPress e realizando operações sobre elas. Depois que uma ação é executada, não há necessidade de passar nenhum dado de volta para o WordPress.

Para adicionar ações, é utilizada a função add_action(). O WordPress oferece várias funções que facilitam a utilização de ações, sendo as seguintes as mais comumente empregadas:

• add_action(): Essa função anexa uma função especificada a um gancho dentro do processo do_action.
• remove_action(): Permite a remoção de uma função anexada a um determinado gancho de ação.
• do_action(): É aqui que as funções conectadas ao gancho serão executadas.
• has_action(): Verifica se uma ação foi registrada ou não.

As ações são definidas no código do WordPress como

do_action( 'action_name', [optional_arguments] );

Ao se conectar à ação do_action('wp_head'), você pode executar um código personalizado sempre que o WordPress processar o cabeçalho do site. Essa ação não requer nenhum argumento adicional.

Exemplo completo:

add_action( string $hook_name, callable $callback, int $priority = 10, int $accepted_args = 1 ): true

Referências de todas as ações:

https://codex.wordpress.org/Plugin_API/Action_Reference

https://developer.wordpress.org/reference/functions/add_action/

Filtros:

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

Exemplos:

• add_filter(): anexa uma função a um gancho
• remove_filter(): remove uma função anexada a um gancho de filtro especificado
• doing_filter(): detecta qualquer filtro que esteja sendo executado no momento
• has_filter(): verifica se um filtro foi registrado

Os filtros são definidos no código do WordPress como

apply_filters( 'filter_name', 'value_to_be_filtered', [optional_arguments] );

A cadeia de caracteres filter_name é o nome do filtro, a variável value_to_be_filtered é o valor que precisa ser filtrado e retornado, e a variável [optional_arguments] pode passar argumentos adicionais, assim como nas ações.

Exemplo: O filtro apply_filters( 'admin_footer_text' , string $text ) pode ser conectado para modificar o texto exibido no rodapé do administrador. A partir do WordPress 5.4, seu valor padrão mostrará a frase. Obrigado por criar com o WordPress. no rodapé da área de administração.

Ganchos do WordPress
Ações	Filtros
As ações são usadas para executar funções personalizadas em um ponto específico durante a execução do WordPress Core.	Os filtros são usados para modificar ou personalizar os dados usados por outras funções.
As ações são definidas/criadas pela função do_action( 'action_name') no código do WordPress.	Os filtros são definidos/criados pela função apply_filters( 'filter_name', 'value_to_be_filtered' ) no código do WordPress.
As ações também são chamadas de ganchos de ação.	Os filtros também são chamados de hooks de filtro.
As ações só podem ser conectadas com funções de ação. Por exemplo, add_action(), remove_action().	Os filtros só podem ser conectados com funções de filtro. Por exemplo, add_filter(), remove_filter().
As funções de ação não precisam passar nenhum argumento para suas funções de retorno de chamada.	As funções de filtro precisam passar pelo menos um argumento para suas funções de retorno de chamada.
As funções de ação podem executar qualquer tipo de tarefa, inclusive alterar o comportamento do funcionamento do WordPress.	As funções de filtro existem apenas para modificar os dados passados a elas pelos filtros. As funções de ação não devem retornar nada. Entretanto, elas podem ecoar a saída ou interagir com o banco de dados.
As funções de ação não devem retornar nada. Entretanto, elas podem ecoar a saída ou interagir com o banco de dados.	As funções de filtro devem retornar suas alterações como saída. Mesmo que uma função de filtro não altere nada, ela deve retornar a entrada não modificada.
As ações podem executar quase tudo, desde que o código seja válido.	Os filtros devem funcionar de maneira isolada para que não tenham efeitos colaterais indesejados.

Concluindo, dominar a arte dos hooks, ações e filtros do WordPress abre um mundo de infinitas possibilidades para personalizar e aprimorar seu site WordPress. Ao entender como os hooks funcionam, aproveitar o poder das ações e a flexibilidade dos filtros, você pode moldar a funcionalidade e a aparência do seu site para atender às suas necessidades específicas. Com o conhecimento adquirido com este guia, você está preparado para assumir o controle total da sua jornada de desenvolvimento do WordPress. Portanto, vá em frente, experimente e crie experiências incríveis para seus usuários. Aproveite a versatilidade dos ganchos, ações e filtros do WordPress e desbloqueie o verdadeiro potencial de seu site. Boa codificação!

Você está interessado no futuro do WordPress? Dê uma olhada neste post!