TemplaVoila
Un article de Typo3 CMS / Documentation Typo3 / Support Typo3.
Sommaire |
[modifier] Présentation
TemplaVoilà est une extension qui a été développée dans le cadre d'un projet pour l'entreprise Dassault Systemes.
TemplaVoilà permet de créer des structures de pages plus flexibles que celles utilisant la notion classique de “colonnes” et facilite le mapping de contenu grâce à son interface graphique.
[modifier] Utilisation dans typoscript
Avant d'utiliser TemplaVoilà comme mécanisme d'intégration, il faut que le TypoScript soit paramétré pour son utilisation. Pour cela le contenu de l'objet « PAGE » doit être lié à la fonction de traitement de TemplaVoilà
# Default PAGE object: page = PAGE page.typeNum = 0 page.10 = USER page.10.userFunc = tx_templavoila_pi1->main_page
[modifier] Mise en place d'un gabarit de page
Pour créer un gabarit de page avec TemplaVoilà sélectionner « Filelist » dans la colonne de gauche Apparaît alors la liste des fichiers disponibles.
Cliquer sur l'icône associée au fichier html que vous souhaitez utiliser dans TemplaVoilà.
Dans le menu contextuel qui s'ouvre, sélectionner « TemplaVoilà »
L'interface qui suit va permettre de réaliser le mapping de page et de contenu à l'instar de ce qui était réalisé avant en TypoScript via les marqueurs dans le template.
La création d'une nouvelle zone de contenu au sein de notre gabarit s'effectue en trois temps :
1) On crée l'élément de contenu
- On donne un nom à la zone
- On clique sur « Add »
2 ) On définit les propriétés de la zone
- Mapping Type:Définit le type de mapping« Element » pour un élément de contenu standard
- Title:Titre de la zone
- Sample Data:Texte de substitution lors des prévisualisations
- Editing Type:Type d'élément « Content Elements pour une zone contenant des éléments de contenu classiques »
3) On mappe la zone
Chaque élément créé doit être mappé, c'est à dire que l'on définit la zone dans le gabarit HTML où l'élément de contenu apparaîtra. Pour cela sélectionner le bouton « Map » associé à l'élément à mapper.
Dans la page qui s'ouvre, sélectionner le tag HTML dans lequel l'élément de contenu doit être inclus.
Une fois l'élément mappé,sélectionner le type d'action OUTER ou INNER
Une fois tous les éléments mappés, sauvegarder grâce au bouton « Save As ».
Dans la fenêtre qui s'ouvre
- Choisissez un nom pour votre template
- Définissez le Template Type comme template de page « Page Template ».
- Sélectionnez le dossier sysfolder qui stockera le gabarit.
Arrivé à ce stade nous disposons d'une structure de page qui définit des zones de contenus et leur mapping au sein d'une page HTML statique.
[modifier] Exploitation du gabarit
Nous pouvons désormais affecter à une page le gabarit que nous venons de créer. Pour cela nous devons éditer les propriétés de la page en question
Dans cette page nous devons
- préciser le dossier dans lequel est stocké notre gabarit Templavoila.
- choisir le template Templavoila à utiliser
