WordPress: Comment créer vos propres taxonomies WordPress personnalisées – SitePoint

WordPress: Comment créer vos propres taxonomies WordPress personnalisées - SitePoint

Ce didacticiel vous aidera à décrire tout ce que vous devez savoir en matière de taxonomies .

Nous commencerons par discuter de ce que sont les taxonomies, comment elles peuvent interagir et pourquoi elles sont importantes.

Plus loin dans le didacticiel, nous passerons par le processus étape par étape de création de vos propres taxonomies personnalisées.

À la fin, vous devriez avoir une bonne compréhension de ce que sont les taxonomies et comment vous pouvez tirer parti de vos propres taxonomies personnalisées pour répondre aux besoins de votre site Web.

Que sont les taxonomies ?

Les taxonomies, dans leur sens le plus simple, sont un moyen de regrouper des éléments connexes en utilisant un ou plusieurs ensembles de mots.

utilise des taxonomies pour fournir un mécanisme simple pour regrouper vos publications et pages. Prêt à l’emploi, est livré avec deux principaux types de taxonomies:

Ces deux taxonomies vous permettent de regrouper facilement vos publications à l’aide de noms / regroupements qui ont du sens pour vous et vos lecteurs. Par exemple, vous pouvez créer une nouvelle catégorie appelée « En vedette » à laquelle vous pouvez ensuite attribuer des articles spécifiques.

Lorsque vous créez une catégorie ou une étiquette, vous créez un «terme» dans une «taxonomie». C’est utile à savoir: les catégories et les balises ne sont que l’implémentation par défaut de . Vous pouvez créer vos propres «taxonomies» avec des «conditions» adaptées à vos besoins.

Catégories et balises Zones d’administration

crée automatiquement des zones d’administration pour que vous puissiez facilement ajouter vos tags et catégories. Ces zones d’administration sont situées dans le menu ‘Publications’ en tant que sous-menus.

WordPress Taxonomies_Image 1

Les écrans d’administration des catégories et des tags se ressemblent, vous permettant d’ajouter facilement de nouveaux termes à votre site Web.

Taxonomies WordPress_Image 2

Attribution de catégories et de balises à vos messages

La façon la plus simple d’attacher vos catégories et vos balises à votre publication est via l’éditeur .

Lorsque vous modifiez votre article / page, vous remarquerez une métabox contenant vos catégories et tags. Ces cases apparaissent souvent sous votre métabox « publier ». Ces cases sont celles que vous devrez utiliser pour attribuer vos termes au message actuellement modifié.

Taxonomies WordPress_Image 3

Les métaboxes de balise et de catégorie vous permettront d’attribuer plusieurs termes à votre message. Vous pourrez ajouter des termes que vous avez créés précédemment via leurs menus d’administration, ou vous pouvez les créer et les affecter à la volée (ces nouveaux termes seront ensuite sélectionnables pour d’autres articles à l’avenir).

Que fait avec ses taxonomies?

fera une série de choses avec ses taxonomies intégrées, notamment:

  • Créez une page de liste de termes unique: créera une nouvelle page pour ce terme. L’URL du terme lui-même sera le nom de la taxonomie suivi du nom du terme. Par exemple, si vous aviez une «catégorie» nommée «en vedette», l’URL serait / catégorie / en vedette. Le but de cette page est essentiellement d’agir comme une page de liste.

  • Créez un lien vers la page de liste de taxonomie unique sur vos messages individuels: Si vous attachez les termes intégrés à votre article, lorsque vous affichez votre article sur le front-end, affichera un nom cliquable du terme, généralement directement sous le titre de l’article. En cliquant sur le terme, vous accédez à la page de liste des termes.

  • Listez vos termes dans les widgets: est fourni avec plusieurs «widgets» qui vous permettent d’ajouter facilement du contenu aux zones de widgets de votre site (comme les barres latérales et les pieds de page). Vos widgets « catégories » et « nuage de tags » tireront vos termes et les afficheront sous forme de liens cliquables.

  • Ajoutez vos termes au menu de navigation: Toutes vos balises et catégories sont ajoutées au menu d’administration de navigation où vous définissez et créez votre menu principal. Cela vous permet de créer facilement un lien directement vers votre terme le plus couramment utilisé.

Selon votre thème, il peut y avoir d’autres domaines qui tirent parti de vos taxonomies.

Création de vos propres taxonomies personnalisées

Bien que les catégories et les balises intégrées puissent répondre à vos besoins organisationnels, le plus souvent, vous aurez besoin de plus de façons de regrouper vos publications, surtout si vous utilisez des types de publication personnalisés.

Comment enregistrer votre propre taxonomie personnalisée

Pour créer vos propres taxonomies personnalisées, vous devrez définir votre taxonomie à l’aide du register_taxonomy une fonction. Cette fonction prend trois valeurs comme suit register_taxonomy($taxonomy, $object_type, $args). Un bref résumé de ces valeurs est détaillé ci-dessous:

  1. $taxonomy – Nom de la nouvelle taxonomie que vous créez. Lorsque appelle leur taxonomie «catégories» ou «tags», vous pouvez donner un autre nom au vôtre, comme «membres». Ce nom doit contenir moins de 32 caractères et ne peut utiliser que des lettres et le caractère de soulignement.

  2. $object_type – Nom du type de publication auquel vous souhaitez joindre cette taxonomie. » post le type de message a à la fois des catégories et des balises. Vous souhaiterez peut-être attacher votre nouvelle taxonomie à un type de publication existant ou à votre propre type de publication personnalisé que vous avez créé précédemment. Dans ce cas, vous avez deux options:

    • Une chaîne unique représentant le nom du type de message, par exemple $object_type = 'post'

    • Un tableau de chaînes pour les noms des types de publication tels que $object_type = array('post','page')

  3. $args – Ce sont vos arguments utilisés pour définir les différentes options de votre nouvelle taxonomie. Il existe plusieurs options que vous pouvez définir. Plusieurs d’entre eux sont obligatoires, mais la plupart sont facultatifs ( gérera tous les arguments manquants):

    • label – Le nom pluriel de votre taxonomie, par exemple «membres», si vous créez une taxonomie d’appartenance.

    • labels – Un tableau de vos noms et valeurs qui seront utilisés pour la taxonomie. Ils sont utilisés dans les zones d’administration pour la gestion. Ce tableau spécifie toutes les étiquettes utilisées pour votre taxonomie. Si vous laissez ce champ vide, utilisera votre label valeur et définissez-les. De plus, vous pouvez ignorer des valeurs spécifiques non nécessaires et elles seront par défaut.

      • name – Nom pluriel de la taxonomie.

      • singular_name – Nom singulier utilisé pour un terme dans la taxonomie.

      • menu_name – Texte à afficher sur le back-end d’administration de (le long du menu d’administration de gauche).

      • all_items – Affichage de tous les termes de la taxonomie.

      • view_item – Affichage d’un seul terme de la taxonomie.

      • update_item – Mise à jour d’une taxonomie unique.

      • add_new_item – Ajoutez un nouveau texte de terme.

      • parent_item – Utilisé avec les taxonomies hiérarchiques, généralement définies sur Parent $taxonomy_name.

      • parent_item_colon – Idem que ci-dessus, mais en ajoutant également deux points à la fin.

      • search_items – Rechercher le texte utilisé lors de la recherche dans votre taxonomie.

      • popular_items – Nom de terme populaire, utilisé dans la section d’administration principale pour les termes non hiérarchiques. Peut facilement être réglé sur Popular $taxonomy_name.

      • separate_items_with_commas – Ce texte est affiché pour les taxonomies non hiérarchiques, c’est le texte affiché sur la méta-boîte de taxonomie pour les publications individuelles (il est affiché directement sous le bouton «ajouter»).

      • add_or_remove_items – Ce texte s’affiche pour les taxonomies non hiérarchiques. Ce texte est uniquement affiché avec JavaScript désactivé dans la méta-boîte de taxonomie pour les pages individuelles.

      • choose_from_most_used – Ce texte est affiché pour les taxonomies non hiérarchiques, au bas de la méta-boîte de taxonomie et lorsqu’il est sélectionné, il affichera une liste des termes les plus utilisés.

      • not_found – Ce texte est affiché pour les taxonomies non hiérarchiques, à l’intérieur de la méta-boîte de taxonomie uniquement une fois que vous avez cliqué sur le texte en surbrillance « Choisir parmi les plus utilisés ». Une fois cliqué, recherchera les termes les plus utilisés. S’il n’y en a pas, ce texte sera affiché.

    • public – Détermine si votre taxonomie sera affichée et pourra être interrogée.

    • show_ui – Détermine si affichera une zone d’administration pour votre taxonomie. Si ce n’est pas défini, vous n’aurez pas d’espace pour gérer vos conditions.

    • show_in_nav_menus – Détermine si les termes de cette taxonomie seront sélectionnables dans votre menu de navigation.

    • show_tagcloud – Détermine si inclura les termes de votre taxonomie dans le widget de nuage de tags.

    • meta_box_cb – Vous permet de spécifier une fonction utilisée pour sortir la conception de la méta-boîte de taxonomies à l’intérieur de vos messages uniques. S’il n’est pas sélectionné, utilisera sa valeur par défaut.

    • show_admin_column – Cela détermine si les termes de votre taxonomie apparaîtront dans une nouvelle colonne pour vos annonces de publication. La définition de « true » affichera une nouvelle colonne pour votre type de publication spécifié qui affichera tous ses termes joints.

    • hierarchical – Détermine si votre taxonomie peut des niveaux tels que les parents / enfants (comme les catégories) ou sont tous de niveau plat (comme les balises).

    • update_count_callback – Nom d’une fonction à appeler en cas de mise à jour du type de message joint. Lorsque le type de message de cette taxonomie change, cette fonction sera appelée.

    • query_var – Détermine le nom utilisé pour interroger le type de message. Par défaut, il est défini sur le nom de la taxonomie elle-même. S’il est défini sur une chaîne, cette chaîne sera utilisée. Il vaut mieux laisser sa valeur par défaut.

    • rewrite – Cela peut être défini de plusieurs manières. La définition de ce paramètre sur « false » désactivera les permaliens. Si cela n’a pas été défini sur false, vous pouvez spécifier plusieurs éléments tels que le «slug». Il vaut mieux laisser sa vraie valeur par défaut.

    • capabilities – Détermine les capacités (autorisations) nécessaires pour interagir avec la taxonomie, telles que la suppression, l’ajout et l’attribution. Il vaut mieux laisser sa valeur par défaut.

    • sort – Spécifie que lors de l’attribution des termes à un message, il doit se souvenir de la commande.

    • _builtin – Détermine si ce terme est une taxonomie «intégrée» ou une taxonomie personnalisée. Cela ne devrait pas être touché lors de la création de votre taxonomie

N’oubliez pas de cocher la case Vérifier le codex sur les taxonomies personnalisées, car elle indique quelles valeurs sont obligatoires et lesquelles sont facultatives (ainsi que les valeurs valides).

Création de votre première taxonomie personnalisée

Comme vous pouvez le voir, il existe plusieurs options que vous pouvez définir pour modifier votre taxonomie en fonction de vos propres besoins.

Bien que vous puissiez définir individuellement toutes vos options de taxonomies, la plupart du temps, il est préférable de laisser revenir à ses paramètres par défaut.

Pour ce tutoriel, nous allons créer une nouvelle taxonomie appelée Members que nous attacherons à notre déjà existant Post Type de poste.

//create a function that will attach our new 'member' taxonomy to the 'post' post type
function add_member_taxonomy_to_post(){

    //set the name of the taxonomy
    $taxonomy = 'member';
    //set the post types for the taxonomy
    $object_type = 'post';
    
    //populate our array of names for our taxonomy
    $labels = array(
        'name'               => 'Members',
        'singular_name'      => 'Member',
        'search_items'       => 'Search Members',
        'all_items'          => 'All Members',
        'parent_item'        => 'Parent Member',
        'parent_item_colon'  => 'Parent Member:',
        'update_item'        => 'Update Member',
        'edit_item'          => 'Edit Member',
        'add_new_item'       => 'Add New Member', 
        'new_item_name'      => 'New Member Name',
        'menu_name'          => 'Member'
    );
    
    //define arguments to be used 
    $args = array(
        'labels'            => $labels,
        'hierarchical'      => true,
        'show_ui'           => true,
        'how_in_nav_menus'  => true,
        'public'            => true,
        'show_admin_column' => true,
        'query_var'         => true,
        'rewrite'           => array('slug' => 'member')
    );
    
    //call the register_taxonomy function
    register_taxonomy($taxonomy, $object_type, $args); 
}
add_action('init','add_member_taxonomy_to_post');

L’exécution du code ci-dessus créera une nouvelle taxonomie avec le nom Members et attachez-le au Post Type de poste. Lorsque vous affichez le back-end de votre site Web, vous verrez maintenant un nouveau sous-menu à l’intérieur du Post menu. Cliquer sur ce nouveau Members le sous-menu vous amènera à l’écran d’administration de la taxonomie.

Taxonomies WordPress_Image 4

Votre écran d’administration de taxonomie ressemblera à category ou tag écrans en fonction de ce que vous définissez votre hierarchical argument à. Notre nouveau member l’interface ressemble à ceci:

Taxonomies WordPress_Image 5

Créer vos nouvelles conditions

Avec votre taxonomie enregistrée, vous pouvez maintenant créer vos nouveaux termes (dans notre cas, les membres) à votre guise.

Nous avons créé trois nouveaux termes de premier niveau. Nos termes s’appellent Featured Members,Standard Members et Seasonal Members.

Nos membres en vedette et standard sont des termes à un seul niveau tandis que nos membres saisonniers sont à plusieurs niveaux, avec deux termes comme ses enfants l’appellent Winter Members et Summer Members.

Ceci est facile à visualiser lorsque vous considérez les catégories. Les catégories peuvent avoir de nombreuses sous-catégories, voire aucune.

Taxonomies WordPress_Image 6

Ajout de vos conditions à votre publication

Vous pouvez ajouter autant de termes que vous le souhaitez à vos messages. Vous attribuez ces termes en modifiant le message lui-même et en utilisant la méta-boîte de taxonomie pour joindre les termes.

WordPress Taxonomies_Image 7

Interagir avec votre taxonomie / conditions

Une fois que vous avez créé et affecté vos termes à vos messages, vous devrez modifier votre thème pour profiter de votre nouvelle taxonomie.

affichera ses liens liés aux catégories et aux termes lorsque vous afficherez vos publications individuelles. Cependant, comme vous avez enregistré votre propre taxonomie, vous devrez personnaliser votre modèle pour vous assurer que vos termes sont affichés.

Modification de vos fichiers de thème pour afficher votre nouvelle taxonomie

Comme vous avez ajouté une taxonomie supplémentaire, vous devrez modifier légèrement vos fichiers de modèle de thème pour vous assurer que vos termes sont affichés. Cela implique de modifier quelques fichiers de thème et d’interagir avec certaines fonctions .

Comprendre votre fichier de modèle unique

Si vous travaillez sur un thème enfant (et vous devriez l’être), vous pouvez ouvrir votre fichier de modèle single.php. Bien que nous n’éditions pas ce fichier, il est important de savoir que ce fichier gère la sortie de tous les fichiers posts. Depuis que nous avons attaché notre member taxonomie à posts, nous allons commencer ici.

Votre single.php devrait ressembler à ce qui suit. J’utilise Twenty Thirteen comme thème parent, mais dans l’ensemble, la plupart des fichiers single.php ont la même fonctionnalité de base.


	

La principale partie sur laquelle vous devez vous concentrer est get_template_part('content',get_post_format()). Cette fonction est ce qui affichera réellement tout le contenu de votre publication et c’est ici que nous devrons effectuer nos modifications.

Comprendre votre fichier de modèle de contenu

content.php est le fichier responsable de la sortie du contenu de vos messages. En réalité, c’est le fichier principal utilisé pour sortir tout le contenu du type de publication, quand il n’y a pas de modèle plus spécifique à charger, il chargera content.php.

La première partie de get_template_part() prendra le nom du fichier que vous essayez de charger. Le deuxième paramètre (facultatif) recherchera alors une version spécifique de ce fichier. Par exemple get_template_part('content','video') recherchera un fichier appelé «content-video.php». Lorsqu’il est appelé par lui-même, comme get_template_part('content’), il recherchera un fichier nommé «content.php»

Ce que nous voulons faire, c’est modifier notre partie de modèle de contenu. Cependant, cela présente certaines difficultés car les méta-informations telles que les taxonomies sont traitées différemment dans différents thèmes.

  • Vingt treize: Dans Twenty Thirteen, les méta-informations sont affichées à l’aide du twentythirteen_entry_meta() une fonction. Cette fonction parcourt les catégories / balises de votre publication et est appelée à partir de content.php (et de tous vos autres fichiers de «contenu» tels que «content-video.php»).

  • Vingt quatorze: Dans Twenty Fourteen, les méta-informations s’affichent directement dans content.php (en outre, chacun des autres fichiers de «contenu» tels que «content-video.php» les traite également manuellement).

Création d’une fonction pour générer vos nouveaux termes de taxonomie

Notre solution sera de créer une fonction rapide qui aura pour seul objectif d’afficher nos nouveaux termes «membres».

Ouvrez votre fichier functions.php et entrez le code suivant:

function display_member_taxonomy_terms($post_id){
    
    //get all terms assigned to this post
    $member_terms = get_the_terms($post_id,'member'); 
    //if we have member terms assigned to this post
    if($member_terms){
        echo '
'; echo ' Member Terms: '; //loop through each term foreach($member_terms as $term){ //collect term information and display it $term_name = $term->name; $term_link = get_term_link($term,'member'); echo ''; echo '' . $term_name . ''; echo ''; } echo '
'; } }

Appel de votre nouvelle fonction dans votre fichier de contenu

Une fois que vous avez ajouté cette fonction à votre fichier functions.php, ouvrez votre content.php et recherchez où votre «entrée-méta» est sortie. Appelez votre nouvelle fonction à l’intérieur de cette div «entrée-méta». J’ai appelé notre fonction au-dessus de la méta-fonction standard de Twenty Thirteen comme détaillé ci-dessous:

Lorsque vous ouvrez vos messages uniques, vous verrez que le member les termes sont désormais affichés au-dessus des termes de catégorie et de balise standard (tant que vous avez affecté des termes de membre).

Taxonomies WordPress_Image 8

Comprendre ce que nous venons de faire

Pour afficher vos nouveaux termes, nous avons d’abord appelé une fonction nommée display_member_taxonomy_terms($post->ID);à partir de votre fichier content.php. Cette fonction prend en compte l’ID du message actuel et tente d’afficher tous les termes appartenant à notre nouvelle taxonomie qui ont été attribués à ce message.

Nous avons d’abord appelé $member_terms = get_the_terms($post_id,'member'); pour recueillir nos conditions pour ce poste. le get_the_terms($post_id,$taxonomy_name) La fonction prend l’ID d’un article, avec un nom de taxonomie et nous donne tous les termes attachés pour cette taxonomie. Dans notre situation, nous lui avons transmis notre identifiant de poste actuel ainsi que la taxonomie «membre».

Ensuite, nous vérifions si nous avons des résultats en utilisant une simple instruction if if($member_terms). Si nous avons des termes à afficher, nous parcourons chacun de nos termes en utilisant notre boucle for foreach($member_terms as $term). Cette boucle nous permet de parcourir chaque terme et d’accéder à ses informations.

Enfin, nous avons accédé au nom du terme (pour l’afficher à l’utilisateur) et récupéré l’URL du terme à l’aide du get_term_link($term_object,$taxonomy_name) une fonction. Cette fonction prend un objet terme et le nom de la taxonomie, et obtient le lien direct avec le terme lui-même.

Envelopper les choses

Comme vous pouvez le voir, la création de taxonomies personnalisées peut vous fournir un large éventail de nouvelles façons d’organiser le contenu de vos sites Web tels que vos publications.

En créant une nouvelle taxonomie et les termes associés et en les affectant à une publication, vous pouvez créer une couche d’organisation que vous pouvez exploiter pour catégoriser davantage le contenu de votre site Web.

All the CMS Templates You Could Ask For.

WordPress: Comment créer vos propres taxonomies WordPress personnalisées - SitePoint

2M+ items from the worlds largest marketplace for CMS TemplatesEnvato Market.



WordPress: Comment créer vos propres taxonomies WordPress personnalisées - SitePoint

#Comment #créer #vos #propres #taxonomies # #personnalisées #SitePoint

Bad Behavior has blocked 3713 access attempts in the last 7 days.

%d blogueurs aiment cette page :