term_updated_messagesхук-фильтрWP 3.7.0

Позволяет изменять сообщения, отображаемые при взаимодействии с терминами (рубриками, метками и так далее) на странице их создания и редактирования.

В фильтр по умолчанию приходит следующий массив (русская локализация):

Array
(
	[_item] => Array
		(
			[0] =>
			[1] => Элемент добавлен.
			[2] => Элемент удалён.
			[3] => Элемент обновлён.
			[4] => Элемент не добавлен.
			[5] => Элемент не обновлён.
			[6] => Элементы удалены.
		)

	[category] => Array
		(
			[0] =>
			[1] => Рубрика добавлена.
			[2] => Рубрика удалена.
			[3] => Рубрика обновлена.
			[4] => Рубрика не добавлена.
			[5] => Рубрика не обновлена.
			[6] => Рубрики удалены.
		)

	[post_tag] => Array
		(
			[0] =>
			[1] => Метка добавлена.
			[2] => Метка удалена.
			[3] => Метка обновлена.
			[4] => Метка не добавлена.
			[5] => Метка не обновлена.
			[6] => Метки удалены.
		)

)

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

add_filter( 'term_updated_messages', 'wp_kama_term_updated_messages_filter' );

/**
 * Function for `term_updated_messages` filter-hook.
 * 
 * @param array[] $messages Array of arrays of messages to be displayed, keyed by taxonomy name.
 *
 * @return array[]
 */
function wp_kama_term_updated_messages_filter( $messages ){

	// filter...
	return $messages;
}
$messages(массив)
The messages to be displayed.

Примеры

0

#1 Изменим сообщение "Рубрика обновлена"

add_filter( 'term_updated_messages', 'change_term_updated_messages' );

function change_term_updated_messages( $messages ) {
	$messages['category'][3] = 'Эта прекрасная рубрика обновлена';

	return $messages;
}
0

#2 Изменим сообщение при обновлении термина WooCommerce

По умолчанию будет выведено "Элемент обновлен", но на хуке term_updated_messages мы можем изменить данное сообщение на своё, например "Термин «{название атрибута}» обновлён".

add_filter( 'term_updated_messages', 'wc_term_updated_messages' );

function wc_term_updated_messages( $messages ) {
	global $post_type, $tag;

	if ( 'product' === $post_type && $tag ) {
		$messages['_item'][3] = "Термин «{$tag->name}» обновлен.";
	}

	return $messages;
}

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

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

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

В файле: /wp-admin/includes/edit-tag-messages.php
term_updated_messages
wp-admin/includes/edit-tag-messages.php 49
$messages = apply_filters( 'term_updated_messages', $messages );

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

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