substitution

Syntaxe

Paramètres

Description

Cette balise permet de remplacer dynamiquement du contenu basé sur un nom de substitution défini dans le portail.

Remarques

• Utile pour insérer du contenu dynamique dans des pages partiellement mises en cache : La balise {% substitution %} permet d'entourer une portion de contenu devant être recalculée ou rechargée dynamiquement à chaque affichage, même si le reste de la page est mis en cache. C'est essentiel pour afficher des données variant selon l'utilisateur ou le contexte.
• Le contenu inclus est remplacé à l'exécution par le moteur de substitution : Lors du rendu de la page, le contenu à l'intérieur de la balise substitution est remplacé par une valeur dynamique définie dans le portail (dans la section "Substitutions de contenu"). Cela permet d'insérer facilement des chaînes variables comme le nom de l'utilisateur ou des messages personnalisés.
• Aucune variable Liquid n'est évaluée à l'intérieur de la balise : Contrairement aux autres blocs Liquid, le code placé à l'intérieur de {% substitution %} n'est pas traité comme du Liquid, mais comme un identifiant de substitution. Ce sont les définitions configurées dans le portail contrôlant ce qui sera affiché.
• Idéal pour afficher des données sensibles ou personnalisées à la volée : Lorsque certains contenus varient selon la session (comme un solde de points, un nom de connexion ou des instructions ciblées), on peut utiliser cette balise pour garantir que ces données ne sont pas stockées dans le cache de la page et restent confidentielles.
• Les substitutions sont définies dans l'administration du portail Power Pages : Pour qu'une substitution fonctionne, il faut créer un enregistrement correspondant dans le modèle de données du portail (via l'entité Web Template Substitution). La balise recherche alors ce nom et remplace son contenu dynamiquement à l'exécution.
• Permet d'introduire une couche d'abstraction dans la gestion du contenu : En définissant des substitutions réutilisables dans l'administration, les développeurs et les éditeurs de contenu peuvent centraliser certains textes ou blocs HTML. Cela évite de modifier plusieurs pages à la fois en cas de changement de contenu.
• Ne doit pas être confondue avec la balise include ou assign : Contrairement à include, insérant des fichiers, ou assign, affectant une variable, substitution est un mécanisme de remplacement lié au contexte d'exécution et non à la structure du fichier Liquid. Elle intervient plus tard dans le cycle de rendu.
• Peut servir à contourner les limitations du cache côté serveur : Certaines pages du portail sont mises en cache pour améliorer les performances. La balise substitution permet d'injecter du contenu non-caché dans ces pages sans désactiver tout le cache. C'est donc un compromis utile entre performance et personnalisation.