Projet Socle ENT
Pages enfant
  • 07 - Personnalisations

Vous regardez une version antérieure (v. /wiki/display/ESUPMU/07+-+Personnalisations) de cette page.

afficher les différences afficher l'historique de la page

« Afficher la version précédente Vous regardez la version actuelle de cette page. (v. 6) afficher la version suivante »

Vos personnalisations (ou custom)

Toute vos personnalisation DOIVENT être dans le dossier custom.

Ce dossier se redécoupe en :

  1. uPortal
  2. Tomcat

Le dossier Tomcat n'est traité que dans le package esupdev.

Pour les custom uPortal, vous devez reproduire la structure du dossier source uportal.

Par exemple si vous voulez faire des modifications perso dans le fichier Logger.properties vous devez le créer dans custom/uPortal/properties/Logger.properties.

ATTENTION

Avant de personnaliser un fichier vérifiez s'il n'est pas présent dans l'arborescence update.
S'il est déjà présent dans ce dossier partez de celui-ci plutôt que de celui contenu dans les sources uPortal car le fichier dans le dossier update contient des balises de remplacement ESUP utilisées par les configurations.

Démarche


Premier exemple : patcher le fichier [esup-sources]/properties/personDirectory.xml

  1. mkdir custom/uPortal/properties/
  2. Chercher dans l'update si ce fichier existe (find update -name 'personDirectory.xml')
  3. Il existe, donc : cp update/uPortal/properties/personDirectory.xml custom/uPortal/properties
  4. Adaptez votre fichier, par exemple on ajoute un mapping d'attribut LDAP (<entry key="mail"> <value>mail</value></entry>)
  5. Vous allez trouver des TAG dans ce fichier car il est issu de l'update (@esup.ldap.groups.etu.formation@) ; il seront remplacés lors de l'appel à ant init. Vous pouvez les supprimer mais la configuration (en l'occurence esup.ldap.groups.etu.formation) n'aura plus d'effet sur cette partie.

Second exemple : patcher le fichier [esup-sources]/webpages/error.jsp

  1. mkdir custom/uPortal/webpages/
  2. Cherchez dans l'update si ce fichier existe (find update -name 'error.jsp')

  3. Il n'existe pas dans l'update, donc on va le recopier depuis les sources uPortal : cp src/[esup-sources]/webpages/error.jsp custom/uPortal/webpages

  4. Adaptez votre fichier, par exemple on ajoute un mapping d'attribut LDAP (<title>Portal: Une erreur est survenu</title>)

Lors de l'appel a ant init le fichier custom va etre recopié dans les source uPortal.

CONSEIL

Je vous conseille de conserver une copie de sauvegarde des fichiers d'origines.
cp src/[esup-sources]/webpages/error.jsp custom/uPortal/webpages/error.jsp.orig
cp custom/uPortal/webpages/error.jsp.orig custom/uPortal/webpages/error.jsp


  • Aucune étiquette