get_taxonomy_labels() │ WP 3.0.0

Будує/повертає об’єкт із усіма заголовками зазначеної таксономії.

Це допоміжна функція. Потрібна щоб заповнити заголовки в описі таксономії. Наприклад, якщо не було вказано заголовок для ‘not_found’, то він буде замінений на $tax->no_tagcloud. Використовуйте функції register_taxonomy() .

Опис заголовків, які вказуються в масиві при реєстрації таксономії, дивіться в описі параметра labels у функції register_taxonomy() .

Працює на основі:
_get_custom_object_labels()

Хуки з функції

taxonomy_labels_(taxonomy)

taxonomy_labels_category

taxonomy_labels_post_tag

Повертає

Объект. Об’єкт із заголовками таксономії. Базові значення за замовчуванням встановлюються всім таксономіям, при цьому дефолтні значення відрізняються для деревоподібних та не деревоподібних таксономій.

Можливі значення масиву:

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 (WP 4.9): Текст для вкладки “Часто використовувані”.
back_to_items (WP 4.9): Текст, який буде показано після оновлення терміна.
filter_by_item (WP 5.7): Використовується тільки для деревоподібних таксономій, адмінці, в таблиці записів (posts list table).

За замовчуванням: ‘Filter by category’ .
item_link (WP 5.8): Текст для посилання, наприклад: ‘Tag Link’ або ‘Category Link’.
item_link_description (WP 5.8): Текст для опису посилання, наприклад: ‘A link to a tag.’ або ‘A link to a category.’.
name_field_description (WP 5.9): Опис поля
Nameна сторінці редагування терміна (Edit Tags screen).

За замовчуванням: ‘Назва – це те, як вона відображається на вашому сайті’.
slug_field_description (WP 5.9): Опис поля
Slugна сторінці редагування терміна (Edit Tags screen).

Типово: ‘Ярлик “slug” – це зручна для URL версія назви. Зазвичай містить лише малі літери, цифри та дефіси.’.
parent_field_description (WP 5.9): Опис поля
Parentна сторінці редагування терміна (Edit Tags screen).

За промовчанням: ‘Призначте батьківський термін для створення ієрархії. Наприклад, термін Jazz є батьком термінів Bebop і Big Band.
desc_field_description (WP 5.9): Опис поля
Descriptionна сторінці редагування терміна (Edit Tags screen).

За замовчуванням: ‘За замовчуванням опис не відображається, однак деякі теми можуть відображатися.’.

Використання

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.
З версії 5.7.0	Added the `filter_by_item` label.
З версії 5.8.0	Added the `item_link` and `item_link_description` labels.
З версії 5.9.0	Added `name_field_description` , `slug_field_description` , `parent_field_description` , і `desc_field_description` labels.

get taxonomy labels ^{WP 6.0.2}

wp-includes/taxonomy.php

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 = WP_Taxonomy::get_default_labels(); $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 labels of a specific taxonomy. * * The dynamickа порція 'hook name', `$taxonomy`, refers to the taxonomy slug. * * Possible hook names include: * * - `taxonomy_labels_category` * - `taxonomy_labels_post_tag` * * @ Since 4.4.0 * * @see get_taxonomy_labels() for full list of taxonomy labels. * * @param object $labels Object with labels for 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; }