SEO Маяк

Функция 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;
}

Таблица изменений

function get_taxonomy_labels( $tax ) {
	$tax->labels = (array) $tax->labels;

	if ( isset( $tax->helps ) && empty( $tax->labels['separate_items_with_commas'] ) )
		$tax->labels['separate_items_with_commas'] = $tax->helps;

	if ( isset( $tax->no_tagcloud ) && empty( $tax->labels['not_found'] ) )
		$tax->labels['not_found'] = $tax->no_tagcloud;

	$nohier_vs_hier_defaults = array(
		'name' => array( _x( 'Tags', 'taxonomy general name' ), _x( 'Categories', 'taxonomy general name' ) ),
		'singular_name' => array( _x( 'Tag', 'taxonomy singular name' ), _x( 'Category', 'taxonomy singular name' ) ),
		'search_items' => array( __( 'Search Tags' ), __( 'Search Categories' ) ),
		'popular_items' => array( __( 'Popular Tags' ), null ),
		'all_items' => array( __( 'All Tags' ), __( 'All Categories' ) ),
		'parent_item' => array( null, __( 'Parent Category' ) ),
		'parent_item_colon' => array( null, __( 'Parent Category:' ) ),
		'edit_item' => array( __( 'Edit Tag' ), __( 'Edit Category' ) ),
		'view_item' => array( __( 'View Tag' ), __( 'View Category' ) ),
		'update_item' => array( __( 'Update Tag' ), __( 'Update Category' ) ),
		'add_new_item' => array( __( 'Add New Tag' ), __( 'Add New Category' ) ),
		'new_item_name' => array( __( 'New Tag Name' ), __( 'New Category Name' ) ),
		'separate_items_with_commas' => array( __( 'Separate tags with commas' ), null ),
		'add_or_remove_items' => array( __( 'Add or remove tags' ), null ),
		'choose_from_most_used' => array( __( 'Choose from the most used tags' ), null ),
		'not_found' => array( __( 'No tags found.' ), __( 'No categories found.' ) ),
		'no_terms' => array( __( 'No tags' ), __( 'No categories' ) ),
		'items_list_navigation' => array( __( 'Tags list navigation' ), __( 'Categories list navigation' ) ),
		'items_list' => array( __( 'Tags list' ), __( 'Categories list' ) ),
		/* translators: Tab heading when selecting from the most used terms */
		'most_used' => array( _x( 'Most Used', 'tags' ), _x( 'Most Used', 'categories' ) ),
		'back_to_items' => array( __( '← Back to Tags' ), __( '← Back to Categories' ) ),
	);
	$nohier_vs_hier_defaults['menu_name'] = $nohier_vs_hier_defaults['name'];

	$labels = _get_custom_object_labels( $tax, $nohier_vs_hier_defaults );

	$taxonomy = $tax->name;

	$default_labels = clone $labels;

	/**
	 * Filters the labels of a specific taxonomy.
	 *
	 * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
	 *
	 * @since 4.4.0
	 *
	 * @see get_taxonomy_labels() for the full list of taxonomy labels.
	 *
	 * @param object $labels Object with labels for the taxonomy as member variables.
	 */
	$labels = apply_filters( "taxonomy_labels_{$taxonomy}", $labels );

	// Ensure that the filtered labels contain all required default values.
	$labels = (object) array_merge( (array) $default_labels, (array) $labels );

	return $labels;
}