Généralités
Paramètres globaux
La modification des paramètres du portail (sources de données, authentification, attributs, thèmes...) se fait en modifiant des fichiers de configuration et en redéployant le portail.
Beaucoup de paramètres se modifient dans le fichier config.properties.
Pour les autres, le principe est d'utiliser le répertoire custom, prévu pour les personnalisations de l'établissement : Créez le fichier de paramètre dans ce répertoire (ou copiez le à partir du répertoire update) en respectant l'arborescence (basez-vous sur le répertoire update) et modifiez-le.
Pour prendre en compte les modification, relancez les tâches ant init et ant deploy puis redémarrez le portail.
Entités du portail
La création ou la modification d'entités du portail (Canaux, Profils/fragments, Groupes locaux, utilisateurs locaux...) peut se faire :
- soit par l'import de fichier de définition de l'entité
- soit par l'interface du portail
Si vous utilisez l'interface du portail, il est conseillé de créer quand même un fichier de définition, de manière à pouvoir le rejouer, surtout en période de tests.
Pour créer/modifier une entité avec un fichier de définition, créez ce fichier dans l'arborescence custom/uPortal/uportal-impl/src/main/resources/properties/db/mini (basez-vous sur le répertoire update), puis utilisez la tâche ant db.import pour importez les objets voulus (ou les tâches ant init db.init pour réimporter toute la base).
Réinitialisation du déploiement
Il n'y a pas de tâche de réinitialisation du répertoire des sources uPortal (TODO : Ajouter dans une prochaine version). Quand un fichier est inclut dans les sources à partir des répertoires update ou custom avec la tâche ant init, il ne sera jamais supprimé.
Pour réinitialiser le déploiement :
- Supprimez le dossier Portail/uPortal-rel-3.2.4
- ant unzip
Attributs utilisateurs
Article détaillé : Attributs utilisateurs (esup-3)
- Copiez le fichier update/uPortal/uportal-impl/src/main/resources/properties/contexts/personDirectoryContext.xml sous la même arborescence dans custom
- Editez le fichier custom/uPortal/uportal-impl/src/main/resources/properties/contexts/personDirectoryContext.xml
- Redéployez le portail : ant init deploy
- Relancez le portail
Groupes
Article détaillé sur les groupes : Groupes (esup-3)
Groupes PAGS
- Recopier le fichier update/uPortal/uportal-impl/src/main/resources/properties/groups/PAGSGroupStoreConfig.xml dans le répertoire custom selon la même arborescence
- Editez ce fichier, en conservant les groupes pags_root et all_users
- Déployez : ant init deploy
- Relancez le portail
Groupes locaux
Avec des fichiers d'import
- Pour chaque groupe, créez un fichier avec l'extension ".group_membership" dans le répertoire custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/group_membership, en vous basant sur ceux du répertoire update.
- Dans la balise <name>, indiquez le nom du groupe
- Dans la balise <entity-type>, indiquez s'il s'agit d'un groupe de personnes (org.jasig.portal.security.IPerson) ou d'une catégorie de canaux (org.jasig.portal.ChannelDefinition)
- Dans la balise <children>, indiquez les membres du groupe
- La balise <children> accepte comme membre :
- <literal> : un utilisateur (groupe de personnes uniquement)
- <group> : un groupe local, un groupe PAGS (groupe de personnes) ou un groupe de canaux
- Importez le ou les groupes :
Import d'un groupe :
| Bloc de code |
|---|
ant db.import -Ddir={esup.root}/custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/group_membership -Dpattern="nom_groupe\.group_membership"
|
Import de tous les groupes du dossier :
| Bloc de code |
|---|
ant db.import -Ddir={esup.root}/custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/group_membership -Dpattern=".*\.group_membership"
|
le paramètre "pattern" accepte les expressions régulières
Avec l'interface
Utilisez le canal "Gestionnaire de groupes" (Group Manager)
Canaux
Article détaillé : Publication de canaux (esup-3)
- Pour chaque canal, créez un fichier avec l'extension ".channel" dans le répertoire custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/channel, en vous basant sur ceux du répertoire update.
- Importez le ou les canaux:
Import d'un canal :
| Bloc de code |
|---|
ant db.import -Ddir={esup.root}/custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/channel -Dpattern="nom_canal\.channel"
|
Import de tous les canaux du dossier :
| Bloc de code |
|---|
ant db.import -Ddir={esup.root}/custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/channel -Dpattern=".*\.channel"
|
Profils utilisateurs
Article détaillé : Profils utilisateurs (esup-3)
Référencement des profils
Si le fichier dlm.xml doit être modifié (ajout de profil modification des droits) :
- Recopier le fichier update/uPortal/uportal-impl/src/main/resources/properties/dlm.xml dans le répertoire custom selon la même arborescence
- Editez ce fichier
- Déployez : ant init deploy
- Relancez le portail
Fragments de profils
Avec des fichiers d'import
- Pour chaque fragment, créez un fichier avec l'extension ".fragment_layout" dans le répertoire custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/fragment_layout, en vous basant sur ceux du répertoire update.
- Importez le ou les fragments :
Import d'un fragment :
| Bloc de code |
|---|
ant db.import -Ddir={esup.root}/custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/fragment_layout -Dpattern="nom_fragment\.fragment_layout"
|
Import de tous les fragments du dossier :
| Bloc de code |
|---|
ant db.import -Ddir={esup.root}/custom/uPortal/uportal-impl/src/main/resources/properties/db/mini/fragment_layout -Dpattern=".*\.fragment_layout"
|
Avec l'interface
Utilisez le canal "Gestionnaire de fragments" (Fragment Manager)
Thèmes
Voir article détaillé : TODO
Personnalisation de thème d'uPortal
Pour personnaliser un thème livré avec uPortal :
- Copiez le fichier update/uPortal/uportal-war/src/main/webapp/media/skins/universality/nom_theme/esup-portal.css sous la même arborescence dans custom
- Surchargez les styles du thème (portal.css et portlet.css) dans ce fichier
- Placez éventuellement les images propres à votre thème dans un sous-dossier images du dossier nom_theme
- Déployez : ant init deploy
Création de thème
Pour créer un nouveau thème :
- Copiez le fichier de la liste des thèmes d'uPortal vers le répertoire custom :
- Fichier pour navigateur : Portail/uPortal_rel-3.2.4/uportal-war/src/main/webapp/media/skins/universality/skinList.xml
- Fichier pour mobile : Portail/uPortal_rel-3.2.4/uportal-war/src/main/webapp/media/skins/muniversality/skinList.xml
- Copiez le dossier d'un des thèmes d'uPortal vers le répertoire custom (en respectant l'arborescence) :
- Dossier thème pour navigateur : Portail/uPortal_rel-3.2.4/uportal-war/src/main/webapp/media/skins/universality/nom_theme
- Dossier thème pour mobile : Portail/uPortal_rel-3.2.4/uportal-war/src/main/webapp/media/skins/muniversality/nom_theme
- Renommez le dossier en votre nouveau thème
- Modifiez les styles
- Ajoutez votre thème dans le fichier custom/uportal-war/src/main/webapp/media/skins/universality/skinList.xml
- Déployez : ant init deploy