Gancho de publicação de post do WordPress

Uma das melhores partes do WordPress é seu sistema de ganchos/ações; esse sistema especial de ganchos é a maneira do WordPress de atribuir retornos de chamada quando ocorrem determinados eventos. Um evento sobre o qual parece haver muita confusão é qual gancho usar para detectar quando uma postagem é inicialmente publicada. Há o publish_post mas ele é acionado quando o usuário clica no botão “Update” (Atualizar) depois que uma postagem já foi publicada; isso não é o ideal.

Vasculhe a documentação e os fóruns do WordPress e você certamente verá uma dúzia de outras soluções, mas nenhuma funciona tão bem quanto a transition_post_status hook:

// Add the hook action
add_action('transition_post_status', 'send_new_post', 10, 3);

// Listen for publishing of a new post
function send_new_post($new_status, $old_status, $post) {
  if('publish' === $new_status && 'publish' !== $old_status && $post->post_type === 'post') {
    // Do something!
  }
}

O transition_post_status ocorre quando uma postagem passa de um status para outro; o senhor pode conferir o lista de status de postagens para ver outros valores possíveis. Também adicionei um post_type para garantir que o post seja um post de blog e não uma página.

Ufa, demorei um pouco para encontrar o que eu precisava aqui – espero que isso poupe o senhor de muita pesquisa e dor!