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 );