get_taxonomy_labels() – Builds an object with all taxonomy labels out of a taxonomy object.

You appear to be a bot. Output may be restricted

Description

Builds an object with all taxonomy labels out of a taxonomy object.

Usage

$object = get_taxonomy_labels( $tax );

Parameters

$tax
( WP_Taxonomy ) required – Taxonomy object.
$name
( string ) required – General name for the taxonomy, usually plural. The same as and overridden by `$tax->label`. Default 'Tags'/'Categories'.
$singular_name
( string ) required – Name for one object of this taxonomy. Default 'Tag'/'Category'.
$search_items
( string ) required – Default 'Search Tags'/'Search Categories'.
$popular_items
( string ) required – This label is only used for non-hierarchical taxonomies. Default 'Popular Tags'.
$all_items
( string ) required – Default 'All Tags'/'All Categories'.
$parent_item
( string ) required – This label is only used for hierarchical taxonomies. Default 'Parent Category'.
$parent_item_colon
( string ) required – The same as parent_item`, but with colon `: in the end.
$name_field_description
( string ) required – Description for the Name field on Edit Tags screen. Default 'The name is how it appears on your site'.
$slug_field_description
( string ) required – Description for the Slug field on Edit Tags screen. Default '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 ) required – Description for the Parent field on Edit Tags screen. Default '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 ) required – Description for the Description field on Edit Tags screen. Default 'The description is not prominent by default; however, some themes may show it'.
$edit_item
( string ) required – Default 'Edit Tag'/'Edit Category'.
$view_item
( string ) required – Default 'View Tag'/'View Category'.
$update_item
( string ) required – Default 'Update Tag'/'Update Category'.
$add_new_item
( string ) required – Default 'Add New Tag'/'Add New Category'.
$new_item_name
( string ) required – Default 'New Tag Name'/'New Category Name'.
$separate_items_with_commas
( string ) required – This label is only used for non-hierarchical taxonomies. Default 'Separate tags with commas', used in the meta box.
$add_or_remove_items
( string ) required – This label is only used for non-hierarchical taxonomies. Default 'Add or remove tags', used in the meta box when JavaScript is disabled.
$choose_from_most_used
( string ) required – This label is only used on non-hierarchical taxonomies. Default 'Choose from the most used tags', used in the meta box.
$not_found
( string ) required – Default 'No tags found'/'No categories found', used in the meta box and taxonomy list table.
$no_terms
( string ) required – Default 'No tags'/'No categories', used in the posts and media list tables.
$filter_by_item
( string ) required – This label is only used for hierarchical taxonomies. Default 'Filter by category', used in the posts list table.
$items_list_navigation
( string ) required – Label for the table pagination hidden heading.
$items_list
( string ) required – Label for the table hidden heading.
$most_used
( string ) required – Title for the Most Used tab. Default 'Most Used'.
$back_to_items
( string ) required – Label displayed after a term has been updated.
$item_link
( string ) required – Used in the block editor. Title for a navigation link block variation. Default 'Tag Link'/'Category Link'.
$item_link_description
( string ) required – Used in the block editor. Description for a navigation link block variation. Default 'A link to a tag'/'A link to a category'. }

Returns

object { Taxonomy labels object. The first default value is for non-hierarchical taxonomies (like tags) and the second one is for hierarchical taxonomies (like categories).

Source

File name: wordpress/wp-includes/taxonomy.php


Lines:

1 to 47 of 47
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 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;
}
 

 View on GitHub View on Trac