Depuis la version 3.10 d'eZ publish , nous pouvons configurer le schéma des urls tel que nous le désirons. Voici une petite documentation sur les différentes fonctionnalités.

eZ publish 3.10 modifie son schéma d'url, en remplaçant le underscore par le tiret. Mais voulant rester flexible, il nous permet de personnaliser le schéma des urls.

Les schémas d'url de base, et leur configuration

eZ publish définit dès l'installation 7 schémas d'url. Ces schémas sont définit dans le fichier transform.ini. Nous pouvons donc retrouver :

• search
• urlalias_iri
• urlalias
• urlalias_compat
• identifier
• uppercase
• lowercase

Ajouter un schéma d'url

Pour ajouter un schéma d'url, il faut créer le fichier transform.ini.append.php. Une fois créer, il faut rajouter notre nouveau schéma dans le tableau Groups de la section [Transformation]. Il faut ensuite créer une section portant le nom de votre schéma. Dans votre section, deux tableaux doivent être créer : Extensions et Commands.

Le tableau Extensions doit comporter un lien vers les extensions comportant des scripts de transformation. Commands est un tableau contenant les différentes règles à utiliser pour modifier les urls.

Voici la liste des commandes disponibles par défaut :

• normalize : normalise plusieurs caractères similaires
• search_normalize : requis pour le moteur de recherche.
• transform : Transform un caractère en un autre
• decompose : Transforme les caractères spéciaux.
• lowercase : Passe tout en minuscule si possible
• uppercase : Passe tout en majuscule si possible
• transliterate : Convertit en un charset possible
• diacritical : Supprime les caractères non critiques
• rule : Permet de lancer une commande personnalisée

Il existe des commandes spéciales : url_cleanup (nettoie l'url pour en faire un texte présentable en tant qu'url), identifier_cleanup (similaire à url_cleanup, mais pour que ca ressemble à un identifiant), search_cleanup (transforme l'url pour que l'url soit utilisable par le moteur de recherche).

Par exemple, pour que notre schéma d'url soit séparé par des tirets, et le tout en minuscule, voici à quoi ressemblerait notre transform.ini.append.php

 
[Transformation]
Groups[]=lower_uri
 
[lower_uri]
Extensions[]
Commands[]
Commands[]=normalize
Commands[]=transform
Commands[]=decompose
Commands[]=transliterate
Commands[]=diacritical
Commands[]=lowercase
Commands[]=url_cleanup

Il faut configurer notre site pour qu'il prenne ce nouveau schéma. Il faut modifier le fichier site.ini.append.php. Il faut modifier la variable TransformationGroup de la section URLTranslator :

 
[URLTranslator]
TransformationGroup=lower_uri
 

Pour mettre à jour toutes vos urls après, vous pouvez exécuter deux scripts php, à partir de votre répertoire eZ publish .

php bin/php/updateniceurls.php -s votre_siteaccess
php bin/php/ezcache.php --clear-all