Développeurs

Composants CMS comme blocs

Tous les composants frontend enregistrés par vos plugins peuvent être placés sur une page PageTree comme des blocs, avec leurs propriétés modifiables dans un formulaire.

Ajouter un composant

1. Cliquez sur Ajouter un composant.
2. Les composants CMS sont rangés par plugin dans la bibliothèque. Cliquez sur celui que vous voulez.
3. Double-cliquez sur le bloc pour régler ses propriétés.
4. Enregistrez la page.

Ce qui fonctionne

• Les propriétés déclarées par defineProperties() sont présentées sous forme de formulaire : texte, texte multiligne, case à cocher, liste déroulante (y compris get{Property}Options() et optionsMethod) et listes de chaînes (une valeur par ligne).
• Sur le site, le composant est déclaré sur la page comme dans une page CMS classique : init(), onRun(), les gestionnaires AJAX, les partials du composant et ses fichiers CSS/JS fonctionnent normalement.

Limites

• Aperçu : dans le back-office, l’aperçu affiche une carte qui résume le composant et ses propriétés. Le rendu réel n’apparaît que sur le site.
• Propriétés non modifiables : les propriétés de type set, dictionary, object et objectList ne sont pas modifiables pour l’instant. Elles gardent leur valeur par défaut.
• Paramètres d’URL : les paramètres comme {{ :slug }} ne sont pas disponibles sur les pages PageTree.
• Fichiers CSS/JS : ils sont produits par {% styles %} et {% scripts %}. Le layout de la page doit contenir ces balises (voir Intégration au thème).
• Plugin désactivé : si le plugin du composant est désactivé ou supprimé, le bloc affiche « Ce composant CMS n’est pas disponible ».

Alias et surcharge des partials

L’alias du composant est généré à partir de l’identifiant du bloc : pagetreeComponent_<blockId>.

Pour surcharger les partials du composant dans votre thème, placez-les dans le dossier :

themes/votre-theme/partials/pagetreeComponent_<blockId>/

La surcharge vaut donc pour un bloc précis, pas pour toutes les utilisations du composant.