wp_insert_post │ хук-событие │ WP 2.0.0

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

Вызывается после событий save_post_{$post_type} и save_post, но до wp_after_insert_post.

Событие не вызывается для вложений при сохранении через wp_insert_post().

Если нужно обрабатывать только определённый тип записи, используйте событие save_post_{$post_type}, например save_post_product.

Вызов wp_update_post() или wp_insert_post() внутри обработчика может рекурсивно вызвать это же событие.

wp_insert_post() очищает post_content, post_excerpt и post_content_filtered через wp_filter_post_kses(), если текущий пользователь не имеет возможности unfiltered_html. Заголовок дополнительно очищается через wp_filter_kses().

Это важно при запуске через WP-CLI, WP-Cron, неавторизованный REST-запрос или отдельный скрипт с подключённым wp-load.php. В таких случаях get_current_user_id() обычно возвращает 0, поэтому потенциально опасный HTML, включая <script>, <iframe> и запрещённые атрибуты, может быть удалён без предупреждения. Запись при этом успешно сохраняется, и функция не возвращает ошибку.

Перед сохранением установите пользователя с возможностью unfiltered_html, а затем восстановите исходного пользователя:

$original_user_id = get_current_user_id();

wp_set_current_user( 1 );

try {
	$post_id = wp_insert_post(
		[
			'post_title'   => 'Импортированная запись',
			'post_content' => $html_content,
			'post_status'  => 'publish',
		],
		true
	);
} finally {
	wp_set_current_user( $original_user_id );
}
Мультисайт

В мультисайте возможность unfiltered_html доступна только супер-админиам. Обычный администратор отдельного сайта её не имеет. Константа DISALLOW_UNFILTERED_HTML, установленная в true, запрещает эту возможность всем пользователям, включая администраторов и супер-админиов.

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

add_action( 'wp_insert_post', 'wp_kama_insert_post_action', 10, 3 );

/**
 * Function for `wp_insert_post` action-hook.
 * 
 * @param int     $post_id Post ID.
 * @param WP_Post $post    Post object.
 * @param bool    $update  Whether this is an existing post being updated.
 *
 * @return void
 */
function wp_kama_insert_post_action( $post_id, $post, $update ){
	// action...
}
$post_id(int)
ID сохранённой записи.
$post(WP_Post)
Объект сохранённой записи.
$update(bool)
true, если существующая запись была обновлена. false, если создана новая запись.

Примеры

#1 Выполнить действие после сохранения записи

Сохраним время обновления обычной записи в метаполе. Ревизии и автосохранения пропускаются.

add_action( 'wp_insert_post', 'wp_kama_after_insert_post', 10, 3 );

function wp_kama_after_insert_post( $post_id, $post, $update ) {
	if (
		'post' !== $post->post_type
		|| wp_is_post_revision( $post_id )
		|| wp_is_post_autosave( $post_id )
	) {
		return;
	}

	update_post_meta( $post_id, '_last_processed', time() );
}

#2 Обновить запись без рекурсивного вызова обработчика

Перед вызовом wp_update_post() временно отключим обработчик.

add_action( 'wp_insert_post', 'wp_kama_update_post_slug', 10, 3 );

function wp_kama_update_post_slug( $post_id, $post, $update ) {
	if ( ! $update || 'product' !== $post->post_type ) {
		return;
	}

	remove_action( 'wp_insert_post', 'wp_kama_update_post_slug', 10 );

	wp_update_post(
		[
			'ID'        => $post_id,
			'post_name' => sanitize_title( $post->post_title ),
		]
	);

	add_action( 'wp_insert_post', 'wp_kama_update_post_slug', 10, 3 );
}

Список изменений

С версии 2.0.0 Введена.

Где вызывается хук

wp_insert_post()
wp_insert_post
wp_publish_post()
wp_insert_post
WP_Customize_Manager::trash_changeset_post()
wp_insert_post
wp-includes/post.php 5297
do_action( 'wp_insert_post', $post_id, $post, $update );
wp-includes/post.php 5467
do_action( 'wp_insert_post', $post->ID, $post, true );
wp-includes/class-wp-customize-manager.php 3130
do_action( 'wp_insert_post', $post->ID, $post, true );

Где используется хук в WordPress

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