Функция get_taxonomy_labels() создает/возвращает объект из настроек служебных заголовков, указанных в массиве $labels при регистрации таксономии (см. register_taxonomy()).
Функция является вспомогательной и обслуживает цепочку заменяемости/взаимодействия аргументов переданных в функцию при регистрации таксономии.
Работает на основе функции: _get_custom_object_labels() (служебная)
Применение:
get_taxonomy_labels( $tax_object );
Где:
$tax_object — объект таксономии (обязательно).
Возвращаемые значения
Возвращает объект служебных текстов, в котором все недостающие/неуказанные или неподходящие элементы будут заменены значениями по умолчанию.
Функция будет создавать/возвращать разные объекты в зависимости от типа указанной таксономии (древовидная или не древовидная).
Возвращает false если таксономия не найдена.
Пример работы
$taxonomy = get_taxonomy('category'); $labels = get_taxonomy_labels($taxonomy); print_r($labels); /* Получим объект заголовков древовидной таксономии category 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] => Рубрик нет [items_list_navigation] => Навигация по списку рубрик [items_list] => Список рубрик [most_used] => Часто используемые [back_to_items] => ← Назад к рубрикам [menu_name] => Рубрики [name_admin_bar] => category [archives] => Все рубрики ) */ $taxonomy = get_taxonomy('tag'); $labels = get_taxonomy_labels($taxonomy); print_r($labels); /* Получим объект заголовков не древовидной таксономии tag 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] => Меток нет [items_list_navigation] => Навигация по списку меток [items_list] => Список меток [most_used] => Часто используемые [back_to_items] => ← Назад к меткам [menu_name] => Метки [name_admin_bar] => ) */
Описание массива
Название (главный заголовок) таксономии, не путать с именем таксономии для регистрации (отображается на главной странице таксономии в админке). Обычно во множественном числе. Взаимозаменяется со значением аргумента label.
По умолчанию: Метки (для не древовидной) и Рубрики (для древовидной).
Заголовок в единственном числе. Если аргумент не был указан, то его значение заменяется значением аргумента name..
По умолчанию: Метка / Рубрика.
Текст для кнопки поиска по таксономии.
По умолчанию: Поиск меток / Поиск рубрик.
Текст для популярных меток. В объекте древовидной таксономии заменяется аргументом all_items.
По умолчанию: Популярные метки / Все рубрики.
Текст для выбора родительских термов таксономии. В объекте не древовидной таксономии будет заменен аргументом edit_item.
По умолчанию: Изменить метку / Родительская рубрика.
Текст для родительского терма с двоеточием на конце. В объекте не древовидной таксономии заменяется аргументом edit_item.
По умолчанию: Изменить метку / Родительская рубрика:.
Текст для всего списка термов. В объекте для древовидной таксономии заменяет аргумент popular_items. Если аргумент не был указан, то его значение заменяется значением аргумента name.
По умолчанию: Все метки / Все рубрики.
Заголовок для страницы редактирования терма. В объекте для не древовидной таксономии заменяет аргументы: parent_item и parent_item_colon.
По умолчанию: Изменить метку / Изменить рубрику.
Текст для уведомления «Посмотреть страницу» Выводится в админке в вернем тулбаре.
По умолчанию: Посмотреть метку / Посмотреть рубрику.
Текст для обновления терма через опцию «Свойства».
По умолчанию: Обновить метку / Обновить рубрику.
Текст для опции добавления нового терма.
По умолчанию: Добавить новую метку / Добавить новую рубрику.
Текст для названия нового терма.
По умолчанию: Название новой метки / Название новой рубрики.
Текст для уведомления о правиле добавления меток на странице редактирования записи. В объекте для древовидной таксономии заменяется аргументом not_found.
По умолчанию: Метки разделяются запятыми / Рубрик не найдено.
Текст для добавления/удаления меток. В объекте для древовидной таксономии заменяется аргументом not_found.
По умолчанию: Добавить или удалить метки / Рубрик не найдено.
Текст для опции выбора часто используемых меток. В объекте для древовидной таксономии заменяется аргументом not_found.
По умолчанию: Выбрать из часто используемых меток / Рубрик не найдено.
Текст для уведомления, когда термы не найдены. В объекте для древовидной таксономии заменяет аргументы: separate_items_with_commas, add_or_remove_items и choose_from_most_used.
По умолчанию: Меток не найдено / Рубрик не найдено.
Текст для уведомления, когда еще не создано ни одного терма.
По умолчанию: Меток нет / Рубрик нет.
Текст для скрытого заголовка в опции навигации по таксономии.
По умолчанию: Навигация по списку меток / Навигация по списку рубрик.
Текст для скрытого заголовка общей таблицы со списком термов (в админке, на главной странице таксономии).
По умолчанию: Список меток / Список рубрик.
Текст для опции выбора часто используемых термов.
По умолчанию: Часто используемые / Часто используемые.
Текст для ссылки, ведущей на главную страницу таксономии (отображается в уведомлении при обновлении терма).
По умолчанию: ← Назад к меткам / ← Назад к рубрикам.
Текст для меню в админке. Если аргумент не был указан при регистрации таксономии, то его значение будет заменено на значение аргумента name.
По умолчанию: Метки / Рубрики.
Название для админ бара. Если аргумент не указан, то его значение будет заменено на значение аргумента singular_name.
По умолчанию: Нет / category.
Название для архива. Если аргумент не указан, то его значение будет заменено на значение аргумента all_items.
По умолчанию: Нет / Рубрики.
На заметку! Большая часть замен осуществляется в основной функции _get_custom_object_labels() и уже после массив передается непосредственно в get_taxonomy_labels().
Хуки функции
В арсенале функции get_taxonomy_labels() есть интересный хук-фильтр:
taxonomy_labels_{$taxonomy}
Где:
{$taxonomy} — имя зарегистрированной таксономии (например: category}.
Применение:
add_filter( 'taxonomy_labels_{$taxonomy}, 'taxonomy_labels_filter' ); function taxonomy_labels_filter( $labels ){ //Какой-то сценарий return $labels; }
Изменим заголовок в меню админки для стандартных категорий с «Рубрики» на «Разделы»:
add_filter( 'taxonomy_labels_'.'category', 'taxonomy_labels_wordpress_filter' ); function taxonomy_labels_wordpress_filter( $labels ){ $lab = array( 'menu_name' => 'Разделы' ); return $lab; }
Таблица изменений
Версия | Дата | Описание |
---|---|---|
3.0.0 | 17.07.2010 | Внедрение |
4.3.0 | 18.08.2015 | Введен аргумент no_terms. |
4.4.0 | 08.12.2015 | Введены аргументы items_list_navigation и items_list. |
4.9.0 | 16.11.2017 | Введены аргументы most_used и back_to_items. |
Файл: wp-includes/taxpnomy.php (Развернуть)