Tutorial : déployer une portlet

Comment déployer une portlet sous Jahia 5

1/ Télécharger une portlet compatible JSR-168 :

2/ Copier le fichier WAR dans : WEB-INF/var/new_webapps

3/ Attendre 1 ou 2 minutes : Tomcat détecte le fichier et va le déployer (vous pouvez surveiller les logs dans la console pour suivre l'avancement du déploiement)

4/ Aller dans l'administration de Jahia (back-office), puis "Gérer le serveur" et "Gérer les portlets". Vous allez voir la nouvelle portlet qui apparaît, puis pouvez l'éditer : nom, suppression, etc.

5/ Créer une nouvelle page Jahia avec le template "Simple".

6/ Cliquer sur "Ajouter une boîte" en centre de page, et sélectionner le type "Portlet",

7/ De retour sur la page créée, cliquer sur "Ajouter un portlet" et "Ajouter un portlet" dans le petit menu qui s'ouvre.

8/ Cliquer sur le nom de la portlet ajoutée et faire OK.

9/ La portlet affiche alors son contenu dans la page qui la porte.

Entre l'étape 8 et 9 vous pouvez aussi gérer les rôles pour la portlets.
C'est pas super visible, mais après avoir sélectionné la portlet il y a un onglet "Roles" un peu au dessus de la liste des portlets. Cela permet en particulier de mapper le rôle admin de la portlet avec des users/groups de Jahia. Sans cela vous pourriez ne pas pouvoir configurer la portlet une fois ajoutée. Et donc avoir l'impression qu'elle ne fonctionne pas.

Autre truc (à valider tout de même) : une fois déployée, Jahia n'appréciera pas que les fichiers web.xml ou portlet.xml de la portlet soit modifié (même si on fait un "remplacer" avec le même fichier sans modifier le contenu). On peut donc mettre à jour les classes, les JSP, ... mais pas ces fichiers. Sinon il faut undeployer la portlet puis la déployer de nouveau.