Fonction et utilisation de get_the_taxonomies() dans WordPress

Question

Réponses ( 1 )

  1. La fonction get_the_taxonomies() dans WordPress est un outil puissant pour récupérer et afficher les taxonomies associées à un article spécifique. Voici une explication détaillée de la fonction et un exemple de son utilisation :

    Fonction :

    get_the_taxonomies( int|WP_Post $post, array $args = array() ): string[]

    Description :

    Cette fonction est conçue pour récupérer toutes les taxonomies (telles que les catégories, les étiquettes ou les taxonomies personnalisées) associées à un article donné. Elle est particulièrement utile dans "The Loop", qui est la manière de WordPress d'afficher des articles à travers un processus répété. La fonction renvoie un tableau de taxonomies, chacune formatée avec des liens vers leurs pages de taxonomie respectives et les noms de taxonomie.

    Paramètres :

    $post (int|WP_Post, facultatif) :

    Description : Ce paramètre peut être soit l'ID d'un article, soit un objet WP_Post.

    Par défaut : S'il n'est pas spécifié, la fonction utilise la variable globale $post, qui représente l'article actuel dans The Loop.

    $args (tableau, facultatif) :

    Description : Un tableau d'arguments pour contrôler la façon dont la liste des taxonomies est formatée.

    Paramètres clés :

    • template : Un modèle de chaîne pour afficher chaque libellé de taxonomie et sa liste de termes. Le format par défaut est "Libellé : Termes."
    • term_template : Un modèle pour afficher chaque terme dans la liste de taxonomie. Par défaut, il montre le nom du terme lié à sa page d'archive.

      Par défaut : Un tableau vide array().

    Retour :

    string[] : Cette fonction renvoie un tableau de chaînes. Chaque chaîne est une liste formatée d'une seule taxonomie et de ses termes, selon les arguments spécifiés.

    Exemple d'utilisation :

    // À l'intérieur d'une boucle WordPress
    if ( have_posts() ) {
        while ( have_posts() ) {
            the_post();
            
            // Récupérer les taxonomies pour l'article actuel
            $taxonomies = get_the_taxonomies( get_the_ID(), array( 
                'template' => '<strong>%s :</strong> %l', 
                'term_template' => '<a href="%1$s">%2$s</a>' 
            ));
            // Afficher les taxonomies
            foreach ( $taxonomies as $taxonomy ) {
                echo '<p>' . $taxonomy . '</p>';
            }
        }
    }
    

    Dans cet exemple, get_the_taxonomies() est utilisé à l'intérieur de The Loop pour récupérer les taxonomies de chaque article. Le format de sortie est personnalisé avec le paramètre $args, où %s représente le libellé de la taxonomie et %l représente la liste des termes. Chaque terme est lié à sa page d'archive. Cela affichera chaque taxonomie et ses termes pour l'article actuel de manière formatée.

Laisser une réponse