DOCUMENTATION Guide d`administration Jahia v6.6

Transcription

DOCUMENTATION
Guide d’administration
Jahia v6.6
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
http://www.jahia.com
Guide d’administration Jahia v6.6
Sommaire
Introduction à l’Administration de Jahia ........................................................................................................... 4
1
Première partie : Paramètres du Serveur................................................................................................... 6
1.1
1.1.1
Création d’un site web ................................................................................................................... 9
1.1.2
Supprimer un site ......................................................................................................................... 16
1.1.3
Exporter un site ............................................................................................................................ 17
1.1.4
Modifier les informations d’un site ............................................................................................. 18
1.1.5
Autres réglages propres aux sites ................................................................................................ 18
1.2
Gérer les utilisateurs........................................................................................................................... 19
1.2.1
Créer un utilisateur ...................................................................................................................... 19
1.2.2
Modifier un utilisateur ................................................................................................................. 20
1.2.3
Supprimer un utilisateur .............................................................................................................. 21
1.2.4
Suspendre un utilisateur .............................................................................................................. 21
1.2.5
Créer un lot d’utilisateurs par import .......................................................................................... 23
1.3
Configuration des notifications E-mails.............................................................................................. 24
1.4
Gérer les portlets ................................................................................................................................ 26
1.5
Editer les propriétés du Super Administrateur .................................................................................. 28
1.6
Statut du serveur et des caches ......................................................................................................... 29
1.7
Gestion de la politique des mots de passe ......................................................................................... 35
1.8
Gestion des rôles ................................................................................................................................ 36
1.8.1
Création d’un nouveau rôle ......................................................................................................... 37
1.8.2
Suppression, copie d’un rôle........................................................................................................ 43
1.8.3
Export / Import des rôles ............................................................................................................. 43
1.9
2
Gestion des Projets Web ...................................................................................................................... 7
Gestion des modules .......................................................................................................................... 44
1.10
Système de suivi des incidents ........................................................................................................ 46
1.11
Documentation ............................................................................................................................... 46
1.12
A propos de Jahia ............................................................................................................................ 47
Seconde partie : Paramètres du site ........................................................................................................ 48
© 2002 – 2011 Jahia Solutions Group SA
Page 2 sur 69
2.1
Gérer les groupes ............................................................................................................................... 49
2.1.1
Créer un groupe ........................................................................................................................... 51
2.1.2
Ajouter et supprimer des utilisateurs .......................................................................................... 52
2.1.3
Supprimer un groupe ................................................................................................................... 56
2.1.4
Dupliquer un groupe .................................................................................................................... 57
2.2
Gérer les langues ................................................................................................................................ 58
2.2.1
Langue par défaut ........................................................................................................................ 58
2.2.2
Langue par défaut ........................................................................................................................ 58
2.2.3
Langue obligatoire ....................................................................................................................... 59
2.2.4
Actif (Editer) ................................................................................................................................. 59
2.2.5
Actif (En ligne) .............................................................................................................................. 60
2.2.6
Utiliser plusieurs langues lors de la navigation sur le site ........................................................... 60
2.2.7
Ajouter une nouvelle langue........................................................................................................ 61
2.3
Paramètres HTML ............................................................................................................................... 63
2.4
Afficher les vanity URL ........................................................................................................................ 64
2.5
Gestion des templates ........................................................................................................................ 65
2.6
Vérificateur de liens ............................................................................................................................ 65
2.6.1
Comment auditer les liens externes en utilisant le module de vérification des liens ................. 66
Page 3 sur 69
Introduction à l’Administration de Jahia
Jahia dispose d’un module de back office pour répondre aux besoins des administrateurs des sites et de la
plateforme dans son ensemble.
Ce module est appelé “l’Administration” ou “Admin. Center”.
Le fait d’avoir les droits d’administration vous donne accès à l’Administration
-
en saisissant directement l’adresse de votre serveur Jahia dans un navigateur, suivi de
/administration
-
à partir de votre page personnelle, dans les liens situés en haut à droite de la page
-
à partir des barres de menu présentes dans certains Modes.
Via l’Edit mode :
Via le studio :
Par défaut, après installation et création d’un site, Jahia est livré avec :

Un utilisateur « root » : C’est utilisateur est le « super utilisateur » du système, il a tous les droits
sur la totalité du système. Il peut accéder à toutes les fonctionnalités de la plateforme pour tous les
sites hébergés. C’est un utilisateur système à qui les droits ne peuvent être modifiés, même s’il
n’apparaît pas directement dans les interfaces de gestion des permissions des différents objets de
contenu. L’utilisateur « root », naturellement, n’est pas contraint aux permissions du système, il a
tous les droits et ils sont irrévocables.

Un groupe « Administrateurs de site » (site-administrators) qui représente les personnes qui auront
en charge l’administration du site et qui auront les « pleins pouvoirs » sur celui-ci, écriture,
participation aux workflows… Ainsi qu’un groupe d’utilisateurs privilégiés (site-privileged), qui
Page 4 sur 69
représente les personnes ayant besoin d’un accès au workspace default, utilisé notamment en
mode Edit et Contribute. Ceci permet de sécuriser les accès. A noter que si vous attribuer à un
utilisateur un rôle qui nécessite d’avoir accès au workspace default (rôle éditeur par exemple),
celui-ci sera automatiquement ajouté à ce groupe.

Pour finir, les administrateurs de sites ou du server ont la possibilité de déléguer des tâches à
d’autres utilisateurs du système. Par exemple, l’administrateur du site pourra donner l’accès de la
gestion des utilisateurs et groupes à d’autres utilisateurs. Bien entendu ces utilisateurs n’auront
accès qu’aux fonctionnalités définies par l’administrateur du site et à celle-ci uniquement.
La première partie de ce guide traite des fonctions de gestion de la plateforme dans son ensemble, en
particulier la création des projets web (sites), des utilisateurs et des rôles. La plupart des fonctions de
gestion du serveur sont réservées au compte super administrateur (root)
La seconde partie traite des fonctions de gestion disponibles pour chaque projet web créé sur la
plateforme. Ces fonctions sont utilisées plus couramment que les fonctions de gestion de la plateforme et
sont accessibles aux utilisateurs disposant du rôle « site administrator »
Page 5 sur 69
1 Première partie : Paramètres du Serveur
L’onglet Paramètres du serveur est normalement réservé au seul Super Administrateur du fait que les
actions et opérations effectuées vont impacter l’ensemble des sites mutualisés au sein du même serveur
(ou cluster) Jahia.
C’est donc à partir de cet onglet que l’on va pouvoir créer de nouveaux utilisateurs, ajouter de nouveaux
portlets ou modifier les rôles disponibles sur la plateforme. C’est également depuis cet onglet que l’on va
pouvoir lister, administrer, créer ou effacer des instances de sites virtuels / projets web.
De manière similaire à l’onglet “Paramètres du site”, le Super Administrator peut parfaitement
déléguer l’accès à un ou plusieurs modules disponibles dans cette section à d’autres utilisateurs. Cette
option de délégation est disponible au sein du menu « Gérer les rôles ».
Figure 1 : écran d'accueil des Paramètres du Serveur
Page 6 sur 69
1.1 Gestion des Projets Web
Vous pouvez créer de multiples sites virtuels au sein du même serveur Jahia. Chaque site virtuel possèdera
ainsi son propre jeu de pages, de contenu, de fichiers,…
La notion de « site virtuel » dans Jahia n’est cependant pas une mutualisation entière de la plateforme
mais signifie plutôt la capacité de créer des « espaces virtuels » distincts.
Ainsi chaque site peut disposer de :

Son propre domaine (par exemple vous pouvez décider de gérer un premier site sur le domaine:
www.mon-premier-domaine.com et un second site qui sera disponible sur le domaine www.monsecond-domaine.com les deux tournant en définitive sur le même serveur Jahia).

Son propre plan de site avec sa propre arborescence

Ses groupes propres (par exemple vous pouvez parfaitement disposer de deux groupes “Auteurs”
distincts dont la composition des membres différents selon le site A ou le site B)

Ses propres paramétrages (voir les fonctionnalités décrites dans le chapitre précédant)
Cependant chaque site partage avec les autres sites :

La même base de données sous-jacente et la même API : Il est ainsi possible d’accéder aux objets
de contenu disponibles dans les autres sites virtuels. Ceci permet ainsi de facilement réutiliser du
contenu identique entre plusieurs sites (ex : des nouvelles qui sont identiques pour chaque
département disposant chacun de leur propre site), mais cela peut poser évidemment des
problèmes de sécurité en cas de mutualisation complète de la plateforme (ex : deux sociétés
distinctes sont hébergées sur le même serveur).

Les mêmes sets de templates (du moins pour les sites qui partagent le même set de templates).

Les mêmes modules

Le même arbre de catégorie

Les mêmes utilisateurs (LDAP ou Jahia : il n’est ainsi pas possible d’avoir deux utilisateurs distinct
(ex : John) avec le même identifiant entre deux sites. Les groupes LDAP sont pour leur part, à
l’instar des utilisateurs LDAP, également commun à tous les sites.
Page 7 sur 69
Créer un nouveau site virtuel est donc utile lorsque la même société doit gérer plusieurs initiatives web
différentes (ex : un site web public, un ou plusieurs extranets et un ou plusieurs intranets
départementaux). La notion de sites virtuels permet ainsi de mieux déléguer les rôles, de disposer de vues
(sitemap, thèmes, résultats de recherche…) ou d’url/domaine différenciés par site tout en conservant des
capacités de partage de contenu, d’utilisateurs ou de mashups.
Figure 2 : Menu principal du module de gestion des sites virtuels
Vous pouvez accéder à la liste de tous les sites virtuels existants depuis cette interface.
Le site par défaut est celui qui est indiqué par une croix verte. Les opérations nécessaires à la création,
modification ou suppression d’un site
Page 8 sur 69
1.1.1 Création d’un site web
Si aucun site n’a encore été créé sur la plateforme (ce qui est peu probable sur un serveur de production,
les équipes de développement remettant généralement un environnement prêt à l’emploi) Jahia propose
par défaut un écran pour créer un nouveau site.
Figure 3 : Ecran de création du premier site virtuel
Si des sites existent déjà sur la plateforme, une interface légèrement différente par sa disposition, mais
proposant les mêmes options est affichée.
Figure 4 Ecran de gestion des sites virtuels
Page 9 sur 69
Trois possibilités sont offertes à l’utilisateur qui souhaite créer un site. Nous n’aborderons ici que la
première dans le détail, la seconde étant plutôt utilisée lorsque l’on souhaite se former et la troisième lors
d’une restauration d’un site sauvegardé ou pour le transfert d’un site d’un serveur vers un autre serveur.
1.1.1.1 Créer un nouveau Projet web
Etape 1
Figure 5 : Création d’un nouveau site projet : Titre / Domaine / Clef / Description
Titre du site : champ purement informatif, c’est ce titre qui apparaitra dans diverses interfaces de Jahia
pour identifier le site. Cette valeur peut être modifiée ultérieurement.
Nom du serveur du site : nom de domaine sur lequel ce site sera accessible. Si le site que vous créez n’est
pas destiné à de la production immédiate mais doit servir de site de développement ou de test, laissez la
valeur localhost dans le champ, cette valeur sera convenablement configurée sur le serveur de production.
En cas de doute laissez toujours la valeur localhost et demandez à un administrateur ou un responsable
d’hébergement. Cette valeur peut être modifiée ultérieurement.
Clé du site : nom du nœud racine du site. Ce nom apparaitra dans les urls par défaut, puisque toutes les
pages et les contenus du site seront stockés en dessous de celui-ci, aussi est-il recommandé de choisir un
Page 10 sur 69
titre court et descriptif. Cette valeur ne peut pas être modifiée ultérieurement, aussi est-il important de
bien réfléchir avant de définir celle-ci.
Description du site : champ purement informatif permettant de décrire un peu plus en détail le site. Cette
valeur peut être modifiée ultérieurement.
Utiliser comme projet Web par défaut : si cette case est cochée et que la plateforme comporte plusieurs
sites, c’est vers ce site que seront dirigés les utilisateurs qui appellent le serveur sans préciser le site
désiré. Cette valeur peut être modifiée ultérieurement.
Ne pas créer d’administrateur : aucun compte administrateur pour le site ne sera créé, les utilisateurs
disposant de suffisamment de droits (dont le compte ROOT bien sûr) pourront administrer le site. Sur une
plateforme multi sites gérée par un webmestre unique, ou plusieurs webmestres intervenant sur tous les
sites, cette option est préférable.
Créer un nouvel utilisateur : créer un nouveau compte utilisateur disposant de tous les droits sur le site en
cours de création. Cette option est utile si le site doit avoir un webmestre spécifique. Si le webmestre
dispose utilise le compte ROOT, ou que le compte utilisateur qui va assumer le rôle de webmestre existe
déjà (dans Jahia ou dans un annuaire d’entreprise) il n’est pas utile de créer un nouveau compte.
Une fois ces champs d’information remplis, cliquez sur « Etape suivante »
Etape 2
Page 11 sur 69
Figure 6 : Création d’un nouveau site web : set de templates, modules et langues
Cette étape permet de sélectionner le jeu de modèles (templates), des modules optionnels à déployer sur
le site et la langue par défaut du site.
Page 12 sur 69
Jeux de modèles : liste déroulante permettant de sélectionner le set de templates souhaité ; Si le set de
template dispose d’une image de prévisualisation, celle-ci sera affichée en dessous de la liste déroulante
pour faciliter son identification.
Modules : par défaut tout site bénéficie d’une série de composants / fonctionnalités qui font partie du
cœur du logiciel (module default). Les modules listés ici sont ceux disponibles sur la plateforme (dont les
fichiers war ont été déployés dans Jahia) et qui peuvent être activés sur le site en cours de création. Ces
modules permettent d’ajouter de nouveaux types de contenus ou de nouvelles fonctionnalités.
Note : Lors de la création d’un nouveau site, les équipes de développement ou les responsables
fonctionnels du projet sont supposés vous avoir informé des modules à déployer. Si ce n’est pas le cas, les
modules peuvent être déployés ultérieurement à partir du Studio (version communautaire, Enterprise
Jahia en mode développement) ou à partir du panneau Gestion des Modules dans les Paramètres du
serveur de l’interface d’Administration (Enterprise Jahia mode développement et mode production).
Langue par défaut : liste déroulante de choix de la langue et des variantes locales. Pour un site multilingue
sélectionnez la langue considérée comme la plus importante, celle vers laquelle les utilisateurs seront
redirigés s’ils tentent d’accéder au site sans préciser la langue souhaitée. La langue par défaut peut être
modifiée ultérieurement dans les paramètres de site.
Cliquer sur « Etape suivante »
Etape 3
L’écran final récapitule toutes les informations saisies précédemment pour permettre une dernière
vérification avant création du site. En cas d’erreur, il est possible de revenir au début du processus de
création pour modifier ces valeurs. Les informations précédemment rentrées sont mémorisées tant que la
session utilisateur est active, ce qui évite d’avoir à retaper toutes les informations.
Page 13 sur 69
Figure 7 : Création d’un nouveau site web : récapitulatif
Si les informations sont correctes cliquez sur « Créez votre projet Web ». Une petite fenêtre flottante
apparait pour montrer que des opérations sont en cours et disparaît une fois que la création du site est
terminée.
Figure 8 : Création en cours d’un nouveau site web
COMPRENDRE : Pourquoi la création d’un site prend-elle un peu de temps ?
La création d’un site, même si celui-ci semble presque vide lors de sa création, est un processus qui
implique plus que la création d’un simple nœud racine contenant les informations saisies dans les écrans
de paramétrage. L’essentiel du temps est en fait consacré à copier le set de templates sélectionné sous le
nœud racine et à associer toutes les permissions nécessaires.
Page 14 sur 69
Une fois la création du site terminée, vous êtes redirigé sur l’écran de liste des sites, dans laquelle le site
nouvellement créé doit apparaître.
Figure 9 : écran de gestion des sites virtuels
Pour accéder directement au site nouvellement créé, cliquez sur l’onglet « Accéder au Mode Edition ».
Vous êtes alors redirigé sur la première page du site, plus ou moins vide selon le set de templates utilisé,
mais prête à être remplie, comme cela est expliqué dans le Guide de l’Editeur.
1.1.1.2 Utiliser un site préconfiguré :
Cette option crée un nouveau site contenant déjà des pages et du contenu (généralement des exemples
fournis par Jahia à titre de démonstration) : sélectionner dans la liste déroulante le site d’exemple voulu,
cliquer sur « Poursuivre ». Sur l’écran suivant donner un titre au site, le nom de domaine et l’identifiant
unique du site qui apparaitra dans les URLs par défaut puis cliquer sur Importer.
Page 15 sur 69
Figure 10 : Création d’un site préconfiguré : Titre / Domaine / Clef / Description
1.1.1.3 Importer un site préalablement exporté
Cette option permet de sélectionner sur un disque dur un fichier au format zip résultant d’un export
préalable. L’export aura été réalisé via les interfaces d’exportation de Jahia (voir plus loin). Un nouveau
site sera créé reprenant fidèlement les réglages et le contenu de celui-ci au moment de son export.
1.1.2 Supprimer un site
Pour supprimer un site unique, cliquez sur l’icône rouge en face de son nom
. Attention cette action est
irréversible, il est fortement conseillé d’exporter le site au préalable, par sécurité.
Figure 11 : Suppression d’un site virtuel
Page 16 sur 69
Pour supprimer plusieurs sites, utilisez les cases à cocher pour sélectionner ceux désirés puis cliquez sur
« Supprimer les sites sélectionnés ».
1.1.3 Exporter un site
L’export de site peut répondre à divers besoins :
-
Sauvegarde : il est possible de réimporter un site exporté tel qu’il était. Cependant, cette solution
demande une intervention manuelle d’un webmaster ou d’un administrateur et ne peut en aucun
cas être considérée comme une méthode de backup fiable.
-
Transfert vers un autre serveur : qu’il s’agisse d’effectuer une copie à l’identique à un instant T pour
travailler sur un autre serveur, faire des tests, servir de base de départ d’un nouveau projet.
-
Transfert d’un serveur de développement vers un serveur de production : dans le cas d’un projet
qui a été réalisé et pré-rempli avec du contenu sur un environnement de développement, il peut
être pratique de réaliser un export et une réimportation vers le serveur qui servira à la production.
Figure 12 : Suppression d’un site virtuel
Page 17 sur 69
Pour exporter un site unique, cliquer sur l’icône la plus à droite en face de son nom
Pour exporter plusieurs sites, utilisez les cases à cocher pour sélectionner ceux désirés puis cliquez sur
« Exporter les sites sélectionnés ».
Pour exporter tous les sites, cliquez sur « Exporter tous les sites ».
1.1.4 Modifier les informations d’un site
Pour modifier les informations concernant un site, cliquez sur son titre. L’écran suivant permet d’éditer les
champs
-
Titre
-
Nom du serveur
-
Description
1.1.5 Autres réglages propres aux sites
D’autres réglages sont disponible directement en mode édition, dans le Sélecteur, vous pouvez utiliser le
menu contextuel (clic-droit) pour éditer le nœud représentant un site Web, afin d’accéder à des
informations et réglages complémentaires. Plus d’informations sont disponibles dans le guide du
Webmestre.
Page 18 sur 69
Figure 13 : Paramètres de site virtuel disponibles directement depuis le Mode Edition
1.2 Gérer les utilisateurs
Contrairement aux groupes, les utilisateurs sont communs à l’ensemble de la plateforme afin de garantir
leur unicité et sont donc gérés au niveau des paramètres du serveur.
1.2.1 Créer un utilisateur
Rendez-vous dans la rubrique Gérer les utilisateurs, et cliquez sur « Créer un nouvel utilisateur ».
Page 19 sur 69
Figure 14 : Ecran de gestion des utilisateurs
Vous arrivez alors sur l’écran de création où vous pouvez saisir les différentes propriétés du nouvel
utilisateur :
Figure 15 : Formulaire de création d’un nouvel utilisateur
1.2.2 Modifier un utilisateur
Pour modifier un utilisateur, double cliquez simplement sur son nom, vous serez alors redirigé vers un
écran similaire à celui de la création d’un utilisateur et vous pourrez modifier toutes ses propriétés à
l’exception bien sûr de son nom d’utilisateur.
Page 20 sur 69
1.2.3 Supprimer un utilisateur
Sélectionner dans la liste l’utilisateur à supprimer en cliquant dessus puis cliquez sur le bouton « Supprimer
l’utilisateur sélectionné ».
Figure 16 : Formulaire de création d’un nouvel utilisateur
1.2.4 Suspendre un utilisateur
Il est possible de suspendre un utilisateur c'est-à-dire de rendre son compte inactif, l’empêchant ainsi de
s’authentifier.
Page 21 sur 69
L’avantage de la suspension de compte est de bloquer l’utilisateur sans pour autant détruire celui-ci c'està-dire sans pour autant supprimer l’ensemble des informations, documents ou contenus stockés dans son
répertoire personnel.
Pour suspendre un utilisateur vous devez vous rendre dans la fiche détaillée de l’utilisateur en double
cliquant sur son nom dans la liste (ou en le sélectionnant et en cliquant sur le bouton « Editer / Afficher les
propriétés de l’utilisateur sélectionné »). Une fois dans sa fiche, vous devez cliquer sur la case « compte
bloqué », puis « OK ».
Figure 17 : Désactivation d’un compte utilisateur
Page 22 sur 69
1.2.5 Créer un lot d’utilisateurs par import
Des lots d’utilisateurs peuvent être chargés dans Jahia par l’intermédiaire d’un ficher CSV. Celui-ci doit
contenir au minimum un nom d’utilisateur et mot de passe, mais peut contenir l’ensemble des propriétés
de l’utilisateur. Il est impératif de spécifier les champs référencés dans le CSV en spécifiant un header,
comme ceci :
j:nodename,j:password,j:firstName,j:lastName
steven,steven1234,Steven,ACME
robert, robert1234, Robert, ABME
Enfin pensez bien à spécifier le séparateur au moment de l’import, ici « , ».
Figure 18 : Import d’utilisateur par lot (CSV)
Page 23 sur 69
1.3 Configuration des notifications E-mails
Depuis ce module vous pouvez modifier les paramètres du serveur email qui servira de relai pour l’envoi
des notifications par email. Ces paramètres ont normalement été saisis au préalable lors de l’installation du
serveur Jahia.
Figure 19 : Configuration des emails
Afin de paramétrer correctement votre serveur mail, entrer tout d’abord l’adresse de votre serveur SMTP.
Vous pourrez ensuite saisir le mail de l’administrateur système. Ce dernier recevra les emails de
notifications en cas d’erreurs système. Vous pouvez également déterminer l’adresse email qui servira de
source lors de l’envoi des notifications automatiques par le système. Cette adresse email doit bien sûr être
reconnue et acceptée par le serveur SMTP.
Vous pourrez trouver des compléments d’informations de paramétrage ci-dessous :
1. "Serveur de messagerie": ce champ contient l’adresse SMTP du serveur email. Ce champ peut contenir
certaines propriétés avancées telles que :
- le numéro de port : si ce dernier diffère du port SMTP standard (25)
- l’utilisateur et son mot de passe : dans le cas où le serveur SMTP requiert une authentification
- des propriétés additionnelles : par exemple afin d’activer le TLS
Page 24 sur 69
Le format pour ce champ est le suivant :
<utilisateur>:<mot de passe>@<smtp-host>:<smtp-port>[Paramètre1=Valeur1,Paramètre2=Valeur2,...]
Tous les arguments à l’exception de <smtp-host> sont optionnelles. Merci de consulter les exemples
d’utilisation ci-dessous pour plus de détails.
2. Le champ "e-mail à l’administrateur" contient une ou plusieurs adresses emails séparées par des
virgules. Chacun de ces utilisateurs recevra les notifications systèmes (si ces dernières sont activées).
3. Finalement le champ "e-mail de" déterminera le nom par défaut utilisé par Jahia pour envoyer les emails
de notifications.
Afin d’illustrer différentes configurations possibles, veuillez trouver différents exemples d’utilisation cidessous :
1. Le serveur SMTP ne requiert aucune authentification et utilise le port standard 25 :
smtp.acme.com
2. Le serveur SMTP requiert une authentification et utilise le port non standard 11019 :
utilisateur : [email protected]:11019
3. Exemple pour un compte GMail : Le serveur SMTP requiert une authentification et le TLS est activé :
[email protected]: mot-de-passe-secret @smtp.gmail.com:587[mail.smtp.starttls.enable=true]
4. Si nécessaire activation des options de debuging email avancées afin de voir le détail de la
communication avec le serveur SMTP : smtp.acme.com:25[mail.debug=true]
Finalement l’option concernant le niveau de notification est uniquement utilisée afin d’envoyer des emails
de notification concernant certaines erreurs systèmes. Normalement seuls les administrateurs système de
la plateforme sont concernés par cette option (voir ci-dessus pour la liste des récepteurs).
La configuration du serveur email concerne pour sa part l’envoi de tous les emails de notification de Jahia
(y compris les notifications des workflows par exemple) et ne s’arrêtent pas uniquement aux messages
d’alerte système.
Page 25 sur 69
1.4 Gérer les portlets
L’application Jahia supporte nativement la norme JSR168 (Portlet 1.0) et JSR286 (Portlet 2.0). Des portlets
génériques peuvent donc être facilement déployés et réutilisés au sein du système Jahia qui peut se
substituer à un serveur de portail additionnel.
Un portlet est généralement une micro-application web qui peut gérer plusieurs instances. Par exemple un
administrateur peut déployer une portlet générique de type « Portlet RSS » servant à lire et afficher un
flux RSS. Cette portlet générique peut ainsi être utilisée au sein de plusieurs pages, voire plusieurs sites afin
d’afficher des flux RSS totalement différents. Chaque flux sera donc traité par Jahia comme une instance de
ce portlet. Chaque instance est sauvée et est considérée comme un « mashup » disponible au sein de
l’application.
Ainsi la portlet générique est déployée et gérée directement au sein du centre d’administration à partir de
ce module. Le Super Administrateur peut ensuite déterminer quels seront les utilisateurs qui auront le
droit de créer des nouvelles instances à partir de ce portlet (par ex : des nouveaux flux RSS). Ensuite
chacune de ces instances pourra elle-même recevoir des droits d’utilisation distincts par utilisateur. Ce
mécanisme permet à l’administrateur de déterminer qui peut ajouter des nouveaux flux et qui peut les
positionner au sein d’une page dans un site précis. Ce système ne fait évidement de sens que si
l’administrateur souhaite contrôler les « instances de mashups » qui auront été générées. Si tel n’est pas le
souhait, il suffit de rajouter le groupe « utilisateurs » (tous les utilisateurs identifiés) à chacune des portlets
et chaque utilisateur sera alors libre de créer le nombre d’instances de ce portlet qu’il souhaite.
Merci de vous référez à la documentation en ligne disponible sur le site www.jahia.com afin d’apprendre
comment développer de nouvelles portlets ou comment déployer un portlet existant au sein de votre
environnement de travail Jahia.
Page 26 sur 69
Figure 20 : Gérer des portlets
De manière similaire au menu concernant la gestion des sites virtuels, vous trouverez dans le menu des
portlets une liste de tous les portlets déjà déployés dans la partie supérieure de l’interface principale. Vous
pouvez cliquer sur les opérations et actions disponibles à côté de chaque portlet afin d’obtenir des détails,
de modifier leurs permissions d’accès ou d’accéder à la liste de leur utilisation.
Afin de déployer un portlet dans le serveur d’application Tomcat livré par défaut avec Jahia, un
développeur aura besoin de réaliser une légère modification dans un fichier de configuration fourni avec le
portlet. Cette manipulation est décrite dans l’écran affiché après avoir cliqué sur le bouton d’aide. Cette
modification peut également être automatiquement réalisée en cliquant sur « Préparer » ou « Préparer et
Déployer la portlet ».
Page 27 sur 69
Figure 21 : Ecran de déploiement d’une nouvelle portlet
Si vous utilisez un autre serveur d’application que Tomcat, vous devez effectuer de manière manuelle cette
opération et déployer vos portlets tels que précisés dans la documentation de votre serveur d’application.
1.5 Editer les propriétés du Super Administrateur
En tant que Super Administrateur vous pouvez bien entendu modifier à n’importe quel moment vos
propriétés personnelles (nom, mot de passe, email, …).
Figure 22 : Propriétés du Super Administrateur
Mettez simplement à jour les informations nécessaires et cliquez sur le bouton OK.
Page 28 sur 69
1.6 Statut du serveur et des caches
Ce module permet de renseigner le Super Administrateur sur les différents paramètres du système. En plus
de fournir des informations, cette interface permet d’intervenir sur les caches et de récupérer des
informations détaillées en vue d’analyse en cas de comportement anormal à fournir aux équipes de
support.
Statut du serveur et de caches
La première ligne de l’écran permet d’effectuer un export complet de l’ensemble des paramètres du
système (thread dump, caches, environnement…).
Cache
Ce panneau permet de visualiser l’état de chacun des caches de Jahia, front-end et back-end et de vérifier
leur niveau d’efficacité.
Les trois boutons situés en haut du panneau permettent de purger les caches
-
Frontaux (purger tous les HTML caches) c’est à dire les fragments de cache générés au format
HTML pour chaque élément de contenu.
-
Back-end (purger tous les Hibernate caches)
-
Les deux en même temps (Purger tous les caches)
Pour des purges plus sélectives sur les caches back-end le panneau liste un à un chacun d’entre eux.
Page 29 sur 69
Attention, une purge de caches est une action dont les conséquences sont importantes en termes de
cohérence des données, de stabilité et de performances. Le flush des caches HTML, par exemple, induira
une surcharge de travail conséquente sur la plateforme pour recalculer les différents fragments. Une telle
purge ne doit jamais être réalisée sous forte charge, sous peine de provoquer une indisponibilité de la
plateforme. De manière générale, des purges de caches ne devraient être réalisées qu’à la demande du
support techniques Jahia ou si vous maîtrisez bien le fonctionnement du logiciel et les conséquences de ces
purges.
Figure 23 : Liste et statut des caches gérés par Jahia
Page 30 sur 69
En bas du panneau, il est possible d’activer les statistiques Hibernate (couche d’abstraction entre Jahia et
la DB)
Si les statistiques sont activées, le panneau est étendu.
Page 31 sur 69
Ces informations statistiques peuvent s’avérer utiles ponctuellement pour auditer le système en cas de
problème ou de travail d’optimisation des performances. En situation normale de production, ces
statistiques n’ont pas besoin (et ne devraient pas) être activées
Mémoire
Figure 24 : Onglet mémoire
Ce panneau délivre des informations sur la mémoire allouée, la mémoire effectivement utilisée et la
mémoire libre à l’instant T.
Il est possible, depuis cet onglet de déclencher le garbage collector pour purger la mémoire utilisée
(attention, les conséquences d’une purge de mémoire forcée sur un site en production ne sont pas anodins
en terme de performances, seuls des administrateurs maitrisant bien les principes de fonctionnement des
serveurs d’application et des JVM devraient utiliser cette option)
Thread Dump
Page 32 sur 69
Ce panneau permet en premier lieu d’effectuer des threads dumps pour analyser les processus en cours
d’exécution et de récupérer les données selon différentes modalités
-
Dans une fenêtre du navigateur
-
Dans un fichier téléchargeable sur l’instant
-
Dans la console java
-
Dans un fichier stocké sur le disque du serveur : *répertoire d’installation de jahia+/temp/jahiathreads/
-
Plusieurs dumps effectués à intervalle régulier dans un fichier stocké sur le disque du serveur.
Il est ensuite possible de désactiver les fonctions Thread Monitor et Error File Dumper intégrées à Jahia et
qui ont pour effet de stocker automatiquement sur disque un grand nombre d’informations lorsque
surviennent des erreurs sur la plateforme. Bien que ces fonctions soient très utiles pour le support, il est
conseillé de désactiver ces deux outils sur des plateformes de production soumises à de fortes charges,
dans la mesure où de telles opérations sont elle-mêmes fortement consommatrices de ressources. Sur une
plateforme qui connaitrait déjà des erreurs ou des ralentissements liés à une trop forte charge, ces
fonctions auraient pour effet d’aggraver la situation.
La dernière ligne permet de lancer un outil d’analyse de thread dumps.
Dans tous les cas, au moment de la demande de génération des thread-dumps, les crédentiels
administrateur de votre serveur d’application (et non de Jahia) vous seront demandés pour pouvoir
effectuer ces opérations bas niveau.
Informations système
Le dernier panneau rassemble les informations relatives au système (OS), à l’environnement dans lequel
évolue Jahia (JVM / Path d’installation / Base de données / …) et à certaines configurations de Jahia.
Page 33 sur 69
Figure 25 : Informations système
Page 34 sur 69
1.7 Gestion de la politique des mots de passe
Le module de gestion de politique de mot de passe a pour objectif de fixer les règles servant à sécuriser les
identifiants des utilisateurs. Des paramètres tels la taille minimale pour les mots de passe, l’intégration de
certains caractères spéciaux, l’obligation de changer de mots de passe après un certain délai, etc… peuvent
être ajustés depuis ce menu.
Figure 26 : Gestion de la politique des mots de passe
Il est important de mentionner que cette politique de sécurisation des mots de passe ne concerne que les utilisateurs Jahia et non pas les
utilisateurs LDAP ou Active Directory qui sont directement gérés et soumis aux règles édictés par ces serveurs distants.
Page 35 sur 69
1.8 Gestion des rôles
Le système de gestion des habilitations (accès à certaines pages, droit d’écriture, possibilité d’utiliser
certains outils, etc.) repose sur des permissions groupées entre elles pour former un rôle.
Figure 27 : Gestion des rôles
En standard, Jahia fourni des permissions relatives aux « repository », c'est-à-dire à la lecture / écriture
dans les workspace live ou default (edit), des permissions permettant de restreindre l’accès aux managers
ou encore des permissions pour gérer l’accès aux différents modes contribute / edit / studio. Néanmoins,
chaque module déployé dans Jahia peut venir ajouter ses propres permissions, pour effectuer ses propres
contrôles d’accès. C’est par exemple le cas du blog ou des commentaires, qui définissent des permissions
permettant de créer des commentaires ou des entrées de blog directement en live. Enfin, certaines
opérations dans Jahia vont venir générer automatiquement des permissions, tel que le déploiement de
Page 36 sur 69
portlet, ou le déploiement template, ce qui va permette de gérer l’utilisation de ces éléments au sein du
système.
Le couplage de plusieurs permissions va permettre de définir un rôle. Par exemple un rôle de traducteur,
devra avoir la permission d’accès à l’édit mode, la permission de modifier du contenu en mode edit dans
une langue donnée, mais pas celle d’en créer ! Un rôle de publicateur, qui doit valider le contenu, aura lui
la permission « publish », et la permission lecture du mode edit, mais pas écriture car il n’est là que pour
valider ! ect … Libre à vous de créer vos propres rôles pour répondre à vos besoins. Par exemple un rôle
« blogueur ».
Ces rôles pourront ensuite être associés à des groupes d’utilisateurs ou à des utilisateurs pour tout ou
partie d’un site directement via l’édit mode.
1.8.1 Création d’un nouveau rôle
Cliquer sur le bouton
en haut à gauche pour créer un nouveau rôle. Une fenêtre de saisie apparait
alors et vous pouvez y saisir le nom « technique » du rôle.
Page 37 sur 69
Figure 28 : Création d’un nouveau rôle
Une fois que vous avez cliquez sur OK, la liste des rôles est mise à jour et on peut alors sélectionner le rôle
en question pour l’éditer via un simple click :
Page 38 sur 69
Figure 29 : Edition d’un nouveau rôle
Titre et description
Un rôle peut disposer d’un titre internationalisé (ce titre sera alors utilisé en lieu et place du nom système
dans la plupart des interfaces). On peut également ajouter une description du rôle encore une fois de
façon internationale avec une valeur par langue.
Types de noeuds
Il est possible de définir les types de nœuds (types de contenus) sur lesquels le rôle peut être appliqué. Par
défaut, un rôle peut être conféré à un utilisateur ou un groupe sur n’importe quel type de contenu. En
sélectionnant des types de contenus particuliers, le rôle en question n’apparaitra dans les interfaces de
gestion des droits que pour ces types de contenu et ne sera pas disponible pour les autres. Cette faculté
permet de maintenir des interfaces de gestion des droits non surchargées et de confuser les utilisateurs en
leur mettant à disposition des rôles qui n’auraient strictement aucun effet sur l’objet sur lesquels ils
essaient de l’appliquer.
Page 39 sur 69
Figure 30 : Edition d’un nouveau rôle - Suite
Accès automatique au contenu en édition
Si le rôle que vous créez nécessite d’accéder en lecture au workspace default (c'est-à-dire lire du contenu
via le Mode Contribution, le Mode Edition ou le Studio) vous devez cocher la case. Lorsque cette case est
cochée, tout utilisateur qui sera associé à ce rôle sera automatiquement placé dans le groupe « sitepriviliged », ce qui lui permettra d’accéder au workspace default en lecture.
Groupe de rôle
Ce champ permet de définir dans quel onglet de l’engine d’édition ce rôle doit apparaître. Par défaut il
existe deux groupes : Rôle Public, Rôle d’Edition.
Lorsqu’un rôle ne contient de permissions que sur le workspace Live, il est recommandé de mettre celui-ci
dans le groupe Rôle Public. Si le rôle définit des permissions mixtes (workspace Live et Default) ou d’édition
uniquement (workspace Default), il est recommandé de le placer dans le groupe Rôle d’Edition. Par défaut,
les simples éditeurs ne voient dans les interfaces d’édition que le premier onglet (Rôle Public) qui leur
permet de contrôler leur contenu une fois publié, seuls des utilisateurs disposant de droits plus étendus
ont accès dans les interfaces d’édition à l’onglet Rôles d’édition.
Page 40 sur 69
Une fois la partie contenu correctement configuré, il faut se rendre sur l’onglet « permissions » pour
sélectionner les permissions que l’on veut associer à ce rôle :
Figure 31 : Edition d’un nouveau rôle – ajout des permissions
Page 41 sur 69
Les permissions sont regroupées par « rubrique ». Si l’on coche directement la rubrique, alors l’ensemble
des sous permissions sont sélectionnées :
Figure 32 : Sélection d’un groupe de permissions
Les différents groupes de permissions sont :

actions (possibilité de participer à un blog, de commenter, …)

admin (paramétrage des accès aux différents items de l’administration)

contributeMode (paramètres d’accès au contribute mode)

editMode (paramètres d’accès à l’édit mode et personnalisation du mode edit)

job (paramètrage de la gestion des background jobs)

managers (accès aux managers : catégories, tags, document, repository, …)

repository-permissions (droits de lecture / écriture / modifcation sur les worspace live et default)

studioMode (droits d’accès et personnalisation du studio)

templates (droits d’utilisation des templates mis à disposition sur la plateforme)

webapps (droits d’utilisation des portlets ou webapps déployées sur le système)

wokflow-tasks (paramétrage des étapes de workflow accessible avec le rôle)

wysiwyg-editor-toolbar (paramétrage du type d’éditeur FCK associé à ce rôle)
Page 42 sur 69
1.8.2 Suppression, copie d’un rôle
Les opérations usuelles de suppression ou de copie d’un rôle sont disponibles dans l’interface de gestion.
Pour les utiliser sélectionner le rôle avec lequel vous voulez interagir via un simple clic, puis cliquer sur
l’icône de l’action de votre choix :
Figure 33 : Sélection d’un groupe de permissions
1.8.3 Export / Import des rôles
Afin de vous éviter d’avoir à reconfigurer les rôles sur l’ensemble des serveurs, ceux-ci sont exportables au
format XML ou ZIP. Vous pouvez ainsi les réimporter à souhait sur d’autres serveurs. Pour cela utilisez les
deux icones prévues à cet effet dans le panneau de gestion des rôles.
Page 43 sur 69
1.9 Gestion des modules
La gestion des modules et leur mise à disposition (déploiement) sur différents sites de la plateforme peut
être réalisée via le Studio lorsque Jahia est en mode développement.
En mode production, les réglages de la plateforme sont optimisés et pour des raisons de sécurité des
processus de mise à jour, le Studio n’est pas accessible.
Cet écran permet donc d’effectuer les tâches de déploiement (ajout / mise à jour) des modules qui sont
disponibles sur la plateforme.
Cet écran comporte trois parties
Première partie : deux menus déroulants permettant de sélectionner un module particulier
Le premier menu déroulant avec les 4 grands types de modules
o Jahiapp : module complexe pouvant être assimilé à une application web à part entière
o Module : module standard
o My Space : modules liés à l’espace utilisateur
o Jeux de modèles : templates de mise en page
Le second menu affiche la liste des modules correspondant au type de module choisit dans le premier
menu.
Page 44 sur 69
Seconde partie : Liste des sites sur lesquels ce module est déjà déployé.
Lorsqu’un module sélectionné dans la première partie est déjà déployé sur un ou plusieurs sites, ceux-ci
sont affichés et un bouton permet d’effectuer d’un seul clic la mise à jour sur tous les sites.
La troisième partie : liste de sites sur lesquels le module sélectionné n’est pas déployé.
Page 45 sur 69
Il est possible de déployer le module sélectionné sur l’ensemble des sites de la plateforme qui n’en
disposent pas encore, ou de sélectionner manuellement un ou plusieurs sites sur lesquels effectuer ce
déploiement.
1.10 Système de suivi des incidents
Ce raccourci vous redirige directement vers le système de gestion des tickets des incidents disponible en
ligne. Une connexion internet est donc nécessaire.
Deux systèmes de gestion des incidents coexistent :

Le système gratuit mis à disposition de la communauté Jahia.

Le système commercial uniquement à disposition des clients avec un contrat de support valide
Le système communautaire a également pour objectif d’enregistrer et de suivre les différentes
propositions d’amélioration. Donc n’hésitez pas à suggérer des propositions ou des idées afin d’améliorer
l’application. Comme ces tickets sont disponibles publiquement, merci de ne pas faire mention de vos
paramètres propres à votre environnement ou d’autres données confidentielles.
Le système de suivi des tickets commercial est uniquement disponible pour les clients. Chaque client
dispose de son environnement distinct et sécurisé uniquement disponible via une accréditation spécifique.
Tous les tickets de bugs traités par ce système le sont par des employés de Jahia Solutions Group sous le
couvert des règles classiques de confidentialité. Les tickets ne sont donc pas partagés entre les clients et
chaque client dispose d’un temps minium ainsi que d’une obligation de réponse de la part de l’éditeur.
1.11 Documentation
Ce lien vous redirige vers l’espace de documentation.
De manière similaire au système de gestion des incidents, la documentation Jahia est séparée en deux
parties :

la documentation gratuite et communautaire disponible sur le site jahia.org.
Page 46 sur 69

la documentation commerciale uniquement disponible pour les clients des versions payantes qui
est disponible dans l’espace Extranet client.
1.12 A propos de Jahia
Finalement le module: “A Propos de Jahia” résume l’ensemble des fonctionnalités disponibles dans le
cadre de votre clé de licence actuelle (nombre d’utilisateurs, contraintes sur certains modules, expiration
des versions d’essais,…).
Figure 34 : A propos de Jahia
Dans cette section vous trouverez également le numéro de version de l’applicatif. Ce numéro apparaît
normalement également en bas de chaque écran d’édition.
Page 47 sur 69
Ce numéro doit être mentionné dans chaque report d’incident afin de simplifier la résolution de ce dernier
par l’équipe de support.
2 Seconde partie : Paramètres du site
L’interface d’administration se présente comme ci-dessous en tant qu’administrateur de site :
Figure 35: Ecran d'accueil de gestion d'un site virtuel
Cet écran propose tous les outils nécessaires à l’administration d’un site hébergé sur la plate-forme Jahia.
Dans la mesure où l’administrateur de site à les droits d’administration sur d’autres sites virtuels hébergés
sur le système, il peut via une liste déroulante accéder à chacun des autres sites virtuels et gérer celui-ci
avec les mêmes options.
Figure 36: Un administrateur de site gérant plusieurs sites virtuels.
Un administrateur de site peut accéder aux « Paramètres du serveur » mais seules certaines options seront
disponibles, les autres étant grisées car réservées à des administrateurs ayant des droits plus élevés.
Page 48 sur 69
En cliquant sur « Accéder au Mode Edition », l’administrateur du site sera redirigé vers la page d’accueil du
site couramment sélectionné.
Un utilisateur avancé ayant certains droits d’administration pourra accéder aux options sur lesquelles des
droits lui ont été conférés, les autres choix étant grisés. Dans l’exemple ci-dessous, l’utilisateur avancé ne
pourra accéder qu’à la gestion des utilisateurs et groupes.
Figure 37: Paramètres du site pour un utilisateur avancé avec droits limités
2.1 Gérer les groupes
La gestion des groupes est réalisée dans l’interface d’Administration, à partir de l’onglet « Paramètres du
site », en effet, si les utilisateurs sont globaux sur la plateforme afin de garantir leur unicité, chaque site
possède son propre jeu de groupes qui peut être différent des groupes d’un autre site.
Page 49 sur 69
Figure 38 : interface de gestion des groupes
Page 50 sur 69
2.1.1 Créer un groupe
Cliquer sur le bouton « Créer un nouveau groupe » puis dans l’interface saisissez un nom pour celui-ci.
Figure 39 : créer un groupe
Une fois la création validée, la liste des groupes se réaffiche, mise à jour.
Figure 40: écran principal après création d'un nouveau groupe
Lors de sa création un nouveau groupe est vide
Page 51 sur 69
2.1.2 Ajouter et supprimer des utilisateurs
Dans la liste des groupes, faites un double-clic sur le groupe souhaité ou sélectionnez ce groupe et cliquez
sur le bouton « Editer le groupe sélectionné ».
Figure 41 : sélection d’un groupe
Page 52 sur 69
Figure 42 : Ecran d’ajout d’utilisateurs dans un groupe donné
Pour ajouter des utilisateurs dans le groupe cliquez sur « Ajouter des membres ».
Une fenêtre flottante apparaît listant la totalité des utilisateurs enregistrés sur la plateforme, par ordre
alphabétique. Si votre plateforme comporte de nombreux utilisateurs, un champ de recherche placé de
haut de la fenêtre permet de saisir un nom ou une partie d’un nom.
Page 53 sur 69
Figure 43 : Liste des utilisateurs de la plateforme pouvant être ajouté au groupe
Pour ajouter un utilisateur unique, sélectionnez celui-ci dans la liste puis cliquez sur le bouton « Ajouter ».
La fenêtre flottante se ferme pour afficher la liste des utilisateurs du groupe mise à jour.
Pour ajouter plusieurs utilisateurs, sélectionnez ceux-ci avec un CTRL-clic puis cliquez sur « Ajouter », ou
double-cliquez sur chacun des utilisateurs souhaités puis fermez la fenêtre en cliquant sur la croix rouge en
haut à droite de la fenêtre. (note : l’ajout d’utilisateurs via double-clic est réalisé instantanément, de ce
fait, même en cliquant sur le bouton « Annuler » les utilisateurs ajoutés de la sorte seront bel et bien
ajoutés dans le groupe même en fermant la fenêtre via le bouton « Annuler »).
Une fois la fenêtre de sélection d’utilisateurs fermée, la liste des membres du groupe apparaît mise à jour.
Page 54 sur 69
Figure 44 : Ecran de gestion des utilisateurs du groupe
Pour retirer un utilisateur d’un groupe, sélectionnez-le (ou les via ctrl+click) dans la liste et cliquez sur
« Supprimer ces membres ». Notez que cette action ne supprime pas l’utilisateur de la plateforme, il retire
juste celui-ci des membres du groupe.
Page 55 sur 69
2.1.3 Supprimer un groupe
Dans la liste des groupes, sélectionnez le groupe à supprimer en cliquant dessus puis cliquez sur le bouton
« Supprimer le groupe sélectionné ».
Figure 45 : Suppression d’un groupe
Page 56 sur 69
2.1.4 Dupliquer un groupe
Si vous avez besoin de définir un nouveau groupe dont les membres sont très proches de ceux existant
d’ores et déjà dans un autre groupe, vous pouvez dupliquer celui-ci en le sélectionnant et en cliquant sur
« Copier le groupe sélectionné ». Jahia vous demande alors de saisir un nom pour le nouveau groupe qui
sera créé. Il ne vous reste plus qu’à retirer les membres excédentaires ou ajouter les membres manquants
dans ce nouveau groupe, mais sans avoir à refaire toutes les inscriptions manuellement.
Figure 46 : Duplication d’un groupe
Page 57 sur 69
2.2 Gérer les langues
Ce menu vous permet de gérer les paramètres concernant les langues du site courant.
La partie haute de l’interface affiche les langues déjà déclarées comme utilisables sur le site.
2.2.1 Langue par défaut
Vous pouvez choisir si la langue est obligatoire et si c’est celle par défaut (une seule possible).
Figure 47 : Gérer les langages
2.2.2 Langue par défaut
Cette option correspond à la langue qui sera utilisée par Jahia pour servir le contenu s’il ne parvient pas à
trouver une langue correspondant aux préférences exprimées explicitement ou implicitement par
l’utilisateur. La détermination de cette préférence utilisateur se fait par une série de tests, qui s’enchainent
tant que le résultat du test est négatif.
L’ordre des tests est le suivant
Page 58 sur 69
-
Langue spécifiée dans l’url
-
Langue préférée déclarée dans les options du navigateur
-
Langue du navigateur
Exemple :
Si un visiteur appelle l’url suivante, par exemple http://www.monsite.fr/en/home/societe.html Jahia lui
retournera la page demandée en anglais (langue spécifiée dans l’url). Si la langue anglaise n’existe pas sur
le site, Jahia regardera si une version existe correspondant à la langue préférée, puis à la langue du
navigateur. Si Jahia ne trouve aucune correspondance entre les langues déclarées et actives sur le site et
ces préférences, la page sera servie dans la langue définie comme langue par défaut.
Si le visiteur appelle une page sans spécifier de version de langue, par exemple http://www.monsite.com
Jahia se basera d’abord sur les préférences de langue déclarées dans les options du navigateur, puis sur la
langue du navigateur lui-même pour servir la langue appropriée. Si Jahia ne trouve aucune correspondance
entre les langues déclarées et actives sur le site et ces préférences, la page sera servie dans la langue
définie comme langue par défaut.
2.2.3 Langue obligatoire
manque
2.2.4 Actif (Editer)
Cette option permet de dire si la langue est modifiable via les interfaces d’édition. Si cette option est
décochée, les contenus saisis dans cette langue sont conservés, mais il n’est plus possible via les interfaces
d’édition de basculer sur cette langue et donc de l’éditer.
Cette option est particulièrement appropriée si vous souhaitez arrêter de traduire les nouveaux contenus
dans une langue donnée sur votre site et vous contenter de l’existant, ou que vous souhaitez désactiver
complétement une langue (auquel cas cette case et la case suivante doivent être cochées) sans pour
autant supprimer cette langue et donc perdre tout le contenu déjà traduit.
Page 59 sur 69
A tout instant, il est possible de réactiver une langue désactivée et les contenus déjà traduits
réapparaissent.
2.2.5 Actif (En ligne)
Cette option permet de dire si cette langue est accessible par les personnes qui consultent la version
publiée de votre projet web. Si cette case est décochée et même si des traductions dans cette langue
existent, les utilisateurs ne pourront y avoir accès.
Cette option est particulièrement utile lorsqu’une langue est ajoutée sur un site déjà actif et que l’on
souhaite pouvoir commencer à traduire celui-ci et même publier des pages en ne rendant la langue
effectivement utilisable par les visiteurs que quand le niveau de finition est considéré comme suffisant
pour permettre une navigation correcte sur cette nouvelle langue.
2.2.6 Utiliser plusieurs langues lors de la navigation sur le site
Pour des besoins intranet ou extranet, vous pourriez avoir besoin d’afficher du contenu indépendamment
de la langue du navigateur de l’utilisateur. Dans le cas, par exemple, où vous ne voudriez pas de pages
vides dans certaines langues sachant que tout le site n’a pas été entièrement traduit ou disponible dans
toutes les langues, vous pouvez alors activer l’option de mixité des langues (Utiliser plusieurs langues lors
de la navigation).
Si cette option est activée et que l’objet de contenu n’existe pas dans la langue courante, Jahia affichera le
contenu dans la langue par défaut.
Si l’anglais est la langue par défaut et que certains contenus ne sont pas traduits en français, ceux-ci
pourraient alors être remplacés automatiquement par de l’anglais.
L’utilisation de cette option n’est pas recommandée sur des sites ouverts au public car le résultat peut
dérouter des utilisateurs non avertis, elle peut être envisagée sur des sites de type intranet si les personnes
Page 60 sur 69
sont au fait de ce choix et ne sont donc pas susceptibles d’être déroutées par des contenus en deux
langues sur une même page.
2.2.7 Ajouter une nouvelle langue
Pour ajouter une ou plusieurs langues à un site virtuel, il faut sélectionner les langues désirées et cliquer
sur le bouton « ajouter des langues » pour les ajouter à la liste des langues disponibles.
Figure 48 : ajouter des langues
Vous remarquerez que certaines langues sont listées plusieurs fois. En effet la liste est basée sur les
langues locales (langue de la région), les langues disponibles sont en fait une combinaison entre une
langue et sa région.
Jahia peut identifier ces langues locales en provenance des préférences du navigateur et saura réagir
différemment suivant la langue détectée (fr_CA ou fr_FR par exemple). Vous pourriez avoir 2 sites distincts
avec du contenu différent pour des français et canadiens.
Si vous préférez gérer le français de manière générique, il faudra alors choisir la langue française FR. Si
vous n’avez pas l’intention d’avoir du contenu spécifique à un pays ou à une région (comme fr_CA ou
fr_FR), vous devriez utiliser systématiquement la langue locale générique pour la langue spécifiée.
La liste des langues et langues locales disponibles proviennent directement de la Machine Virtuelle
Java (JVM) utilisée. Chaque JVM supporte des langages différents. Les langues officielles ISO peuvent ne
pas être présentes suivant la JVM utilisée. Dans ce cas, vous pouvez utiliser une autre langue que vous
n’utiliserez jamais (comme langue disponible sur le site) et modifier l’icône de la langue (drapeau) sur le
Page 61 sur 69
disque ou le template. Jahia ne pourra pas automatiquement reconnaitre cette langue à des fins de
redirection pour les utilisateurs, cependant ils pourront naviguer entre les différentes langues à partir de la
page d’accueil.
Page 62 sur 69
2.3 Paramètres HTML
Lors de l’édition d’un site, les contributeurs utilisent souvent un éditeur HTML riche. Du fait que les
contributeurs aient la possibilité d’utiliser directement des balises HTML ou de copier/coller du contenu
HTML, cela peut mener à des incohérences vis-à-vis des normes W3C, ou déformer le rendu de la page.
Ils peuvent par exemple oublier de fermer une balise, déformer une page en incluant un large tableau, etc.
Jahia offre la possibilité de vérifier la conformité du code généré grâce à l’option Conformité WCAG.
Vous avez également la possibilité d’empêcher l’usage de certaines balises HTML dans les zones HTML
riches. Vous devrez spécifier dans l’option « filtrage des balises », la liste des champs non autorisés dans
l’éditeur HTML, séparés d’une virgule. A la sauvegarde du contenu, Jahia extraira automatiquement les
balises du contenu.
Exemple de filtrage : H1,script,table,tr,td,strong,hr
Figure 49 : Paramètres HTML
Page 63 sur 69
2.4 Afficher les vanity URL
Cette rubrique de l’administration permet d’afficher un tableau de bord de l’ensemble des vanity URL (URL
explicites, optimisées pour le référencement) définies sur la plateforme. Pour chacune d’entre elle,
différentes informations sont affichées dont l’url « technique » la langue, le statut, et le fait qu’elle soit l’url
par défaut ou non.
Figure 50 : Tableau de bord des vanity urls
Vous pouvez accéder à la page concernée par la vanity URL en cliquant sur le lien.
Page 64 sur 69
2.5 Gestion des templates
Cette rubrique permet de voir l'ensemble des templates, JahiApps et modules déployés sur le site grâce à
l'utilisation du Jahia Studio.
Figure 71 : liste des template, JahiApps et modules déployés sur le site de démonstration Acme Space
2.6 Vérificateur de liens
Le vérificateur de liens est un puissant outil d’administration permettant aux administrateurs du site de
vérifier la validité des liens externes dans un site web complet fonctionnant sous Jahia. Par lien externe, on
entend des liens qui pointent vers des pages hors de la plateforme, donc hors du périmètre de Jahia.
Par définition est lien externe est susceptible de poser des problèmes et d’être « cassé » : que les éditeurs
aient mal tapé le lien désiré (goggle.com au lieu de google.com) ou simplement que la page visée par le
lien disparaisse avec le temps, change de nom ou d’emplacement.
Le but du module de vérification des liens est de parcourir toutes les pages Jahia à la recherche de liens
externes saisis par les auteurs. Il affiche ensuite un rapport qui aide l’administrateur du site à corriger les
liens cassés.
Le module passe sur toutes les pages dans la langue et le mode sélectionné.
Page 65 sur 69
Figure 51 : barre de menu du module de vérification de liens externes
Pour lancer le scan, il suffit de cliquer sur « Start checking ». Puis de cliquer sur « Display progress » pour
voir les résultats. Le « Display progress with auto refresh » permet de rafraichir la page automatiquement.
« Clean stored results » permet de vider les résultats avant de relancer un scan.
Attention, le vérificateur des liens est un outil qui sollicite fortement le serveur, son usage ponctuel
contribue à maintenir la qualité éditoriale du site, mais il n’est pas recommandé d’utiliser celui-ci en
continu.
2.6.1 Comment auditer les liens externes en utilisant le module de
vérification des liens
2.6.1.1 Cas d’utilisation
Dans le site de demo ACME, sur la page “Accueil”, l’auteur saisit un texte et y insère par erreur, un mauvais
lien vers http://beta.jahia.com au lieu de http://beta65.jahia.org . Le lien est donc un lien « mort » qui
pointe vers un site n’existant pas. Le lien est embarqué dans un paragraphe (de type Big Text) saisit à l’aide
de l’éditeur de texte riche fourni par Jahia.
2.6.1.2 Comment lancer une analyse du site web
Pour procéder à un audit de vérification des liens et détecter puis réparer les liens “cassés”,
l’administrateur du site peut cliquer sur le bouton “Start checking” dans le module de vérification des
liens :
Figure 52 : démarrer la vérification
Page 66 sur 69
Le temps nécessaire à la réalisation de l’audit dépend du volume de données à analyser.
Dès que l’administrateur du site lance le processus de vérification des liens, un statut d’activité sera
disponible en bas de module après avoir cliqué sur « Display progress ».
L’affichage ressemblera à ca:
Figure 53 : Rapport d’analyse des liens cassés
A noter que le tableau contient uniquement les liens cassés. Les liens valides ne sont pas affichés dans le
rapport.
2.6.1.3 Description du rapport de vérification des liens
Le rapport de vérification des liens contient 5 colonnes :
Figure 54 : Rapport d’analyse des liens cassés

Chemin : chemin du nœud qui contient le lien cassé

Propriété : propriété dans le nœud concerné qui contient le lien cassé

Lien : lien qui pose problème
Page 67 sur 69

Status : cause du problème

Code : code d’erreur http
Remarque : la console de Tomcat affiche le chemin du nœud traité, ainsi que le code HTML associé et les
tentatives de connexions aux liens qui en découlent.
Nodes:185
Node:/sites/ACME/home/aside/how-to-use-this-demonstration/bigText
property:text <p>
You can discover<strong><a href="http://beta.jahia.com">Jahia
CE BETA v6.5</a></strong> using the following users (login /
password):</p>
<div>
<div>
<p>
You can also decide to go to <a
href="/start"><strong>Jahia's welcome page </strong>by clicking
here.</a></p>
<p>
 </p>
<p>
<a href="http://beta65.jahia.org/">Link to
beta</a></p>
</div>
</div>
Try to connect to http://beta.jahia.com
Try to connect to http://beta65.jahia.org/
Page 68 sur 69
Jahia Solutions Group SA
9 route des Jeunes,
CH-1227 Les acacias
Genève, Suisse
http://www.jahia.com
Page 69 sur 69

DOCUMENTATION Guide d`administration Jahia v6.6

Transcription

Documents pareils

Diplomatic-Cover - Top Interactive Agencies

Vers une pédagogie explicite à l`école maternelle…

Sites web institutionnels de l`UNIL avec Jahia Les bases de Jahia

Premier pas avec Jahia: édition

LICENCE STAPS Education et Motricité

09/04/2013

Alexis BARLATIER

Sites internet pour l`Orientation professionnelle