Créer un shortcode qui affiche un contenu réutilisable.
Durée indicative : 15 minutes.
Relier contenu, champ et affichage
Un champ personnalisé ajoute une information associée à un contenu.
Pour une ressource, cela peut être une durée indicative. Le champ stocke l’information ; il ne décide pas automatiquement de son affichage.
Un shortcode est une instruction courte placée dans le contenu. WordPress la remplace par le résultat d’une fonction. Cette fonction doit retourner son résultat avec return, et non l’afficher directement avec echo.
- Type de contenu : Ressource
- Une ressource : « Préparer une modification »
- Champ personnalisé : t1pp_duree = 15 minutes
- Shortcode : [t1pp_duree]
- Affichage : Durée indicative : 15 minutes
Ajouter le champ personnalisé natif
Ouvrez la ressource créée en leçon A.
- Enregistrez votre contenu.
- Ouvrez le menu à trois points de l’éditeur.
- Recherchez Préférences, puis l’option permettant d’afficher les champs personnalisés.
- Activez cette option et acceptez le rechargement si WordPress le demande.
- Repérez le panneau « Champs personnalisés ».
Les intitulés et onglets varient selon la version. La documentation recommande d’enregistrer le contenu avant ce changement, car un rechargement peut être nécessaire.
Ajoutez :
Nom :
t1pp_duree
Valeur :
15 minutesValidez l’ajout du champ, puis mettez la ressource à jour.
Si le panneau est absent, vérifiez que le type prend en charge custom-fields et qu’une extension ne remplace pas cette interface. Ne créez pas un second système de champs au hasard.
Fonction concrète 2 : afficher la durée
Créez un deuxième snippet :
T1PP | Shortcode de durée d’une ressourceAjoutez :
// Retourne la durée associée au contenu courant.
function t1pp_afficher_duree( $atts ) {
// Valeur utilisée si aucun libellé n'est fourni.
$atts = shortcode_atts(
array( 'libelle' => 'Durée indicative' ),
$atts,
't1pp_duree'
);
// Lire le champ du contenu actuellement affiché.
$duree = get_post_meta(
get_the_ID(),
't1pp_duree',
true
);
// Ne rien afficher si la valeur est vide ou inattendue.
if ( ! is_string( $duree ) || '' === trim( $duree ) ) {
return '';
}
// Retourner le HTML avec les textes protégés.
return '<p class="t1pp-duree">'
. esc_html( $atts['libelle'] )
. ' : '
. esc_html( $duree )
. '</p>';
}
add_shortcode( 't1pp_duree', 't1pp_afficher_duree' );shortcode_atts() combine les attributs reconnus avec leurs valeurs par défaut. Le résultat du shortcode est retourné à WordPress, qui l’insère à l’emplacement prévu. Les textes affichés passent par esc_html().
Ce code lit une valeur déjà enregistrée. Il ne crée pas de formulaire et ne gère pas une soumission de données.

Utiliser le shortcode
Activez le snippet, puis ajoutez un bloc « Code court » dans votre ressource :
[t1pp_duree]Consultez l’aperçu ou la page côté visiteur.
Résultat attendu :
Durée indicative : 15 minutesEssayez ensuite :
[t1pp_duree libelle="Temps à prévoir"]Résultat attendu :
Temps à prévoir : 15 minutesTester les cas limites
| Manipulation | Résultat attendu |
|---|---|
Remplacer le champ par 20 minutes | La durée affichée change après enregistrement |
| Vider le champ | Aucun paragraphe de durée n’est produit |
Remettre 15 minutes | L’affichage revient |
Modifier l’attribut libelle | Le libellé change |
| Désactiver le snippet | Le shortcode n’est plus interprété |
Si le snippet est désactivé, le texte du shortcode peut rester visible dans le contenu public. Avant une mise en production, prévoyez donc aussi son retrait ou son remplacement.
Cet exemple vise un shortcode placé dans le corps d’un contenu individuel. N’en déduisez pas qu’il fonctionnera à l’identique dans tous les modèles, boucles ou widgets.
La limite de ce champ simple
Le champ natif ne fournit pas ici un formulaire métier contrôlant une durée numérique, une unité et des règles de saisie.
Si vous avez besoin de plusieurs champs obligatoires, de listes de choix, de relations ou de validation, évaluez une solution de champs structurés plutôt que d’empiler des snippets.
À vous de jouer
Conservez une capture de l’affichage et notez :
Champ utilisé :
Valeur testée :
Shortcode utilisé :
Résultat avec une valeur :
Résultat avec un champ vide :
Retour arrière prévu :À retenir
Un shortcode retourne son résultat avec return ; il affiche une information à l’endroit choisi.