Portlet Esup Lecture – Guide d'installation
Auteur : Bourges Raymond (Université de Rennes 1)
Installation
Installer la portlet
- Télécharger lecture-portlet-<VERSION>.war depuis le site du projet
- Depuis le répertoire contenant ESUP-Portail lancer : ant portlet.deploy -DportletApp=/path/to/war/lecture-portlet-<VERSION>.war En tant qu'administrateur de uPortal lancer le portlet manager pour ajouter ESUP-Lecture en tant que nouvelle portlet
Vous pouvez préciser une préférence de portlet avec le nom "context" afin de pouvoir utiliser N instances de cette même portlet avec des configurations différentes. Voir le guide de configuration pour plus d'information sur l'utilisation de cette préférence.
- Adapter le fichier properties/config.properties
Si vous utilisez la configuration JNDI (ce qui est recommandé) alors vous avez besoin de définir votre source de données dans le contexte tomcat utilisé par la portlet.
Ajouter des ressources ESUP-Lecture dans uPortal
ESUP-Lecture utilise au maximum les ressources (styles CSS et scripts javaScript) fournis par le portail. Néanmoins il nécessite l'ajout de 2 fichiers dans l'environnement du portail :
- lecture.css pour les styles CSS
- esup-lecture.js pour le javaScript
Ces deux fichiers peuvent être trouvés dans le fichier war de la portlet. Respectivement :
- /media/lecture.css
- /media/js/esup-lecture.js
Pour que ces fichiers soient pris en compte il faut y faire référence dans le fichier skin.xml de uPortal.
uPortal contient potentiellement plusieurs skins chacun ayant son propre fichier skin.xml. De plus, uPortal gère un mode standard ("universality") et un mode mobile ("muniversality"). Chacun de ces modes ayant ses propres skins. Il convient donc de modifier tous les fichiers skin.xml correspondant aux différents skins proposés aux utilisateurs du portail.
Mode opératoire pour le package ESUP-Portail de uPortal
Les exemples donnés ici concerne le skin uPortal "uportal3" et le mode standard ("universality"). De plus, nous utilisons le répertoire "custom" proposé par le package qui permet de conserver les modifications locales indépendamment des sources livrées avec le package.
- A la racine du package, créer l'arborescence suivante :
- custom/uPortal/uportal-war/src/main/webapp/media/skins/universality/ avec ses sous répertoires :
- common/javascript/uportal
- uportal3
- custom/uPortal/uportal-war/src/main/webapp/media/skins/universality/ avec ses sous répertoires :
- Déposer le fichier esup-lecture.js dans custom/.../universality/common/javascript/uportal
- Déposer le fichier lecture.css dans custom/.../universality/uportal3
- Copier depuis la racine du package le fichier update/uPortal/uportal-war/src/main/webapp/media/skins/universality/uportal3/skin.xml dans le répertoire custom/.../universality/uportal3
- Editer le fichier custom/.../universality/uportal3/skin.xml pour ajouter en fin de fichier les lignes suivantes
- <css>lecture.css</css>
- <js>../common/javascript/uportal/esup-lecture.js</js>
- Pour que ces modifications soient prises en compte il faut, à la racine du package, lancer la commande suivante :
- ant init deploy
Servlet mode
Le mode servlet est possible mais n'est pas documenté. Il est essentiellement utilisé pour le développement. Pour être parfaitement fonctionnel le mode servlet doit utiliser un Web Service du portail qui expose les groupes. Ce Web Service n'a pas obligatoirement vocation à perdurer avec la montée en puissance de Grouper. Pour autant Grouper n'est pas encore pris en compte dans ESUP-Lecture.