Le template custom dans nuxeo 5.4.2

Pré-requis

Avoir effectué l'Installation minimale de nuxeo 5.4.2

Introduction

Les templates sont des répertoires (situés sous nuxeo-dm-5.4.2-tomcat/templates) qui contiennent entre autres un certain nombre de fichiers de configuration qui seront copiés au démarrage de Nuxeo dans le répertoire nxserver/config mais également dans le répertoire Catalina. Ils contiennent également un fichier nuxeo.defaults qui initialise des variables de configuration par défaut.

Il existe plusieurs templates : common, default, mysql, mssql, oracle, postrgesql et custom.

Pour plus d'informations sur les templates nous vous invitons à lire la documentation suivante : nuxeo.conf et les templates

Le template custom

Ce template permet de centraliser dans un même répertoire toutes les personnalisations de l'utilisateur et/ou choix de configuration.

Nous vous conseillons donc de l'utiliser pour y placer vos diverses personnalisations (points d'extensions, bundles, plugins, contentViews, notifications, etc...). Nous vous expliquerons un peu plus tard comment configurer Nuxeo pour que celui-ci charge les fichiers qui y sont contenus lors de son démarrage.

Paramétrage

Placez-vous dans le répertoire correspondant au template custom (nuxeo-dm-5.4.2-tomcat/templates/custom).

Éditez le fichier nuxeo.defaults

custom.target=nxserver
nuxeo.template.includes=default,postgresql

Explications :

• <nom_du_template>.target : Indique à Nuxeo le dossier dans lequel il doit copier les différents fichiers de configuration. Avec une valeur à nxserver, nos différents fichiers de configuration seront copiés directement dans le dossier nuxeo-dm-5.4.2-tomcat/nxserver lors du chargement du template.
• nuxeo.template.includes : Indique à Nuxeo quels templates il doit également inclure lors du chargement du template actuel. C'est un système de dépendances entre templates. Dans notre configuration nous chargeons également les templates par défaut et ceux de notre base de donnée postgresql lors du chargement de notre template custom.

Créez maintenant les dossiers suivants dans le dossier custom :

• config  : Vous y insérerez les differents fichiers de configuration
• bundle : Contiendra les jars de Nuxeo
• plugins: Espace à privilégier pour les plugins et bundles développés par des tiers
• schemas : Placez ici vos schémas. Ceux-ci pourront éventuellement pour surcharger les existants

Chargement au lancement de Nuxeo

Vous avez configuré votre template custom mais Nuxeo ne sait toujours pas qu'il doit charger celui-ci lors de son lancement.

Pour cela, vous devez éditer le fichier nuxeo.conf (nuxeo-dm-5.4.2-tomcat/bin/nuxeo.conf) :

nuxeo.templates=custom