MoodleDocs - Contributions [fr]

Installation de plugins

2015-10-12T15:20:18Z

Lepage :

{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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 n'est pas détecté automatiquement.
#Si votre répertoire cible n'est pas accessible en écriture, vous verrez un message d'avertissement.
#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 plugins peuvent être situés dans les répertoires suivants :
*/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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types de plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle]
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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 seront trouvés automatiquement par votre site 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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 qu'un problème a été renconntré lors de 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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 message 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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.),
*Précisez systématiquement la version de votre site Moodle ( 1.9 - 2.4 - 2.9.1 ? ...)
*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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugin
*le lancement de la mise à jour(le cas échéant).

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 annotations en face du plugin).

[[Fichier:plugin_install_16b.gif]]

== Mise à jour d'un plugin à partir de Moodle ==
Un administrateur peut activer le déploiement des mises à jour dans '''''Administration> Administration du site> Serveur> notifications de mise à jour'''''.
Quand les mises à jour sont disponibles, les boutons "Installez cette mise à jour" sont affichés sur la page "Vue d'ensemble des plugins".
Pour plus de détails, consulter la page [https://docs.moodle.org/29/en/Automatic_updates_deployment| Automatic updates deployment (en anglais) ].

[[Fichier:plugin_install_17.gif]]

[[Fichier:plugin_install_18.gif]]

'''Si vous êtes administrateur principal d'une plateforme Moodle, vous recevez donc de temps en temps un courriel qui vous indique que...'''

[[Fichier:PluginMAJ_01b.gif]]

'''Quand vous lancerez la mise à jour,''' après avoir cliquez le lien indiqué dans le courriel, vous aurez à confirmer votre décision de mettre à jour le plugin (après avoir pris les précautions nécessaires)

[[Fichier:PluginMAJ_04b.gif]]

'''Le plugin mis à jour sera opérationnel quand vous aurez lancé la mise à jour de la base de données :'''

[[Fichier:PluginMAJ_05b.gif]]

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évitées en copiant les lignes de code suivantes dans le fichier config-dist.php et en les collant dans le fichier config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T09:50:40Z

Lepage : /* Obtention d'aide */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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 n'est pas détecté automatiquement.
#Si votre répertoire cible n'est pas accessible en écriture, vous verrez un message d'avertissement.
#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 plugins peuvent être situés dans les répertoires suivants :
*/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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types de plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle]
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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 seront trouvés automatiquement par votre site 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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 qu'un problème a été renconntré lors de 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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 message 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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.),
*Précisez systématiquement la version de votre site Moodle ( 1.9 - 2.4 - 2.9.1 ? ...)
*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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugin
*le lancement de la mise à jour(le cas échéant).

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 annotations en face du plugin).

[[Fichier:plugin_install_16b.gif]]

== Mise à jour d'un plugin à partir de Moodle ==
Un administrateur peut activer le déploiement des mises à jour dans '''''Administration> Administration du site> Serveur> notifications de mise à jour'''''.
Quand les mises à jour sont disponibles, les boutons "Installez cette mise à jour" sont affichés sur la page "Vue d'ensemble des plugins".
Pour plus de détails, consulter la page [https://docs.moodle.org/29/en/Automatic_updates_deployment| Automatic updates deployment (en anglais) ].

[[Fichier:plugin_install_17.gif]]

[[Fichier:plugin_install_18.gif]]

'''Si vous êtes administrateur principal d'une plateforme Moodle, vous recevez donc de temps en temps un courriel qui vous indique que...'''

[[Fichier:PluginMAJ_01b.gif]]

'''Quand vous lancerez la mise à jour,''' après avoir cliquez le lien indiqué dans le courriel, vous aurez à confirmer votre décision de mettre à jour le plugin (après avoir pris les précautions nécessaires)

[[Fichier:PluginMAJ_04b.gif]]

'''Le plugin mis à jour sera opérationnel quand vous aurez lancé la mise à jour de la base de données :'''

[[Fichier:PluginMAJ_05b.gif]]

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évitées en copiant les lignes de code suivantes dans le fichier config-dist.php et en les collant dans le fichier config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T09:37:12Z

Lepage : /* Mise à jour d'un plugin à partir de Moodle */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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 n'est pas détecté automatiquement.
#Si votre répertoire cible n'est pas accessible en écriture, vous verrez un message d'avertissement.
#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 plugins peuvent être situés dans les répertoires suivants :
*/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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types de plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle]
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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 seront trouvés automatiquement par votre site 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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 qu'un problème a été renconntré lors de 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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 message 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugin
*le lancement de la mise à jour(le cas échéant).

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 annotations en face du plugin).

[[Fichier:plugin_install_16b.gif]]

== Mise à jour d'un plugin à partir de Moodle ==
Un administrateur peut activer le déploiement des mises à jour dans '''''Administration> Administration du site> Serveur> notifications de mise à jour'''''.
Quand les mises à jour sont disponibles, les boutons "Installez cette mise à jour" sont affichés sur la page "Vue d'ensemble des plugins".
Pour plus de détails, consulter la page [https://docs.moodle.org/29/en/Automatic_updates_deployment| Automatic updates deployment (en anglais) ].

[[Fichier:plugin_install_17.gif]]

[[Fichier:plugin_install_18.gif]]

'''Si vous êtes administrateur principal d'une plateforme Moodle, vous recevez donc de temps en temps un courriel qui vous indique que...'''

[[Fichier:PluginMAJ_01b.gif]]

'''Quand vous lancerez la mise à jour,''' après avoir cliquez le lien indiqué dans le courriel, vous aurez à confirmer votre décision de mettre à jour le plugin (après avoir pris les précautions nécessaires)

[[Fichier:PluginMAJ_04b.gif]]

'''Le plugin mis à jour sera opérationnel quand vous aurez lancé la mise à jour de la base de données :'''

[[Fichier:PluginMAJ_05b.gif]]

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évitées en copiant les lignes de code suivantes dans le fichier config-dist.php et en les collant dans le fichier config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T09:36:06Z

Lepage : /* Mise à jour d'un plugin à partir de Moodle */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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 n'est pas détecté automatiquement.
#Si votre répertoire cible n'est pas accessible en écriture, vous verrez un message d'avertissement.
#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 plugins peuvent être situés dans les répertoires suivants :
*/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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types de plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle]
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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 seront trouvés automatiquement par votre site 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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 qu'un problème a été renconntré lors de 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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 message 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugin
*le lancement de la mise à jour(le cas échéant).

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 annotations en face du plugin).

[[Fichier:plugin_install_16b.gif]]

== Mise à jour d'un plugin à partir de Moodle ==
Un administrateur peut activer le déploiement des mises à jour dans '''''Administration> Administration du site> Serveur> notifications de mise à jour'''''.
Quand les mises à jour sont disponibles, les boutons "Installez cette mise à jour" sont affichés sur la page "Vue d'ensemble des plugins".
Pour plus de détails, consulter la page [https://docs.moodle.org/29/en/Automatic_updates_deployment| Automatic updates deployment (en anglais) ].

[[Fichier:plugin_install_17.gif]]

[[Fichier:plugin_install_18.gif]]

'''Si vous êtes administrateur principal d'une plateforme Moodle, vous recevez donc de temps en temps un courriel qui vous indique que...'''

[[Fichier:PluginMAJ_01b.gif]]

'''Quand vous lancerez la mise à jour,''' après avoir cliquez le lien indiqué dans le courriel, vous aurez à confirmer votre décision de mettre le plugin (après avoir pris les précautions nécessaires)

[[Fichier:PluginMAJ_04b.gif]]

'''Le plugin mis à jour sera opérationnel quand vous aurez lancé la mise à jour de la base de données :'''

[[Fichier:PluginMAJ_05b.gif]]

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évitées en copiant les lignes de code suivantes dans le fichier config-dist.php et en les collant dans le fichier config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T09:33:01Z

Lepage : /* Mise à jour d'un plugin à partir de Moodle */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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 n'est pas détecté automatiquement.
#Si votre répertoire cible n'est pas accessible en écriture, vous verrez un message d'avertissement.
#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 plugins peuvent être situés dans les répertoires suivants :
*/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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types de plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle]
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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 seront trouvés automatiquement par votre site 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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 qu'un problème a été renconntré lors de 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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 message 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugin
*le lancement de la mise à jour(le cas échéant).

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 annotations en face du plugin).

[[Fichier:plugin_install_16b.gif]]

== Mise à jour d'un plugin à partir de Moodle ==
Un administrateur peut activer le déploiement des mises à jour dans '''''Administration> Administration du site> Serveur> notifications de mise à jour'''''.
Quand les mises à jour sont disponibles, les boutons "Installez cette mise à jour" sont affichés sur la page "Vue d'ensemble des plugins".
Pour plus de détails, consulter la page [https://docs.moodle.org/29/en/Automatic_updates_deployment| Automatic updates deployment (en anglais) ].

[[Fichier:plugin_install_17.gif]]

[[Fichier:plugin_install_18.gif]]

Si vous êtes administrateur principal d'une plateforme Moodle, vous recevez donc de temps en temps un courriel qui vous indique que...

[[Fichier:PluginMAJ_01b.gif]]

[[Fichier:PluginMAJ_04b.gif]]

[[Fichier:PluginMAJ_05b.gif]]

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évitées en copiant les lignes de code suivantes dans le fichier config-dist.php et en les collant dans le fichier config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Fichier:PluginMAJ 01b.gif

2015-10-12T09:31:38Z

Lepage : courriel d'avertissement de MAJ de plugin

courriel d'avertissement de MAJ de plugin

Fichier:PluginMAJ 05b.gif

2015-10-12T09:29:27Z

Lepage : mettre à jour la Base de donnée

mettre à jour la Base de donnée

Fichier:PluginMAJ 04b.gif

2015-10-12T09:28:51Z

Lepage : confirmer une MAJ de plugin

confirmer une MAJ de plugin

Fichier:PluginMAJ 04.gif

2015-10-12T09:25:03Z

Lepage : confirmer la MAJ d'un plugin

confirmer la MAJ d'un plugin

Fichier:PluginMAJ 01.gif

2015-10-12T09:23:21Z

Lepage : courriel notification de MAJ Plugin

courriel notification de MAJ Plugin

Installation de plugins

2015-10-12T09:22:11Z

Lepage : /* Mise à jour d'un plugin à partir de Moodle */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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 n'est pas détecté automatiquement.
#Si votre répertoire cible n'est pas accessible en écriture, vous verrez un message d'avertissement.
#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 plugins peuvent être situés dans les répertoires suivants :
*/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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types de plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle]
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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 seront trouvés automatiquement par votre site 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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 qu'un problème a été renconntré lors de 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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 message 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugin
*le lancement de la mise à jour(le cas échéant).

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 annotations en face du plugin).

[[Fichier:plugin_install_16b.gif]]

== Mise à jour d'un plugin à partir de Moodle ==
Un administrateur peut activer le déploiement des mises à jour dans '''''Administration> Administration du site> Serveur> notifications de mise à jour'''''.
Quand les mises à jour sont disponibles, les boutons "Installez cette mise à jour" sont affichés sur la page "Vue d'ensemble des plugins".
Pour plus de détails, consulter la page [https://docs.moodle.org/29/en/Automatic_updates_deployment| Automatic updates deployment (en anglais) ].

[[Fichier:plugin_install_17.gif]]

[[Fichier:plugin_install_18.gif]]

Si vous êtes administrateur principal d'une plateforme Moodle, vous recevez donc de temps en temps un courriel qui vous indique que...

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évitées en copiant les lignes de code suivantes dans le fichier config-dist.php et en les collant dans le fichier config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T09:19:59Z

Lepage : /* Empêcher l'installation de plugins à partir de Moodle */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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 n'est pas détecté automatiquement.
#Si votre répertoire cible n'est pas accessible en écriture, vous verrez un message d'avertissement.
#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 plugins peuvent être situés dans les répertoires suivants :
*/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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types de plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle]
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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 seront trouvés automatiquement par votre site 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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 qu'un problème a été renconntré lors de 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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 message 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugin
*le lancement de la mise à jour(le cas échéant).

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 annotations en face du plugin).

[[Fichier:plugin_install_16b.gif]]

== Mise à jour d'un plugin à partir de Moodle ==
Un administrateur peut activer le déploiement des mises à jour dans '''''Administration> Administration du site> Serveur> notifications de mise à jour'''''.
Quand les mises à jour sont disponibles, les boutons "Installez cette mise à jour" sont affichés sur la page "Vue d'ensemble des plugins".
Pour plus de détails, consulter la page [https://docs.moodle.org/29/en/Automatic_updates_deployment| Automatic updates deployment (en anglais) ].

[[Fichier:plugin_install_17.gif]]

[[Fichier:plugin_install_18.gif]]

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évitées en copiant les lignes de code suivantes dans le fichier config-dist.php et en les collant dans le fichier config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T09:18:38Z

Lepage : /* Vue d'ensemble des Plugins */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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 n'est pas détecté automatiquement.
#Si votre répertoire cible n'est pas accessible en écriture, vous verrez un message d'avertissement.
#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 plugins peuvent être situés dans les répertoires suivants :
*/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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types de plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle]
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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 seront trouvés automatiquement par votre site 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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 qu'un problème a été renconntré lors de 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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 message 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugin
*le lancement de la mise à jour(le cas échéant).

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 annotations en face du plugin).

[[Fichier:plugin_install_16b.gif]]

== Mise à jour d'un plugin à partir de Moodle ==
Un administrateur peut activer le déploiement des mises à jour dans '''''Administration> Administration du site> Serveur> notifications de mise à jour'''''.
Quand les mises à jour sont disponibles, les boutons "Installez cette mise à jour" sont affichés sur la page "Vue d'ensemble des plugins".
Pour plus de détails, consulter la page [https://docs.moodle.org/29/en/Automatic_updates_deployment| Automatic updates deployment (en anglais) ].

[[Fichier:plugin_install_17.gif]]

[[Fichier:plugin_install_18.gif]]

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T09:16:07Z

Lepage : /* Erreur d'autorisation d'accès à un fichier */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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 n'est pas détecté automatiquement.
#Si votre répertoire cible n'est pas accessible en écriture, vous verrez un message d'avertissement.
#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 plugins peuvent être situés dans les répertoires suivants :
*/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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types de plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle]
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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 seront trouvés automatiquement par votre site 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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 qu'un problème a été renconntré lors de 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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 message 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.gif]]

== Mise à jour d'un plugin à partir de Moodle ==
Un administrateur peut activer le déploiement des mises à jour dans '''''Administration> Administration du site> Serveur> notifications de mise à jour'''''.
Quand les mises à jour sont disponibles, les boutons "Installez cette mise à jour" sont affichés sur la page "Vue d'ensemble des plugins".
Pour plus de détails, consulter la page [https://docs.moodle.org/29/en/Automatic_updates_deployment| Automatic updates deployment (en anglais) ].

[[Fichier:plugin_install_17.gif]]

[[Fichier:plugin_install_18.gif]]

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T09:15:20Z

Lepage : /* Erreurs */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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 n'est pas détecté automatiquement.
#Si votre répertoire cible n'est pas accessible en écriture, vous verrez un message d'avertissement.
#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 plugins peuvent être situés dans les répertoires suivants :
*/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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types de plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle]
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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 seront trouvés automatiquement par votre site 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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 qu'un problème a été renconntré lors de 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.gif]]

== Mise à jour d'un plugin à partir de Moodle ==
Un administrateur peut activer le déploiement des mises à jour dans '''''Administration> Administration du site> Serveur> notifications de mise à jour'''''.
Quand les mises à jour sont disponibles, les boutons "Installez cette mise à jour" sont affichés sur la page "Vue d'ensemble des plugins".
Pour plus de détails, consulter la page [https://docs.moodle.org/29/en/Automatic_updates_deployment| Automatic updates deployment (en anglais) ].

[[Fichier:plugin_install_17.gif]]

[[Fichier:plugin_install_18.gif]]

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T09:13:50Z

Lepage : /* Installation manuelle sur le serveur */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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 n'est pas détecté automatiquement.
#Si votre répertoire cible n'est pas accessible en écriture, vous verrez un message d'avertissement.
#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 plugins peuvent être situés dans les répertoires suivants :
*/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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types de plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle]
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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 seront trouvés automatiquement par votre site 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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.gif]]

== Mise à jour d'un plugin à partir de Moodle ==
Un administrateur peut activer le déploiement des mises à jour dans '''''Administration> Administration du site> Serveur> notifications de mise à jour'''''.
Quand les mises à jour sont disponibles, les boutons "Installez cette mise à jour" sont affichés sur la page "Vue d'ensemble des plugins".
Pour plus de détails, consulter la page [https://docs.moodle.org/29/en/Automatic_updates_deployment| Automatic updates deployment (en anglais) ].

[[Fichier:plugin_install_17.gif]]

[[Fichier:plugin_install_18.gif]]

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T09:11:37Z

Lepage : /* Installation manuelle sur le serveur */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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 n'est pas détecté automatiquement.
#Si votre répertoire cible n'est pas accessible en écriture, vous verrez un message d'avertissement.
#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 plugins peuvent être situés dans les répertoires suivants :
*/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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.gif]]

== Mise à jour d'un plugin à partir de Moodle ==
Un administrateur peut activer le déploiement des mises à jour dans '''''Administration> Administration du site> Serveur> notifications de mise à jour'''''.
Quand les mises à jour sont disponibles, les boutons "Installez cette mise à jour" sont affichés sur la page "Vue d'ensemble des plugins".
Pour plus de détails, consulter la page [https://docs.moodle.org/29/en/Automatic_updates_deployment| Automatic updates deployment (en anglais) ].

[[Fichier:plugin_install_17.gif]]

[[Fichier:plugin_install_18.gif]]

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T09:11:26Z

Lepage : /* Installation manuelle sur le serveur */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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 n'est pas détecté automatiquement.
#Si votre répertoire cible n'est pas accessible en écriture, vous verrez un message d'avertissement.
#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 plugins peuvent être situés dans les répertoires suivants : :
*/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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.gif]]

== Mise à jour d'un plugin à partir de Moodle ==
Un administrateur peut activer le déploiement des mises à jour dans '''''Administration> Administration du site> Serveur> notifications de mise à jour'''''.
Quand les mises à jour sont disponibles, les boutons "Installez cette mise à jour" sont affichés sur la page "Vue d'ensemble des plugins".
Pour plus de détails, consulter la page [https://docs.moodle.org/29/en/Automatic_updates_deployment| Automatic updates deployment (en anglais) ].

[[Fichier:plugin_install_17.gif]]

[[Fichier:plugin_install_18.gif]]

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T09:09:53Z

Lepage : /* Installation à partir d'un fichier ZIP */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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 n'est pas détecté automatiquement.
#Si votre répertoire cible n'est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.gif]]

== Mise à jour d'un plugin à partir de Moodle ==
Un administrateur peut activer le déploiement des mises à jour dans '''''Administration> Administration du site> Serveur> notifications de mise à jour'''''.
Quand les mises à jour sont disponibles, les boutons "Installez cette mise à jour" sont affichés sur la page "Vue d'ensemble des plugins".
Pour plus de détails, consulter la page [https://docs.moodle.org/29/en/Automatic_updates_deployment| Automatic updates deployment (en anglais) ].

[[Fichier:plugin_install_17.gif]]

[[Fichier:plugin_install_18.gif]]

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T09:07:14Z

Lepage : /* Mise à jour d'un plugin à partir de Moodle */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.gif]]

== Mise à jour d'un plugin à partir de Moodle ==
Un administrateur peut activer le déploiement des mises à jour dans '''''Administration> Administration du site> Serveur> notifications de mise à jour'''''.
Quand les mises à jour sont disponibles, les boutons "Installez cette mise à jour" sont affichés sur la page "Vue d'ensemble des plugins".
Pour plus de détails, consulter la page [https://docs.moodle.org/29/en/Automatic_updates_deployment| Automatic updates deployment (en anglais) ].

[[Fichier:plugin_install_17.gif]]

[[Fichier:plugin_install_18.gif]]

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Fichier:plugin install 18.gif

2015-10-12T09:01:30Z

Lepage : paramétrage des notifications de mise à jour

paramétrage des notifications de mise à jour

Installation de plugins

2015-10-12T09:00:59Z

Lepage : /* Mise à jour d'un plugin à partir de Moodle */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

[[Fichier:plugin_install_17.gif]]

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Fichier:plugin install 17.gif

2015-10-12T08:59:02Z

Lepage : menu serveur notifications

menu serveur notifications

Installation de plugins

2015-10-12T08:52:42Z

Lepage : /* Voir aussi */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo de MoodleBites, en anglais sur YouTube) ]

*[https://www.youtube.com/watch?v=K3MYE8am7M4&feature=youtu.be| Installer un nouveau thème (vidéo de MoodleBites, en anglais sur YouTube) ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:51:16Z

Lepage : /* Voir aussi */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de Gavin Henrick) ]

*[https://www.youtube.com/watch?v=RxlmVzIllVk&feature=youtu.be| Administration des Plugins dans Moodle 2 (vidéo en anglais sur YouTube) ]

*[| Installer un nouveau thème MoodleBites vidéo sur YouTube ]

'''Pour les développeurs :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:49:47Z

Lepage : /* Voir aussi */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 (blog en anglais de 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 :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:49:19Z

Lepage : /* Voir aussi */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/| Gestion des add-ons dans Moodle 2.5 -blog en anglais de 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 :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:47:56Z

Lepage : /* Voir aussi */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installing a contributed extension from its Git repository (en anglais) ]

*[| 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 :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:46:29Z

Lepage : /* Voir aussi */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[https://docs.moodle.org/29/en/Git_for_Administrators#Installing_a_contributed_extension_from_its_Git_repository| Installer une extension contribué de son dépôt Git (en anglais) ]

*[| 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 :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:45:24Z

Lepage : /* Voir aussi */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[https://moodle.org/mod/forum/view.php?id=44| Forum en anglais Moodle sur les plugins ]

*[| 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 :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:44:26Z

Lepage : /* Voir aussi */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins (en anglais) ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ en anglais sur les Plugins ]

*[| Forum Moodle sur les plugins ]

*[| 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 :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:42:50Z

Lepage : /* Voir aussi */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*[https://docs.moodle.org/29/en/Plugin_Review_Criteria| Critères d'examen des Plugins ]

*[https://docs.moodle.org/29/en/Plugins_FAQ| FAQ sur les Plugins ]

*[| 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 :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:34:15Z

Lepage : /* Voir aussi */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*Critères d'examen des Plugins

*FAQ sur les Plugins

*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 :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:32:16Z

Lepage : /* Voir aussi */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*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 :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[https://docs.moodle.org/dev/Plugin_validation| dev:Plugin validation ]
*[https://docs.moodle.org/dev/On-click_add-on_installation| dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:31:22Z

Lepage : /* Voir aussi */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*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 :'''

*[https://docs.moodle.org/dev/Category:Plugins| Plugins developer documentation ]
*[ | dev:Plugin validation ]
*[ | dev:On-click add-on installation ]

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:29:26Z

Lepage : /* Voir aussi */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
*[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

*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 :'''

*Plugins developer documentation
*dev:Plugin validation
*dev:On-click add-on installation

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:28:12Z

Lepage : /* Voir aussi */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

== Voir aussi ==
[https://docs.moodle.org/2x/fr/Notifications_de_mise_%C3%A0_jour| Notifications de mise à jour ] pour plus de détail sur les mises à jour

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-

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:19:28Z

Lepage : /* Prévenir l'installation de greffons à partir de Moodle */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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.

== Empêcher l'installation de plugins à partir de Moodle ==
Si nécessaire, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $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-

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:19:04Z

Lepage : /* Prévenir l'installation de greffons à partir de Moodle */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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, l'installation et la mise à jour à partir de Moodle peuvent être évités en copiant les lignes de code suivantes dans config-dist.php et en les collant dans config.php.

// Use the following flag to completely disable the On-click plugin installation
// feature and hide it from the server administration UI.
//
// $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-

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:16:27Z

Lepage : /* Vue d'ensemble des Plugins */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*la version (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*un bouton d'accès aux paramètres du plugins
*le lancement de la mise à jour(le cas échéant).

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 nannotations en face du plugin).

[[Fichier:plugin_install_16b.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-

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:14:04Z

Lepage : /* Vue d'ensemble des Plugins */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*l'édition (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*le lancement de la mise à jour(le cas échéant).

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_16b.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-

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Fichier:plugin install 16b.gif

2015-10-12T08:13:40Z

Lepage : vue d'ensemble des plugins, liste des plugins installés

vue d'ensemble des plugins, liste des plugins installés

Installation de plugins

2015-10-12T08:11:11Z

Lepage : /* Vue d'ensemble des Plugins */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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 rechercher des mises à jour : 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)

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*l'édition (par ex. "nouveau en 2.9"),
*la disponibilité (activé ou désactivé),
*le lancement de la mise à jour(le cas échéant).

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_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-

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:07:43Z

Lepage : /* Vue d'ensemble des Plugins */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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'''''

[[Fichier:plugin_install_13b.gif]]

'''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

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*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).

[[Fichier: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-

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:07:16Z

Lepage : /* Vue d'ensemble des Plugins */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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

[[Fichier:plugin_install_13b.gif]]

[[Fichier:plugin_install_15.gif]]

'''Dans le contenu de la page, on trouve la liste de tous les plugins installés, avec :'''
*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).

[[Fichier: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-

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T08:05:38Z

Lepage : /* Vue d'ensemble des Plugins */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier: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).

[[Fichier:plugin_install_13b.gif]]

[[Fichier:plugin_install_15.gif]]

[[Fichier: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-

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Fichier:plugin install 16.gif

2015-10-12T07:55:38Z

Lepage : vue d'ensemble des plugins, liste des plugins

vue d'ensemble des plugins, liste des plugins

Installation de plugins

2015-10-12T07:55:03Z

Lepage : /* Vue d'ensemble des Plugins */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier:plugin_install_14b.gif]]

== Vue d'ensemble des Plugins ==

La page d'administration "'''Vue d'ensemble des plugins'''" a plusieurs utilités :
*elle indique
**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

Pour accéder à cette page :
mettant en évidence bouton de vérification
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).

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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier:plugin_install_15.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-

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T07:46:54Z

Lepage : /* Vue d'ensemble des Plugins */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier:plugin_install_14b.gif]]

== Vue d'ensemble des Plugins ==

Aperçu plugins disponibles mettant en évidence bouton de vérification
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).

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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier:plugin_install_15.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-

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]

Installation de plugins

2015-10-12T07:45:41Z

Lepage : /* Aperçu Plugins */

{{Travail en cours}}{{Installation}}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 [https://moodle.org/plugins/browse.php?list=category&id=38 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''' :

#Le plugin peut être installé à partir de Moodle en accédant directement au répertoire des plugins Moodle.
#Le plugin peut être installé à partir de Moodle en téléchargeant le fichier ZIP du plugin.
#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 ==
#connectez-vous sur votre site en mode administrateur
#dans le menu administration, choisissez "installer des plugins"
#dans la fenêtre qui s'affiche, cliquez sur le bouton "Installer des plugins à partir du répertoire des plugins Moodle"
#Moodle vous connecte sur la base des plugins de Moodle (vous devrez créer un compte au besoin, mais c'est gratuit)
#précisez la version de votre plateforme Moodle
#recherchez un plugin avec un bouton Installer, cliquez sur le bouton Installer, puis cliquez sur Continuer.
#si vous administrez plusieurs sites Moodle, pointez le site sur lequel installer le plugin
#le plugin est téléchargé sur votre site Moodle
#Moodle vérifie que le plugin est compatible avec la version de votre plateforme, et vous renvoie le message "validation passée"
#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
#Moodle installe le plugin
#Moodle vous demande de mettre la base de données à jour
#Moodle vous informe du succès de l'opération

'''Installation directe : tutoriel'''

[[Fichier:plugin_install_01.gif]]

[[Fichier:plugin_install_02.gif]]

[[Fichier:plugin_install_03.gif]]

[[Fichier:plugin_install_04.gif]]

[[Fichier:plugin_install_05.gif]]

[[Fichier:plugin_install_06.gif]]

[[Fichier:plugin_install_07.gif]]

[[Fichier:plugin_install_08.gif]]

[[Fichier:plugin_install_09.gif]]

[[Fichier:plugin_install_10.gif]]

== Installation à partir d'un fichier ZIP ==

#accédez au [https://moodle.org/plugins/| répertoire des plugins Moodle ] ,
#sélectionnez la version de votre site Moodle,
#choisissez un plugin avec un bouton de téléchargement et téléchargez le fichier ZIP.
#connectez-vous à votre site Moodle en tant qu'administrateur et accédez à '''''Administration> Administration du site> Plugins> Installer des plugins'''''.
##'''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.
#Si votre répertoire cible est pas accessible en écriture, vous verrez un message d'avertissement.
#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 : [https://docs.moodle.org/dev/Plugin_types| dev:Plugins ] pour la liste complète de tous les types plugin et leurs emplacements dans l'arborescence de Moodle.

'''Deuxièmement :'''
#allez sur le [https://moodle.org/plugins/| répertoire des plugins de Moodle];
#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.
#téléchargez ou copiez-le dans votre serveur Moodle.
#décompressez-le à la localisation correcte pour le plugin dans l'arborescence de Moodle (ou suivez les instructions du plugin).
#dans votre site Moodle (en tant qu'administrateur), allez dans '''''Paramètres> Administration du site> Notifications'''''
#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.

[[Fichier:plugin_install_11.gif]]

== Dépannage ==

==== Erreurs ====

Si un message d'erreur s'affiche, activez le les [https://docs.moodle.org/29/en/Debugging| 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 [https://docs.moodle.org/29/en/SSL_certificate_for_moodle.org| 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.

[[Fichier: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é : [https://moodle.org/mod/forum/view.php?id=951| 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 :
#utilisez le menu '''''Administration> Administration du site> Plugins> Vue d'ensemble des Plugins'''''
#cliquez sur le lien '''''Désinstaller''''', à droite dans la ligne du plugin que vous souhaitez supprimer
#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.

[[Fichier:plugin_install_13b.gif]]

[[Fichier:plugin_install_14b.gif]]

== Vue d'ensemble des Plugins ==

Aperçu plugins disponibles mettant en évidence bouton de vérification
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).

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.

== 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-

[[Category:Code tiers]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]
[[en:Installing plugins]]