Installer des plugins

De MoodleDocs
Aller à :navigation, rechercher
Remarque. Cette page est obsolète et a été remplacée par la page Installation de plugins. Si nécessaire, veuillez compléter et modifier cette dernière page, et non celle-ci

Principes

L'installation de plugin est facilitée dans Moodle (il est modulaire).

Cela consiste à ajouter à l'arborescence de fichiers de Moodle des dossiers contenant les fichiers scripts php (et autres) nécessaires au fonctionnement du module ajouté.

Liste des dossiers de Moodle "ouverts" aux ajouts

  • Le dossier des Blocs : /moodle/blocks/
  • Le dossier des Modules /moodle/mod/
  • le dossier des Rapports : /moodle/report/
  • le dossier des Filtres : /moodle/filter/
  • le dossier des Thèmes : /moodle/theme/
  • le dossier Local : /moodle/local/
  • ...

Pour une liste plus exhaustive, se référer à la page concernant le développement de plugins (Plugin types (Anglais)) en portant l'attention sur la colonne "Moodle path". La présence de sous-dossiers à l'intérieur de l'un de ces emplacements déclenche automatiquement la recherche d'ajout de plugin manuel (cf Installation à la main). Aussi, n'ajoutez rien qui ne soit un plugin dans ces dossiers sous peine de générer une erreur de la part de Moodle !

Procédure de base

Avec le rôle d'administrateur de premier niveau sur le système de fichiers hébergeant la plateforme Moodle :

1) Récupérer les sources du plugin

  • Vous pouvez télécharger directement sur Moodle.org le paquetage correspondant au plugin à installer.
  • Vous pouvez aussi télécharger des modules non standards (qui ne sont pas intégrés dans la distribution officielle de Moodle)
  1. soit sur la plateforme Moodle
  1. soit chez le fournisseur du paquetage (en général sur un serveur Git ou sur GitHub)

2) Installation

Installation à la main

Décompressez l'archive du plugin dans le dossier ad hoc de l'arborescence de Moodle (voir ci-dessus), qui dépend de la nature du plugin à installer...

Le nom du dossier doit avoir le même nom que le plugin installé.

Il faut que les droits d'écriture et lecture sur le dossier et ses composants soient correctement ajustés (vérifier comment c'est fait dans un autre dossier de plugin)


Attention : Vérifiez que l'archive est correctement structurée :

Nom-archive-a-installer.zip
     nomplugin                  :: ceci est le dossier racine du plugin à copier dans le dossier Moodle ad hoc
            ./db                                            :: sous-dossier d'accès à la base de données Moodle
            ./lang                                          :: sous-dossier des langues supportées 
etc.            
            ./index.php                                     :: fichier d'index
            ./locallib.php                                  :: fichier des fonctions
            ./README.md                                     :: fichier de description
etc.
            ./version.php                                   :: fichier version du plugin

A priori le dossier doit contenir a minima un fichier version.php, un fichier index.php et un dossier de langue.

Connectez-vous maintenant sur Moodle avec le rôle d'administrateur et passez à la partie Activer le plugin

Fichiers de langue

Si le paquetage contient des fichiers de langue en français (ou tout fichier de langue différent de l'anglais) dans le dossier /nomplugin/lang le mieux est de les y laisser.

Mais pour activer ces langues vous devrez :

  • Si ce n'est déjà fait, activer le paquetage de la langue en question au niveau de l'administration des Langues de Moodle
  • Purger les caches système pour activer le nouveau paquetage lié au plugin.

Installation avec l'installateur intégré dans Moodle

C'est la méthode recommandée.

Vous devez disposer d'une archive ZIP de l'ensemble des sources du plugin

Logez-vous comme administrateur, allez dans la rubrique Administration du site > Plugin > Installer un plugin puis laissez-vous guider.

Activation et configuration du plugin

Suite à l'installation passez par "Administration du site > Notification" pour vérifier si d'autres tâches sont à compléter pour activer le plugin.

Puis selon le type de plugin (module, bloc, etc.) vous devez passer par "Administration du site > Plugins > Gestion des plugins" pour configurer / activer le nouveau plugin.

Et en cas d'erreur ?

Vérifiez :

  • Que l'archive est correctement structurée
  • Que le plugin est compatible avec votre version de Moodle.
  • Que le dossier du plugin est correctement situé dans l'arborescence de Moodle
  • Que les droits d'écriture / lecture sont corrects dans l'arborescence des fichiers de Moodle


That's all folks!

Voir aussi