7 days of WordPress plugins, themes & templates - for free!* Unlimited asset downloads! Start 7-Day Free Trial
Advertisement
  1. Code
  2. WordPress

Guide Tuts+ des Template Tags: Introduction

Scroll to top
Read Time: 5 mins
This post is part of a series called The Tuts+ Guide to Template Tags.
The Tuts+ Guide to Template Tags: First Batch

French (Français) translation by Jean-Frédéric Barré (you can also view the original English article)

Nous avons souvent déclaré sur ce site que WordPress est un CMS très puissant et que sont pouvoir est dû à son évolutivité. Si un produit est évolutif, les gens vont contribuer à son évolution et, si les gens contribuent, le produit évolue attirant plus d'utilisateurs donc plus de contributeur etc ... C'est ce cercle vertueux qui construit des communautés et, ce cycle a contribué à rendre WordPress le CMS le plus populaire au monde.

Dans cette série d'articles, nous allons apprendre l'un des concepts fondamentaux de WordPress : les "Template Tags".

Que sont ces "Template Tags" ?

Les deux caractéristiques principales qui démontrent l'extensibilité de WordPress sont : la possibilité de créer des plugins (améliorer ou ajouter des fonctionnalités) et la possibilté de créer des thèmes (améliorer l'apparence). Ces deux fonctionnalités sont le résultat du succès des concepts de base de WordPress tels les API ou les sub-systems. L'un de ces concept est celui qui nous intéresse aujourd'hui, les Template Tags.

Les Template Tags sont un concept bien antérieur à WordPress. "L'outil blog" dont sont parti Matt Mullenweg et Mike Little avait déjà des Template Tags. On pourrait même dire que c'est l'une des plus ancienne fonction de WordPress, avant même la possibilité de pouvoir créer des thèmes ou des plugins. Respect pour les anciens !

Dans le Codex, les TemplateTags sont expliqués ainsi :

Les Template Tags sont utilisés dans vos Templates pour afficher des informations de manière dynamique ou bien modifier votre site. Ils vous fournissent le moyen de rendre votre site aussi personnel et intéressant que vous.

Pour la faire courte, les Template Tags sont des fonctions PHP qui vont permettrent à WordPress de faire des trucs pour vous. Croyez-moi, ça ne va pas être très compliqué si vous avez les bases de PHP et HTML.

Où se trouvent ces Template Tags ?

Vous trouverez les fichiers de tous les Template Tags dans le dossier wp-includes. Vous y trouverez 9 fichiers avec le suffix -template :

  • wp-includes/author-template.php pour les Template Tags concernant l'Auteur
  • wp-includes/bookmark-template.php pour les Template Tags concernant les Marques Pages.
  • wp-includes/category-template.php pour les Template Tags concernant tous ce qui est Taxonomies, Mots Clés, Catégories ou Tags
  • wp-includes/comment-template.php pour les Template Tags concernant la section Commentaires.
  • wp-includes/link-template.php pour les Template Tags qui concernent les liens (permalinks, attachment links, archive links etc.)
  • wp-includes/nav-menu-template.php pour les Template Tags qui concernent les Menus.
  • wp-includes/post-template.php pour les Template Tags concernant les billets.
  • wp-includes/post-thumbnail-template.php pour les Template Tags qui concernent l'image mise en avant.
  • wp-includes/general-template.php pour tous les autres Template Tags.

Utilisation des Template Tags dans WordPress

Comme je vous le disais précédemment, le concept de "Template Tags" n'est pas très compliqué si vous vous débrouillé en PHP, en HTML, et pourquoi pas en CSS (principalement le PHP). Puisque les Template Tags ne sont rien d'autre que des fonctions PHP, leur utilisation va être assez simple. Malgré tout, il y a plusieurs choses à savoir les concernants.

Les fonctions Template Tags

Mise à part "Include Tags" et "Conditional Tags" (qui sont un famille à part des Template Tags), toutes les autres fonctions peuvent être rangées dans 2 groupes : celles qui écrivent des choses (echo) et celles qui nous renvoient des choses (return). Ces deux types de fonctions sont la base des Template Tags et vont vous permettre de développer vos nouveaux thèmes.

Vous pouvez reconnaitre les fonctions qui return des choses par le prefix get_. Bien qu'elles ressemblent à des fonctions classiques un peu modifiées, elles contiennent le code original et nous return (renvoient) le résultat. Les fonctions qui echo (écrivent) des choses sont généralement relié à celles qui envoient l'information (get_). Voici le code source de le fonction the_ID() :

Bien évidemment, pour certaines fonctions, vous pouvez passer un paramètre $echo booléen. Si vous le réglé sur TRUE le résultat sera écrit, si vous le réglé sur FALSE la fonction continue. Ne vous inquiétez pas si cela vous semble un peu confus pour le moment, voyons plutôt les paramètres de tous ces Template Tags.

Les paramètres des fonctions

C'est la partie ardue des Templates Tags, cependant c'est très simple.(Note du traducteur : contre sens voulu par l'auteur ?)

Les paramètres sont des types de données qui peuvent modifier le comportement d'une fonction. Grâce aux paramètres, vous pouvez ajouter des préfixes ou des suffixes au résultat retourné par la fonction. Vous pouvez aussi limiter la quantité de données ou en exclure certaines etc ... Si vous ne connaissez pas les différents paramètres d'une fonction, vous vous limité au comportement par défaut de la fonction.

Déclarer des paramètres

Il y a trois façons de déclarer des paramètres à un Template Tags :

Utiliser les paramètres classiques : la plupart des Template Tags accèptent les paramètres genre "PHP" ; vous pouvez les séparer par des virgules :

Utiliser des query-strings (requêtes) : certaines fonctions acceptent des paramètres genre "requête", par exemple :

Mais ce genre de requête est un peu compliqué à lire et il vous faudra apprendre à écrire ces "requêtes". Je vous conseille plutôt d'utiliser les array (tableaux).

Utiliser des tableaux : La façon la plus propre de déclarer des paramètres est d'utiliser un array

Souvenez-vous que vous pouvez utiliser les arrays au lieux des query-strings et inversement, mais vous ne pouvez pas utiliser des paramètres "classiques" à la place de query-strings ou un array à la place d'un paramètre classique. Si un Template Tag accèpte des paramètres "classique", vous ne pouvez utiliser que ceux là. Si la fonction accepte les query-strings ou les arrays, vous pouvez utiliser les deux.

Si ce n'est pas clair, vous pouvez consulter cette page : les paramètres des fonctions Template Tags.

Conclusion

Maintenant que nous avons vu les bases de l'utilisation des Template Tags, nous pouvons passer à l'apprentissage de chacun d'eux. Dans les prochaines parties nous verrons tous les Template Tags (qui sont documentés sur le Codex) avec pour chacun une description, des explications concernant les paramètres et quelques bouts de code sur la manière de les utiliser. Ca va être un long mais excellent voyage !

Des choses à partager concernant les Template Tags ? Donnez votre avis en commentant ci-dessous et, si vous avez apprécié cet articles, partagez avec vos amis !

Advertisement
Did you find this post useful?
Want a weekly email summary?
Subscribe below and we’ll send you a weekly email summary of all new Code tutorials. Never miss out on learning about the next big thing.
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.