edit_post_(post_type) │ хук-событие │ WP 5.1.0

Срабатывает после обновления существующей записи указанного типа в БД.

Динамическую часть (post_type) нужно заменить названием типа записи:

• edit_post_post - обычные записи.
• edit_post_page - страницы.
• edit_post_book - произвольный тип book.

В wp_insert_post() событие вызывается при обновлении записи (когда указан ID) или через wp_update_post(). При вставке новой записи вызов пропускается.

Сохранение из редактора может быть обновлением уже созданного авто-черновика.

Хук не ограничен админкой. В ядре он также вызывается:

• В wp_publish_post(), в том числе при публикации по расписанию.
• В wp_update_comment_count_now() после пересчёта количества комментариев, даже если число не изменилось.
• В WP_Customize_Manager::trash_changeset_post() при перемещении набора изменений кастомайзера в корзину.

При обновлении через wp_insert_post() порядок событий такой:

• edit_post_(post_type)
• edit_post
• post_updated
• save_post_(post_type)
• save_post

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

add_action( 'edit_post_(post_type)', 'wp_kama_edit_post_type_action', 10, 2 );

/**
 * Function for `edit_post_(post_type)` action-hook.
 * 
 * @param int     $post_id Post ID.
 * @param WP_Post $post    Post object.
 *
 * @return void
 */
function wp_kama_edit_post_type_action( $post_id, $post ){
	// action...
}

$post_id(число)

ID обновлённой записи.

$post(WP_Post)

Объект записи. Чтобы получить его в коллбэке, передайте 2 в четвёртом аргументе add_action().

При вызове из wp_update_comment_count_now() объект загружен до обновления счётчика, поэтому $post->comment_count содержит прежнее значение.

Для актуальных данных повторно получите запись через get_post( $post_id ). Если нужны старое и новое значения счётчика, используйте wp_update_comment_count.

Примеры

#1 Сбросим кеш карточки книги после обновления

Предположим, данные карточки книги хранятся в транзиенте myplugin_book_{ID}. Удалим его после обновления записи типа book, чтобы при следующем обращении приложение заново сформировало карточку.

add_action( 'edit_post_book', 'myplugin_clear_book_cache' );

function myplugin_clear_book_cache( $post_id ) {
	delete_transient( 'myplugin_book_' . $post_id );
}