term_updated_messages
Позволяет изменять сообщения, отображаемые при взаимодействии с терминами (рубриками, метками и так далее) на странице их создания и редактирования.
В фильтр по умолчанию приходит следующий массив (русская локализация):
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.
Примеры
#1 Изменим сообщение "Рубрика обновлена"
add_filter( 'term_updated_messages', 'change_term_updated_messages' );
function change_term_updated_messages( $messages ) {
$messages['category'][3] = 'Эта прекрасная рубрика обновлена';
return $messages;
} #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 | Введена. |
Где вызывается хук
term_updated_messages
wp-admin/includes/edit-tag-messages.php 49
$messages = apply_filters( 'term_updated_messages', $messages );
