13.7. Configuration de Moodle

Vous pouvez configurer Mahara de deux manières différentes pour utiliser Moodle :

  • Configuration au niveau du site, pour faciliter l’usage du service LTI par les enseignants qui auraient peu de connaissances techniques.

  • Configuration au niveau du cours

Toutes les captures d’écran ont été réalisées avec Moodle 3.5.

13.7.1. Préconfigurer LTI pour tous les cours

Accédez à Administration du site → Plugins → Modules d’activité → Outil externe → Gérer les outils.

Configurer Moodle pour se connecter à Mahara

Configurer Moodle pour se connecter à Mahara

  1. Nom de l’outil: Indiquez ici un nom que les enseignants vont reconnaître.

  2. URL de l’outil : Indiquez ici l’URL de lancement. Il est composé de la base de l’URL de votre site Mahara et suivi à la fin par : /webservice/rest/server.php?wsfunction=module_lti_launch

  3. Description de l’outil : Ce champ est facultatif. Fournir une description aidera vos enseignants à identifier l’outil.

  4. Clé client : Copiez et collez la clé client depuis la page de configuration de l’outil de connexion LTI que vous avez configuré auparavant.

  5. Secret partagé : Copiez et collez ici le secret partagé généré par Mahara lors de la configuration de l’outil de connexion LTI.

  6. Contenu de lancement par défaut : Choisissez « Nouvelle fenêtre » ou « Fenêtre existante ». Ne choisissez pas d’intégrer Mahara. Cela ne fonctionnera pas car vous n’êtes pas autorisé à intégrer Mahara dans d’autres sites web. De plus, cela réduira l’espace dont vous disposez pour travailler dans Mahara.

  7. URL de l’icône sécurisée : Si vous ne désirez pas utiliser l’icône standard de Moodle pour les outils externes, vous pouvez indiquez ici le lien vers votre icône à afficher à la place. Il est recommandé que cette icône soit hébergée sur le serveur Mahara et qu’elle soit aux dimensions demandées par Moodle pour un meilleur affichage.

  8. Cliquez sur le bouton Enregistrer pour accepter les modifications ou le bouton Annuler pour annuler la configuration de l’outil.

Note

Vous n’avez pas besoin de toucher aux autres paramètres de cette page.

13.7.2. Utiliser dans le cours une connexion à Mahara préconfigurée

Si Mahara a été déjà configuré comme outil externe au niveau du site dans Moodle, un enseignant doit seulement le sélectionner lors de l’ajout de l’activité « Outil externe » dans Moodle.

Sélectionner dans Moodle une instance préconfigurée de Mahara

Sélectionner dans Moodle une instance préconfigurée de Mahara

  1. Nom de l’activité : Donnez un nom à votre activité

  2. Outil préconfiguré : Sélectionnez votre instance Mahara dans le menu déroulant. Elle peut ne pas s’appeler « Mahara ». Certains champs ne sont pas modifiables lorsque vous choisissez cette option car ils sont déterminés par la configuration existante du site.

    Note

    Cliquez sur le lien Afficher plus* si vous désirez accéder à d’autres paramètres.

  3. Confidentialité : Cochez l’option « Accepter les notes de l’outil » si vous souhaitez pouvoir utiliser l’activité pour la soumission d’un portfolio.

  4. Cliquez sur le bouton Enregistrer et retourner au cours pour enregistrer les modifications et retourner sur la page du cours; cliquez sur le bouton Enregistrer et afficher pour lancer directement la connexion à Mahara; cliquez sur le bouton Annuler pour annuler les modifications effectuées.

13.7.3. Configurer manuellement Mahara comme activité d’un cours

Vous pouvez configurer une connexion à Mahara aussi comme une activité d’un seul cours dans Moodle, sans avoir une préconfiguration préalable au niveau du site. Ceci permet par exemple de limiter l’accès à votre Mahara aux seuls utilisateurs présents dans ce cours ou de pouvoir diriger ceux-ci vers une instance particulière de Mahara pour dans le cadre du cours.

Si tous les utilisateurs doivent accéder à la même institution sur la même instance Mahara, il convient de préconfigurer l’outil externe au niveau du site.

Configurer Mahara comme un outil externe dans un cours Moodle

Configurer Mahara comme un outil externe dans un cours Moodle

  1. Nom de l’activité : Donnez un nom à votre activité

  2. Description de l’activité : Indiquez ici une brève description des buts de votre activités. Cette rubrique est optionnelle.

  3. Outil préconfiguré : Sélectionnez « Automatique, basé sur l’URL de l’outil ».

  4. URL de l’outil sécurisé : Indiquez ici l’URL de lancement. Elle est construite sur l’URL de base de votre Mahara, à laquelle on ajoute /webservice/rest/server.php?wsfunction=module_lti_launch

    Note

    Vous pouvez utiliser le champ « URL de l’outil », mais comme les services web de Mahara ne fonctionnent qu’avec SSL (à moins que vous n’ayez une instance de développeur), il est recommandé de choisir « URL de l’outil sécurisé ».

  5. Lancer le conteneur : Choisissez « Nouvelle fenêtre » ou « Fenêtre existante ». Ne choisissez pas d’intégrer Mahara. Cela ne fonctionnera pas car vous n’êtes pas autorisé à intégrer Mahara dans d’autres sites web. De plus, cela réduira l’espace dont vous disposez pour travailler dans Mahara.

  6. Clé client : Copiez et collez la clé client depuis la page de configuration de l’outil de connexion LTI que vous avez configuré auparavant.

  7. Secret partagé : Copiez et collez ici le secret partagé généré par Mahara lors de la configuration de l’outil de connexion LTI.

  8. URL de l’icône sécurisée : Si vous ne désirez pas utiliser l’icône standard de Moodle pour les outils externes, vous pouvez indiquez ici le lien vers votre icône à afficher à la place. Il est recommandé que cette icône soit hébergée sur le serveur Mahara et qu’elle soit aux dimensions demandées par Moodle pour un meilleur affichage.

  9. Confidentialité : Cochez l’option « Accepter les notes de l’outil » si vous souhaitez pouvoir utiliser l’activité pour la soumission d’un portfolio.

  10. Cliquez sur le bouton Enregistrer et retourner au cours pour enregistrer les modifications et retourner sur la page du cours; cliquez sur le bouton Enregistrer et afficher pour lancer directement la connexion à Mahara; cliquez sur le bouton Annuler pour annuler les modifications effectuées.

Note

Vous n’avez pas besoin de toucher aux autres paramètres de cette page.

13.7.4. Configurer un devoir dans Moodle

  1. Sélectionnez cette option pour ajouter l’activité Outil externe dans Moodle.

  2. Pendant le setup, assurez-vous de cocher la case à côté de « Accepter les notes de l’outil » sous « Confidentialité ». Si vous ne cochez pas cette case, vous pourrez seulement vous authentifier sur Mahara mais pas sélectionner un portfolio à soumettre.

  3. Cliquez sur le nom de l’activité pour finaliser les paramètres de l’évaluation. Les apprenants ne peuvent pas utiliser l’activité tant que ces paramètres n’ont pas été enregistrés.

13.7.5. Nouveauté Mahara 22.04 Contrôle de similitude avec Ouriginal

Il est possible de soumettre un portfolio via la fonctionnalité de soumission des devoirs dans Moodle et de l’envoyer à Ouriginal pour des vérifications de similarité. Cela nécessite l’installation du plugin de soumission de devoirs de Mahara (services web) et du plugin Moodle Ouriginal. Ce dernier nécessite un certain nombre de modifications pour accéder aux services web dans Mahara. Ces modifications n’ont pas encore été ajoutées au code public du plugin Moodle.

Du côté de Mahara, les fonctionnalités disponibles sont les options d’exportation HTML lite et PDF lite. Comme les logiciels de contrôle de similitude ne peuvent traiter que certains types de fichiers, l’exportation « lite » permet de restreindre l’exportation à ces seuls types de fichiers. Référez-vous à htdocs/export/htmllite/lib.php ou htdocs/export/pdflite/lib.php pour les types de fichiers qui seront inclus dans l’exportation via la variable $validfiles.

L’exportation de PDF lite est une preuve de concept et une fonctionnalité expérimentale à ce stade.

  1. Assurez-vous que l’exportation HTML normale est activée, car c’est une condition préalable au fonctionnement de HTML lite. Si vous utilisez l’option PDF lite, activez l’option d’exportation PDF normale.

  2. Activez le plugin dans le menu Administration → Extensions → Administration des plugins → HTML Lite en cliquant sur le bouton Afficher.

  3. Activez les demandes de services Web entrants et sélectionnez le protocole que vous souhaitez utiliser dans Menu Administration → Services Web → Configuration.

  4. Mettez en place un service web sur la même page :

    • Créez un nouveau groupe de service et assignez la fonction mahara_submission_generate_view_for_plagiarism_test au groupe et assurez-vous que les options « Service » et « Accès au jeton d’utilisateur » sont activées.

    • Créez un nouveau jeton d’accès au service et sélectionnez le groupe de services nouvellement créé.

  5. Vous pouvez désormais accéder à ce service depuis une source externe, par exemple pour y accéder depuis un terminal via cURL :

curl --location --request POST 'http://example.com/webservice/rest/server.php' \
-F 'views[0][viewid]="8"' \
-F 'views[0][iscollection]=0' \
-F 'views[0][submittedhost]="fakeexternalsite"' \
-F 'views[0][exporttype]="htmllite"' \
-F 'wstoken="...your generated webservice token..."' \
-F 'wsfunction="mahara_submission_generate_view_for_plagiarism_test"'

Note

Pour utiliser l’option PDF lite dans la commande cURL, changez views[0][exporttype]="htmllite" en views[0][exporttype]="pdflite".

13.7.6. Dépannage de la connexion LTI de Moodle

Certaines personnes ont rencontré des problèmes pour connecter Moodle à Mahara via LTI pour la soumission des devoirs. Une chose à vérifier si cela arrive est que les hôtes ne sont pas bloqués par Moodle.

  1. Assurez-vous que le plugin de soumission des devoirs Mahara est installé dans votre Moodle.

  2. Dans le code de Moodle modifiez le code du fichier /mod/assign/submission/maharaws/classes/mahara_oauth.php, et mettez en commentaire les lignes suivantes.

    if ($this->http->info['http_code'] != 200) {
          throw new \moodle_exception('webservice call was not successful');
        }
    
  3. Ajoutez les trois lignes suivantes sous votre code mis en commentaire :

    echo $url;
    echo $method;
    echo $params;
    
  4. Définissez Messages de débogage dans Moodle dans Administration du site → Développement sur « DEVELOPER : messages de débogage Moodle supplémentaires pour les développeurs ».

  5. Dans Administration du site → Sécurité → Sécurité HTTP supprimez tous les hôtes présents dans « Liste d’hôtes bloqués pour cURL ».

  6. Ajouter à nouveau l’un après l’autres les hôtes dans « Liste d’hôtes bloqués pour cURL », créez une nouvelle activité « Devoir » qui se connecte à Mahara, et vérifiez si vous obtenez un message d’erreur.

  7. Si vous obtenez un message du type mahara.xxx.xxx/webservice/rest URL bloquée alors vous avez l’hôte qui est bloqué. Supprimez-le de la « Liste d’hôtes bloqués pour cURL ».

  8. Essayez à nouveau l’activité.

  9. Assurez-vous d’ajouter ou de mettre à jour l’hôte sur lequel tourne votre site Mahara dans votre fichier /etc/hosts.

    Note

    Si vous ne vous assurez pas que vous avez la bonne IP hôte dans votre fichier ``hosts`”, vous pouvez voir le message d’erreur suivant : « Erreur lors de la connexion aux services Web de Mahara Vérifiez que l’URL et les informations d’identification OAuth sont correctes et qu’il existe un certificat SSL valide si HTTPS est utilisé. Vérifiez également que les fonctions correctes sont attribuées à l’accès OAuth. »