get_taxonomy_labels() — описание функции WordPress на русском

Сигнатура

get_taxonomy_labels( WP_Taxonomy $tax ): object

Описание

Формирует объект со всеми метками таксономии из объекта таксономии.

Параметры

$tax WP_Taxonomy обязательный

Объект таксономии.

Возвращаемое значение

object

name stringОбщее имя таксономии, обычно во множественном числе. То же, что и $tax->label, и переопределяется им. По умолчанию 'Tags'/'Categories'. singular_name stringИмя одного объекта этой таксономии. По умолчанию 'Tag'/'Category'. search_items stringПо умолчанию «Search Tags»/«Search Categories». popular_items stringЭта метка используется только для неиерархических таксономий. По умолчанию «Popular Tags». all_items stringПо умолчанию «All Tags»/«All Categories». parent_item stringЭта метка используется только для иерархических таксономий. По умолчанию «Parent Category». parent_item_colon stringТо же, что parent_item, но с двоеточием : в конце. name_field_description stringОписание поля Name на экране Edit Tags. По умолчанию «The name is how it appears on your site». slug_field_description stringОписание поля Slug на экране Edit Tags. По умолчанию «The “slug” is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens». parent_field_description stringОписание поля Parent на экране Edit Tags. По умолчанию «Assign a parent term to create a hierarchy. The term Jazz, for example, would be the parent of Bebop and Big Band». desc_field_description stringОписание поля Description на экране Edit Tags. По умолчанию «The description is not prominent by default; however, some themes may show it». edit_item stringПо умолчанию «Edit Tag»/«Edit Category». view_item stringПо умолчанию «View Tag»/«View Category». update_item stringПо умолчанию «Update Tag»/«Update Category». add_new_item stringПо умолчанию «Add Tag»/«Add Category». new_item_name stringПо умолчанию «New Tag Name»/«New Category Name». template_name stringПо умолчанию «Tag Archives»/«Category Archives». separate_items_with_commas stringЭта метка используется только для неиерархических таксономий. По умолчанию «Separate tags with commas», используется в метабоксе. add_or_remove_items stringЭта метка используется только для неиерархических таксономий. По умолчанию «Add or remove tags», используется в метабоксе, когда JavaScript отключён. choose_from_most_used stringЭта метка используется только для неиерархических таксономий. По умолчанию «Choose from the most used tags», используется в метабоксе. not_found stringПо умолчанию «No tags found»/«No categories found», используется в метабоксе и таблице списка таксономии. no_terms stringПо умолчанию «No tags»/«No categories», используется в таблицах списка записей и медиа. filter_by_item stringЭта метка используется только для иерархических таксономий. По умолчанию «Filter by category», используется в таблице списка записей. items_list_navigation stringМетка для скрытого заголовка постраничной навигации таблицы. items_list stringМетка для скрытого заголовка таблицы. most_used stringЗаголовок вкладки Most Used. По умолчанию «Most Used». back_to_items stringМетка, отображаемая после обновления термина. item_link stringИспользуется в блочном редакторе. Заголовок вариации блока ссылки навигации. По умолчанию «Tag Link»/«Category Link». item_link_description stringИспользуется в блочном редакторе. Описание вариации блока ссылки навигации. По умолчанию «A link to a tag»/«A link to a category».

Исходный код

wp-includes/taxonomy.php:707

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 );

	if ( ! isset( $tax->labels->template_name ) && isset( $labels->singular_name ) ) {
		/* translators: %s: Taxonomy name. */
		$labels->template_name = sprintf( _x( '%s Archives', 'taxonomy template name' ), $labels->singular_name );
	}

	$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.
	 *
	 * Possible hook names include:
	 *
	 *  - `taxonomy_labels_category`
	 *  - `taxonomy_labels_post_tag`
	 *
	 * @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;
}

История изменений

Версия	Описание
6.6.0	Added the template_name label.
5.9.0	Added the name_field_description, slug_field_description, parent_field_description, and desc_field_description labels.
5.8.0	Added the item_link and item_link_description labels.
5.7.0	Added the filter_by_item label.
4.9.0	Added the most_used and back_to_items labels.
4.4.0	Added the items_list_navigation and items_list labels.
4.3.0	Added the no_terms label.
3.0.0	Introduced.