get_taxonomy_labels() WP 3.0.0
Строит/возвращает объект со всеми заголовками указанной таксономии.
Это вспомогательная функция. Нужна чтобы заполнить недостающие заголовки в описании таксономии. Например, если не был указан заголовок для 'not_found' то он будет заменен на $tax->no_tagcloud
. Используйте в функции register_taxonomy().
Описание заголовков, которые указываются в массиве при регистрации таксономии смотрите в описании параметра labels в функции register_taxonomy().
Хуки из функции
Возвращает
Объект с заголовками таксономии. Базовые значения по умолчанию устанавливаются всем таксономиям, при этом дефолтные значения отличаются для древовидных и не древовидных таксономий.
Возможные значения массива:
-
name
Имя таксономии, обычно во множественном числе. По умолчанию _x( 'Post Tags', 'taxonomy general name' ) или _x( 'Categories', 'taxonomy general name' ); -
singular_name
Название для одного элемента этой таксономии. По умолчанию _x( 'Post Tag', 'taxonomy singular name' ) или _x( 'Category', 'taxonomy singular name' ); -
menu_name
Текст для названия меню. Эта строка обозначает название для пунктов меню. По умолчанию значение параметра name; -
search_items
Текст для поиска элемента таксономии. По умолчанию __( 'Search Tags' ) или __( 'Search Categories' ); -
popular_items
Текст для блока популярных элементов. __( 'Popular Tags' ) или null; -
all_items
Текст для всех элементов. __( 'All Tags' ) или __( 'All Categories' ); -
parent_item
Текст для родительского элемента таксономии. Этот аргумент не используется для не древовидных таксономий. По умолчанию null или __( 'Parent Category' ); -
parent_item_colon
Текст для родительского элемента таксономии, тоже что и parent_item но с двоеточием в конце. По умолчанию нет или __( 'Parent Category:' ); -
edit_item
Текст для редактирования элемента. По умолчанию __( 'Edit Tag' ) или __( 'Edit Category' ); -
update_item
Текст для обновления элемента. По умолчанию __( 'Update Tag' ) или __( 'Update Category' ); -
add_new_item
Текст для добавления нового элемента таксономии. По умолчанию __( 'Add New Tag' ) или __( 'Add New Category' ); -
view_item
Текст для просмотра термина таксономии. По умолчанию: "Посмотреть метку", "Посмотреть категорию". Используется например, в админ баре (тулбаре). -
new_item_name
Текст для создания нового элемента таксономии. По умолчанию __( 'New Tag Name' ) или __( 'New Category Name' ); -
separate_items_with_commas
Текст описывающий, что элементы нужно разделять запятыми (для блога в админке). Не работает для древовидного типа. По умолчанию __( 'Separate tags with commas' ) или null; -
add_or_remove_items
Текст для "удаления или добавления элемента", который используется в блоке админке, при отключенном javascript. Не действует для древовидных таксономий. По умолчанию __( 'Add or remove tags' ) или null; -
choose_from_most_used
текст для блога при редактировании поста "выберите из часто используемых". Не используется для древовидных таксономий. По умолчанию __( 'Choose from the most used tags' ) или null; -
popular_items
Текст для поиска популярных терминов. Этот параметр не используется для древовидных таксономий. По умолчанию: "Популярные метки" или null. -
separate_items_with_commas
Текст говорящий о том, что термины (метки) нужно разделять запятыми. Не используется для древовидных таксономий. По умолчанию: "Разделяйте метки запятыми" или null. -
add_or_remove_items
Текст для добавления или удаления терминов. Не используется для древовидных типов. По умолчанию: "Добавить или удалить метки". или null. -
choose_from_most_used
Текст "Выбрать из часто используемых". Не используется для древовидных типов. -
not_found
Текст "не найдено", который отображается, если при клике на часто используемые ни один термин не был найден. -
no_terms
Используется в таблицах записей и медиафайлов. По умолчанию 'No tags'/'No categories'. -
items_list_navigation
Текст для таблицы пагинации, для скрытого заголовка. -
items_list
Текст для скрытого заголовка таблицы. -
most_used
Текст для вкладки "Часто используемые". С версии 4.9. - back_to_items
Текст который будет показан после обновления термина. С версии 4.9.
Использование
get_taxonomy_labels( $tax );
- $tax(объект/WP_Taxonomy) (обязательный)
- Объект таксономии.
Примеры
#1 Демонстрация работы
$tax = get_taxonomy('category'); $labels = get_taxonomy_labels( $tax ); print_r( $labels ); /* Получим: stdClass Object ( [name] => Рубрики [singular_name] => Рубрика [search_items] => Поиск рубрик [popular_items] => [all_items] => Все рубрики [parent_item] => Родительская рубрика [parent_item_colon] => Родительская рубрика: [edit_item] => Изменить рубрику [view_item] => Просмотреть рубрику [update_item] => Обновить рубрику [add_new_item] => Добавить новую рубрику [new_item_name] => Название новой рубрики [separate_items_with_commas] => [add_or_remove_items] => [choose_from_most_used] => [not_found] => Рубрик не найдено. [no_terms] => Рубрик нет [menu_name] => Рубрики [name_admin_bar] => category ) */
Список изменений
С версии 3.0.0 | Введена. |
С версии 4.3.0 | Added the no_terms label. |
С версии 4.4.0 | Added the items_list_navigation and items_list labels. |
С версии 4.9.0 | Added the most_used and back_to_items labels. |