Hook wp_head — Inserir meta tags e scripts no
Causa
Alterar o diretamente em templates quebra a portabilidade do tema e dificulta a manutenção. O hook garante que a inserção ocorra no momento correto.
Como resolver
Use wp_head para adicionar conteúdo ao . Para scripts e estilos, prefira wp_enqueue_scripts. Use alta prioridade (9999) se precisar que o código apareça por último.
<?php
add_action('wp_head', function (): void {
// Meta tags para redes sociais (Open Graph)
if (is_singular()) {
$post_id = get_the_ID();
$description = get_post_meta($post_id, '_meta_description', true)
?: wp_trim_words(get_the_excerpt(), 30);
$image = get_the_post_thumbnail_url($post_id, 'large');
echo '<meta property="og:title" content="' . esc_attr(get_the_title()) . '" />' . PHP_EOL;
echo '<meta property="og:description" content="' . esc_attr($description) . '" />' . PHP_EOL;
if ($image) {
echo '<meta property="og:image" content="' . esc_url($image) . '" />' . PHP_EOL;
}
}
}, 10);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 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.
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 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 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.
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.