get_taxonomy_labels() │ WP 3.0.0

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

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

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

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

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

Повертає

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

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

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) (обов’язковий)
Об’єкт таксономії.

Приклади

0

#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.0Added the no_terms label.
З версії 4.4.0Added the items_list_navigation and items_list labels.
З версії 4.9.0Added the most_used and back_to_items labels.
З версії 5.7.0Added the filter_by_item label.
З версії 5.8.0Added the item_link and item_link_description labels.
З версії 5.9.0Added 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;
}

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *