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.
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:
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/
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:
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!
