Décorateur

Les 5 notions principales pour aborder la décoration de contenu sont les suivantes :

• Les types de contenu eux-même : abstraction des objets métier de votre projet, objet de base autour duquel le moteur de décoration va construire un template.
• Les thèmes : namespace des éléments Synapse, chaque élément sous-jacent est toujours référencé à l'intérieur d'un thème. Physiquement, il correspond au bundle Symfony qui déclare le thème et les templates, souvent votre bundle d'application front.
• les templates : gabarits de page, layout, cœur du pattern decorator, il est en particulier le template Twig dans lequel sera rendu le contenu, et est composé de zones.
• les zones : espaces dans un template, déclarés via des tags similaires à des blocks Twig, dans lequelles il est possible d'ajouter et de rendre des composants.
• les composants : éléments de décoration d'un contenu, ajoutés dans une zone et porteurs de données utilisables dans leur contexte de rendu seulement.

Ces éléments sont chacun adjoints d'un "type". Ces types sont créés depuis la configuration et le prototypage des thèmes. Ils définissent les informations spécifiques au rendu d'un template, comme en particulier les templates Twig à appeler, les configurations par défaut, les composants autorisés pour telle ou telle zone, les formats d'images etc...

Le prototypage des ces éléments permet de disposer d'une grande flexibilité sur le modèle et le moteur de rendu de Synapse, sans pour autant écrire la moindre ligne de code Php : les développeurs en charge du front peuvent donc reprendre leurs droits sur le paramétrage de leurs rendus, et ainsi maîtriser toute la chaîne de décoration d'un contenu.

Pour tous les exemples suivants de cette documentation, nous utiliserons les objets suivants :

• l'objet Page, issu du PageBundle
• un objet News, custom, avec les champs :
  • Title
  • Date
  • Headline
  • Body

Nous considérerons également qu'une base de données gérée par Doctrine a été initialisée pour gérer les objets News.