Hook admin_notices — Exibir avisos no painel administrativo
Causa
Mensagens de feedback no admin precisam ser exibidas no local correto do layout. Inserir HTML diretamente fora do hook quebra a interface do WordPress.
Como resolver
Use as classes notice, notice-success, notice-error, notice-warning, notice-info e is-dismissible para manter consistência com o design do WordPress.
<?php
add_action('admin_notices', function (): void {
// Exibe apenas na tela de plugins
$screen = get_current_screen();
if ($screen?->id !== 'plugins') return;
// Verifica se a opção de configuração foi preenchida
if (!get_option('meu_plugin_api_key')) {
echo '<div class="notice notice-warning is-dismissible">
<p>
<strong>Meu Plugin:</strong> Configure sua chave de API para ativar todas as funcionalidades.
<a href="' . esc_url(admin_url('options-general.php?page=meu-plugin')) . '">Configurar agora</a>
</p>
</div>';
}
});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 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.
add_action() com prioridade — Controlar ordem de execuçã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.
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 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.
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.