Comment afficher les étiquettes WordPress sur votre site ?

Vous cherchez à afficher les étiquettes WordPress sur vos articles ? Dans ce tutoriel, je vais vous guider pas à pas pour que vous arriviez à le faire facilement.

Sur WordPress, vous pouvez en effet classer vos articles grâce aux étiquettes (appelées "tags" dans la version anglaise). La plupart des thèmes WordPress affichent les tags par défaut en bas de chaque article. Si ce n'est pas le cas, vous devrez modifier le code de votre thème pour les ajouter.

Rassurez-vous, ce n'est pas si compliqué que ça en a l'air !

Où afficher les étiquettes sur WordPress ?

Vous devez d'abord trouver quel fichier de votre thème contrôle l'affichage d'un article. Souvent, c'est le fichier "single.php". Il va falloir modifier ce fichier :

• Soit en allant dans le menu Apparence > Éditeur de WordPress et en cliquant sur "single.php" dans la colonne de droite. Cette méthode de modification des fichiers de WordPress n'est pas conseillée car elle provoque souvent des erreurs, mieux vaut opter pour la seconde que je vous suggère.
• Soit en allant directement sur votre FTP (là où vous avez installé les fichiers de votre thème), dans le dossier wp-content/theme/nomdevotretheme/. Vous pouvez vous connecter au FTP à l'aide d'un client FTP comme FileZilla ou WinSCP, en utilisant les informations de connexion qui vous ont été fournies par votre hébergeur lorsque vous avez souscrit votre contrat.

Je vous conseille de faire une copie de ce fichier single.php avant toute modification. Ainsi, si vous faites une erreur, vous pourrez facilement restaurer la version initiale du fichier.

Notez aussi qu'il n'est pas conseillé de modifier directement votre thème WordPress "principal" : il est préférable de créer un thème enfant, une sorte de copie du thème principal où vous allez effectuer toutes vos personnalisations. Ainsi, si le thème principal est mis à jour, vos modifications ne seront pas effacées.

Ces petits conseils donnés, repérez le code suivant dans le fichier single.php :

<?php the_content(); ?>

Il permet à WordPress de publier le contenu ("content" en anglais) de votre article. Nous allons afficher les étiquettes WordPress juste en dessous (je vous explique comment faire un peu plus bas).

Cas particuliers avec single.php

Il peut arriver, sur certains thèmes, que le code the_content() qui contrôle l'affichage du contenu sur les articles se trouve dans un autre fichier que single.php (par exemple "content-single.php" ou autre variante). Dans ce cas, pour le retrouver, vous pouvez télécharger le thème et faire une recherche du bout de texte the_content() dedans (en utilisant par exemple un logiciel comme TextCrawler).

Il faudra ensuite déterminer quel fichier parmi ceux que vous avez trouvés peut correspondre à l'affichage d'un article (seuls les articles WordPress possèdent des étiquettes mais pas les pages par exemple).

Quel code utiliser pour afficher les étiquettes WordPress ?

Vous pouvez partir d'un code très simple comme celui-ci :

<?php the_tags('A', 'B', 'C'); ?>

Le code "the_tags" indique à WordPress qu'il doit afficher les tags (je vous l'avais dit, c'est facile !). Ensuite, l'intérieur de la parenthèse vous permet de préciser trois paramètres :

• Le texte qui précède la liste des étiquettes (A) ;
• Le séparateur entre chaque tag (B) ;
• Un éventuel texte qui suit la liste des tags (C).

Vous pouvez tout à fait laisser ces champs vides. Le code suivant par exemple affichera "Cet article parle de :" puis la liste des tags séparés par des tirets.

<?php the_tags('Cet article parle de : ', '-', ''); ?>

Attention, si votre texte comporte une apostrophe, cela risque de poser problème puisque chaque élément de la parenthèse se trouve déjà entre apostrophes. Vous devrez alors utiliser un anti-slash avant l'apostrophe de votre texte, par exemple :
<?php the_tags('L\'article parle de : ', '-', ''); ?>

Vous pouvez améliorer ce code très facilement, comme ceci par exemple :

<?php if (has_tag()) { echo the_tags( '<div class="displaytags">Thèmes : ', '&nbsp;', '</div>'); } ?>

Cette version du code comporte :

• Une condition : "s'il y a des tags ("if has_tag"), alors affiche les tags ("echo the_tags")". A l'inverse, si l'article ne comporte aucun mot clé, rien ne s'affichera.
• Une balise div qui me permet de personnaliser l'affichage des tags : je peux ainsi ajouter la classe "displaytags" que j'ai créée à la feuille de style du thème WordPress (fichier style.css) afin de contrôler l'apparence des tags.

Afficher les tags utilisés

Parfois, on associe une étiquette à un seul article. Elle n'a donc pas vraiment de pertinence pour le visiteur tant qu'il n'y a pas davantage d'articles qui y sont rattachés. Car plus une étiquette est utilisée, plus elle va rassembler une sélection de posts riche et intéressante pour vos lecteurs.

On peut donc choisir de n'afficher les étiquettes que lorsqu'elles sont utilisées un certain nombre de fois. Par exemple, le code ci-dessous permet d'afficher les étiquettes seulement lorsqu'elles sont utilisées plus de 5 fois (vous pouvez remplacer 5 par le chiffre de votre choix). Ce grâce à la partie "if ($tag->count > 5)". Un bon moyen de garantir une pertinence maximale !

C'est le code que j'utilise actuellement sur No Tuxedo :

<?php
	$tags = wp_get_post_tags($post->ID);
    if ($tags) {
		echo '<div class="displaytags">';
    foreach($tags as $tag) {
      if ($tag->count > 5) {
        echo '' . $title . '<a href="' . get_term_link( $tag->term_id, 'post_tag' ) . '" title="' . sprintf( __( "%s" ), $tag->name ) . '" ' . '>' . $tag->name.'</a> ';
      }
    }
	echo '</div>';
  }
?>

J'espère que cet article vous sera utile ! N'hésitez pas à poursuivre votre lecture en parcourant ces conseils pour bien tirer profit des étiquettes WordPress.