Ajouter des champs custom fields à une taxonomie avec Tax Meta Class

Notre dernier tutoriel explique comment regrouper des articles de blog dans une taxonomie Série. Cette fois, personnalisons nos taxonomies en leur ajoutant des nouveaux champs (custom fields) et étudions l’utilisation de la classe-helper Tax Meta Class.

• Helper Class PHP TaxMetaClass : github.com/bainternet/Tax-Meta-Class
• Présentation de TaxMetaClass (en anglais) : bainternet.info
  
• Code créé dans ce tutoriel : http://pastebin.com/CHWP0sng & http://pastebin.com/jJy8SJVE

La première partie de cette série se concentre sur notre nouvelle taxonomie Série créée avec la librairie Cuztom, puis sur la création d’un shortcode permettant d’afficher les articles de la série en cours de lecture. A ce stade, les éléments de notre taxonomie WordPress ne possèdent que peu d’informations : titre et description sont les seules données à afficher.

Mais saviez-vous qu’il est possible de créer des nouveaux champs pour étendre les structures des taxonomies WordPress ? L’helper Tax Meta Class s’avère bien pratique pour ajouter de nombreux types de champs : image, texte, date, checkbox, select, radio… et bien plus encore !

Création d’une metabox et ajout de custom fields

require_once(get_template_directory() . '/inc/Tax-meta-class/Tax-meta-class.php');

if (is_admin()){
  $config = array(
    'id' => 'serie_metabox',
    'title' => 'Information sur cette série',
    'pages' => array('serie'),
    'context' => 'normal',
    'fields' => array(),
    'local_images' => true,
    'use_with_theme' => get_template_directory_uri() . '/inc/Tax-meta-class'
  );

  $serie_metabox = new Tax_Meta_Class($config);

  $serie_metabox->addText(
    'difficulty',
    array(
      'name' => 'Difficulté'
    )
  );

  $serie_metabox->addImage(
    'image',
    array(
      'name' => 'Image'
    )
  );

  $serie_metabox->Finish();
}

Dans un premier temps, on définit une array de configuration de notre metabox qui contiendra nos nouveaux champs. Ensuite, on instancie la classe Tax_Meta_Class et on utilise les méthodes à disposition (lisez class-usage-demo.php pour une liste des champs disponibles) pour ajouter des champs à notre metabox : addText ajoute un champs custom field de texte, addImage ajoute la possibilité d’assigner une image à notre taxonomie.

Enfin, on termine avec Finish pour initialiser le tout.

Affichage des données des custom fields d’un terme de taxonomie

$serie_image = get_tax_meta( $serie->term_id, 'image' );

La syntaxe ressemble beaucoup à get_post_meta : on passe tout d’abord l’ID du terme de notre taxonomie, puis l’ID du champs (meta) de notre taxonomie. Rien de compliqué ! Notez qu’un champ d’image renvoie une array associativé avec l’ID et l’URL de l’image.

En couplant l’utilisation de la librairie Cuztom avec cette classe helper Tax Meta Class, nous pouvons désormais transformer WordPress en un vrai CMS qui va au delà du simple blog. Nos types de contenus personnalisés se voient recevoir des champs uniques pour stocker des données spécifiques. Des custom taxonomies sont ajoutées sans souci et associées à n’importe quel type de contenu. Enfin, des champs custom fields sont également associés à ces taxonomies.

Avec une bonne connaissance de ces 2 librairies, vous pouvez maintenant développer des contenus proprement nommés et catégorisés aux données complexes, avec une interface qui se fond à l’interface WordPress pour que vos clients profitent de ces fonctionnalités en toute simplicité !