Um guia para ganchos, ações e filtros do WordPress
Bem-vindo ao "Um Guia para Ganchos, Ações e Filtros do WordPress." No vasto domínio do desenvolvimento do WordPress, entender ganchos, ações e filtros é essencial para desbloquear todo o potencial dessa poderosa plataforma.
Os ganchos servem como a espinha dorsal da personalização do WordPress, permitindo que você modifique e expanda suas funcionalidades de forma fluida. As ações permitem que você realize tarefas específicas em pontos-chave durante a execução, enquanto os filtros permitem manipular dados e devolver resultados modificados. Seja você iniciante ou um desenvolvedor experiente, este guia completo fornecerá insights valiosos e exemplos práticos para aproveitar a verdadeira flexibilidade e capacidades de personalização oferecidas pelos ganchos, ações e filtros do WordPress. Vamos mergulhar e desbloquear as possibilidades ilimitadas do desenvolvimento em WordPress.
Ganchos
Ganchos são a base do desenvolvimento de plugins e temas do WordPress. São lugares onde os desenvolvedores podem 'conectar' seu código personalizado ao WordPress em locais específicos e mudar como o WordPress opera sem editar arquivos principais.
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. |
Em conclusão, dominar a arte dos ganchos, ações e filtros do WordPress abre um mundo de possibilidades infinitas para personalizar e aprimorar seu site WordPress. Ao entender como funcionam os ganchos, aproveitar o poder das ações e aproveitar a flexibilidade dos filtros, você pode moldar a funcionalidade e a aparência do seu site para atender às suas necessidades únicas. Com o conhecimento adquirido neste guia, você está preparado para assumir o controle total da sua jornada de desenvolvimento do WordPress. Então, vá em frente, experimente e crie experiências notáveis para seus usuários. Aproveite a versatilidade dos ganchos, ações e filtros do WordPress e desbloqueie o verdadeiro potencial do seu site. Boas programações!
Você está interessado no Futuro do WordPress ? Confira isso Postar !


