publish_post │ хук-событие │ WP 2.3.0

Позволяет сделать что-либо, когда пост (запись типа post) публикуется или обновляется.

wp_insert_post() вызывает этот хук всегда. Поэтому, если нужно делать что-либо один раз, только когда пост публикуется (а не обновляется), используйте:

• Хуки из семейства (old_status)_to_(new_status):

  • new_to_publish - при первой публикации новой записи, например если запись добавляется функцией wp_insert_post().
  • auto-draft_to_publish - при первой публикации новой записи из админки WP.
  • draft_to_publish - при публикации, сохраненной записи.
  • future_to_publish - при публикации запланированной записи.
• Или хук transition_post_status - срабатывает при любом обновлении записи или смене статуса.

Использование

add_action( 'publish_post', 'wp_kama_publish_post_action', 10, 3 );

/**
 * Function for `publish_post` action-hook.
 * 
 * @param int     $post_id    Post ID.
 * @param WP_Post $post       Post object.
 * @param string  $old_status Old post status.
 *
 * @return void
 */
function wp_kama_publish_post_action( $post_id, $post, $old_status ){

	// action...
}

$post_id(int)

ID поста.

$post(WP_Post)

Объект поста WP_Post.

$old_status(строка) (WP 5.9.0)

Старый статус поста.

Примеры

add_action( 'publish_post', 'publish_post_action', 10, 2 );

function publish_post_action( $post_id, $post ){

	// делаем что-то при публикации поста
}

Добавить свой пример