1. Introduction

Pour communiquer des URLs d’accès à des contenus JCMS dans des médias non interactifs (papier, radio, télévision, …), ces URLs doivent être simples à taper, explicites et mémorisables. Or, les URLs natives de JCMS sont composées pour la plupart d’un appel à la JSP display.jsp et d’un identificateur, ce qui les rend ni explicite et ni mémorisable.

Pour répondre à ce besoin, JCMS 5.5 introduit les URLs intuitives (friendly URLs). Elles permettent d’associer un chemin d'accès simple à retenir à une publication ou une catégorie. Par exemple, sur JaliosXperience l’URL intuitive "/faq" est associée à la FAQ d’installation de JCMS. Cette publication est donc accessible via l’URL support.jalios.com/faq/.

Les URLs intuitives peuvent être structurées et il est possible d’en associer plusieurs à une même publication ou catégorie. Par exemple, la FAQ de JaliosXperience est également accessible via le chemin "/documentations/faq".

Les URLs intuitives fonctionnent par redirection; l'accès à une URL intuitive redirige immédiatement l'utilisateur sur l'URL de consultation "habituelle" du contenu ou de la catégorie.

2. Mise en oeuvre

Pour les publications commes pour les catégories, une URL intuitive :

• est insensible à la casse, (si vous ajoutez l'URL intuitive "/contacts", il n'est pas nécéssaire de saisir également "/Contacts" ou tout autre variation) ;
• doit commencer par un "/", mais ne doit pas se terminer par "/" ;
• doit être composé uniquement de caractéres alphanumérique parmis "0-9a-zA-Z/-_" ;
• ne doit pas commencer par le nom d'un dossier présent à la racine de JCMS (/front, /admin, /work, /upload, etc.)

2.1 Pour les publications

Les URLs intuitives se déclarent dans l’onglet "Avancé" de l'éditeur de publications.

2.2 Pour les catégories

Les URLs intuitives se déclarent dans l’onglet "URLs intuitives" de l'éditeur de catégories.

Grâce au panier des Catégories, vous pouvez générer automatiquement les URLs intuitives d'un ensemble de catégories. Pour cela, vous pouvez soit ajouter les catégories une par une, soit ajouter l'ensemble des catégories descendantes de la catégorie en cours de consultation, en utilisant l'icône du caddy située en haut de la liste des catégories.

Une fois dans le panier de catégories, dans l'onglet avancé, cochez la case "générer des URLs intuitives".

Les URLs intuitives générées automatiquement exploitent le nom des catégories (dans toutes les langues du site) et l'arborescence dans les quelles elle se trouvent.

Voici un exemple d'URLs intuitives générées automatiquement :

3. Interface de gestion

Une interface de gestion des URLs intuitives permet de consulter et modifier l’ensemble des URLs intuitives visibles par l'utilisateur.

Cette interface est accessible :

• soit depuis l'interface d'édition des URLs intuitives d'une catégorie ou d'une publication, grâce au lien "Tout afficher" ;
• soit depuis la page d'administration de l'espace de travail courant pour l'administrateur fonctionnel ;
• soit depuis la page d'administration du site pour l'administrateur technique.

Cette interface vous permet :

• d'effectuer des recherches textuelles sur les URLs intuitives et les données associées ;
• de consulter les URLs intuitives associées aux données ou inversement

4. Fonctionnement

4.1 Persistence

Les URLs intuitives sont enregistrées directement dans la publication ou dans la catégorie sur laquelle elles pointent. Vous pouvez les accéder et les modifer en utilisant respectivement les méthodes getFriendlyURLSet() et setFriendlyURLSet() des classes Publication et Category.

4.2 Détection

Une fois enregistrées dans une publication ou dans une catégorie, les URLs sont alors automatiquement ajoutées dans la ServletFilter com.jalios.jcms.servlet.FriendlyURLFilter.
C'est cette servlet qui filtre toute les requêtes du site pour détecter celles qui doivent faire l'objet d'une redirection vers une publication ou une catégorie.