Jahia Modules DOCUMENTATION

Transcription

1 DOCUMENTATION Jahia Modules Jahia, le CMS open source de nouvelle génération apportant à vos projets la convergence applicative (web, document, social, recherche et portail) unifiée par la simplicité d utilisation des outils de gestion de contenu web. Jahia Solutions Group SA 9 route des Jeunes, CH-1227 Les acacias Genève, Suisse

2 Sommaire Jahia Modules Définitions Structure catégories Modules à caractère éditorial Article Banner Big Text Contact External Link File List Flash Image Main Content News Teaser Text Tree Event FAQ Job Location People Press Publication Tasks Static HTML Frame Page 2 sur 27

3 2.24 Video Modules définissant des fonctions Author Display Back To Parent Page Bookmarks BreadCrumb Calendar CSS Page Current User Facet Form Builder Language Switcher Latest Login Form Navigation Menu Page Tagging Page Title Poll Portlet Query Rating RSS Search Shortcuts Twitter Top Stories Sitemap User Registration Page 3 sur 27

4 Jahia Modules 1 Définitions Module: un module est un répertoire stocké sur le disque du serveur contenant tous les fichiers qui définissent le comportement, le traitement et le rendu d une fonctionnalité du logiciel. Chaque module est l équivalent d un plug-in qui étend les fonctionnalités de Jahia et lui permet de gérer un ou des cas spécifiques. Composant: on désigne par composant un élément pouvant être ajouté dans une page gérée par Jahia, qu il s agisse d un simple contenu éditorial (un article, une news, un faq...), ou d une fonctionnalité (un nuage de tags, un formulaire de recherche, le fil d Ariane...). Chaque composant est défini dans un module. Un même composant ne peut être défini deux fois, par contre un composant défini dans un module peut, dans le contexte d un autre module se voir ajouter de nouveaux fichiers d affichage spécifiques. Par exemple, le composant user est défini dans le module user avec plusieurs fichiers de rendu, mais est régulièrement surchargé dans des contextes spécifiques comme le blog, le forum ou le docspace. Un module - peut ne définir aucun composant (mais ajouter une fonctionnalité bas niveau par exemple) - peut définir un composant unique (c est le cas pour la plupart des modules qui définissent des structures de contenu simples) - peut définir plusieurs composants (le module FAQ définit par exemple un composant FAQ - question/réponse- et un composant Sommaire FAQ qui peut générer automatiquement le sommaire d une liste de FAQ). Les modules les plus évolués, qui forment de véritables mini-applications, peuvent définir 6 ou 10 composants utilisables unitairement ou conjointement via l interface d édition du logiciel et / ou le Studio. Un module peut contenir - des définitions (format cnd) - des fichiers de rendu (jsp, velocity, freemarker...) - des fichiers de propriétés (resourcebundles Java) - des resources statiques (css, javascript) - des icones pour les composants - des règles (Drools) - des fichiers de workflow (jbpm) - des librairies ou des ensembles de librairies sous forme de fichiers jar (note: les développeurs si ils ajoutent des librairies non créées par eux doivent vérifier que les dites librairies ne sont pas déjà présentes dans Jahia, qu ils agisse de la même version ou d une autres version, afin de p^révenir d éventuels conflits). Page 4 sur 27

5 1.1 Structure tomcat/webapp/jahia/modules/ Les modules placés directement dans ce répertoire sont ceux dont nous pensons qu ils ont vocation à être régulièrement modifiés pour les besoins spécifiques des projets basés sur Jahia. tomcat/webapp/jahia/modules/default/ Les modules placés dans ce répertoire sont a priori prévus pour ne pas être modifiés lors d une intégration, soit que les modifier ne fasse pas sens a priori, soit que Jahia se réserve la possibilité de les faire évoluer dans le temps lors de ses mises à jour. Si pour les besoins d un projet vous souhaitez modifier un de ces modules, nous vous conseillons de créer votre propre module (directement dans /modules/) qui étendra celui d origine, soit de noter que des modifications ont été apportées afin de gérer sélectivement le remplacement ou non de celui-ci en cas de mise à jour de votre plateforme Jahia. Comment faire apparaître / disparaître les composants définis dans les modules du sélecteur Un module peut définir un ou plusieurs composants qui apparaîtront dans les interfaces de Jahia et particulièrement dans le sélecteur, afin d être manipulables par les éditeurs et webmasters. Pour qu un composant apparaisse dans le sélecteur, il est nécessaire au niveau de sa définition de définir une propriété jmix Exemple, le composant banner apparaitra dans le sélecteur dans les composants éditoriaux. [jnt:banner] > jnt:content, mix:title, jmix:editorialcontent 1.2 catégories Il existe par défaut 5 catégories de composants: jmix:editorialcontent = contenus éditoriaux On y place tous les composants qui se contentent de définir des strcutures de contenu telles que news, article, communiqué de presse, etc. jmix:sitecomponentcontent = composants de site Ce sont généralement des fonctions prêtes à l emploi tel que le fil d arianne, le formulaire de login, la fonction de changement de langue, etc. jmix:sandboxcontent = bac à sable on y met les composants inclassables, fournis à titre de démonstration et de formation ou encore les composants en cours de développement donc réputés instables, même si ils ne le sont pas nécessairement. jmix:formcontent = composants de formulaire On y regroupe tous les éléments relatifs à la construction d un formulaire (champs, règles de validation...) et les formulaires prêts à l emploi. Page 5 sur 27

6 jmix:querycontent = composants de requêtes On y regroupe tous les composants basés sur des requêtes, qu il s agisse du composant le plus simple permettant de saisir une requête sur l instant, jusqu aux composants qui travaillent sur des requêtes prédéfinies comme la liste des dernières pages crées, la liste des dernières actualités, etc. Page 6 sur 27

7 2 Modules à caractère éditorial Ces modules définissent des structures de contenu et pour chacun d entre eux une ou plusieurs vues correspondant à des cas d usage classiques. Ces modules n intègrent généralement aucune logique ou traitement, ils sont destinés à présenter du contenu et à structurer celui-ci lors de sa saisie dans le CMS. 2.1 Article Article /modules/article/ Ce module définit un objet de type article très structuré et relativement complet. Il associe à une titre et une introduction (uniques) un ensemble de paragraphes basés sur me module main content. L objet article définit également la possibilité sur chaque paragraphe d ajouter un encart (mise en exergue ou citation) qui viendra s insérer au sein du texte sur la droite ou sur la gauche de celui-ci. Ce module constitue un bon exemple pour les intégrateurs souhaitant comprendre comment l héritage de modules fonctionne et réaliser eux même des composants étendant ou intégrant d autres objets. [jnt:paragraph] > jnt:maincontent - inserttext (string, richtext) i18n - inserttype (string,choicelist[resourcebundle]) = quote indexed=no < quote, exergue - insertposition (string,choicelist[resourcebundle]) = left indexed=no < left, right - insertwidth (long) = "150" indexed=no [jnt:article] > jnt:content, jmix:editorialcontent, mix:title, jmix:tagged - intro (string, richtext) i18n + * (jnt:paragraph) 2.2 Banner Banner /modules/default/jnt_banner/html/ (rendu) /modules/definitions.cnd (définition) Ce module permet de sélectionner une bannière (image) qui sera utilisé en background de l élément DIV définit par le fichier de rendu, et de lui associer un titre et une accroche textuelle. Le titre et l accroche, tel que le fichier de rendu est écrit, sont affichés par dessus l image choisie. Il est également possible de définir le positionnement du texte en saisissant une marge à gauche et une marge haute, à partir du coin de la photo. Page 7 sur 27

8 [jnt:banner] > jnt:content, mix:title, jmix:editorialcontent - background (weakreference, file[mime='image/*']) i18n - cast (string, richtext) i18n - positiontop (long) indexed=no - positionleft (long) indexed=no Améliorations / adaptations possibles: - si la liste des images autorisées pour créer les bannières est limitée et connue à l avance, il est possible de remplacer le champ image par une liste pré-définie, ce qui fera gagner du temps aux éditeurs et évitera des erreurs. - en raison de la superposition des textes sur l image, il peut être intéressant d ajouter un champ pour sélectonner une couleur de texte qui sera utilisée avec une instruction de style in-line. 2.3 Big Text BigText /modules/default/bigtext/ /modules/default/definitions.cnd Ce module permet de saisir un texte de longeur illimitée. En édition, le champs s affiche avec un éditeur de texte WYSIWYG. Il est recommandé de ne pas modifier cette structure de contenu. 2.4 Contact Contact /modules/contact/ Ce module permet d insérer dans une page un formulaire de contact pré-défini directement dans un fichier jsp. L éditeur peut choisir sur l instant quels champs il souhaite afficher, parmi la 15aine disponible. Fonctionnellement ce module est très simple puisqu il consite uniquement à lister des champs et stocker un boléen (vrai/faux) qui sert à afficher ou non le champ en question, mais c est un bon exemple d alternative à l utilisation du module Form Builder qui est plus puissant mais demande plus de temps et de maîtrise. Si votre projet comporte quelques formulaires dont vous connaissez à l avance la structure et ne requiert pas la création de nouveaux formulaires régulièrement, cette approche présente un intérêt certain. Le résultat des formulaires envoyés est stocké dans le repository et accessible en format CSV. Page 8 sur 27

9 2.5 External Link External Link /modules/default/jnt_externallink/ (affichage) /modules/default/definitions-nav-menu.cnd (structure) Ce module permet d insérer un lien externe à la plateforme Jahia en choisissant certains paramètres tels que la target et le alt. Il s appuie sur un type de donnée (jmix:navmenuitem) interne à Jahia. 2.6 File List File List /modules/default/jnt_filelist/ (affichage) /modules/default/definitions.cnd (structure) Ce module permet de sélectionner un repertoire du Gestionnaire de Document pour en afficher automatiquement dans une page tous les fichiers enfants. L intérêt principal est que la liste des contenus affichée est mise à jour dès que le contenu du dossier cible change. [jnt:filelist] > jnt:content, jmix:editorialcontent - folder (weakreference, file[folder]) 2.7 Flash Flash /modules/default/flash/html/ (affichage) /modules/default/definitions.cns (structure) Ce module a pour objet d insérer une animation Adobe Flash dans une page. Il utilise la balise <object> définie par le standard. Lorsque le composant flash est inséré dans une page, l éditeur peut définir tous les paramètres relatifs à l animation Flash. Certains de ces paramètres ne sont pas indispensables et peuvent être supprimés intentionnellement de la définition afin de limiter les informations à renseigner par l éditeur. Attention, toute modification du fichier de définitions pour retirer un champ doit être effectuée avant déploiement de la définition en question. [jnt:flash] > jnt:content, mix:title, jmix:editorialcontent - flashsource (weakreference, file) - width (string) analyzer='keyword' nofulltext - height (string) analyzer='keyword' nofulltext - flashplayer (string) = '9' analyzer='keyword' nofulltext Page 9 sur 27

10 - id (string) analyzer='keyword' nofulltext - name (string) - swliveconnect (string, choicelist[resourcebundle]) analyzer='keyword' nofulltext < 'true', 'false' - play (string, choicelist[resourcebundle]) indexed=no < 'true','false' - loop (string, choicelist[resourcebundle]) indexed=no < 'true','false' - menu (string, choicelist[resourcebundle]) indexed=no < 'true','false' - quality (string, choicelist[resourcebundle]) analyzer='keyword' nofulltext < 'low','high','autolow','autohigh','best' - scale (string, choicelist[resourcebundle]) analyzer='keyword' nofulltext < 'default','noborder','exactfit' - align (string, choicelist[resourcebundle]) indexed=no < 'l','r','t','b' - salign (string, choicelist[resourcebundle]) indexed=no < 'l','r','t','b','tl','tr','bl','br' - wmode (string, choicelist[resourcebundle]) indexed=no < 'window','opaque','transparent' - bgcolor (string, color) indexed=no - base (string) indexed=no - flashvars (string) indexed=no 2.8 Image Image /modules/default/image/ /modules/default/definitions.cnd Ce module permet d insérer une image dans une page en l accompagnant d un texte alternatif. Il peut aisément être étendu pour intégrer une valeur css, une légende ou autre. 2.9 Main Content Main Content /modules/default/jnt_maincontent/html/ (rendu) /modules/definitions.cnd (définition) Ce module très générique définit la structure de contenu la plus utilisée que l on pourrait rapprocher d un paragraphe : un titre, une corps de texte (texte riche), une image et une variable pour aligner l image a gauche ou a droite du corps du texte. [jnt:maincontent] > jnt:content, mix:title, jmix:editorialcontent - body (string, richtext) i18n - image (weakreference, file[mime='image/*']) i18n - align (string,choicelist[resourcebundle]) = left indexed=no < left,right,default Page 10 sur 27

11 2.10 News News /modules/news/ Ce module permet de gérer des actualités (news). Il est fournit avec plusieurs rendus différents permettant d afficher des listes d actualités selon divers formats (petit, moyen, grand). Un composant permettant d afficher les dernières actualités est également fourni, qui laisse à l éditeur la possibilité de choisir le nombre d actualités souhaité, et un critère de filtrage basé sur l arbre des catégories. [jnt:news] > jnt:content, mix:title, jmix:editorialcontent - desc (string, richtext) i18n - image (weakreference, file[mime='image/*']) - date (date) = now() [jnt:lastnews] > jnt:content, jmix:list, mix:title, jmix:querycontent, jmix:cache - maxnews (long) = 10 indexed=no - filter (reference, category[autoselectparent=false]) - j:subnodestemplate (string, choicelist[templates=jnt:news,resourcebundle,image]) nofulltext itemtype = layout 2.11 Teaser Teaser /modules/default/jnt_teaser/html/ (affichage) /modules/definitions.cnd (structure) Ce module permet d insérer dans les pages des accroches constituées d un titre, d une image et d un lien. Divers rendus sont disponibles pour offrir des variantes classiques (liens sur l image, lien à la fin du texte...) L objet teaser est totalement indépendant de l objet cible vers lequel il renvoie, de sorte qu il offre une grande souplesse. Les cas d utilisation typiques sont - en page d accueil pour faire la promotion des certaines parties du site - dans les colonnes secondaires, souvent sous la forme image cliquable, comme cela se voit beaucoup dans les sites media. [jnt:teaser] > jnt:content, mix:title, jmix:editorialcontent - abstract (string, text[multiline]) i18n - image (weakreference, file[mime='image/*']) - link (weakreference) Page 11 sur 27

12 2.12 Text Text /modules/default/jnt_text/html/ (affichage) /modules/default/definitions.cnd (structure) Ce module définit un composant constitué d un simple champ texte court (255 caractères). Il est recommandé de ne pas modifier cette structure de contenu Tree Tree /modules/default/jnt_tree/html/ (affichage) /modules/default/definitions.cnd (structure) 2.14 Event Event /modules/event/ Ce module permet de gérer des événements (titre, description, date de début, date de fin, localisation, type d événement). Les types d événements sont définis dans le fichier de définitions en dur et peuvent être modifiés, remplacés ou faire appel à un autre initialiseur plus conforme aux besoins de votre projet (liste externe, appel à une liste stockée dans le jcr...) L ajout de fonctions d inscription à un événement donné peut être réalisé très facilement par la mise en place d un simple formulaire affiché en mode live dont la vocation sera de créer des sous-noeuds à l événement en question pour chaque enregistrement, par exemple. [jnt:event] > jnt:content, jmix:editorialcontent, mix:title - startdate (date) facetable - enddate (date) facetable - location (string) i18n facetable - eventstype (string, choicelist[resourcebundle]) facetable < meeting,consumershow,roadshow,conference,show,pressconference - body (string, richtext) i18n Page 12 sur 27

13 2.15 FAQ FAQ /modules/faq/ Ce module permet de construire des listes de questions fréquentes. Il est constitué de deux composants distincts: - sommaire de FAQ - liste de FAQ Pour construire un FAQ simple, le second composant se suffit à lui même. Si vous souhaitez construire un FAQ relativement long, voire organiser celui-ci en plusieurs sections, vous devez utiliser le composant sommaire. Celui-ci intègre un liste de FAQ mais en plus construit automatiquement, comme son nom le laisse supposser, un sommaire automatique de toutes les questions. [jnt:faq] > jnt:content, jmix:editorialcontent - question (string) i18n - answer (string, richtext) i18n 2.16 Job Job /modules/job/ Ce module permet de gérer des offres d emploi et de recevoir des propositions via un formulaire de réponse en ligne. Le formulaire de réponse est extrêmement basique (nom, prénom, adresse , texte libre) et peut / doit être adapté aux besoins de votre projet. [jnt:job] > jnt:content, mix:title, jmix:editorialcontent - reference (string) - businessunit (string) i18n facetable - contract (string, choicelist[resourcebundle]) facetable < contract1, contract2, contract3, contract4 - date (string) - town (string) - country (string, choicelist[country,flag]) facetable - educationlevel (string) i18n analyzer='keyword' - description (string, richtext) i18n - skills (string, richtext) i18n + * (jnt:jobapplication) Page 13 sur 27

14 [jnt:jobapplication] > jnt:content - firstname (string) - lastname (string) primary - (string) - text (string, richtext) i18n 2.17 Location Location /modules/location/ Ce module permet de décrire un lieu, une adresse. Il est classiquement utilisé pour accompagner un contenu prinicpal et renseigner sur la localisation de celui-ci, ou constituer un annuaire de lieux. Il peut être associé à un annuiare de persionnes pour permettre la saisie d une localisation pour chaque personne par exemple. [jnt:location] > jnt:content, mix:title, jmix:editorialcontent - street (string) - zipcode (string) analyzer='keyword' - town (string) i18n facetable - country (string,choicelist[country,flag]) i18n facetable - latitude (string) i18n facetable - longitude (string) i18n facetable En s appuyant sur les champs lattitude et longitude, il est possible de faire apparaître automatiquement une carte via l API Googlemaps People People /modules/people/html/ Ce module est destiné à décrire une personne (un portait ). On l utilise typiquement pour gréer les pages notre équipe dans les sites corporates, de petits annuaires, ou encore des réaliser des fiches biographiques dans le cadre d une base documentaire. Ce module n est pas redondant avec le module user qui gère les utilisateurs enregistrés dans Jahia. Pour réaliser un annuaire d utilisateurs enregistrés ou une fiche biographique, il est recommandé de s appuyer directement sur le module user afin de ne pas dupliquer inutilement les données. Page 14 sur 27

15 - firstname (string) - lastname (string) primary - function (string) i18n - businessunit (string, choicelist[resourcebundle]) analyzer='keyword' facetable < sales,marketing, GA, production, humanressources - telephone (string) - cellular (string) - fax (string) - (string) - biography (string, richtext) i18n - picture (weakreference, file[mime='image/*']) Le champ businessunit est initialisé à partir de la définition (definitions.cnd) par une série de valeurs directement écrites dans le fichier cnd. Ces valeurs peuvent être librement modifiées, étendues, ou remplacées par un autre initialiseur. Le module est fourni avec deux vues différentes /templates/people/html/people.jsp est la vue par défaut qui présente un abstract /templates/people/html/people.full.jsp est la vue la plus complète qui présente tous les champs 2.19 Press Press /modules/press/ Ce module gère des communiqués de presse [jnt:press] > jnt:content, mix:title, jmix:editorialcontent - body (string, richtext) i18n - date (date) - pdfversion (weakreference, file) i18n 2.20 Publication Publication /modules/publication/ Page 15 sur 27

16 Ce module définit un objet publication permettant de décrire de façon générique une oeuvre (titre, auteur, date de sortie, etc.) il peut être aisément étendu pour intégrer des champs typiques de bibliographie ou de documentation (n ISBN, ISSN, n de cote interne) ou de classement (genre, sous-genre, etc.). Le composant permet d attacher un fichier téléchargeable et une image de pré-vue. [jnt:publication] > jnt:content, jmix:editorialcontent, mix:title - file (weakreference, file) i18n - preview (weakreference, file) i18n - author (string) i18n analyzer='simple' - source (string) i18n - date (string) i18n indexed=untokenized nofulltext - body (string, richtext) i18n 2.21 Tasks Tasks /modules/tasks/ A compléter 2.22 Static HTML Static HTML A compléter 2.23 Frame Frame /modules/default/jnt_frame/html/ (affichage) /modules/default/definitions.cnd (définition) Ce module met à disposition des éditeurs un composant qui, inséré dans une page, déclare une Frame. Tous les paramètres standards peuvent être définis par l éditeur (taille, scrolling, espacement...) [jnt:frame] > jnt:content, mix:title, jmix:editorialcontent - source (string) indexed=no - name (string) indexed=no - width (long) indexed=no - height (long) indexed=no - frameborder (long) = '0' indexed=no Page 16 sur 27

17 - marginwidth (long) = '0' indexed=no - marginheight (long) = '0' indexed=no - scrolling (string, choicelist[resourcebundle]) indexed=no < 'yes','no','auto' - alt (string) i18n indexed=no 2.24 Video Video /modules/default/video/html/ (affichage) /modules/default/definitions.cns (structure) Ce module a pour objet d insérer une video dans une page. il utilise la balise <object> définie par le standard. Lorsque le composant video est inséré dans une page, l éditeur peut définir tous les paramètres classiques définis par la norme W3C. Il est possible de définir un dur dans le fichier certains de ces paramètres afin de ne plus devoir les demander aux éditeurs qui n ont pas toujours les connaisssances pour renseigner correctement les champs. [jnt:video] > jnt:content, mix:title, jmix:editorialcontent - name (string) - source (weakreference, file) - width (long) = '0' - height (long) = '0' - hspace (long) = '0' - vspace (long) = '0' - autostart (string, choicelist[resourcebundle]) analyzer='keyword' nofulltext < 'true','false' - invokeurls (string, choicelist[resourcebundle]) analyzer='keyword' nofulltext < 'true','false' - enablecontextmenu (string, choicelist) analyzer='keyword' nofulltext < '0','1' - showstatusbar (string, choicelist) analyzer='keyword' nofulltext < '0','1' - showcontrols (string, choicelist) analyzer='keyword' nofulltext < '0','1' - autosize (string, choicelist[resourcebundle]) analyzer='keyword' nofulltext < 'true','false' - displaysize (long) = '0' analyzer='keyword' nofulltext - loop (string, choicelist[resourcebundle]) analyzer='keyword' nofulltext < 'true','false' Page 17 sur 27

18 3 Modules définissant des fonctions 3.1 Author Display AuthorDisplay /modules/default/authordisplay/ (affichage) /modules/default/definitions.cnd (structure) Ce module, prévu essentiellement pour être intégré au niveau des templates, permet d afficher automatiquement des informations relatives à l auteur d un contenu. Il s agît d un composant destiné à accompagner un composant principal auquel il est lié. De multiples variantes d affichage peuvent être ajoutées pour produire des vues de l auteur plus ou moins riches. 3.2 Back To Parent Page Permet d insérer un lien de retour vers la page parente 3.3 Bookmarks Bookmarks /modules/bookmarks/ Ce module définit deux composants, un composant bookmark actuellement utilisé dans la page User Profile, qui permet de stocker des couples de données url/date, et un composant bookmarkbutton qui permet d insérer dans des pages ou des templates Jahia un bouton qui, sur un simple clic, ajoutera la page courante en bookmark dans la liste des bookmarks de l utilisateur. Améliorations possibles: - une amélioration possible et agréable pour les utilisateurs, serait de coupler ce module avec un outil en ligne de génération de vignettes et de stocker celle-ci avec le bookmark pour constituer une gallerie de liens plus parlante visuellement (exemples de services en ligne proposant le vignettage de pages web: etc.) - une seconde amélioration très simple consisterait a ajouter un champ notes à l objet bookmark pour que l utilisateur puisse commenter celui-ci. Page 18 sur 27

19 3.4 BreadCrumb BreadCrumb Ce module permet d insérer un fil d Arianne dans une page. Le fil d Arianne affiche le chemin de la page courante depuis la page d Accueil du site. 3.5 Calendar Calendar /modules/calendar/ Ce module permet d insérer un calendrier dans une page, et de mettre ce calendrier en relation avec une liste de contenu. Une fois la relation établie et le champs de type date définissant cette relation choisi (le plus souvent il s agît de la date de création ou de la date de modification du contenu, mais cela n est pas obligatoire) le calendrier affichera pour chaque date le nombre d éléments correspondants dans la liste, ainsi qu un lien sur la date en question qui aura pour effet de filtrer la liste sur la date choisie. Améliorations possibles: L ajout d un petit formulaire très simple en mode live pour que les visteurs puissent ajouter leurs propres contenus dans la liste permet de créer un système d annonces / calendrier public ou privé en quelques minutes. 3.6 CSS Page csspage /modules/csspage/ Ce module, livré à titre d exemple pour une utilisation sélective et appropriée aux besoins spécifiques de vos projets, permet à un éditeur de redéfinir en ligne un ensemble de style css majeurs, tels que l image et la couleur de background, les tailles, couleurs et polices de caractères, la couleur des liens non suivis, suivis, etc. Les valeurs choisies par l utilisateur sont introduites dans la page courante sous forme d un ajout de style in-line. Par cette approche, la css originale n est jamais modifiée et les styles définis par l utilistaeur ont un poid supérieur à ceux de la feuille de style. Laissé à la libre utilisation des éditeurs, ce module permet d offrir une grande liberté, mais aussi d obtenir des résultats graphiquement catastrophiques, aussi recommandons nous de ne l utiliser que sélectivement (pour enrichir les pages blog par exemple, ou chaque utilisateur est responsable de son propre blog) et de Page 19 sur 27

20 limiter le nombre de champs laissés à disposition des rédacteurs afin de préserver un minimum de qualité graphique. [jnt:pagecss] > jnt:content, jmix:sandboxcontent - j:backgroundcolor (string) = '' indexed=no - j:bodycolor (string) = '' indexed=no - fontfamily (string,choicelist) indexed=no < '', 'Arial, Helvetica, sans-serif', 'Times New Roman, Times, serif', 'Courier New, Courier, monospace', 'Georgia, Times New Roman, Times, serif', 'Verdana, Arial, Helvetica, sans-serif', 'Geneva, Arial, Helvetica, sans-serif' - lineheight (string,choicelist) indexed=no < '', '100%', '110%', '120%', '130%', '140%', '150%', '160%', '170%', '180%', '190%', '200%' - fontsize (string,choicelist) indexed=no < '', '80%', '90%', '100%', '110%', '120%', '130%', '140%', '150%' - j:alinkvisitedcolor (string) = '' indexed=no - j:ahoveractivecolor (string) = '' indexed=no - j:h1color (string) = '' indexed=no - j:h2color (string) = '' indexed=no - j:h3color (string) = '' indexed=no - j:h4color (string) = '' indexed=no - j:h5color (string) = '' indexed=no - h1fontfamily (string,choicelist[resourcebundle]) indexed=no < '', 'Arial, Helvetica, sans-serif', 'Times New Roman, Times, serif', 'Courier New, Courier, monospace', 'Georgia, Times New Roman, Times, serif', 'Verdana, Arial, Helvetica, sans-serif', 'Geneva, Arial, Helvetica, sans-serif' - h2fontfamily (string,choicelist[resourcebundle]) indexed=no < '', 'Arial, Helvetica, sans-serif', 'Times New Roman, Times, serif', 'Courier New, Courier, monospace', 'Georgia, Times New Roman, Times, serif', 'Verdana, Arial, Helvetica, sans-serif', 'Geneva, Arial, Helvetica, sans-serif' - h3fontfamily (string,choicelist[resourcebundle]) indexed=no < '', 'Arial, Helvetica, sans-serif', 'Times New Roman, Times, serif', 'Courier New, Courier, monospace', 'Georgia, Times New Roman, Times, serif', 'Verdana, Arial, Helvetica, sans-serif', 'Geneva, Arial, Helvetica, sans-serif' - h4fontfamily (string,choicelist[resourcebundle]) indexed=no < '', 'Arial, Helvetica, sans-serif', 'Times New Roman, Times, serif', 'Courier New, Courier, monospace', 'Georgia, Times New Roman, Times, serif', 'Verdana, Arial, Helvetica, sans-serif', 'Geneva, Arial, Helvetica, sans-serif' - h5fontfamily (string,choicelist[resourcebundle]) indexed=no < '', 'Arial, Helvetica, sans-serif', 'Times New Roman, Times, serif', 'Courier New, Courier, monospace', 'Georgia, Times New Roman, Times, serif', 'Verdana, Arial, Helvetica, sans-serif', 'Geneva, Arial, Helvetica, sans-serif' - j:colorresource1 (string) = '' indexed=no - j:colorresource2 (string) = '' indexed=no - img1 (weakreference, file[mime='image/*']) - img2 (weakreference, file[mine='image/*']) 3.7 Current User Current User /modules/default/jnt_currentuserdisplay/html/ (affichage) /modules/default/definitions.cnd (structure) Ce module affiche le nom (username) de l utilisteur courant, si celui-ci s est authentifié. Il est utilisé classiquement en haut de page pour signaler à l utilisateur qu il a été reconnu. Page 20 sur 27

21 Il peut être étendu très facilement pour afficher des informations complémentaires, ou servir de base pour créer différents composants ayant besoin de s appuyer sur l identification de l utilisateur courant. 3.8 Facet Facet /modules/facets/ Ce module gère les capacités de Jahia de recherche par facettes. Il permet d insérer un composant de facettes qui peut être mis en relation avec la liste d éléments à facetter. Contrairement aux autres CMS qui demandent à ce que les facettes soient codées manuellement par les développeurs, Jahia permet de faire cela dans le studio par simple sélection-clic. 3.9 Form Builder Form Builder /modules/formbuilder/ Ce module permet de construire un formulaire directement dans une page Jahia en insérant des champs de tous types et en définissant les règles de validation associées, ainsi que le traitement attendu pour le formulaire lorsque celui-ci est posté par uin utilisateur. Les règles de validation fournies actuellement sont - obligatoire - validation d une plage de données - validation de syntaxe pour adresse - validation de date D autres règles de validation peuvent être ajoutées par des développeurs. déclarées en tant que composants de formulaires, elles deviennent dès lors applicables aux champs de vos formulaires Language Switcher Language Switcher /modules/default/languageswitcher/ (affichage) /modules/default/definitions.cnd (structure) Page 21 sur 27

22 Ce module insère dans la page un lien par langue active sur le site, permettant aux utilisateurs de passer d une langue à l autre. Il est actuellement fourni avec un seul rendu, des rendus supplémentaires (avec ou sans drapeau, sous forme de liste déroulante, etc.) seront ajoutés ultérieurement Latest Latest /modules/latest/ Ce module définit deux composants: - liste des dernières pages crées ou modifiées (au choix de l éditeur) - liste des derniers contenus de type X (au choix de l utilisateur) créés ou modifiés A partir de ces deux exemples, il est très aisé de créer, si besoin est, une liste de composants prêts à l emploi fonctionnant sur le même principe, en fonction des besoins fonctionnels de votre projet (liste de derniers articles, des derniers utilisateurs, des derniers commentaires...) 3.12 Login Form Login Form /modules/default/loginform/html/ (affichage) /modules/default/definitions.cnd (structure) Ce module affiche un formulaire d authentification. Lorsque l utilisateur est authentifié, le module affiche 3.13 Navigation Menu NavMenu A compléter. Ce module gère le menu de navigation standard de Jahia qui reprend l exacte arborescence des pages et liens créés dans le sélecteur. Il est possible de choisir le niveau de départ du menu, et son niveau de profondeur, ainsi qu une classe CSS qui permet de changer son apparence instabntannément (cf. document dédié aux Menus) Page 22 sur 27

23 3.14 Page Tagging Page Tagging Ce module affiche un formulaire que les visiteurs peuvent utiliser pour ajouter un tag à la page courante. A noter que le composant Nuage de tags (tag cloud) est définit dans le modules Facets Page Title Page Title /modules/default/jnt_pagetitle/ (affichage) /module/default/definitions.cnd (structure) Affiche le titre de la page courante. Ce composant est essentiellement destiné à être utilisé lors de la construction des templates. Le fichier de rendu défini actuellement un affichage du titre dans une balise <h2> avec une classe pagetitle. Une modification rapide permetttrait de donner la possibilité aux éditeurs de choisir le niveau de titre à utiliser (h1, h2, h3) ou encore la couleur, etc. On peut également imaginer étendre se composant pour afficher automatiquement l auteur de la page, la date de création et / ou la date de dernière modification par exemple Poll Poll /modules/poll/ Ce module permet de créer un sondage. L éditeur définit la question et les n réponses possibles. Les fonctions de calcul sont implémentées mais le rendu du vote (l affichage) est assez basique et peut être personnalisé en fonction de vos attentes graphiques Portlet Portlet Ce module permet d insérer une portel (JSR 168 / JSR 283) Page 23 sur 27

24 3.18 Query Query /modules/default/jnt_query/html/ (affichage) /modules/efault/efinitions.cnd (structure) Ce module permet d insérer dans une page le résultat d une requête (SQL2, QOM ou XPath). Lorsque le composant est inséré l éditeur peut saisir dans un champ la requête souhaitée Rating Rating /modules/rating Ce module permet de proposer aux utilisateurs de noter une page ou un contenu. Le système de vote et sa représentation graphique dans la page sont disponibles en deux versions - stars. représentation classique avec 5 étoiles. Le note est la somme des votes sur 5 divisée par le nombre total de votants. - plusone_minorone. représentation que l on trouve souvent dans des forums ou l utilisateur peut voter +1 ou -1. La note est l addition de tous les votes + et -. Le module est également accompagné d un composant pour afficher les contenus les mieux notés RSS Rss Ce module permet de définir un adresse de flux RSS et le nombre d entrées désirées qui seriont dès lors affichés dans la page Search Search /modules/search/ Page 24 sur 27

25 3.22 Shortcuts Shortcuts /modules/default/jnt_shortcuts/ /module/default/definitions.cnd Ce module insère une série de liens définis directement dans le fichier jsp de rendu. Par défault il intègre - une fonction pour se déconnecter de Jahia (logout) - l affichage du username pour l utilisateur courant (si connecté) - un raccourci vers la page personelle de l utilisateur connecté - une fonction de changement de la taille des caractères dans la page - des liens pour passer en mode édition ou contribution (selon les droits de l utlilisateur connecté) - un raccourci vers la page d acceuil du site courant - un raccourci vers le plan du site 3.23 Twitter Twitter /modules/twitter/ Ce module définit actuellement deux composants - TwitterSearch : affiche dans la page un simple champ de recherche qui permet de récupérer sur l instant le feed twitter correspondant. L objet de la recherche n est pas conservé dans le JCR, il s agît juste d un paramètre passé sur l instant pour recevoir un résultat. - TwitterFeed : permet de définir un ta g de recherche, qui est stocké dans le JCR. Le composant affichera donc en permanence le Feed twitter en question Top Stories Top Stories Ce module permet d ajouter une option dans les engines standard d édition pour que d un simple clic, les éditeurs puissent dire qu un contenu, quelqu il soit apparaisse dans un bloc des top stories (ce bloc peut être inséré n importe ou). Tel que fourni le module gère trois niveaux hiérarchiques parmis lesquels les éditeurs peuvent choisir, il peut être aisément simplifié si les top stories n ont pas besoin d être graphiquement differenciées ou hiérarchisées. Page 25 sur 27

26 3.25 Sitemap Ce module fait apparaître une option dans les interfaces d édition de jahia. Cette option lorsqu elle ets activée permet d ajouter l élément courant au fichier sitemap.xml qui respecte la norme définie par Google. L éditeur peut également définir l importance de l élément et la périodicité à laquelle Jahia va demander à Google réindexer cet élément. Bien que la gestion du sitemap.xml soit fastidieuse pour les éditeurs, il s agît d un élément essentiel en terme de visibilité sur internet et de référencement des sites publics. Une appoche moins manuelle mas moins fine peut être envisagée afin que le fichier sitemap.xml soit créé sans intervention humaine en n y insérant que certains type de contenus, par exemple. Ce module est toutefois un bon exemple à regarder pour des intégrateurs désirant faire apparaître leurs propres options dans les interfaces de Jahia User Registration User registration /templates/userregistration/html/ (affichage) /templates/userregistration/definition.cnd (structure) Ce module une fois inséré dans une page se présente comme un formulaire permettant aux utilisateurs de s auto-enregistrer dans Jahia. Lors de l insertion du composant dans une page - il est possible de renseigner la ou les personnes à prévenir qu un nouvel utilisateur s est enregistré (par ) - il nécessaire de définir la page sur laquelle l utilisateur sera redirigé une fois le formulaire envoyé. Par défaut les champs suivants sont présents dans le formulaire et définis comme obligatoires - First Name - Last Name - Username - Password - Le formulaire peut être étendu à volonté pour insérer des champs correspondant à d autres propriétés du type user. <input type="text" name="property_name" id="property_name" value="" tabindex="xx"/> L enregistrement d un utilisateur donne lieu à l envoi automoatique d un à l administrateur de la plateforme, ainsi que d un mail de bienvenue au nouvel utilisateur enregistré. Le dossier userregistration/mails/templates/ contient le modèle utilisé pour prévenir le responsable des enregistrements. Ce template accepte le HTML et peut être personnalisé aisément. Page 26 sur 27

27 Jahia Solutions Group SA 9 route des Jeunes, CH-1227 Les acacias Genève, Suisse Page 27 sur 27