13.5. Configuration dans Canvas

Vous pouvez configurer une connexion LTI vers Mahara globalement pour tous les cours ou pour un cours Canvas particulier.

L’avantage de configurer la connexion pour l’entier du serveur Canvas est que les enseignants n’ont alors pas configurer la connexion eux-mêmes et de ce fait tout le monde se connecte au même Mahara, dans la même institution.

Si vous désirez conserver plus du contrôle notamment accéder à une institution différente en fonction du cours, configurez la connexion LTI à l’intérieur de celui-ci.

Vous pouvez décider de créer une connexion via l’Edu App Center ou par une configuration manuelle. La configuration manuelle vous permet d’afficher Mahara dans une nouvelle fenêtre, alors qu’en passant par l’Edu App Center, celle-ci s’affichera dans le cours Canvas.

13.5.1. Utilisation de l’Edu App Center

Lorsque vous utilisez l’Edu App Center pour créer un connexion avec Mahara, ce dernier s’affiche dans un iframe sur la page de Canvas. Ceci réduit considérablement l’espace de travail dans Mahara. De plus, vous aurez toujours affichés les outils de navigation de Canvas, ce qui peut créer un peu de confusion parmi les utilisateurs.

Avertissement

Pour des raisons de sécurité, Mahara a un système qui l’empêche d’être inclur en tant qu’iframe dans un autre site web. Si vous désirez toutefois absolument utiliser l’Edu App Center pour configurer une connexion LTI (la connexion manuelle ne prend qu’un tout petit plus de temps), vous devez désactiver une option de sécurité dans Mahara, ce qui n’est pas recommandé. Pour faire cela, vous devez ajouter la commande $cfg->sameoriginframes = false;` dans votre fichier config.php.

Voir aussi

Si vous désirez voir s’afficher Mahara dans une nouvelle fenêtre, il vous faut suivre les instructions données ici.

Choose Mahara from the Edu App Center

Sélectionner Mahara dans l’Edu App Center

  1. Cliquez sur Paramètres dans votre site Canvas ou au niveau du cours.

    Note

    Si vous choisissez de mettre le lien dans votre site, tous les cours verront le lien s’afficher dans le menu de navigation. Si vous décidez de mettre le lien seulement dans certains cours, seuls les participants à ces cours pourront accéder à leur compte sur Mahara.

  2. Cliquez sur l’onglet Apps. Vous avez alors accès à l’Edu App Center.

  3. Rechercher « mahara » dans la rubrique de recherche.

  4. Cliquez sur l’app Mahara qui vous est affichée. Vous accédez alors à un écran qui propose plus d’informations sur l’application elle-même.

  5. Cliquez sur le bouton Ajouter app pour commencer la configuration.

Afin d’ajouter une connexion vers Mahara, vous devez configurer Canvas comme outil externe dans Mahara pour votre institution. Sans cette étape préalable vous n’aurez pas de clé client ni de clé partagée pour la configuration de votre connexion.

Configure Mahara via the Edu App Center

Configurer Mahara via l’Edu App Center

  1. Nom : Vous pouvez choisir le nom que vous voulez. C’est ce nom qui sera affiché dans le menu de navigation.

  2. Clé client : Copiez et collez la clé client créée par Mahara sur la page de configuration de la connexion LTI que vous avez faite précédemment.

  3. Secret partagé : Copiez et collez le secret partagé créé par Mahara sur la page de configuration de la connexion LTI que vous avez faite précédemment.

  4. URL de lancement : Collez l’URL de votre site Mahara.

  5. Cliquez sur le bouton Ajouter app pour terminer la configuration.

  6. Cliquez sur le bouton Fermer ou sur l’icône Fermer pour annuler la configuration de connexion.

  7. L’app apparaît alors dans le menu de navigation lorsque vous rechargez la page.

  8. Cliquez sur l’app pour être authentifié et connecté à votre instance Mahara.

    Note

    Si vous avez déjà un compte dans votre institution Mahara avec la même adresse de courriel dans Canvas, vous vous retrouvez avec ce compte utilisateur dans Mahara.

    Si votre adresse courriel n’existe pas encore dans Mahara et que vous avez autorisé la création automatique des comptes, un compte est créé pour vous dans Mahara.

    Si votre adresse courriel existe déjà dans l’instance Mahara mais que vous n’êtes pas membre de l’institution sur laquelle le lien LTI devrait vous amener, vous recevez un message d’erreur vous informant que vous devez d’abord devenir membre de cette institution avant de pouvoir utiliser le lien LTI depuis Canvas.

13.5.2. Configuration manuelle

La configuration manuelle d’une connexion vers Mahara est aussi très simple.

Choose to set up Mahara manually

Choisissez de configuration manuellement Mahara

  1. Cliquez sur Paramètres dans votre site Canvas ou au niveau du cours.

    Note

    Si vous choisissez de mettre le lien dans votre site, tous les cours verront le lien s’afficher dans le menu de navigation. Si vous décidez de mettre le lien seulement dans certains cours, seuls les participants à ces cours pourront accéder à leur compte sur Mahara.

  2. Cliquez sur l’onglet Apps

  3. Cliquez sur le bouton Afficher les configurations des app

  4. Cliquez sur le bouton App pour ajouter votre instance Mahara manuellement.

Ajoutez les détails de votre instance Mahara dans la fenêtre surgissante.

Configure the connection to Mahara

Configurer la connexion à Mahara

  1. Type de configuration : Sélectionnez « Par URL ». Les paramètres de configuration sont disponibles dans votre instance Mahara.

  2. Nom : Vous pouvez choisir le nom que vous voulez. C’est ce nom qui sera affiché dans le menu de navigation.

  3. Clé client : Copiez et collez la clé client créée par Mahara sur la page de configuration de la connexion LTI que vous avez faite précédemment.

  4. Secret partagé : Copiez et collez le secret partagé créé par Mahara sur la page de configuration de la connexion LTI que vous avez faite précédemment.

  5. URL de config : Collez l’URL de votre instance Mahara en y ajoutant à la fin /module/lti/configxml.php.

  6. Cliquez sur le bouton Envoyer pour terminer la configuration.

  7. Cliquez sur le bouton Annuler ou l’icône Fermer pour annuler la configuration.

  8. You are taken to the « External Apps » page.

You will need to add a custom parameter in order to use the assignment submission functionality.

Make changes to the LTI setup

Make changes to the LTI setup

  1. Next to the app that you just created, click the Configure button.

  2. Select the Edit option.

Now you can enter the additional parameter without which the connection cannot be established properly.

Edit the LTI configuration in Canvas

Edit the LTI configuration in Canvas

  1. Name: The name of your external application.

  2. Consumer Key: Review or change the consumer key here that you have from your Mahara instance.

  3. Shared Secret: That is the « Consumer secret » on Mahara. If it has changed, update it here.

  4. Launch URL: The launch URL is the domain of your Mahara instance with /webservice/rest/server.php at the end of it.

    Note

    This URL is different from the one that you entered when setting up the connection. That is correct. When you set up the connection, you need to use /module/lti/configxml.php for Canvas to complete the setup properly.

  5. Domain: Do not enter anything here.

  6. Privacy: Leave this set to « Public ».

  7. Custom Fields: Add wsfunction=module_lti_launch here so that the assignment submission process works.

  8. Description: You can leave the default text here.

  9. Cliquez sur le bouton Envoyer pour terminer la configuration.

  10. Cliquez sur le bouton Annuler ou l’icône Fermer pour annuler la configuration.

  11. You are taken to the « External Apps » page.

  12. L’app apparaît alors dans le menu de navigation lorsque vous rechargez la page.

  13. Cliquez sur l’app pour être authentifié et connecté à votre instance Mahara.

    Note

    Si vous avez déjà un compte dans votre institution Mahara avec la même adresse de courriel dans Canvas, vous vous retrouvez avec ce compte utilisateur dans Mahara.

    Si votre adresse courriel n’existe pas encore dans Mahara et que vous avez autorisé la création automatique des comptes, un compte est créé pour vous dans Mahara.

    Si votre adresse courriel existe déjà dans l’instance Mahara mais que vous n’êtes pas membre de l’institution sur laquelle le lien LTI devrait vous amener, vous recevez un message d’erreur vous informant que vous devez d’abord devenir membre de cette institution avant de pouvoir utiliser le lien LTI depuis Canvas.

13.5.3. Set up an assignment in Canvas

Prerequisite: You have set up the connection to Mahara already via the setup instructions.

In Canvas you can set up the LTI assignment submission as part of the assignment functionality.

Add an assignment to your Canvas course

Add an assignment to your Canvas course

  1. In your course navigation, click the Assignments navigation item.

  2. On the resulting page, click the Assignment button to set up a new assignment.

Note

You can add the assignment to a group of assignments as you wish.

Assignment settings for your LTI activity

Assignment settings for your LTI activity

  1. Once you created an assignment, you can change its paramenters, including the assignment name.

  2. Provide a description or task for the assignment.

  3. Points: Enter « 100 » here as LTI expects a scale from 0 to 100.

  4. Display Grade as: Decide how you want to display the final grade for the assignment.

  5. Submission type: Select « External Tool » from the drop-down menu.

  6. Click the Find button to see all external tools that are available in your course and select the Mahara one. Click the Save button to confirm your selection.

  7. Load This Tool In A New Tab: Tick this check box if you want to load Mahara in a new tab. Note that there is no navigation visible on the Mahara submission screens because they are meant to be embedded in the assignment activity.

  8. Click the Save button if you want to save an preview your assignment or click the Save & Publish button if you are ready to take the assignment live. Click the Cancel button to abort setting up the activity.

  9. Click the activity name or button to finalize the assessment settings. Learners are not able to use the activity until these settings have been saved.