Sites


Lutece : guide développeur

Test de construction et de déploiement d'un premier plugin

Voici une procédure permettant de vérifier que l'environnement est correctement installé et que l'on peut récupérer le source d'un plugin sur GitHub, le compiler et le déployer.

Assemblage du plugin-helloworld

Le plugin-helloworld va servir à vérifier l'environnement de développement. Dans cette partie, nous allons récupérer les sources de ce projet, l'assembler avec Maven, configurer l'accès à la base de données, initialiser la base de données, déployer la webapp dans un conteneur de servlet, activer le plugin et vérifier l'affichage du message "Hello World!"

Sources du projet

Les sources du projet sont disponibles sur github à l'addresse https://github.com/lutece-platform/lutece-dev-plugin-helloworld . Il faut récupérer les sources et utiliser la version 1.0.0. On peut utiliser git ou bien un des liens de téléchargement disponibles sur https://github.com/lutece-platform/lutece-dev-plugin-helloworld/releases/tag/1.0.0 .

Assemblage avec maven

Pour assembler la webapp, il faut utiliser son IDE ou maven directement pour invoquer le goal "lutece:exploded". On obtient alors la webapp dans le dossier "target/lutece".

Configuration de la base de données

La configuration de la base de données se trouve dans le fichier "target/lutece/WEB-INF/conf/db.properties". Il faut éditer ce fichier et fournir le nom d'utilisateur et son mot de passe sur les lignes "portal.user" et "portal.password". De plus, la ligne "portal.url" permet de choisir le nom de la base (par défaut "lutece").

Initialisation de la base de données

Pour initialiser la base de données, il faut utiliser ant avec le fichier de construction "target/lutece/WEB-INF/sql/build.xml", par exemple depuis l'IDE ou depuis une ligne de commande.

Deploiement de l'application

Pour déployer l'application, il faut utiliser une des methodes de déploiement du conteneur de servlets pour deployer le dossier target/lutece, par exemple depuis l'IDE ou depuis une ligne de commande et démarrer la webapp.

Activation du plugin

Pour activer le plugin, il faut accéder à l'URL <webapp>/jsp/admin/system/ManagePlugins.jsp et s'authentifier en utilisant les codes d'access par défaut de l'administrateur : admin/adminadmin.

La page affiche alors la liste des plugins de la webapp, et il faut activer plugin-helloworld.

Note: selon le déploiement effectué, l'adresse de base de la webapp notée "<webapp>" ci-dessus change. Il s'agit la plupart du temps de http://localhost:8080/lutece.

Affichage de la page helloworld

La page helloworld accessible à l'URL <webapp>/jsp/site/Portal.jsp?page=helloworld affiche le message "Bonjour Monde!" si votre navigateur est en Français, ou "Hello World!" sinon.

Il y a une erreur de communication avec le serveur Booktype. Nous ne savons pas actuellement où est le problème.

Vous devriez rafraîchir la page.