Unlimited WordPress themes, graphics, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. WordPress
Code

Guide Tuts+ des Template Tags : Première fournée

by
Difficulty:BeginnerLength:MediumLanguages:
This post is part of a series called The Tuts+ Guide to Template Tags.
The Tuts+ Guide to Template Tags: Introduction
The Tuts+ Guide to Template Tags: Second Batch

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

Dans la première partie de cette série, nous avons découvert ce que sont les Template Tags, où nous pouvons les trouver, comment ils fonctionnent et comment les utiliser.

Dans cette seconde partie, nous allons passer en revue le premier lot des quasiment 200 Template Tags différents. Au cours de ce tutorial, nous allons passer en revue les Template Tags qui concernent les données de post : titres, dates, contenus et autre méta-données.

Récupérer et afficher le contenu d'un billet: get_the_content() & the_content()

Voici probablement les Template Tags les plus populaires, ils renvoient et affichent le contenu d'un post.

Paramètres

Ces deux Template Tags acceptent deux paramètres :

  • $more_link_text (optionel—chaîne de données):
    Texte qui remplace le "(lire la suite ...)" par défaut.
    (par défaut : "(more…)")
  • $strip_teaser (optionnel—booléen):
    Enlever le texte d'accroche.
    (Par défaut: FALSE)

Un mot concernant le "Texte d'accroche": savez vous qu'il existe un Tag, <!--noteaser-->  , pour transformer le contenu placé avant  <!--more--> en "texte d'accroche" et masquer cette partie sur la page affichant l'article, même si $strip_teaser est réglé sur FALSE ?  Moi, je l'ai découvert ! Cette fonction n'est pas tout à fait inconnue même si ... voici un billet datant de 2009.

Utilisation

Récupérer et afficher le contenu des billets pour les flux : get_the_content_feed() & the_content_feed()

Ces Template Tags récupèrent et renvoient le contenu pour les flux.

Paramètres

Ces deux TemplatesTags n'acceptent qu'un paramètre :

  • $feed_type (optionnel—string):
    Types de flux
    (Par défaut: Flux par dé faut)

Utilisation

Récupérer et afficher l'extrait du post  :get_the_excerpt() the_excerpt()

Ces Template Tags récupèrent et affichent l'extrait du post

Paramètres

C'est Template Tags n'ont aucun paramètre.

Utilisation

Afficher l'extrait d'un post pour les flux :the_excerpt_rss()

Ce Template Tag prépare l'extrait pour les flux et le renvoie.

Paramètres

Ce Template Tags ne comporte aucun paramètre.

Utilisation

Récupérer et afficher le titre d'un Post :get_the_title() & the_title()

Ce template Tag permet de renvoyer ou d'afficher le titre pour vos Posts.

Paramètres

get_the_title() accepte 3 paramètres :

  • $post_ID (optionnel—intégrer ou objet):
    L' ID du post.
    (Par défaut : Post courant)

Et the_title() accepte 3 paramètres :

  • $before (optionnel—chaîne de caractères):
    Le texte ou le code HTML qui se affiché avant le résultat.
    (vide par défaut)
  • $after (optionnel—chaîne de caractères):
    Le texte ou code HTML qui sera affiché après le résultat.
    (vide par défaut)
  • $echo (optionnel—booléen):
    Ou bien écrire (echo) si réglé sur TRUE ou bien continuer si réglé sur FALSE.
    (par défaut : TRUE)

Utilisation

Récupérer et afficher la version "Escaped" du titre d'un post :the_title_attribute()

Ce Template Tag prépare les titres pour les afficher proprement dans du code HTML. Voir l'exemple pour de plus amples explications.

Paramètres

Ce Template Tag n'accepte qu'un seul paramètre :

  • $args (optionnel—tableau):
    Un tableau des arguments suivant :
    • 'before' (chaîne de caractères) : code HTML à ajouter avant
      (vide par dédaut)
    • 'after' (chaîne de caractères) : code HTML à ajouter après. 
      (vide par défaut)
    • 'echo' (booléen) : écrire le Template Tag ou non ?
      (par défaut : TRUE)
    • 'post' (objet) : Post courant dont on récupère le titre.
      (par défaut : 0)

Utilisation

Prenons par exemple ce titre :

Bill & Melinda Gate dépensent des milliards en oeuvres de charité, disons "Nous l'avons fait ???"

Ce titre comporte deux guillemets et une esperluette (&) qui vont casser votre code HTML si vous utilisez ce titre dans les attributs d'une balise HTML car les attributs sont eux même entouré de guillemets. C'est là que le Template Tag the_title_attribute() devient pratique :

Maintenant les attributs du titre ressemblent à ça :

Bill &amp; Melinda Gate dépensent des milliards en oeuvres de charité, disons &quot;Nous l'avons fait ???&quot;

Ainsi, vos balises HTML ne seront pas perturbées par des caractères indésirables tel que des guillemets ou des esperluette.

Afficher le titre d'un post pour les flux : the_title_rss()

Ce template Tag récupère le titre, le prépare pour les flux et l'affiche.

Paramètres

Ce Template Tag n'a pas de paramètres.

Utilisation

Récupérer et afficher la date d'un post : get_the_date() & the_date()

Ces Template Tags récupèrent et affichent la date du post.

Paramètres

get_the_date() accepte deux paramètres :

  • $date_format (optionnel—chaîne de caractères):
    Le format de la date
    (par défaut : le format de date est configuré dans la page "options générales")
  • $post_ID (optionnel—intégrer ou object):
    L' ID du poste :
    (par défaut: poste courant)

Et the_date accepte quatre paramètres :

  • $date_format (optionnel—chaîne de caractères):
    Le format de la date.
    (par défaut : Format de date configuré dans la page des options générales)
  • $before (optionnel—chaîne de caractères):
    Le texte ou code HTML à afficher avant le résultat.
    (vide par défaut)
  • $after (optionnel—chaîne de caractères):
    Le texte ou code HTML à afficher après le résultat.
    (vide par défaut)
  • $echo (optionnel—booléen):
    Ou bien la fonction écrit si réglé sur TRUE ou bien la fonction continue si réglé sur FALSE.
    (par défaut : TRUE )

Utilisation

Récupérer et afficher la date du poste au format IOS 8601 : the_date_xml()

Ce Template Tag renvoie et affiche la date du poste au format ISO 8601.

Paramètres

Ce Template Tag ne comporte aucun paramètre.

Utilisation

Récupérer et afficher l'heure d'un poste : get_the_time() & the_time()

Ces Template Tags renvoient ou affichent l'heure d'un poste.

Paramètres

get_the_time() accepte deux paramètres :

  • $time_format (optionnel—chaîne de caractères):
    Le format de l'heure.
    (par défaut : le format d'heure que vous avez réglé dans la page des options générales)
  • $post_ID (optionnel—integrer ou object):
    L' ID d'un poste.
    (par défaut : poste courant)

Et the_time() n'accepte qu'un seul paramètre :

  • $time_format (optionnel—chaîne de caractères):
    Le format de l'heure.
    (par défaut : le format d'heure que vous avez réglé dans la page des options générales)

Utilisation

Récupérer et afficher le nom de l'auteur : get_the_author() & the_author()

Ces Template Tags récupèrent et affichent le nom de l'auteur d'un poste.

Paramètres

Ces Template Tags ne comportent aucun paramètre.

Utilisation

Afficher toutes les méta-données d'un poste : the_meta()

Ce Template Tag liste toutes les méta-données du poste dans une liste non ordonnée.

Paramètres

Ce Template Tag ne comporte aucun paramètre.

Utilisation

Récupérer et afficher la date de modification du poste : get_the_modified_date() & the_modified_date()

Ces Template Tags récupèrent et affichent la date de la dernière modification d'un poste.

Paramètres

get_the_modified_date() n'accepte qu'un seul paramètre :

  • $date_format (optionnel—chaîne de caractères):
    Le format de la date.
    (par défaut : le format de date que vous avez réglé dans la page des options générales)

Et the_modified_date() accepte quatre paramètres :

  • $date_format (optionnel—chaîne de caractères):
    Le format de la date.
    (par défaut : le format de date que vous avez réglé dans la page des options générales).
  • $before (optionnel—chaîne de caractères):
    Le texte ou code HTML qui sera afficher avant.
    (vide par défaut)
  • $after (optionnel—chaîne de caractères):
    Le texte ou code HTML qui sera affiché après.
    (vide par défaut)
  • $echo (optionnel—booléen):
    Ou bien la fonction écrit si réglé sur TRUE ou bien elle continue si réglé sur FALSE
    (par défaut : TRUE)

Utilisation

Récupérer et afficher l'heur de modification d'un poste : get_the_modified_time() & the_modified_time()

Ces Template Tags récupèrent et affichent l'heure de modification du poste.

Paramètres

Ces deux Template Tags acceptent un seul paramètre :

  • $time_format (optionnel—chaîne de caractères):
    Le format de l'heure.
    (par défaut : le format d'heure que vous avez configuré dans la page des options générales).

Utilisation

Récupérer et afficher l'auteur qui a modifié le poste : get_the_modified_author () & the_modified_author()

Ces Template Tags récupèrent et affichent l'auteur qui a modifié le poste.

Paramètres

C'est Template Tags ne comportent aucun paramètre.

Utilisation

Récupérer et afficher la liste des pages suivantes et précédentes : wp_link_pages()

Vous pouvez diviser vos postes sur plusieurs pages en utilisant <!--nextpage-->, ce Template Tag va vous aider à lister ces pages.

Paramètres

Ce Template Tag n'accepte qu'un seul paramètre :

  • $args (optionnel—tableau):
    Un tableau des arguments suivants :
    • 'before' (chaîne de caractères) : code HTML à ajouter avant.
      (par défaut : '<p>Pages:')
    • 'after' (chaîne de caractères) : code HTML à ajouter après.
      (par défaut : '</p>')
    • 'link_before' (chaîne de caractères) : code HTML qui sera ajouté avant chaque lien.
      (par défaut : '')
    • 'link_after' (chaîne de caractères) : code HTML à ajouter avant.
      (par défaut : '')
    • 'next_or_number' (chaîne de caractères) : voulez vous afficher les numéros de page ('number') ou bien les liens "précédent" et "suivant" ('next') ?
      (par défaut : 'number')
    • 'sep' (chaîne de caractères) : texte séparateur.
      (par défaut : ' ')
    • 'nextpagelink' (chaîne de caractères) : le texte pour le lien "page suivante".
      (par défaut : 'Next Page')
    • 'previouspagelink' (chaîne de caractères) : Le texte pour le lien "page précédente".
      (par défaut : 'Previous Page')
    • 'pagelink' (chaîne de caractères) : Format des liens si le paramètre 'next_or_number' est réglé sur 'number'. Le caractère "%" sera remplacé par le numéro de la page, vous pouvez donc utiliser une valeur telle que "Page %" pour générer les liens "Page 1, Page 2, Page 3".
      (par défaut : %)
    • 'echo' (intégrer) : ou bien on écrit le résultat (1) ou bien on continu (0).
      (par défaut : 1)

Utilisation

Conclusion

J'espère que vous avez apprécié cette première fournée de Template Tags. Nous avons encore sept lots à découvrir donc continuez à nous suivre pour découvrir plus de Template Tags.

Si vous avez des questions, commentaires ou correctifs, vous pouvez partager vos remarques avec nous dans la partie Commentaires. Et si vous avez apprécié cet article, n'oubliez pas de partager avec vos amis !

Advertisement
Advertisement
Advertisement
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.