Futuristic Template Building (FTB1 FR)

Transcription

1 Futuristic Template Building (FTB1 FR) Extension Key: doc_tut_ftb1_fr Copyright 2005, Raphael GEYER (), traduction de Futuristic Template Building (FTB) de Kasper Skårhøj et Robert Lemke This document is published under the Open Content License available from The content of this document is related to TYPO3 - a GNU/GPL CMS/Framework available from Table of Contents Futuristic Template Building (FTB2)...1 Introduction... 1 Qu'apporte cette extension?...1 But... 2 L'extension TemplaVoila... 2 Dédicace...2 L'extension...2 ATTENTION logiciel en version beta... 3 Intégration d'une page de gabarit en HTML - avec TemplaVoila... 4 Introduction... 4 Le gabarit HTML... 4 Installation de Static info tables, TemplaVoila et de CSS Styled Content... 6 The Storage Folder...7 Création du gabarit TypoScript...8 Création de l'objet gabarit pour le gabarit du site (première méthode)... 9 Data Structures (DS) et Template Objects (TO) Utilisation du TO comme gabarit de page...16 Configuration de css_styled_content pour le rendu du contenu Ajout du contenu des pages...17 Création du menu dynamique Affectation du stylesheet et de la balise <body>...23 Résumé Création de gabarits de page supplémentaires Modification d'un couple DS/TO existant...29 Gabarit d'impression...31 Gabarit alternatif pour une section du site Création d'une page à deux colonnes Des icônes pour les TOs et les DSs...46 Les éléments de contenu flexibles Flexible Content Elements Création d'un élément flexible de base (FCE)...49 Créer un élément de contenu grille...56 Création d'un second gabarit pour le FCE à 2 colonnes Les éléments de contenu utilisant des objets répétés. 62 Création d'un élément flexible de type liste...72 Divers Utilisation du TypoScript dans les Structures de Données DS Informations concernant le mappage Reste à faire de TemplaVoila Introduction Qu'apporte cette extension? Cette extension est un tutorial réactualisé, par, de Création de gabarits futuristique écrit par Kasper Skårhøj et Robert Lemke permettant la création d'un site de gestion de contenu sous TYPO3 basé sur un gabarit HTML et utilisant l'extension TemplaVoila (ext key: templavoila ). Ce tutorial est basé sur le même contenu que Futuristic Template Building, Part 1 il reprend les mêmes éléments, mais présente l'interface actualisée de Templavoila et décrit une utilisation plus avancée de cette extension. Ce document est recommandé aux développeurs débutants et avancés. Néanmoins, avant de débuter il est conseillé de suivre les tutoriaux Débuter avec Typo3 et Modern Template Building, Part 1 de manière à connaître les bases de TYPO3. Le site que vous allez être guidé afin de réaliser ceci : Futuristic Template Building (FTB1 FR) - 1

2 But Le but de ce tutorial est de vous présenter un nouveau concept de réalisation des gabarits en utilisant l'extension templavoila basée sur les notions de FlexForms et Data Structures. La méthode traditionnelle d'intégration du contenu dans des colonnes sera également remplacé par une intégration arborescence et imbriquée. L'extension TemplaVoila L'extension TemplaVoila a été développée par Kasper Skårhøj et Robert Lemke pour un projet d'une grande entreprise française, Dassault Systemes. TemplaVoila et le résultat de l'innovation permettant la résolution de problèmes rencontrés lors du projet En particulier le fait que TemplaVoila permette de créer des structures de pages plus flexible que la méthode traditionnelle utilisant la notion de colonnes. De plus, elle intègre la notion de gabarits liés aux éléments de contenu et ceci en utilisant une méthode plus flexible basée sur une interface graphique. Finalement le développement de TemplaVoila a également fait évoluer le corps de TYPO3, en particulier le concept de FlexForms qui permet, dans le backend, de créer des formulaires hiérarchiques et de stocker leurs contenu en XML. Dédicace Kasper dédie la version anglaise du document Futuristic Template Building à ses amis de Dassault Systemes en France. L'extension Tous les fichiers de ce tutorial sont contenus dans l'extension TYPO3 (doc_tut_ftb1_fr). En général les extensions contiennent des scripts et des ressources qui étendent les possibilités de TYPO3. Néanmoins cette extension n'interagit pas avec le corps de typo3 si vous l'installée elle permet uniquement de transférer les fichiers vers votre serveur et d'ajouter les fichiers du tutorial à votre serveur et d'ajouter ce document en ligne sur typo3.org. Ainsi pour suivre ce tutorial : il faut installer le dummy-package (voir la section Les bases du tutorial Modern Template Building, Part 1 ) Futuristic Template Building (FTB1 FR) - 2

3 puis il faut importer l'extension "doc_tut_ftb1_fr" du TER (TYPO3 Extension Repository) avec le gestionnaire d'extensions (Extension Manager) et vous aurez tous les fichiers à porté de main sur votre serveur. Ce tutorial peut également être lu en ligne ou vous pouvez le télécharger sous le format openoffice SXW et Acrobat PDF depuis typo3.org. ATTENTION logiciel en version beta Bien que TemplaVoila soit utilisé en production cette extension n'est pas encore terminée. Vous devez être conscient en lisant ce document que certains éléments risquent de changer et que ce document sera amené à être profondément révisé lors de la publication de la version de TemplaVoila. Notez également que la version de de TYPO3 est nécessaire à ce tutorial! Futuristic Template Building (FTB1 FR) - 3

4 Intégration d'une page de gabarit en HTML - avec TemplaVoila Introduction Ce chapitre présente l'intégration du gabarit présenté dans Modern Template Building, Part 1 mais en utilisant TemplaVoila à la place de l'extension Auto-parse Template. Ceci permet de démontrer toute la puissance de TemplaVoila! En introduction des principes que nous allons suivre veuillez lire en premier le chapitre Implementation of a CMS in Modern Template Building, Part 1. Installation du dummy-package et de l'arborescence des pages? En premier vous devez posséder une base vierge de TYPO3 généralement le dummy-package est ce qu'il vous faut. Puis vous devrez créer l'arborescence de pages présentée dans le chapitre The Basics du Modern Template Building, Part 1 (MTB/1). Vous n'êtes pas obligé de suivre le restant du chapitre The Basics dans MTB/1 il suffit de créer la structure des pages. Vous devriez obtenir une arborescence de pages ressemblant à ceci : Le gabarit HTML L'équipe web travail pour un nouveau client - Main Dish & Son - et Raphael, l'artiste de l'équipe, a réalisé le gabarit sous forme de fichier HTML standard: Futuristic Template Building (FTB1 FR) - 4

5 Ce fichier HTML template_page.html est placé dans le dossier "fileadmin/templates/main/" relatif à l'installation de TYPO3. Pour suivre ce tutorial vous devez copier le dossier "templates/" de cette extension dans le dossier "fileadmin/. Vous devez pour cela importer l'extension doc_tut_ftb1_fr" depuis le TER! Revenons au travail de Raphael; le gabarit HTML est une simple page HTML. Mais lorsque TYPO3 importe ce fichier il est important de rendre certaines parties dynamiques. Ceci inclue le menu de gauche et la section de contenu située au centre et à droite. Etudions le code de cette page. Avec TYPO3 c'est simple il suffit d'aller dans le module File > Filelist, de cliquer sur le titre du dossier principale et de cliquer sur le titre de la page : Ceci ouvre le fichier dans un navigateur. L'observation du code source de la page HTML montre un simple document validé XHTML faisant référence à un fichier de style et utilisant un tableau pour positionner les éléments dans la page : Futuristic Template Building (FTB1 FR) - 5

6 Quelques commentaires concernant ce gabarit HTML et les défis à relever : 1. Cette section de l'entête du document doit être reprise puisqu'elle permet de faire référence à la feuille de style utilisée. Défi: Nous devons nous assurer que cette section soit extraite et régénérée par le moteur de rendu! 2. Le menu de gauche est réalisé en utilisant une balise <div> par élément du menu. A chacun de ces <div>- est associée une classe. Avec cette classe le design de chaque élément est géré en CSS depuis la feuille de style. Ceci est une très bonne méthode de création de menus puisque chaque élément est constitué d'un minimum de code HTML, et ils sont facilement répétables (nécessaire lorsque les menus sont dynamiques). Défi: Nous devons remplacer le menu statique par un menu dynamique issu de Typo3! 3. Ceci est la section de contenu que Raphael a placé dans le gabarit pour obtenir un rendu visuel cohérent. Notez le formatage du contenu avec des balises <h1> et <p> (utilisant la classe "bodytext") ceci est intéressant puisque le contenu dynamique généré par TYPO3 utilise également ces balises pour le formatage! (Raphael doit déjà avoir une expérience sous TYPO3, n'est-ce pas?) Défi: Nous devons remplacer le contenu de la page par du contenu dynamique issu de TYPO3. Maintenant que les fichiers du tutorial sont en place, nous passons à l'étape suivante l'installation des extensions nécessaires. Installation de Static info tables, TemplaVoila et de CSS Styled Content Nous devons maintenant installer TemplaVoila qui est notre moteur de gabarit et de génération de contenu. CSS Styled Content est également nécessaire pour le rendu des contenus standards de n'importe quel site classique sous TYPO3. Futuristic Template Building (FTB1 FR) - 6

7 Si vous ne l'avez pas encore fait, importez static_info_tables, TemplaVoila et css_styled_content depuis le TER (TYPO3 Extension Repository) en utilisant le gestionnaire d'extensions EM. Lorsque cela est fait, installez les trois extensions : Lors de l'installation de TemplaVoila vous devriez activer le sélecteur de gabarit Enable Page Template Selector dans l'écran de mis à jour : Appuyez sur Update et toutes les tables et champs de la base de données seront créés automatiquement! Après avoir installé TemplaVoila, il faut réactualiser recharger votre backend puisque l'extension contient de nouveaux modules. css_styled_content Il faut maintenant installer l'extension CSS Styled Content : The Storage Folder Nous allons créer un autre élément essentiel de notre site le Storage Folder. Normalement les éléments relatifs à une page sont stockés dans la page elle-même comme par exemple les éléments de contenu ou les utilisateur du frontend. Néanmoins il est souvent nécessaire de disposer d'un point central de stockage des éléments relatifs à l'ensemble du site et pas seulement à une seule page c'est ce que nous appelons le Storage Folder (Dossier de stockage); Il s'agit d'une page définie comme SysFolder (dossier système) qui sera utilisée pour stocker ces éléments relatifs à toute une branche de l'arborescence des pages. Les étapes pour réaliser ce dossier système sont : Créer une page de type SysFolder (dossier système) dans l'arborescence des pages. En général cette page est la dernière page du premier niveau dans l'arborescence des pages. Puis il faut créer une relation dans General Storage Folder vers ce dossier dans l'entête de la page racine (root page) du site. La copie d'écran précédente montre le dossier système créé. Mais pour le configurer comme storage folder du site il faut Futuristic Template Building (FTB1 FR) - 7

8 éditer l'entête de page de Root page : Et c'est tout. Création du gabarit TypoScript Puis, il faut créer un gabarit pour la page Root page. Pour plus de détails vous pouvez vous référer au MTB/1 où cette méthode est décrite de manière plus détaillée. Le but est d'obtenir un gabarit avec le contenu suivant : Le code visible dans Setup est appelé Template TypoScript - c'est du code de configuration que le moteur de rendu de TYPO3s (frontend engine) (de l'extension cms ) interprète afin d'afficher la page du site. Dans l'exemple précédent le texte HELLO WORLD est affiché. Si vous avez une certaine expérience du TypoScript vous savez que Futuristic Template Building (FTB1 FR) - 8

9 a) le champ Setup peut finir par représenter plusieurs centaines de lignes, b) qu'après un certain temps il devient plus difficile à gérer et c) il faut de bonnes connaissances en TypoScript, généralement le contenu de TSref. Si vous connaissez la méthode employée avec le tutorial MTB/1 vous savez que la quantité de Typoscript utilisée n'était pas aussi conséquente. En fait nous avions seulement configuré l'extension automaketemplate afin de lire le contenu d'un fichier externe en HTML et ensuite nous insérions du contenu dynamique à certains endroits. Cette configuration ne nécessitait qu'une centaines de lignes, les menus mis à part. Ce qui représente beaucoup moins que par le passé. Si vous poursuivez ce document vous verrez que nous n'allons pas ajouter d'autres lignes, nous ne faisons que remplacer les deux dernières : Ainsi, la seule chose nécessaire à l'utilisation de TemplaVoila, en ce qui concerne le TypoScript, est le code suivant : # Default PAGE object: page = PAGE page.typenum = 0 page.10 = USER page.10.userfunc = tx_templavoila_pi1->main_page (Il faudra néanmoins par la suite rajouter du TypoScript puisque nous devrons définir/construire le menu...) Enregistrez le code. Si vous consultez le site vous verrez une page avec un message d'erreur indiquant que la configuration n'est pas terminée: Il faut maintenant créer un objet gabarit pour TemplaVoila (TO) et l'associer au site. Création de l'objet gabarit pour le gabarit du site (première méthode) Allez dans le module File > Filelist, cliquez sur le dossier templates/main/ et cliquez sur l'icône du fichier template_page.html : Ceci vous dirigera vers l'interface de mappage de TemplaVoila : Futuristic Template Building (FTB1 FR) - 9

10 Avec cette interface nous allons créer une Data Structure (DS - structure de données) pour le gabarit de la page et mapper ce DS avec les éléments HTML du fichier de gabarit puis pour finir nous allons stocker les informations de mappage dans un Template Object (TO) créé à partir du DS. Data Structures (DS) et Template Objects (TO) De plus amples informations techniques sont disponibles dans Data Structures du document TYPO3 Core API ainsi que dans la documentation de TemplaVoila. Néanmoins, pour résumer les différences entre DS et TO: Une Data Structure (DS) liste les champs que l'on peut mapper vers un fichier HTML. Un Template Object (TO) associe des champs du DS avec des éléments du fichier HTML. Avec cette définition nous voyons qu'un TO fait toujours lié à un DS qui indique au TO quels champs peuvent être mappés et avec quels règles et hiérarchie. Ceci implique également qu'il est possible d'avoir plusieurs TO faisant référence à une même DS c à d plusieurs gabarits pour les mêmes données! Création de la Data Structure de Main Dish & son Dans ce tutorial la structure de données DS nécessaire pour le fichier gabarit est : Définition de l'élément global contenant la page ce qui correspond a la balise <body>! Menu: Définition du conteneur du menu de gauche Contenu: Définition du conteneur de la cellule de contenu. Un tel DS pourrait être créé à la main si on connaît la syntax XML du DS, <T3DataStructure>. Néanmoins, TemplaVoila permet la création graphique avec une fonction de pointer/cliquer d'une telle structure de données! Futuristic Template Building (FTB1 FR) - 10

11 Ajout d'un élément représentant le menu : (Le nom field_menu est préfixé par field_ qui est une convention appliquée par défaut. Mais vous pouvez utiliser d'autres noms si vous le souhaitez.) Ceci affiche un formulaire permettant de saisir les détails du nouvel élément : Puis en validant avec Add, il reste à définir le nom de l'objet TypoScript identifiant le menu, dans notre cas lib.menu_1 Vous pouvez saisir les informations de façon identique aux copies d'écran. De plus amples détails sont disponibles dans la documentation de TemplaVoila mais les principaux points sont : Mapping Type: permet de définir la manière dont les éléments sont mappés vers le document HTML. Choisissez Element Editing Type: permet de sélectionner le type de contenu du champs. Dans notre cas nous allons insérer du contenu provenant d'un objet TypoScript que nous allons définir à l'aide d'un objet HMENU plus tard! Mapping rules: Comme le menu sera amené à être contenu dans des balises HTML de type <div> ou <td> etc... nous définissons une règle *:inner qui permettra de mapper le menu à l'intérieur d'un élément. Après avoir validé avec Add, Update puis Cancel/Close vous verrez ceci : Puis répétez ce procédé pour le contenu de la page : Futuristic Template Building (FTB1 FR) - 11

12 Ici nous sélectionnons Content Elements dans Editing Type ceci permet d'insérer des blocs de contenu par la suite. Après avoir validé avec Add et Cancel/Close nous disposons maintenant d'une structure de données reflétant nos besoins décrit précédemment c à d un menu et une cellule de contenu: Mappage du DS vers le contenu HTML Après avoir créé le DS (vous auriez également pu le faire pendant le mappage) vous devez mapper les éléments du DS vers la balise correspondante dans le fichier HTML. Appuyez sur Map de l'élément ROOT, puis cliquez sur l'icône de la balise <body> de la section Mapping Window : Puis sélectionnez le type de mappage dans la colonne Action de l'élément ROOT : Pour toutes les balises block-elements (le nom que je donne aux balises HTML qui ont par paires une de début et une de fin, telles que. <td>...</td> or <div>...</div>, contrairement à <img...>) vous pouvez choisir un mappage INNER ou OUTER. Ceci implique que nous remplaçons le contenu interne de la balise (en excluant la balise) ou l'extérieur de la balise (en incluant la balise). Puisque nous souhaitons placer du contenu dans la balise <body> en excluant la balise <body> nous choisissons INNER. Futuristic Template Building (FTB1 FR) - 12

13 Ce qui donne : Le formulaire montre que l'élément ROOT a été mapper avec succès vers la balise <body> du gabarit! Et comme l'élément ROOT est l'élément parent de base de des éléments menu et contenu nous pouvons maintenant mapper le reste du DS. Cliquez sur le bouton Map de l'élément field_menu du DS. Puis sur l'icône de la balise <td> contenant le menu provisoire du gabarit HTML : Notez que cette fois ci nous n'avons pas d'autre choix que INNER : Ceci est du au fait que nous avions définie une règle limitant le mode à INNER - ceci laissera la balise dans le gabarit HTML et ne remplacera que son contenu par notre menu dynamique. Donc choisissez à nouveau INNER pour le mappage de cet élément : Il ne reste plus qu'à mapper l'élément Page content du DS : Futuristic Template Building (FTB1 FR) - 13

14 Comme pour les autres éléments nous utilisons le type INNER. Vous devriez obtenir ceci : Vous pouvez vérifier votre mappage un cliquant sur les liens de la colonne HTML-path. Ceci n'affichera que la section du gabarit HTML concernée : Prévisualisation du mapping Puisque nous avions saisi des données de test (champ Sample Data) dans le DS nous avons la possibilité de prévisualiser le résultat. Appuyez simplement sur le bouton Preview : Ceci génère la fenêtre Mapping Window pour vous : Futuristic Template Building (FTB1 FR) - 14

15 Sauvegarde du DS et TO Jusqu'à présent toutes les opérations réalisée sont stockées dans les données de votre session d'utilisateur du backend. Pour finir vous devez cliquer sur le bouton Save puis Donner un titre pour le couple DS / TO (ceci pourra être changé par la suite) Sélectionnez le type de gabarit, dans notre cas il s'agit d'un gabarit de page Page template (ceci indique à TYPO3 que ce gabarit s'applique à une page complète). Sélectionnez le dossier de stockage (Storage Folder) qui contiendra le DS et TO seul un dossier devrait être disponible. Si vous vous ne pouvez sélectionner aucun storage folder, cela signifie que vous avez commis une erreur au début du tutorial!) Si tout est OK vous devriez obtenir : Futuristic Template Building (FTB1 FR) - 15

16 Et dans le dossier de stockage Storage Folder vous retrouvez le DS et TO que vous venez de créer! Utilisation du TO comme gabarit de page Pour résumer : Fichiers de gabarit: Copie des fichiers HTML du graphiste dans fileadmin/templates/main/ Extensions: Installation de Static info tables, TemplaVoila et CSS Styled Content Storage Folder: Configuration du dossier de stockage du site. Gabarit TypoScript: Création d'un gabarit TypoScript à la racine du site contenant uniquement un cobjet USER permettant l'utilisation de TemplaVoila. Création du DS/TO: Création d'une structure de données (DS) et d'un Template Object (TO) pour le gabarit principale La dernière étape consiste à définir le TO créé comme étant le gabarit par défaut des pages. Pour cela il suffit d'éditer l'entête de la page Root page : Ceci affecte le DS permettant à TYPO3 de connaître les options de la page (dans notre cas il s'agit : d'un menu et du contenu de page). Puis il faut sauvegarder l'entête de page. Il est maintenant possible de sélectionner le type de rendu (c à d le TO): Puis sauvegardez une dernière fois - éventuellement en utilisant Sauvegarder et visualiser : Futuristic Template Building (FTB1 FR) - 16

17 Effectivement le gabarit est bien utilisé lors de la génération de la page. Mais il reste encore à : Configurer css_styled_content pour le rendu du contenu Ajouter le contenu des pages Créer dynamiquement le menu Affecter la feuille de style Configuration de css_styled_content pour le rendu du contenu Avant que le contenu des pages puisse être généré nous devons définir un gabarit statique permettant cela. Il en est de même pour les autres développements sous TYPO3; pour cela il faut éditer le gabarit Typoscript et ajouter CSS Styled Content : Sauvegardez, quittez et videz le cache. Ajout du contenu des pages Un des principaux changements qu'apporte TemplaVoila est le nouveau concept d'intégration du contenu des pages. Jusqu'à présent nous utilisions le concept de colonnes d'une page. Ainsi les éléments sont affichés en fonction de la page et de la colonne à laquelle ils appartiennent. Avec TemplaVoila le contenu est toujours associé à une page mais il existe une relation allant de la page (ou d'un élément de niveau supérieur) vers l'élément de contenu! Cette relation à une direction opposée au fonctionnement standard de TYPO3 puisque jusqu'à présent les éléments de contenu faisaient référence à la page et à la colonne qui les contenait! Nous y reviendrons plus tard. Pour l'instant affichons le contenu du nouveau module Page : ATTENTION: Le module de page n'est pas encore terminé. Les copies d'écran risque de ne pas être à jour! Pour créer du contenu dans une page, il faut cliquer sur l'icône nouveau : Futuristic Template Building (FTB1 FR) - 17

18 Ceci permet d'inclure un élément traditionnel (TEXT, TEXT et IMAGE etc...) : Puis nous ajoutons du texte extrait du gabarit HTML : Sauvegardez, et vous obtenez : Futuristic Template Building (FTB1 FR) - 18

19 Ceci est la méthode TemplaVoila pour ajouter du contenu aux pages. Vous pouvez insérer d'autres contenus, vous pouvez les copier/couper/coller, vous pouvez aussi créer des liens vers des éléments d'une autre page, vous pouvez même imbriquer des éléments comme nous allons le voire par la suite. Vous pouvez visualiser le résultat : Pas encore très élégant mais il manque la feuille de style... La nouvelle méthode de gestion du contenu avec TemplaVoila (Pour les développeurs) - Comment TemplaVoila réalise t'il la relation allant des pages vers le contenu? Par défaut, cette gestion est complètement assurée par le nouveau module Web > Page de TemplaVoila que nous venons d'utiliser. Pour comprendre le mécanisme qui se cache derrière cela vous pouvez éditer l'entête d'une page pour découvrir qu'un nouveau champ a été ajouté permettant d'affecter des éléments de contenu à la page : Futuristic Template Building (FTB1 FR) - 19

20 Vous pourriez changer la structure affichée graphiquement par le module Web > Page en ajoutant des relations vers des éléments de contenu dans cette section Content! Mais ceci n'est pas suffisamment ergonomique par un utilisateur standard! FlexForm et la structure de données (DS) qui y est liée Un autre point important est que le contenu de ce champ n'est pas stocké dans un champ spécifique de la base mais est stocké dans une structure XML dans un nouveau champ tx_templavoila_flex de la table pages qui peut potentiellement contenir d'autres champs définis par le DS. Ceci est une nouveauté fantastique des possibilités qu'offre les structures de données. Le concept est appelé FlexForms et ceci n'est qu'une des nombreuses possibilités. La structure de données que nous avons créée ainsi que le TO associé définissent tout cela. Si vous sélectionnez la page Storage Folder avec le module List, et en éditant le DS, vous pourrez observer la structure XML du DS : En étudiant ce code XML vous verrez que pour le champ field_content il existe une section définissant quelques paramètres pour TCEforms (lignes 35-46) en fait il s'agit du code généré par l'utilisation de la relation Content Elements : 1: <T3DataStructure> 2: <meta type="array"> 3: <langchildren type="integer">1</langchildren> 4: <langdisable type="integer">1</langdisable> 5: </meta> 6: <ROOT type="array"> 7: <tx_templavoila type="array">... 27: </field_menu> 28: <field_content type="array">... 42: <TCEforms type="array"> 43: <config type="array"> 44: <type>group</type> 45: <internal_type>db</internal_type> 46: <allowed>tt_content</allowed> 47: <size>5</size> Futuristic Template Building (FTB1 FR) - 20

21 48: <maxitems>200</maxitems> 49: <minitems>0</minitems> 50: <multiple>1</multiple> 51: <show_thumbs>1</show_thumbs> 52: </config> 53: <label>page content</label> 54: </TCEforms> 55: </field_content> 56: </el> 57: </ROOT> 58: </T3DataStructure> En recherchant dans la base de données (phpmyadmin) le contenu du champ tx_templavoila_flex de la page Root page nous retrouvons également une structure XML - <T3FlexForm>. Qui ressemble à ceci : 1: <?xml version="1.0" encoding="iso " standalone="yes"?> 2: <T3FlexForms> 3: <data type="array"> 4: <sdef type="array"> 5: <ldef type="array"> 6: <field_content type="array"> 7: <vdef>3</vdef> 8: </field_content> 9: </ldef> 10: </sdef> 11: </data> 12: </T3FlexForms> Notez que la valeur contenue entre les balises <vdef> correspond à l'uid du bloc de contenu Buy PaperShredder(tm) Gizmo with 30-days money-... La génération de l'affichage des blocs de contenu Il ne suffit pas de créer une relation vers les blocs de contenu, il faut également les afficher. Nous allons nous intéresser à leur rendu. Il semble que le Typoscript statique CSS Styled Content soit également utilisé avec TemplaVoila. La réponse setrouve également dans la structure de données créée. Observez les lignes 37 à 39 (fond gris clair) :... 28: <field_content type="array"> 29: <tx_templavoila type="array"> 30: <title>page content</title> 31: <description>map this to the container element for page content</description> 32: <sample_data type="array"> 33: <numindex index="0">[here goes my page content. Here goes my page content. Here goes my page content. Here goes my page content. Here goes my page content. Here goes my page content. Here goes my page content.]</numindex> 34: </sample_data> 35: <etype>ce</etype> 36: <TypoScript> 37: 10= RECORDS 38: 10.source.current=1 39: 10.tables = tt_content 40: </TypoScript> 41: </tx_templavoila> Ces lignes contiennent du TypoScript avec lequel nous sommes familier : Il utilise un cobject RECORD, permettant d'afficher les blocs de contenu de la table tt_content, en utilisant les uids de de l'élément actuel - celui-ci semble être initialisé par le contenu de la balise <vdef> affectée par dans le contexte d'exécution du TypoScript (qui se situe dans le plugin tx_templavoila_pi1 comme le montre le code précédent). Pour en savoir plus: Les FlexForms, les Data Structures et tout le reste sont présentés dans le document TYPO3 Core API. Création du menu dynamique Le menu à afficher dans la cellule de gauche est généré avec le même code TypoScript que celui du tutorial MTB/1. Rien ne change avec TemplaVoila; TypoScript reste un excellent moyen pour configurer les menus et la génération d'images. Ainsi, nous allons copier et coller le code du MTB/1 avec une exception; temp.menu_1 est remplacé par lib.menu_1 : Futuristic Template Building (FTB1 FR) - 21

22 # Menu 1 cobject lib.menu_1 = HMENU # First level menu-object, textual lib.menu_1.1 = TMENU lib.menu_1.1 { # Normal state properties NO.allWrap = <div class="menu1-level1-no"> NO.stdWrap.htmlSpecialChars = 1 # Enable active state and set properties: ACT = 1 ACT.stdWrap.htmlSpecialChars = 1 ACT.allWrap = <div class="menu1-level1-act"> } # Second level menu-object, textual lib.menu_1.2 = TMENU lib.menu_1.2 { # Normal state properties NO.allWrap = <div class="menu1-level2-no"> NO.stdWrap.htmlSpecialChars = 1 # Enable active state and set properties: ACT = 1 ACT.stdWrap.htmlSpecialChars = 1 ACT.allWrap = <div class="menu1-level2-act"> } </div> </div> </div> </div> Copiez ce code dans le champ Setup du gabarit TypoScript : Dans le MTB/1 nous faisions référence à ou nous devions copier cet objet HMENU. Ici nous faisons de même mais la référence est placée au niveau de la structure de données que nous venons de créer! Nous avions spécifier comme nom d'objet lib.menu_1 lors de la création du champ field_menu! Nous pouvons vérifier cela en éditant à nouveau le DS : Futuristic Template Building (FTB1 FR) - 22

23 Dans la section Data Structure XML pour l'élément <field_menu> nous retrouvons le nom saisi précédemment ceci est le chemin d'accès à l'objet permettant de générer le menu en TypoScript : Observons à nouveau la page : Le rendu n'est pas plus esthétique mais le menu est présent! Affectation du stylesheet et de la balise <body> Le dernier point consiste à éditer le TO, chose que nous ne pouvions faire pendant la création du DS et du TO, et à configurer l'inclusion d'éléments de l'entête de la balise <body> du fichier HTML! Futuristic Template Building (FTB1 FR) - 23

Montrer encore