L'outil Plugins et Workspaces est accessible depuis le menu Application de l'écran d'accueil de l'interface d'administration.
Cet écran affiche la liste des plugins et workspaces qui ont été chargés au démarrage de l'application.
Dans un premier temps, nous allons nous attarder sur quelques notions utiles pour vous permettre par la suite de pouvoir utiliser cet outil en tout simplicité.
Un plugin est un module d'extension. C'est un composant externe et indépendant du noyau principal d'Ametys servant à apporter de nouvelles fonctionnalités.
Le manuel des Plugins recense la plupart des plugins disponibles pour Ametys, comme par exemple, le plugin Actualité ou le plugin Multimédia.
Les plugins se chargent au démarrage de l'application. N'oubliez pas de redémarrer celle-ci après l'ajout d'un nouveau module.
Chaque workspace (traduction littérale : espace de travail) est un espace de votre application indépendant des autres. Il possède, entre autre, une charte graphique et des méthodes d'authentification qui lui sont propres.
A titre d'exemple le CMS, l'interface d'Administration et le Repository sont des workspaces disponibles par défaut dans l'application de démonstration d'Ametys.
Une des caractéristiques notable d'Ametys est son extensibilité. Les plugins déclarent des extensions dans leur fichiers de configuration pour se brancher sur des points d'extensions. Grâce à ce mécanisme, un développeur peut modifier le comportement de chaque fonctionnalités qui définissent un point d'extension.
Un point d'extension peut être simple ou multiple :
Exemples de points d'extensions
Point d'extension simple : org.ametys.runtime.user.UsersManager (sert à gérer les utilisateurs)
Point d'extension multiple : org.ametys.runtime.plugins.core.right.RightsExtensionPoint (sert à définir les droits)
Dans un plugin, les points d'extensions sont définis au sein de "features" qui sont des groupements d'extensions solidaires face à la désactivation. Lorsqu'une "feature" est désactivée, les implémentations des points d'extensions définis dans cette "feature" ne seront plus actives.
Vous pouvez afficher 3 vues en sélectionnant les rubriques correspondantes dans la zone Sommaire :
Le bouton documentation vous permet de voir la documentation des plugins. C'est une action contextuelle, en sélectionnant un nœud donné dans l'arbre d'une vue vous obtiendrez la documentation rattachée.
Cette vue correspond à l'arborescence physique des plugins sur le disque. Vous pouvez naviguer à travers l'arborescence des plugins pour obtenir la liste des "features" et le détails des extensions utilisées ou désactivées.
Dans la colonne de droite, le menu Gestion affiche des actions contextuelles. Vous pouvez ainsi activer/désactiver des "features" ou sélectionner des points d'extensions lorsque l'action est possible.
Attention, l'activation et la désactivation de features peuvent mener au blocage de votre application. Veuillez consulter le Manuel d'intégration, notamment la partie Paramétrage du projet, pour plus d'informations.
Cette vue recense les points d'extensions classés selon leur type : simple ou multiple.Vous pouvez naviguer à travers l'arborescence pour remonter vers les extensions puis les "features" et enfin les plugins où sont configurés ces points d'extensions.
Il est possible d'activer/désactiver les "features" de votre choix à l'aide du menu contextuel Gestion situé dans la colonne de droite.
Cette vue recense les workspace présent dans votre application Ametys.
Objectif : Changer la gestion des utilisateurs depuis une source de données SQL en source LDAP.
Descendre dans l'arborescence selon le chemin suivant : Points d'extension>Points d'extensions simples>org.ametys.runtime.user.UsersManager.
On voit que le point d'extension simple actif est org.ametys.runtime.plugins.core.user.CoreModifiableCredentialsAwareJdbc (par défaut dans la version de démonstration).
Sélectionner le point d'extension simple org.ametys.runtime.plugins.core.CredentialsAwareLdapAndJdbc à l'aide de la souris.
Valider votre choix en cliquant sur le bouton d'action Sélectionner dans la zone de Gestion.
Cliquer sur OK après l'ouverture de la fenêtre contextuelle avertissant que les changements ne seront effectifs qu'une fois la validation globale des modifications effectuées.
Il est aussi possible de passer par la vue par fichiers et suivre le chemin suivant : et de sélectionner l'extension puis de valider les modifications globales.