« Installer des plugins » : différence entre les versions
(Légères améliorations de présentation) |
|||
Ligne 7 : | Ligne 7 : | ||
===Liste des dossiers de Moodle "ouverts" aux ajouts=== | ===Liste des dossiers de Moodle "ouverts" aux ajouts=== | ||
* Le dossier des Blocs : | * Le dossier des Blocs : /moodle/blocks/ | ||
* Le dossier des Modules | * Le dossier des Modules /moodle/mod/ | ||
* le dossier des Rapports : | * le dossier des Rapports : /moodle/report/ | ||
* le dossier des Filtres : | * le dossier des Filtres : /moodle/filter/ | ||
* le dossier des Thèmes : | * le dossier des Thèmes : /moodle/theme/ | ||
* le dossier Local : | * le dossier Local : /moodle/local/ | ||
* ... | * ... | ||
Ligne 31 : | Ligne 31 : | ||
==== Installation ''à la main''==== | ==== 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é. | Le nom du dossier '''doit''' avoir le même nom que le plugin installé. | ||
Ligne 53 : | Ligne 53 : | ||
A priori le dossier doit contenir a minima un fichier version.php, un fichier index.php et un dossier de langue. | 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 | Connectez-vous maintenant sur Moodle avec le rôle d'administrateur et passez à la partie '''Activer le plugin''' | ||
=====Fichiers de langue===== | =====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 '' | 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. | le mieux est de les y laisser. | ||
Mais pour activer ces langues vous devrez : | Mais pour activer ces langues vous devrez : | ||
* Si ce n'est | * 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. | * Purger les caches système pour activer le nouveau paquetage lié au plugin. | ||
Ligne 69 : | Ligne 69 : | ||
Vous devez disposer d'une archive ZIP de l'ensemble des sources du plugin | 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. | Logez-vous comme administrateur, allez dans la rubrique '''Administration du site > Plugin > Installer un plugin''' puis laissez-vous guider. | ||
===Activation et configuration du plugin=== | ===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. | 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 | 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. | "'''Administration du site > Plugins > Gestion des plugins'''" pour configurer / activer le nouveau plugin. | ||
=== Et en cas d'erreur ? === | === Et en cas d'erreur ? === | ||
Ligne 90 : | Ligne 90 : | ||
==Voir aussi== | ==Voir aussi== | ||
[[Guide_rapide_d%27administration|Guide d'administration]] | * Le [[Guide_rapide_d%27administration|Guide d'administration]] | ||
* La [[Gestion d'un site Moodle]] | |||
[[ |
Version du 30 juin 2016 à 08:30
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/
- ...
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)
- soit sur la plateforme Moodle
- 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!