Portlet Esup Lecture – Guide d'installation

Projet esup-lecture > Guide d'installation V2 (French) > logoCLectureV1.jpg
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
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.