add_action() com prioridade — Controlar ordem de execução

Tipo Hooks de ação

Nome do erro add_action() com prioridade — Controlar ordem de execução

Severidade Informativo

Desde WordPress 1.2

Descrição O terceiro parâmetro de add_action() define a prioridade de execução. Prioridade menor = executa antes. Padrão é 10. Compreender isso evita conflitos entre plugins.

Causa

Quando múltiplos plugins e o tema hookeam a mesma ação, a ordem de execução impacta o resultado. Hooks registrados sem atenção à prioridade podem sobrescrever ou ser sobrescritos inesperadamente.

Como resolver

Use prioridade 5 ou menor para hooks que devem rodar cedo (como registro de CPTs). Use 20+ para hooks que devem rodar depois de plugins de terceiros.

PHP

<?php
// Prioridade 0 — muito antes de tudo (registro de recursos)
add_action('init', 'registrar_post_types', 0);

// Prioridade 10 — padrão
add_action('init', 'inicializar_plugin', 10);

// Prioridade 20 — após a maioria dos plugins
add_action('init', 'verificar_conflitos', 20);

// Prioridade PHP_INT_MAX — última coisa a rodar
add_action('template_include', 'meu_override_template', PHP_INT_MAX);

// Exemplo prático: garantir que nosso estilo seja carregado
// por último (sobrescrevendo outros plugins)
add_action('wp_enqueue_scripts', 'meu_enqueue_estilos', 9999);

function meu_enqueue_estilos(): void
{
    wp_enqueue_style(
        'meu-tema-override',
        plugin_dir_url(__FILE__) . 'assets/css/override.css',
        [],   // sem dependências declaradas (carrega depois de tudo pela prioridade)
        '1.0'
    );
}

Hook wp_head — Inserir meta tags e scripts no

Disparado dentro da tag do HTML. Usado para adicionar meta tags, preloads, scripts inline e outros recursos no cabeçalho.

Pro

Hook wp_ajax — Processar requisições AJAX no admin

Permite criar endpoints AJAX para usuários logados (wp_ajax_) e não logados (wp_ajax_nopriv_) sem precisar criar páginas ou rotas extras.

Hook init — Registros e inicialização de recursos

O hook init é disparado após o WordPress ter carregado mas antes de enviar qualquer header. Ideal para registrar CPTs, taxonomias e rewrite rules.

Hook save_post — Processar dados ao salvar um post

Disparado toda vez que um post é salvo ou atualizado no WordPress, incluindo revisões e auto-saves.

Hook admin_notices — Exibir avisos no painel administrativo

Exibe mensagens de feedback (sucesso, erro, aviso) no painel do WordPress após ações do usuário ou para comunicar estados do plugin.

Pro

Hook rest_api_init — Registrar rotas na REST API

Permite registrar endpoints customizados na WordPress REST API com suporte a autenticação, validação de parâmetros e callbacks de permissão.