» » get_taxonomy_labels()
logotip

get_taxonomy_labels()

Последнее изменение: 2018-11-20

Функция 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] => 
)
*/

Описание массива


name

Название (главный заголовок) таксономии, не путать с именем таксономии для регистрации (отображается на главной странице таксономии в админке). Обычно во множественном числе. Взаимозаменяется со значением аргумента label.

По умолчанию: Метки (для не древовидной) и Рубрики (для древовидной).



singular_name

Заголовок в единственном числе. Если аргумент не был указан, то его значение заменяется значением аргумента name..

По умолчанию: Метка / Рубрика.



search_items

Текст для кнопки поиска по таксономии.

По умолчанию: Поиск меток / Поиск рубрик.


popular_items

Текст для популярных меток. В объекте древовидной таксономии заменяется аргументом all_items.

По умолчанию: Популярные метки / Все рубрики.



parent_item

Текст для выбора родительских термов таксономии. В объекте не древовидной таксономии будет заменен аргументом edit_item.

По умолчанию: Изменить метку / Родительская рубрика.



parent_item_colon

Текст для родительского терма с двоеточием на конце. В объекте не древовидной таксономии заменяется аргументом edit_item.

По умолчанию: Изменить метку / Родительская рубрика:.



all_items

Текст для всего списка термов. В объекте для древовидной таксономии заменяет аргумент popular_items. Если аргумент не был указан, то его значение заменяется значением аргумента name.

По умолчанию: Все метки / Все рубрики.



edit_item

Заголовок для страницы редактирования терма. В объекте для не древовидной таксономии заменяет аргументы: parent_item и parent_item_colon.

По умолчанию: Изменить метку / Изменить рубрику.



view_item

Текст для уведомления «Посмотреть страницу» Выводится в админке в вернем тулбаре.

По умолчанию: Посмотреть метку / Посмотреть рубрику.



update_item

Текст для обновления терма через опцию «Свойства».

По умолчанию: Обновить метку / Обновить рубрику.



add_new_item

Текст для опции добавления нового терма.

По умолчанию: Добавить новую метку / Добавить новую рубрику.



new_item_name

Текст для названия нового терма.

По умолчанию: Название новой метки / Название новой рубрики.



separate_items_with_commas

Текст для уведомления о правиле добавления меток на странице редактирования записи. В объекте для древовидной таксономии заменяется аргументом not_found.

По умолчанию: Метки разделяются запятыми / Рубрик не найдено.



add_or_remove_items

Текст для добавления/удаления меток. В объекте для древовидной таксономии заменяется аргументом not_found.

По умолчанию: Добавить или удалить метки / Рубрик не найдено.



choose_from_most_used

Текст для опции выбора часто используемых меток. В объекте для древовидной таксономии заменяется аргументом not_found.

По умолчанию: Выбрать из часто используемых меток / Рубрик не найдено.



not_found

Текст для уведомления, когда термы не найдены. В объекте для древовидной таксономии заменяет аргументы: separate_items_with_commas, add_or_remove_items и choose_from_most_used.

По умолчанию: Меток не найдено / Рубрик не найдено.



no_terms

Текст для уведомления, когда еще не создано ни одного терма.

По умолчанию: Меток нет / Рубрик нет.



items_list_navigation

Текст для скрытого заголовка в опции навигации по таксономии.

По умолчанию: Навигация по списку меток / Навигация по списку рубрик.



items_list

Текст для скрытого заголовка общей таблицы со списком термов (в админке, на главной странице таксономии).

По умолчанию: Список меток / Список рубрик.



most_used

Текст для опции выбора часто используемых термов.

По умолчанию: Часто используемые / Часто используемые.



back_to_items

Текст для ссылки, ведущей на главную страницу таксономии (отображается в уведомлении при обновлении терма).

По умолчанию: ← Назад к меткам / ← Назад к рубрикам.


menu_name

Текст для меню в админке. Если аргумент не был указан при регистрации таксономии, то его значение будет заменено на значение аргумента name.

По умолчанию: Метки / Рубрики.



name_admin_bar

Название для админ бара. Если аргумент не указан, то его значение будет заменено на значение аргумента singular_name.

По умолчанию: Нет / category.



archives

Название для архива. Если аргумент не указан, то его значение будет заменено на значение аргумента 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 (Развернуть)

Оставить комментарий

Внимание комментатор! Прежде чем вставить: HTML, JavaScript или PHP код в свой комментарий, преобразуй его в html сущность!

Subscribe without commenting

» Подписаться на комментарии по RSS