Hook save_post — Processar dados ao salvar um post – repositoriofull.studioway.com.br

Tipo Hooks de ação

Nome do erro Hook save_post — Processar dados ao salvar um post

Severidade Atenção

Desde WordPress 1.5

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

Causa

Plugins e temas frequentemente precisam executar lógica extra ao salvar posts, como sincronizar dados com APIs externas ou salvar campos personalizados.

Como resolver

Sempre verifique autosave, revisão e nonce antes de processar. Use save_post_{post_type} para limitar a ação a um tipo específico de post.

PHP

<?php
add_action('save_post_produto', function (int $post_id, WP_Post $post): void {
    // Ignora autosave
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) return;

    // Ignora revisões
    if (wp_is_post_revision($post_id)) return;

    // Verifica nonce
    if (!isset($_POST['_meu_nonce']) || !wp_verify_nonce($_POST['_meu_nonce'], 'salvar_produto_' . $post_id)) return;

    // Verifica permissão
    if (!current_user_can('edit_post', $post_id)) return;

    // Sanitiza e salva o campo
    $preco = filter_input(INPUT_POST, '_preco', FILTER_SANITIZE_NUMBER_FLOAT, FILTER_FLAG_ALLOW_FRACTION);
    if ($preco !== null) {
        update_post_meta($post_id, '_preco', (float) $preco);
    }
}, 10, 2);

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 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.

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.

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.

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.

Hook save_post — Processar dados ao salvar um post