Comment configurer Liferay pour le Canada

* NB: ce billet a été publié à l’origine sur mon blog de membre de la communauté Liferay

Nativement, Liferay supporte de nombreuses langues dont le français et l’anglais, les deux langues officielles du Canada. Cependant, la version francophone incluse est fr_FR (français de France) et en_US (anglais des États). Dans la plupart des cas, cela ne posera pas de problème puisque cela concerne surtout les administrateurs qui utilisent l’interface de gestion des contenus. Mais, certaines organisations sont plus pointilleuses sur des éléments linguistiques (courriel plutôt que email, télécopieur plutôt que fax, etc.) et sur les détails visuels (fr_CA plutôt que fr_FR, drapeau canadien plutôt que français).

C’est la raison pour laquelle je travaille, avec l’aide de Liferay, à faciliter une installation et configuration 100 % canadienne. Vous verrez dans les quelques instructions qui suivent qu’il est extrêmement simple d’activer les langues fr_CA (français Canadien) et en_CA (anglais Canadien).

1) Activer les langues fr_CA et en_CA

Il s’agit d’ajouter quelques configurations dans portal-ext.properties et system-ext.properties. Pour rappel, ces deux fichiers doivent être situés à la racine d’une installation (liferay-portal…) ou dans le classpath.

system-ext.properties

user.country=CA
user.language=fr
user.timezone=America/Montreal

portal-ext.properties

company.default.locale=fr_CA
company.default.time.zone=America/Montreal
locales=en_CA,fr_CA

2) Installer le hook des traductions

Les configurations de la section précédente ont pour effet d’activer et restreindre les langues au français et l’anglais du Canada. Cependant, aucune traduction spécifique n’est incluse dans Liferay par défaut. Le portail basculera donc automatiquement sur les traductions françaises et anglaises de base. Liferay ne disposant pas non plus du drapeau canadien, l’affichage sera parfois distordu (voir les captures d’écran ci-dessous).

• Téléchargez ce hook (version 6.1 GA2)
• Installez-le en le déposant dans le répertoire de scrutation /deploy

Le hook inclut les dernières traductions francophones canadiennes ainsi que le drapeau canadien.

3) Ajouter les langues dans le fichier web.xml de Liferay

Afin de rendre le portlet Langues fonctionnel avec les nouvelles langues, vous devrez effectuer un dernier changement dans le fichier web.xml (ROOT/WEB-INF/web.xml typiquement dans TOMCAT_HOME/webapps).

<servlet-mapping>
   <servlet-name>I18n Servlet</servlet-name>
   <url-pattern>/fr_CA/*</url-pattern>
</servlet-mapping>
<servlet-mapping>
   <servlet-name>I18n Servlet</servlet-name>
   <url-pattern>/en_CA/*</url-pattern>
</servlet-mapping>

Exemples de résultats :

Avant :

Après :

Avant :

Après :