# Installer les classes virtuelles sur Moodle en LTI

La solution de classes virtuelles BBB est l'un des services proposés par le LCMS[^1] **Marsha** développé par France Université Numérique. Ce guide détaille la procédure d'installation des classes virtuelles en LTI mais peut aussi vous être utile si vous souhaitez utiliser les autres fonctionnalités disponibles : vidéo, webinaire, documents ou leçons au format Markdown[^2].

{% hint style="info" %}
L'installation du plugin LTI est compatible avec les versions 3.x et 4.x de Moodle
{% endhint %}

## **Prérequis**

{% hint style="warning" %}
Avant de vous rendre sur Moodle, vous devez obtenir **un passeport LTI** auprès de France Université Numérique en utilisant [ce formulaire de demande](https://www.fun-mooc.help/hc/fr/requests/new?ticket_form_id=9122250595357) (choisissez l'option "Demande de passeport LTI").

Le passeport doit contenir 2 identifiants OAuth : une [clef client](#user-content-fn-3)[^3] et un [secret partagé](#user-content-fn-4)[^4].
{% endhint %}

## Ajouter un outil externe LTI

En étant connecté comme administrateur sur Moodle, accédez à l'`Administration du site` :

![](https://2457900260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJojXxTIm7j76SIRmngwQ%2Fuploads%2Fgit-blob-b8ef644fc621074f862d55346b411888091cb4e8%2Fadmin-moodle.png?alt=media)

Rendez-vous sur l'onglet `Plugins`, puis cliquez sur `Gérer les outils` sous `Outils externes` :

![](https://2457900260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJojXxTIm7j76SIRmngwQ%2Fuploads%2Fgit-blob-45328104d27f47466f4e6aec123354863502696b%2Fmoodle-outils.png?alt=media)

### **Configuration semi-automatique**

Sur Moodle, il est possible d'ajouter un outil LTI Legacy préconfiguré. Une configuration supplémentaire sera néanmoins nécessaire (voir plus bas).

Pour ajouter cet outil, collez l'URL suivante `https://marsha.education/lti/config.xml` dans le champ `URL de l'outil...` et cliquez sur `Ajouter LTI Legacy`.

![](https://2457900260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJojXxTIm7j76SIRmngwQ%2Fuploads%2Fgit-blob-b456890da8f7bccbafb1c35f4ee9fa220d68d721%2Fmoodle-outils-legacy.png?alt=media)

Un formulaire sera affiché <img src="https://2457900260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJojXxTIm7j76SIRmngwQ%2Fuploads%2Fgit-blob-99ef3c049a40ec1ea78172cb9358183a1e7574f3%2Fkey-secret.png?alt=media" alt="Formulaire dans lequel saisir la clef et le secret" data-size="line">, demandant de renseigner les paramètres suivants :

| Champ          | Valeur                   |
| -------------- | ------------------------ |
| Clef client    | \[dans le passeport LTI] |
| Secret partagé | \[dans le passeport LTI] |

Remplissez-les avec les valeurs trouvées dans le passeport, puis cliquez sur `Enregistrer`.

Marsha sera disponible dans la liste des `Outils` :

![](https://2457900260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJojXxTIm7j76SIRmngwQ%2Fuploads%2Fgit-blob-62b8c9080a0c3d2f8d15e28d5c778ac4a1bac048%2Fmarsha-outils.png?alt=media)

### Configuration supplémentaire

Une configuration supplémentaire est nécessaire.

Cliquez sur la roue crantée <img src="https://2457900260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJojXxTIm7j76SIRmngwQ%2Fuploads%2Fgit-blob-b98ee9b922b094304e6bd40ea35334880b0de505%2Fmoodle-outils-marsha-modifier.png?alt=media" alt="" data-size="line"> sur l'outil Marsha, ce qui va ouvrir une page de `Configuration de l'outil externe` :

<figure><img src="https://2457900260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJojXxTIm7j76SIRmngwQ%2Fuploads%2Fgit-blob-6f43a01fe9896505e809fef5296f0b747a9d67b1%2Fmoodle-config-additionnelle-v2.png?alt=media" alt=""><figcaption><p>Les champs à modifier impérativement se trouvent dans la zone mise en évidence</p></figcaption></figure>

Remplissez le formulaire avec les données suivantes :

| Champ                                      | Valeur                                                                                                                                               |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Utilisation de la configuration de l'outil | Afficher dans le sélecteur d'activité et comme outil préconfiguré                                                                                    |
| Supporte les liens profonds                | Coché                                                                                                                                                |
| URL de sélection de contenu                | `https://marsha.education/lti/select/classroom/` voir [A propos de l'URL de sélection de contenu](#warning-à-propos-de-lurl-de-sélection-de-contenu) |

### Customisation (facultatif)

#### Renommer l'outil

Pour rendre plus explicite l'accès pour les enseignants, vous pouvez modifier les champs `Nom de l'outil` en renseignant par exemple "**Classes virtuelles BBB"** et en modifiant la `Description de l'outil`.

![Exemple de renommage](https://2457900260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJojXxTIm7j76SIRmngwQ%2Fuploads%2Fgit-blob-fc81a148f3c442d2b08a262fa662c6f209e7f3da%2Fmoodle-config-outil-externe.png?alt=media)

#### Modifier l'icône par défaut (facultatif)

Vous voudrez peut-être remplacer l'icône de l'outil LTI par celle-ci : <img src="https://2457900260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJojXxTIm7j76SIRmngwQ%2Fuploads%2Fgit-blob-fcd5aec096b502c0f5736a19208b2fdd70f71b96%2Ffavicon.ico?alt=media" alt="" data-size="line">

Pour ce faire, cliquez sur `Afficher plus...` sous le champ URL de sélection de contenu.

![](https://2457900260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJojXxTIm7j76SIRmngwQ%2Fuploads%2Fgit-blob-e5958e29f1c4538f78f747c62385e36df3f8d917%2Fmoodle-config-afficher_plus.png?alt=media)

Dans les 2 champs qui s'ouvrent, ajouter respectivement ces 2 URL :

| Champ                    | Valeur                                                                                           |
| ------------------------ | ------------------------------------------------------------------------------------------------ |
| URL de l'icône           | `http://raw.githubusercontent.com/bigbluebutton/bigbluebutton/main/docs/static/img/favicon.ico`  |
| URL de l'icône sécurisée | `https://raw.githubusercontent.com/bigbluebutton/bigbluebutton/main/docs/static/img/favicon.ico` |

![](https://2457900260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJojXxTIm7j76SIRmngwQ%2Fuploads%2Fgit-blob-3b445e0b39b66d204c570217167be86e33426801%2Fmoodle-config-ico-bbb.png?alt=media)

L'icône de BigBlueButton sera affichée au niveau de l'outil configuré : <img src="https://2457900260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJojXxTIm7j76SIRmngwQ%2Fuploads%2Fgit-blob-23981cfc3d42ac6be3ccb581088e4697c5af431b%2Fmoodle-custom-icon.png?alt=media" alt="" data-size="line">

### Configuration des cookies

Les cookies sécurisés doivent être activés pour que l'authentification de réponse des liens profonds[^5] fonctionne.

S'ils ne sont pas activés sur votre instance, rendez-vous sur l'entrée `Sécurité HTTP` depuis Administration du site > Général > Sécurité et cochez la case `Cookies sécurisé uniquement` :

![](https://2457900260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJojXxTIm7j76SIRmngwQ%2Fuploads%2Fgit-blob-0a15efc2f53c3daf5aae803bdad8d32e5e962b73%2Fmoodle4-custom-http.png?alt=media)

### Redimensionnement automatique des iframes

Pour améliorer l'affichage et afin que les iframes soient toujours redimensionnées automatiquement, nous vous recommandons d'ajouter un script supplémentaire.

De retour dans la vue admin, onglet `Présentation`, cliquez sur `HTML additionnel` :

Collez le code suivant `Dans HEAD` et sauvegardez la page. `Within HEAD`:

```html
<script src="https://cdn.jsdelivr.net/npm/iframe-resizer@4.3.6/js/iframeResizer.min.js"></script>
<script>
    window.onload = function() {
        iFrameResize({checkOrigin: false}, '#contentframe');
    }
</script>
```

![](https://2457900260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJojXxTIm7j76SIRmngwQ%2Fuploads%2Fgit-blob-a1999e2f37643bed3ceb2a377a673fc85b8f788c%2Fmoodle-config-add-html.png?alt=media)

### :warning: À propos de l'URL de sélection de contenu

{% hint style="warning" %}
Dans ce guide, nous vous proposons d'installer la solution de classes virtuelles BBB avec l'URL de sélection de contenu suivante :

`https://marsha.education/lti/select/classroom/`

L'utilisation de l'URL`https://marsha.education/lti/select/`vous permet au contraire d'intégrer par défaut toutes les ressources disponibles avec le LCMS Marsha.

Vous pouvez aussi, si vous le souhaitez, utiliser uniquement une ressource spécifique en la spécifiant dans l'URL de sélection de contenu. Pour cela, vous devez spécifier la ressource ciblée à la fin de l'URL.
{% endhint %}

<details>

<summary>Liste des ressources disponibles (services LTI proposés avec le LCMS Marsha)</summary>

**`video` : pour héberger et afficher des vidéos** :vhs:

```url
https://marsha.education/lti/select/video/
```

**`webinar` : pour organiser des webinaires** :movie\_camera:

```url
https://marsha.education/lti/select/webinar/
```

**`document` : pour héberger et partager des fichiers** :open\_file\_folder:

```url
https://marsha.education/lti/select/document/
```

**`classroom` : pour organiser des classes virtuelles avec BigBlueButton** :sparkles:

```url
https://marsha.education/lti/select/classroom/
```

**`markdown` : pour créer de leçons au format Markdown** :writing\_hand:

```url
https://marsha.education/lti/select/markdown/
```

**`deposit` : pour collecter des devoirs** :card\_box:

```url
https://marsha.education/lti/select/deposit/
```

</details>

Une fois l'outil configuré avec cette URL spécifique, il suffira de l'ajouter dans le cours pour obtenir uniquement le contenu relatif à cette ressource.

## Utilisation de Moodle par les enseignants

L'outil externe est configuré, les enseignants peuvent l'utiliser ! :tada:

Ce guide est à leur disposition : [Créer votre classe virtuelle depuis le Moodle de votre établissement](https://doc.numerique-esr.fr/guide-dutilisation/creer-votre-classe-virtuelle/depuis-le-moodle-de-votre-etablissement)

[^1]: Gestionnaire de contenus pour l'éducation (ou Learning Content Management System)

[^2]: Markdown est un langage de balisage léger qui permet de formater du texte de manière simple et rapide

[^3]: consumer key

[^4]: shared secret

[^5]: Un "deeplink" est un lien spécifique visant à renvoyer vers une page ou un produit précis, au lieu de rediriger uniquement vers la page d’accueil de l’application.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.numerique-esr.fr/pour-les-dsi/installation-du-plugin-lti-sur-moodle.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.