post_updated_messages │ хук-фільтр │ WP 3.0.0

Дозволяє змінювати повідомлення, що виводяться під час оновлення або додавання запису (поста).

Під час редагування запису вгорі екрана виводяться повідомлення на кшталт: запис додано, запис оновлено тощо. Цей хук дозволяє доповнювати або повністю замінювати повідомлення.

Використання

add_filter( 'post_updated_messages', 'wp_kama_post_updated_messages_filter');

/**
 * Function for `post_updated_messages` filter-hook.
 *
 * @param array[] $messages Post updated messages. For defaults see `$messages` declarations above.
 *
 * @return array[]
 */
function wp_kama_post_updated_messages_filter( $messages ){

	// Filter...
	return $messages;
}

$messages
(масив)

Масив усіх можливих повідомлень. Масив розбитий на «підмасиви»: post, pageі attachment. І виглядає так:

Для російської локалі:

Array
(
	[post] => Array
		(
			[0] =>
			[1] => Запис оновлено. <a href="http://example.com/foo/">Переглянути запис</a>
			[2] => Поле змінено.
			[3] => Поле видалено.
			[4] => Запис оновлено.
			[5] =>
			[6] => Запис опубліковано. <a href="http://example.com/foo/">Переглянути запис</a>
			[7] => Запис збережено.
			[8] => Запис відправлено. <a target="_blank" href="http://example.com/foo/?preview=true">Переглянути</a>
			[9] => Запис заплановано на <strong>28.05.2016 3:43</strong>. <a target="_blank" href="http://example.com/foo/">Переглянути</a>
			[10] => Чернетка запису оновлено. <a target="_blank" href="http://example.com/foo/?preview=true">Переглянути</a>
		)

	[page] => Array
		(
			[0] =>
			[1] => Сторінку оновлено. <a href="http://example.com/foo/">Відкрити сторінку</a>
			[2] => Поле змінено.
			[3] => Поле видалено.
			[4] => Сторінку оновлено.
			[5] =>
			[6] => Сторінка опублікована. <a href="http://example.com/foo/">Відкрити сторінку</a>
			[7] => Сторінка збережена.
			[8] => Сторінку відправлено. <a target="_blank" href="http://example.com/foo/?preview=true">Переглянути</a>
			[9] => Сторінка запланована на <strong>28.05.2016 3:43</strong>. <a target="_blank" href="http://example.com/foo/">Переглянути</a>
			[10] => Чернетка сторінки оновлено. <a target="_blank" href="http://example.com/foo/?preview=true">Переглянути</a>
		)

	[attachment] => Array
		(
			[1] => Медіафайл оновлено.
			[2] => Медіафайл оновлено.
			[3] => Медіафайл оновлено.
			[4] => Медіафайл оновлено.
			[5] => Медіафайл оновлено.
			[6] => Медіафайл оновлено.
			[7] => Медіафайл оновлено.
			[8] => Медіафайл оновлено.
			[9] => Медіафайл оновлено.
			[10] => Медіафайл оновлено.
		)

)

Для англ локалі:

Array
(
	[post] => Array
		(
			[0] =>
			[1] => Post updated. <a href="http://example.com/foo/">View post</a>
			[2] => Custom field updated.
			[3] => Custom field deleted.
			[4] => Post updated.
			[5] =>
			[6] => Post published. <a href="http://example.com/foo/">View post</a>
			[7] => Post saved.
			[8] => Post submitted. <a target="_blank" href="http://example.com/foo/?preview=true">Preview post</a>
			[9] => Post scheduled for: <strong>May 28, 2016 @ 03:20</strong>. <a target="_blank" href="http://example.com/foo/">Preview post</a>
			[10] => Post draft updated. <a target="_blank" href="http://example.com/foo/?preview=true">Preview post</a>
		)

	[page] => Array
		(
			[0] =>
			[1] => Page updated. <a href="http://example.com/foo/">View page</a>
			[2] => Custom field updated.
			[3] => Custom field deleted.
			[4] => Page updated.
			[5] =>
			[6] => Page published. <a href="http://example.com/foo/">View page</a>
			[7] => Page saved.
			[8] => Page submitted. <a target="_blank" href="http://example.com/foo/?preview=true">Preview page</a>
			[9] => Page scheduled for: <strong>May 28, 2016 @ 03:20</strong>. <a target="_blank" href="http://example.com/foo/">Preview page</a>
			[10] => Page draft updated. <a target="_blank" href="http://example.com/foo/?preview=true">Preview page</a>
		)

	[attachment] => Array
		(
			[1] => Media file updated.
			[2] => Media file updated.
			[3] => Media file updated.
			[4] => Media file updated.
			[5] => Media file updated.
			[6] => Media file updated.
			[7] => Media file updated.
			[8] => Media file updated.
			[9] => Media file updated.
			[10] => Media file updated.
		)

)

Приклади

add_filter('post_updated_messages', function($messages){
	$messages['post'][6] .= 'Додаткове повідомлення.';

	return $messages;
});

Додати свій приклад