Attention : vous consultez actuellement la documentation dédiée aux versions 2.x de Moodle. La documentation pour les versions 3.x de Moodle est consultable ici : Installation de plugins et celle pour Moodle 4.x est consultable là : Installation de plugins.

« Installation de plugins » : différence entre les versions

De MoodleDocs
Aller à :navigation, rechercher
Ligne 151 : Ligne 151 :


== Vue d'ensemble des Plugins ==
== Vue d'ensemble des Plugins ==
Pour accéder à la page '''Vue d'ensemble des Plugins''' utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''


La page d'administration "'''Vue d'ensemble des plugins'''"  a plusieurs utilités :
'''Cette page d'administration a plusieurs utilités :'''
*elle indique  
*elle indique (sous le titre) :
**le nombre de plugins installés
**le nombre de plugins installés
**le nombre de plugins désactivés
**le nombre de plugins désactivés
Ligne 159 : Ligne 160 :
**le nombre de mises à jour disponibles pour les plugins
**le nombre de mises à jour disponibles pour les plugins
**... et la date de la dernière vérification effectuée
**... et la date de la dernière vérification effectuée
*elle permet  
*elle permet :
**d'afficher seulement les plugins additionnels
**d'afficher seulement les plugins additionnels
**de recherche des mises à jour
**de recherche des mises à jour
**de lancer la mise à jour d'un plugin


Pour accéder à cette page
'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
mettant en évidence bouton de vérification
*le numéro de version,  
La page d'aperçu Plugins en administration> Administration du site> Plugins> Plugins listes aperçu tous les plugins installés, ainsi que le numéro de version, l'édition (nouveau en 2.7), la disponibilité (activé ou désactivé) et les paramètres du lien (le cas échéant).
*l'édition (par  ex. "nouveau en 2.9"),  
*la disponibilité (activé ou désactivé),
*le lancement de la mise à jour(le cas échéant).  


Un «Vérifier les mises à jour disponibles de la touche permet aux administrateurs de vérifier rapidement les mises à jour disponibles pour les plugins installés sur le site (à partir du répertoire des plugins). Les mises à jour disponibles sont mis en évidence, avec plus d'informations et un lien de téléchargement dans la colonne des notes en face du plugin.
'''Le bouton "Rechercher des mises à jour"''' permet aux administrateurs de vérifier rapidement les mises à jour disponibles pour les plugins installés sur le site (à partir du répertoire des plugins)
 
Les mises à jour disponibles sont mises en évidence dans la liste, avec quelques informations et un lien de téléchargement (dans la colonne des notes en face du plugin).


[[Fichier:plugin_install_13b.gif]]
[[Fichier:plugin_install_13b.gif]]


[[Fichier:plugin_install_15.gif]]
[[Fichier:plugin_install_15.gif]]
[[Fichier:plugin_install_16.gif]]


== Mise à jour d'un plugin à partir de Moodle ==
== Mise à jour d'un plugin à partir de Moodle ==

Version du 12 octobre 2015 à 08:05

Remarque : cet article est en cours de rédaction. N'hésitez pas à le compléter. Veuillez utiliser la page de discussion ou un forum adéquat de Moodle en français pour vos recommandations et suggestions d'améliorations.

Moodle, une fois installé, comporte par défaut des fonctionnalités variées et très nombreuses. On peut lui ajouter d'autres fonctionnalités par des modules complémentaires : les "plugins". Il existe plus de 1000 modules complémentaires Open Source permettant l'ajout de fonctionnalités et de liens avec d'autres systèmes.

Considérations pour les sites en production

Attention, TRÈS IMPORTANT : soyez conscient que certains plugins n'ont pas été vérifiés : ni leur qualité ni leur compatibilité ne sont garanties. Un plugin non vérifié peut ne pas fonctionner du tout, faire autre chose que ce que vous attendez, il peut même poser de sérieux problèmes de sécurité. La situation s'améliore cependant avec l'évolution du système de répertoire des nouveaux plugins.

Posez-vous les bonnes questions :

  • Si vous avez un site de production dont la bonne marche est importante, avez-vous vraiment besoin du plugin ?
  • Un plugin apporte des fonctionnalités supplémentaires, mais elles ont pour conséquences :
    • plus de maintenance,
    • plus de risques de problèmes de fonctionnement du site
    • plus d'éléments à gérer quand vous faîtes une mise à niveau de Moodle.
  • Le plugin que vous souhaitez installer est-il maintenu, mis à jour, "soutenu" par ses développeurs ? Chaque mise à jour de Moodle suppose de vérifier que les plugins ajoutés ont eux-aussi été mis à jour pour la nouvelle version de Moodle, ...ce qui peut prendre des semaines.
  • Si quelque chose se passe mal, pouvez-vous obtenir de l'aide ?
  • Si le plugin ne fonctionne pas dans une future version de Moodle, comment ferez-vous ?
  • Est-ce un plugin ou un patch : Méfiez-vous des patchs (ils sont dans un répertoire spécifique) ! Il faut être très prudent si un plugin modifie ou remplace les "fichiers core". Son fonctionnement n'est garanti que pour la version de Moodle pour laquelle il a été conçu. Il est très peu probable qu'il survive à une mise à jour de Moodle.

Installation d'un plugin

Pour qu'un plugin soit installé, son code source doit être installé à l'emplacement approprié dans le répertoire d'installation Moodle.

Vous devez consulter la page d'administration Administration> Administration du site> Notifications.

Trois méthodes pour installer un plugin dans Moodle :

  1. Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
  2. Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
  3. Le plugin peut être installé manuellement au niveau du serveur.
  • Remarque : Pour que les méthodes 1 et 2 puissent être utilisées, le processus de serveur Web doit avoir accès en écriture dans le dossier où le nouveau plugin doit être installé.

Installation directe à partir du répertoire des plugins Moodle

  1. connectez-vous sur votre site en mode administrateur
  2. dans le menu administration, choisissez "installer des plugins"
  3. dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
  4. Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
  5. précisez la version de votre plateforme Moodle
  6. recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
  7. si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
  8. le plugin est téléchargé sur votre site Moodle
  9. Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
  10. validez que vous avez pris en compte le fait que l'installation d'un plugin peut planter la plateforme (la "Quittance"), et que vous avez pris les précautions voulues
  11. Moodle installe le plugin
  12. Moodle vous demande de mettre la base de données à jour
  13. Moodle vous informe du succès de l'opération

Installation directe : tutoriel

plugin install 01.gif

plugin install 02.gif

plugin install 03.gif

plugin install 04.gif

plugin install 05.gif

plugin install 06.gif

plugin install 07.gif

plugin install 08.gif

plugin install 09.gif

plugin install 10.gif

Installation à partir d'un fichier ZIP

  1. accédez au répertoire des plugins Moodle ,
  2. sélectionnez la version de votre site Moodle,
  3. choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
  4. connectez-vous à votre site Moodle en tant qu'administrateur et accédez à Administration> Administration du site> Plugins> Installer des plugins.
    1. Nouveau dans 2.9 : Téléchargez le fichier ZIP. Vous devriez être invité à ajouter des détails supplémentaires (dans la section Plus Show) si votre plugin est pas détecté automatiquement.
  5. Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
  6. Sur l'écran suivant, vous verrez alors un message d'accusé de réception précisant que vous prenez la responsabilité de l'installation du plugin.

Installation manuelle sur le serveur

Si vous ne pouvez pas déployer le code du plugin via l'interface Web d'administration, vous devez le copier manuellement dans le système de fichiers du serveur (si, par exemple, le processus de serveur Web n'a pas accès en écriture à l'arborescence d'installation Moodle et ne peut pas le copier pour vous).

Premièrement, identifiez la localisation correcte pour le plugin dans l'arborescence de Moodle. Les Lieux habituels sont:

  • /path/to/moodle/theme/ - themes
  • /path/to/moodle/mod/ - activity modules and resources
  • /path/to/moodle/blocks/ - sidebar blocks
  • /path/to/moodle/question/type/ - question types
  • /path/to/moodle/course/format/ - course formats
  • /path/to/moodle/admin/report/ - admin reports

Voir : dev:Plugins pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

Deuxièmement :

  1. allez sur le répertoire des plugins de Moodle;
  2. sélectionnez la version de votre site Moodle, puis choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
  3. téléchargez ou copiez-le dans votre serveur Moodle.
  4. décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
  5. dans votre site Moodle (en tant qu'administrateur), allez dans Paramètres> Administration du site> Notifications
  6. pour la plupart des types de plugin, vous obtiendrez alors un message indiquant que le plugin est installé.

  • Remarque : Le plugin peut contenir des fichiers de langue. Ils vont être trouvé automatiquement par votre Moodle.
    • Ces chaînes de langue peuvent être personnalisées en utilisant le paramètrage standard Administration du site> Langue> Personnalisation de la langue.
    • Si vous obtenez une «erreur de base de données" lorsque vous essayez de modifier vos fichiers de langue, il y a de fortes chances pour que les fichiers de langue inclus dans le fichier ZIP téléchargé de ce plugin aient un problème de codage.
    • Si vous supprimez le répertoire plugin_name/lang/other_language_different_to_English/ et que l'erreur de base de données disparaît, c'est effectivement le cas.
    • Merci en ce cas de prévenir le responsable du plugin, de sorte qu'il soit corrigé dans les versions futures.

plugin install 11.gif

Dépannage

Erreurs

Si un message d'erreur s'affiche, activez le les options de débogage, cela vous fournira davantage d'informations pour vous aider à détecter le problème.

  • tool_installaddon/err_curl_exec - cURL error 60 : ce message indique des problèmes avec la validation du certificat SSL du site distant (moodle.org). C'est un problème connu pour les serveurs Windows 7 exécutant le package Moodle pour Windows. Voir SSL certificate for moodle.org pour plus d'informations et pour les solutions possibles.

Erreur d'autorisation d'accès à un fichier

Après l'installation d'un plugin il arrive que l'erreur suivante soit signalée : "A file permissions error has occurred. Please check the permissions on the script and the directory it is in and try again." ce qui signifie : "Une erreur d'autorisation d'accès à des fichiers est constatée. Vérifiez les autorisations du répertoire et du script qui s'y trouve, et essayez à nouveau"

Si vous obtenez ce message, les autorisations d'accès aux fichiers du plugin sont probablement réglées sur 711, ce qui empêche le plugin de fonctionner correctement.

Avec votre logiciel client FTP ou via l'interface de gestion de votre hébergement, définissez à 755 les autorisations d'accès de tous les fichiers et répertoires du plugin installé (par exemple : / moodle / mod / [myplugin] /) et vérifiez ensuite que le plugin fonctionne.

plugin install 12.gif

Lors de l'installation manuelle

  • Vérifiez les autorisations d'accès aux fichiers. Le serveur Web doit être en mesure de lire les fichiers du plugin.
  • Si le reste de votre site Moodle fonctionne, essayez de régler les autorisations et l'utilisateur pour le plugin avec les mêmes valeurs que le reste du Moodle.
  • Avez-vous vraiment décompressé ou installé le plugin dans le bon répertoire ?
  • Puisque Moodle scanne les dossiers des plugins pour détecter les nouveaux plugins et les installer, il ne doit pas y avoir d'autres fichiers ou dossiers. Assurez-vous donc que vous avez supprimé le fichier zip et n'essayez pas de renommer une ancienne version du plugin avec un autre nom : plus rien ne marchera.
  • Assurez-vous que le nom du répertoire du plugin est correct. Tous les noms doivent correspondre. Si vous modifiez le nom, le plugin ne fonctionnera pas.

Obtention d'aide

Posez vos questions dans le forum approprié : le forum assistance technique de moodle.org.

  • Assurez-vous que vous indiquez votre système et sa version (y compris les versions de MySQL, PHP, etc.),
  • Expliquez ce que vous avez essayé et ce qui est arrivé.
  • Copiez-collez avec exactitude les messages d'erreur.
  • Donnez le lien vers la version du plugin que vous avez téléchargé (certains ont des noms très similaires).

Désinstaller un plug-in

Pour désinstaller un plugin :

  1. utilisez le menu Administration> Administration du site> Plugins> Vue d'ensemble des Plugins
  2. cliquez sur le lien Désinstaller, à droite dans la ligne du plugin que vous souhaitez supprimer
  3. utilisez ensuite un gestionnaire de fichiers pour supprimer (effacer) le répertoire du plugin selon les instructions, sinon Moodle réinstallera le plugin à votre prochain accès à l'administration du site.

plugin install 13b.gif

plugin install 14b.gif

Vue d'ensemble des Plugins

Pour accéder à la page Vue d'ensemble des Plugins utilisez le menu Administration> Administration du site> Plugins> Vue d'ensemble des Plugins

Cette page d'administration a plusieurs utilités :

  • elle indique (sous le titre) :
    • le nombre de plugins installés
    • le nombre de plugins désactivés
    • le nombre de plugins additionnels
    • le nombre de mises à jour disponibles pour les plugins
    • ... et la date de la dernière vérification effectuée
  • elle permet :
    • d'afficher seulement les plugins additionnels
    • de recherche des mises à jour
    • de lancer la mise à jour d'un plugin

Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :

  • le numéro de version,
  • l'édition (par ex. "nouveau en 2.9"),
  • la disponibilité (activé ou désactivé),
  • le lancement de la mise à jour(le cas échéant).

Le bouton "Rechercher des mises à jour" permet aux administrateurs de vérifier rapidement les mises à jour disponibles pour les plugins installés sur le site (à partir du répertoire des plugins)

Les mises à jour disponibles sont mises en évidence dans la liste, avec quelques informations et un lien de téléchargement (dans la colonne des notes en face du plugin).

plugin install 13b.gif

plugin install 15.gif

plugin install 16.gif

Mise à jour d'un plugin à partir de Moodle

Un administrateur peut activer les mises à jour dans le déploiement Administration> Administration du site> Serveur> notifications de mise à jour. Puis, quand les mises à jour sont disponibles, «Installez cette mise à jour 'boutons sont affichés sur la page de présentation Plugins. Voir les mises à jour automatiques de déploiement pour plus de détails.

Prévenir l'installation de greffons à partir de Moodle

Si nécessaire, installer et mettre à jour à partir de Moodle peuvent être évités en copiant les lignes suivantes de code de config-dist.php et le coller dans config.php.

 // Utilisez le drapeau suivante pour désactiver complètement l'installation du plugin Sur-clic
// Fonction et le cacher à l'interface d'administration du serveur.
//
// $ CFG-> disableonclickaddoninstall = true;

Voir aussi

Notifications pour plus de détails de notifications de mise Critères d'examen Plugin Plugins FAQ Moodle en anglais général plugins forum Installer une extension contribué de son dépôt Git Gestion des add-ons dans Moodle 2.5 blog par Gavin Henrick Moodle 2 Plugins administration MoodleBites vidéo sur YouTube Installer un nouveau thème MoodleBites vidéo sur YouTube Pour les développeurs:

Documentation développeur Plugins dev: validation Plugin dev: Sur-cliquez sur l'installation des add-