...

Démarche

Balise WikiPremier 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.

Balise WikiSecond 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. Balise WikiIl 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.

Personnalisation des groupes

 Pour définir les groupes dynamiques de votre établissement :

1. Adaptez le fichier custom/uPortal/properties/groups/PAGSGroupStoreConfig.xml (voir article détaillé : Gestion des groupes)
2. Redéployez : ant init; ant deploy;

Personnalisation des canaux

1. Créez un fichier  custom/uPortal/properties/chanpub/<nom_canal>.xml par canal à publier (voir article détaillé : Publication de canaux)
2. Lancez ant init puis : soit ant chan.pub -Dchan.pub=all pour publier tous les canaux du répertoire chanpub, soit ant chan.pub -Dchan.pub=<nom_canal>.xml pour ne publier qu'un canal

Personnalisation des environnements utilisateurs (layouts)

 L'environnement d'un utilisateur défini les onglets et menus qui lui sont affichés, ainsi que leur disposition (voir article détaillé : les DLM uPortal)

...

La stratégie de création des environnements utilisateurs dépendra de la structure de l'établissement et de son ENT. On peut décider par exemple de créer un modèle par profil d'usager contenant l'ensemble des onglets et canaux, ou de créer un modèle par onglet, les profils d'usager étant déduits des ACL définies droits d'accès définis dans dlm.xml et dans les canaux.Lorsqu'un utilisateur se 

La configuration est simplifiée si l'on défini un modèle par onglet. Le principe est le suivant :

1. On crée un fichier de layout par onglet potentiellement visible dans l'ENT, en y référençant l'ensemble des canaux potentiellement visibles par toutes les catégories d'utilisateurs.
2. Dans le fichier dlm.xml, on défini la position de cet onglet (balise dlm:fragment, paramètre precedence) et les droits des utilisateurs sur cet onglet (balise dlm:audience). Les utilisateurs qui n'ont pas les droits ne verront pas l'onglet
3. Dans les fichiers de publication des canaux, on défini pour chaque canal les droits des utilisateurs. Les utilisateurs qui n'ont pas les droits ne verront pas le canal

Créer un thème

 Voir l'article détaillé : Personnalisations de look

1. Créez une structure custom/uPortal/webpages/media/org/jasig/portal/layout/tab-column/xhtml-theme/<nom_theme> sur le modèle du dossier update/uPortal/webpages/media/org/jasig/portal/layout/tab-column/xhtml-theme/esup
2. Renommez les fichiers skin/esupXXX.css en skin/<nom_theme>XXX.css
3. Adaptez les feuilles de style dans skin
4. Remplacez dans le fichier skin/<nom_theme>.css les occurences esup par <nom_theme>
5. Modifiez les images et icônes dans les répertoires controls, institutional, navigation
6. Référencez le thème dans custom/uPortal/webpages/media/org/jasig/portal/layout/tab-column/xhtml-theme/skinList.xml
7. Redéployez : ant init; ant deploy;