get_taxonomy( string $taxonomy )

Retourne l'objet d'une taxonomie en donnant son nom.

Paramètre

$taxonomy(string)requis

Nom de l'objet de la taxonomie.

Description / Informations supplémentaires

Vérifie en premier si la taxonomie existe puis retourne l'objet.

Note : ne retourne pas une liste associée à la taxonomie donnée. Pour cela utiliser plutôt la fonction get_terms() ou wp_list_categories() qui retourne une liste HTML de catégories.

Retourne

(WP_Taxonomy|bool) L'objet de la taxonomie ou false si elle n'existe pas.

Déclaration et structure de la fonction get_taxonomy()

function get_taxonomy( $taxonomy ) {
    global $wp_taxonomies;

    if ( ! taxonomy_exists( $taxonomy ) ) {
        return false;
    }

    return $wp_taxonomies[ $taxonomy ];
}
taxonomy_exists()

Détermine si un nom de taxonomie existe.

Où est utilisée la fonction get_taxonomy() dans le CMS WordPress

Exemple

$category_object= get_taxonomy( 'category' );
print_r( $category_object);

// Affiche :
WP_Taxonomy Object
(
    [name] => category
    [label] => Catégories
    [labels] => stdClass Object
        (
            [name] => Catégories
            [singular_name] => Catégorie
            [search_items] => Rechercher des catégories
            [popular_items] => 
            [all_items] => Toutes
            [parent_item] => Catégorie parente
            [parent_item_colon] => Catégorie parente :
            [edit_item] => Modifier la catégorie
            [view_item] => Voir la catégorie
            [update_item] => Mettre à jour la catégorie
            [add_new_item] => Ajouter une nouvelle catégorie
            [new_item_name] => Nom de la nouvelle catégorie
            [separate_items_with_commas] => 
            [add_or_remove_items] => 
            [choose_from_most_used] => 
            [not_found] => Aucune catégorie trouvée.
            [no_terms] => Aucune catégorie
            [items_list_navigation] => Navigation de la liste des catégories
            [items_list] => Liste des catégories
            [most_used] => Plus utilisés
            [back_to_items] => ← Revenir aux catégories
            [menu_name] => Catégories
            [name_admin_bar] => category
        )

    [description] => 
    [public] => 1
    [publicly_queryable] => 1
    [hierarchical] => 1
    [show_ui] => 1
    [show_in_menu] => 1
    [show_in_nav_menus] => 1
    [show_tagcloud] => 1
    [show_in_quick_edit] => 1
    [show_admin_column] => 1
    [meta_box_cb] => post_categories_meta_box
    [meta_box_sanitize_cb] => taxonomy_meta_box_sanitize_cb_checkboxes
    [object_type] => Array
        (
            [0] => post
        )

    [cap] => stdClass Object
        (
            [manage_terms] => manage_categories
            [edit_terms] => edit_categories
            [delete_terms] => delete_categories
            [assign_terms] => assign_categories
        )

    [rewrite] => Array
        (
            [with_front] => 
            [hierarchical] => 1
            [ep_mask] => 512
            [slug] => ffx
        )

    [query_var] => category_name
    [update_count_callback] => 
    [show_in_rest] => 1
    [rest_base] => categories
    [rest_controller_class] => WP_REST_Terms_Controller
    [default_term] => 
    [rest_controller] => 
    [_builtin] => 1
)

Sources

Codex WordPress : get_taxonomy()

Autres fonctions dans le même fichier : wp-includes/taxonomy.php

Retour