editable |
Éditable |
|---|---|
| Liquid (Microsoft) | |
Syntaxe
|
{% editable nom_du_contenu %} ... contenu par défaut ... {% endeditable %} |
Paramètres
| Nom | Description |
|---|---|
| nom_du_contenu | Ce paramètre permet d'indiquer le nom unique associé à la zone de contenu, afin qu'elle puisse être modifiée directement via l'interface du portail. |
Description
Cette balise permet de rendre une zone de contenu modifiable dans le portail, utile pour les utilisateurs autorisés.
Remarques
- Permet de déléguer la gestion du contenu : La balise {% editable %} permet à des utilisateurs non techniques de modifier le contenu d'une section directement depuis l'interface du portail. Cela réduit la dépendance aux développeurs pour les mises à jour fréquentes de texte ou d'éléments visuels.
- Identification via un nom unique : Le paramètre nom_du_contenu doit être unique dans la page ou le site. Ce nom sert de clef pour lier le contenu affiché à son équivalent modifiable dans l'interface de gestion. Une mauvaise gestion de ces noms peut entraîner des conflits ou des zones non modifiables.
- Contenu par défaut de secours : Le contenu placé entre les balises {% editable %} et {% endeditable %} sert de valeur par défaut, c'est-à-dire qu'il est affiché jusqu'à ce qu'il soit remplacé via l'éditeur du portail. Cela garantit un affichage fonctionnel même avant toute personnalisation.
- Sécurité et permissions en ensemble : Seuls les utilisateurs ayant les droits d'édition appropriés sur le portail peuvent modifier les zones editable. Cela permet de restreindre la modification à des rôles spécifiques comme les administrateurs de contenu ou les éditeurs désignés.
- Idéal pour les sections de texte récurrentes : Cette balise est très utile pour des sections changeant souvent, comme des encadrés d'annonce, des descriptions d'événements, ou des zones d'accueil. Elle évite que chaque modification nécessite une re-publication du site ou un déploiement technique.
- Ne s'applique pas à tout le contenu dynamique : La balise editable est conçue pour du contenu statique ou semi-statique. Elle ne permet pas d'éditer directement des éléments comme des résultats de base de données, des listes dynamiques ou des composants personnalisés. Elle est donc complémentaire à d'autres balises.
- Compatible avec les zones de contenu personnalisées : Sur Power Pages, cette balise peut être utilisée pour créer des zones de contenu réutilisables et localisées. Par exemple, une même zone editable peut être définie en plusieurs langues ou contextes selon la configuration multilingue du portail.
- Bonne pratique : nommage structuré : Il est recommandé d'utiliser un nommage structuré pour le paramètre nom_du_contenu, tel que "accueil.zone_intro" ou "evenement.description". Cela facilite l'organisation du contenu côté administration et réduit le risque d'ambiguïté dans les projets complexes.
Dernière mise à jour : Mercredi, le 23 Juillet 2025