Fonctions avancées · Leçon 16/20 · 15 min

Créer un shortcode pour afficher un contenu réutilisable

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.

  1. Type de contenu : Ressource
  2. Une ressource : « Préparer une modification »
  3. Champ personnalisé : t1pp_duree = 15 minutes
  4. Shortcode : [t1pp_duree]
  5. Affichage : Durée indicative : 15 minutes
Du champ personnalisé à l’affichage du shortcode.

Ajouter le champ personnalisé natif

Ouvrez la ressource créée en leçon A.

  1. Enregistrez votre contenu.
  2. Ouvrez le menu à trois points de l’éditeur.
  3. Recherchez Préférences, puis l’option permettant d’afficher les champs personnalisés.
  4. Activez cette option et acceptez le rechargement si WordPress le demande.
  5. 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 minutes

Validez 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 ressource

Ajoutez :

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

Capture d’écran du haut de la page « Video shortcode » (documentation WordPress).
Page officielle « Video shortcode » de la documentation WordPress (page en anglais).

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 minutes

Essayez ensuite :

[t1pp_duree libelle="Temps à prévoir"]

Résultat attendu :

Temps à prévoir : 15 minutes

Tester les cas limites

ManipulationRésultat attendu
Remplacer le champ par 20 minutesLa durée affichée change après enregistrement
Vider le champAucun paragraphe de durée n’est produit
Remettre 15 minutesL’affichage revient
Modifier l’attribut libelleLe libellé change
Désactiver le snippetLe 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.

Toutes les formations

Formations connexes

Nos autres formations

Toutes les formations