Recherche

Sommaire

Pages enfant
  • Personnaliser le thème

Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.
Commentaire: Migrated to Confluence 5.3
Sommaire

 

Remarque

La gestion des thèmes a quelque peu été modifiée avec la version 5.5 de Nuxeo.
La documentation ci-dessous s'applique donc dans un environnement Nuxeo 5.5

...

Voici un exemple du contenu du fichier esup-document-management.xml (à noter que depuis la version 5.5 de Nuxeo, il est possible d'ajouter des classes sur les attribtus <page>, <section>, <cell> et <fragment>, ces derniers pouvant ensuite être définies dans un css)

...

Bloc de code
<extension target="org.nuxeo.theme.services.ThemeService" point="applications">
<application root="${org.nuxeo.ecm.contextPath}"
      template-engine="jsf-facelets">

      <negotiation>
        <strategy>nuxeo5</strategy>
        <default-engine>default</default-engine>
        <default-theme>esup/default</default-theme>
        <default-perspective>default</default-perspective>
      </negotiation>

      <!-- Cache control for theme resources (/nxthemes-lib/) -->
      <resource-caching>
        <lifetime>36000</lifetime>
      </resource-caching>

      <!-- Cache control for theme styles (/nxthemes-css/) -->
      <style-caching>
        <lifetime>900</lifetime>
      </style-caching>
    </application>
  </extension>

</component>

Application

...

concrète

Le principe de fonctionnement ayant été rapidement abordé, voyons maintenant concrètement comment mettre en place notre nouveau thème.

Comme il y a des templates xhtml, des css et des images à intégrer en plus des points d'extension, il va nous falloir faire un plugin.

Pour ce faire, nous vous conseillons d'utiliser Nuxeo IDE avec Eclipse (choisir Nuxeo, Nuxeo Artifact, Nuxeo Plugin Project).

Notre plugin se présentera ainsi :

  • src/main/resources/META-INF/MANIFEST.MF,
  • src/main/java/packagePath => aucun code java ne sera ajouté pour personnaliser le thème
  • pom.xml

SI nous reprenons les fichiers nécessaires, il nous faut un composant qui va regrouper tous nos points d'extension, le fichier esup-document.xml qui décrit la structure, les différents tempaltes xhtml correspondant aux vues que nous avons créées. Il nous faut également stocker nos images  (logo, favicon), nos palettes et nos css.

Au final, on retrouve un plugin avec l'arborescence suivante (quelques fichier exemples téléchargeables) :

Une fois le plugin achevé, il ne reste plus qu'à le déposer sous la forme d'un jar dans le répertoire plugins du template custom.

Redémarrez ensuite Nuxeo.

Remarque

Attention, il existe de nombreuses contributions de thèmes dans Nuxeo : suivant les composants que vous installez (DAM, SC, user center, admi center), il vous faudra surcharger certainement plusieurs contributions pour que votre thème soit pris en compte partout.