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

Bem-vindo ao “A Guide to WordPress Hooks, Actions, and Filters.”No vasto domínio do desenvolvimento do WordPress, entender ganchos, ações e filtros é essencial para desbloquear todo o potencial dessa poderosa plataforma.

Hooks serve as the backbone of WordPress customization, allowing you to seamlessly modify and extend its functionality. Actions enable you to perform specific tasks at key points during runtime, while filters empower you to manipulate data and return modified results. Whether you’re a beginner or an experienced developer, this comprehensive guide will provide you with invaluable insights and practical examples to harness the true flexibility and customization capabilities offered by WordPress hooks, actions, and filters. Let’s dive in and unlock the limitless possibilities of WordPress development.

Ganchos

Hooks are the foundation of WordPress plugin and theme development. They are places where developers can ‘hook’ their custom code into WordPress at specific locations and change how WordPress operates without editing core files.

Existem dois tipos de ganchos do WordPress: ações e filtros

Os ganchos 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 função específica extraindo informações do WordPress e realizando operações nela. Depois que uma ação é executada, não há necessidade de passar nenhum dado de volta para o WordPress.

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

• add_action(): Esta 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 gancho de ação específico.
• 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 enganchar no do_action(‘wp_head’), você pode executar código personalizado sempre que o WordPress processar o cabeçalho do site. Essa ação não requer argumentos adicionais.

Exemplo completo:

add_action ( corda $hook_nome, Callable $callback, int $priority = 10, int $accepted_args = 1 ): verdadeiro

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 devolvendo-os ao WordPress antes de exibi-los no navegador.

Exemplos:

• add_filter() :isso anexa uma função a um gancho
• r emove_filter() :Isso remove uma função anexada a um gancho de filtro especificado
• doing_filter() : Isso 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 string 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 apply_filters ( ‘admin_footer_text ‘ , string $text ) O filtro 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 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 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 ganchos 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, incluindo alterar o comportamento de como o WordPress funciona.	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. No entanto, eles podem ecoar a saída ou interagir com o banco de dados.
As funções de ação não devem retornar nada. No entanto, eles 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 não intencionais.

In conclusion, mastering the art of WordPress hooks, actions, and filters opens up a world of endless possibilities for customizing and enhancing your WordPress website. By understanding how hooks work, leveraging the power of actions, and harnessing the flexibility of filters, you can shape your website’s functionality and appearance to suit your unique needs. With the knowledge gained from this guide, you are equipped to take full control of your WordPress development journey. So go ahead, experiment, and create remarkable experiences for your users. Embrace the versatility of WordPress hooks, actions, and filters, and unlock the true potential of your website. Happy coding!

Você está interessado no Futuro do WordPress ? Confira isso Postar !