Moodle

À propos de l'intégration ONLYOFFICE et Moodle

ONLYOFFICE propose un connecteur officiel pour intégrer ONLYOFFICE Docs dans Moodle et modifier les documents joints à un cours d'enseignement. Vous pouvez télécharger le connecteur ONLYOFFICE à partir de la bibliothèque de modules complémentaires Moodle ou sur GitHub.

Pour en savoir plus sur le fonctionnement du connecteur ONLYOFFICE pour Moodle, veuillez consulter notre documentation API .

Vous pouvez également installer le module complémentaire d'intégration Moodle Assign Submission pour ONLYOFFICE. Ce module complémentaire est l'extension du module complémentaire Moodle de base permettant aux utilisateurs d'ajouter une soumission personnalisée du document ONLYOFFICE au format PDF.

Principales caractéristiques
  • Modifier et afficher des documents texte, des classeurs, des présentations et des formulaires.
    Pour en savoir plus sur formulaires, veuillez consulter les guides appropriés de création et remplissage de formulaires.
  • Collaborer sur un document en temps réel: deux modes de collaboration (Strict et Rapide), le mode de Suivi des modifications, commentaires et le chat intégré.
  • Prise en charge de JWT pour l'échange sécurisé afin que personne ne puisse accéder à vos documents sauf celles ayant les privilèges d'accès appropriés.
Formats pris en charge
  • Afficher et modifier: DOCX, XLSX, PPTX, PDF
  • En lecture seule: TXT, CSV
  • À remplir des formulaires: PDF
Toutes les nouveautés de la version 6.0.1

Nouvelles fonctionnalités ajoutées

  • Les modèles de langues fi, he, no, sl sont ajoutés

Fonctionnalités modifiées

  • La problème de l'en-tête JWT est corrigée
  • Suppression de la barre oblique finale dans les adresses URL après la mise à jour

Le journal des modifications complet est disponible ici.

Connecter ONLYOFFICE Docs à Moodle

Exigences
  • ONLYOFFICE Docs (Document Server) 6.1.0 ou version ultérieure (version serveur ou cloud)

    Vous avez besoin d'une instance ONLYOFFICE Docs pouvant être résolue et connectée par Moodle et tout autre client final. L'instance doit envoyer des données en POST directement vers Moodle.

    Veuillez consulter la documentation officielle pour en savoir plus sur l'installation d'ONLYOFFICE Docs.
  • Moodle v4.9 ou version ultérieure
  • Connecteur ONLYOFFICE v4.4.0 convient pour Moodle v4.3.0; v4.3.0 convient pour Moodle v4 < 4.3.0; v4.2.0 convient pour Moodle v3.9 - 3.11
Il est possible d'installer ONLYOFFICE Docs et Moodle sur des ordinateurs différents ou sur la même machine. Dans ce dernier cas, il faut définir un port personnalisé pour ONLYOFFICE Docs puisque par défaut ONLYOFFICE Docs et Moodle utilisent le port 80. Veuillez consulter les instructions appropriées pour Docker, Ubuntu, CentOS, ou Windows.
Installer le connecteur ONLYOFFICE pour Moodle

Le module complémentaire ONLYOFFICE pour Moodle est un module d'activité.

Installer le connecteur ONLYOFFICE à l'aide de la bibliothèque des modules complémentaires Moodle
  1. Connectez-vous à votre instance Moodle en tant qu'administrateur et passez à Site administration > Plugins > Install plugins. (Gestion du site > Plugins > Installer des plugins).
    Si l'emplacement est introuvable, l'installation de modules complémentaires est désactivé sur vitre site.
  2. Activez l'option Install plugins from Moodle plugins directory (Installer des modules complémentaires à partir du répertoire des modules complémentaires de Moodle).
  3. Sélectionnez votre version Moodle actuelle.
  4. Recherchez le module complémentaire ONLYOFFICE document.
  5. Cliquez sur le bouton Install (Installer), ensuite cliquez sur Continue (Continuer).
  6. Confirmez la demande d'installation.
  7. Vérifiez le rapport de validation du module complémentaire.
    Important Choisissez correctement la version Moodle. Le téléchargement et l'installation d'une version du module complémentaire incompatible avec le serveur Moodle peut causer de sérieux problèmes et même le blocage du site Moodle.
Installer le connecteur ONLYOFFICE à l'aide de l'archive .ZIP de GitHub
  1. Téléchargez le connecteur sur GitHub.
  2. Connectez-vous à votre instance Moodle en tant qu'administrateur, passez à la rubrique Site administration (Gestion du site), passez à l'onglet Plugins (Modules complémentaires) et cliquez sur Install plugins (Installer des plugins).
  3. Téléchargez le fichier moodle-mod_onlyofficeeditor-x.x.x.zip file à l'aide du sélecteur de fichier ou glissez-déposez ce fichier dans le champ approprié et cliquez sur le bouton Install plugin from the ZIP file (Installer un module complémentaire à partir du fichier ZIP).
    ONLYOFFICE_connector ONLYOFFICE_connector
  4. Vérifiez le rapport de validation du module complémentaire et cliquez sur Continue (Continuer).
    Lorsque votre répertoire cible n'est pas accessible en écriture, un message d'avertissement s'affichera, par ex. [Erreur] Vérification des droits d'accès en écriture [/var/www/html/moodle/mod]. Dans ce cas, vous pouvez le rendre temporairement accessible en utilisant la commande suivante: 
    sudo chmod -R 777 /var/www/html/moodle

    Ensuite, suivez l'étape 3.

    Une fois le module complémentaire installé, il faut désactiver les autorisations afin de rendre le répertoire inaccessible ensuite. Utilisez la commande suivante:

    sudo chmod -R 0755 /var/www/html/moodle
  5. Cliquez sur Continue (Continuer) sur la page Current release information -> Server checks (Informations sur la version actuelle -> Vérification du serveur).
  6. Cliquez sur Upgrade Moodle database now (Mettre à jour la base de données Moodle maintenant) sur la page Plugins check (Vérification des plugins).
    ONLYOFFICE_connector ONLYOFFICE_connector
  7. Cliquez sur Continue (Continuer) sur la page Upgrading to new version (Mettre à niveau vers la dernière version).
Installer le module complémentaire d'intégration Moodle Assign Submission pour ONLYOFFICE.
Veuillez noter: pour installer le module complémentaire d'intégration Moodle Assign Submission pour ONLYOFFICE il vous faut installer le module complémentaire ONLYOFFICE de base.
  1. Connectez-vous à votre instance Moodle en tant qu'administrateur et passez à Site administration > Plugins > Install plugins. (Gestion du site > Plugins > Installer des plugins).
    Si l'emplacement est introuvable, l'installation de modules complémentaires est désactivé sur vitre site.
  2. Activez l'option Install plugins from Moodle plugins directory (Installer des modules complémentaires à partir du répertoire des modules complémentaires de Moodle).
  3. Sélectionnez votre version Moodle actuelle.
  4. Recherchez le module complémentaire ONLYOFFICE Assign Submission.
  5. Cliquez sur le bouton Install (Installer), ensuite cliquez sur Continue (Continuer).
  6. Confirmez la demande d'installation.
  7. Vérifiez le rapport de validation du module complémentaire.
    Il est important de choisir correctement votre version Moodle. Le téléchargement et l'installation d'une version du module complémentaire incompatible avec le serveur Moodle peut causer de sérieux problèmes et même le blocage du site Moodle.

Vous pouvez également télécharger le module complémentaire sur la page GitHub et l'installer à partir du fichier ZIP.

Configurer le connecteur ONLYOFFICE pour Moodle

Une fois le module complémentaire installé, la page de configuration du module complémentaire s'affichera. Vous pouvez également rechercher ONLYOFFICE document sur la page Plugins overview (Aperçu des modules complémentaires ) et cliquez sur Settings (Paramètres). Sur la page Settings (Paramètres), vous pouvez configurer les paramètres suivants:

  • Saisissez l'adresse utilisée pour accéder au service de modification des documents depuis Moodle dans le champ Document Editing Service address (Adresse du service de modification des documents). C'est un champ obligatoire.
    L'adresse d'ONLYOFFICE Docs doit être accessible sur Moodle et l'adresse de Moodle doit être accessible sur ONLYOFFICE Docs.
  • Indiquez, facultativement, la clé secrète pour signer les données dans le champ Document Server Secret (Clé secrète du document). La clé secrète est utilisée pour valider le jeton JSON sur la demande à la connexion du Document Server. Pour en savoir plus, consultez la documentation API pour configurer JWT du côté ONLYOFFICE Docs.
    À partir de la version de ONLYOFFICE Docs v.7.2, JWT est activé par défaut et la clé secrète est générée automatiquement. Il vous faut également activer la validation du jeton du côté Moodle: recherchez votre clé secrète dans le fichier de configuration ONLYOFFICE Docs, ensuite indiquez la même clé secrète dans les paramètres du connecteur. Pour en savoir plus, consultez la section Activer le jeton JWT pour l'intégration ONLYOFFICE et Moodle.
  • Enable Force Save (Activer la sauvegarde forcée) - une fois cette option désactivée, toutes modifications sont automatiquement sauvegardées en cache de l'éditeur. Une fois activée, toutes modifications apportées au document sont sauvegardées lorsque vous cliquez sur le bouton Save (Enregistrer).
    ONLYOFFICE_configure ONLYOFFICE_configure
  • Configurez, facultativement, les paramètres de personnalisation de l'éditeur en cochant les cases appropriées:
    • Display Chat menu button (Afficher le bouton du menu Chat) - cette option sert à afficher ou à masquer le bouton Chat dans le menu.
    • Display Help menu button (Afficher le bouton du menu Aide) - cette option sert à afficher ou à masquer le bouton Aide dans le menu.
    • Display the header more compact (Vue compacte de l'en-tête) - cette option sert à afficher les boutons d'actions supplémentaires en haut de l'en-tête de l'éditeur à côté du logo ou sur la barre d'outils.
    • Display Feedback & Support menu button (Afficher le bouton du menu Commentaires et assistance) - cette option sert à afficher ou à masquer le bouton Commentaires et assistance dans le menu.
    • Display monochrome toolbar header (Permuter l'affichage de l'en-tête de la barre d'outils en monochrome) - cette option sert à afficher la barre d'outils de l'éditeur en monochrome.
    • Enable plugins (Activer les module complémentaires) - cette option sert à activer/désactiver l'onglet Modules complémentaires dans l'interface des éditeurs.
    • Run document macros (Exécuter une macro du document) - cette option sert à activer/désactiver l'exécution automatique des macros dans un document. Vous pouvez toujours éxecuter les macros manuellement.

Une fois terminé, cliquez sur Save changes (Enregistrer les modifications).

ONLYOFFICE_configure ONLYOFFICE_configure
Veuillez noter: le module complémentaire d'intégration Moodle Assign Submission pour ONLYOFFICE ne nécessite aucune configuration supplémentaire car tous les paramètres sont configurés depuis le module complémentaire de base.
Comment cela fonctionne

L'interaction utilisateur-document se produit à la fois du côté client et du côté serveur.

Les concepts clés mentionnés dans notre documentation sont les suivantes:

Le côté client inclut:

  • Gestionnaire de documents (Document manager) - la liste des documents qui s'affiche dans le navigateur d'utilisateur dans laquelle l'utilisateur peut sélectionner le document nécessaire et manipuler les documents (en fonction d'autorisations attribuées, l'utilisateur peut ouvrir le document en lecture seule ou en écriture, partager des documents avec d'autres utilisateurs).
  • Éditeur de documents (Document editor) - l'interface permettant d'afficher et modifier des documents dotée de fonctionnalités d'édition les plus utilisées, est un moyen par lequel un utilisateur interagit avec le service d'édition de documents.

Le côté serveur inclut:

  • Service de stockage de documents (Document storage service) - le service du serveur pour stocker tous les documents disponibles aux utilisateurs dotés des autorisations d'accès appropriées. Ce service fournit les identifiants de documents et les liens vers ces documents au gestionnaire de documents que l'utilisateur voit dans son navigateur.
  • Service d'édition de documents (Document editing service) - le service du serveur permettant d'afficher et de modifier les documents (lorsque l'utilisateur est doté des autorisations d'accès appropriées). L'interface de l'éditeur de documents sert à accéder à toutes les fonctionnalités du service d'édition de documents.
  • Service de gestion de commandes dans le document (Document command service) - le service du server permettant d'effectuer les commandes supplémentaires à l'aide du service d'édition des documents. editing service.
  • Service de conversion des documents (Document conversion service) - le service du serveur permettant de convertir le document au format Office Open XML approprié (docx pour les documents texte, xlsx pour les feuilles de calcul et pptx pour les présentations) à des fins d'édition ou téléchargement.
  • Service de génération des documents (Document builder service) - le service du serveur permettant de générer facilement un document sans lancer une application de traitement des documents.

Veuillez noter que le serveur de documents ONLYOFFICE comprend l'éditeur de documents, le service d'édition des documents, le service de gestion de commandes dans le document, le service de conversion des documents et le service de génération des documents. Le gestionnaire des documents et le service de stockage des documents sont inclus dans le Serveur Communauté ou doivent être implémentés par les intégrateurs de logiciels qui utilisent le serveur de documents ONLYOFFICE sur propre serveur.

Activer le jeton JWT pour l'intégration ONLYOFFICE et Moodle

Afin de protéger des documents contre un accès non autorisé, les éditeurs ONLYOFFICE utilisent le jeton JSON (JWT). Le jeton est ajouté à la configuration lorsque l'éditeur de documents est initialisé et l'échange de commandes entre les services internes de ONLYOFFICE Docs est effectué. La clé secrète est utilisée pour signer le jeton web JSON et valider le jeton sur demande à ONLYOFFICE Docs.

À partir de la version de ONLYOFFICE Docs v.7.2, JWT est activé par défaut et la clé secrète est générée automatiquement. Il vous faut rechercher votre clé secrète dans le fichier de configuration ONLYOFFICE Docs, ensuite indiquez la même clé secrète dans les paramètres du connecteur.

Étape 1: Recherchez votre clé secrète dans le fichier de configuration ONLYOFFICE Docs

  1. Ouvrez le fichier local.json avec tout éditeur de texte disponible.
    • Pour Linux - /etc/onlyoffice/documentserver/local.json
    • Pour Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
    • Pour Docker - indiquez le conteneur ONLYOFFICE Docs en utilisant la commande docker exec -it <containerID> bash et ouvrez /etc/onlyoffice/documentserver/local.json

    Le fichier local .json doit ressembler à ceci:

    {"services": {"CoAuthoring": {"token": {"enable": {"request": {"inbox": true,"outbox": true},"browser": true}},"secret": {"inbox": {"string": "yoursecret"},"outbox": {"string": "yoursecret"},"session": {"string": "yoursecret"}}}}}
  2. Le paramètre true figure dans trois sections. Cela signifie que la validation du jeton est activée.
    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox
  3. La clé secrète qui a été généré automatiquement figure dans trois sections. Vous pouvez remplacer le secret par défaut par votre propre clé secrète. La clé secrète doit être la même dans toutes trois sections.
    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string
  4. Lorsque vous apportez des modifications, il vous faut les enregistrer et redémarrer les services pour prendre en compte ces modifications. 
    supervisorctl restart all

Étape 2: Indiquez la même clé secrète dans la configuration du connecteur.

Dans la configuration du connecteur, indiquez la même clé secrète dans le champ Secret key (Clé secrète) et enregistrez les paramètres.

Commencer à utiliser ONLYOFFICE Docs au sein de Moodle

Ajouter des opérations à ONLYOFFICE

Pour créer une nouvelle opération pour ONLYOFFICE:

  1. Accédez à la section My Courses (Mes cours) et recherchez le cours nécessaire.
  2. Activez l'option Edit Mode (Modifier le mode) en utilisant le sélecteur dans le coin supérieur droit.
  3. Cliquez sur Add an activity or resource (Ajouter une opération ou un source).
  4. Sélectionnez l'opération sur un document ONLYOFFICE dans la fenêtre contextuelle.
    ONLYOFFICE_editfile ONLYOFFICE_editfile
  5. Saisissez le titre de l'opération, créez, téléchargez et glissez-déposez le document nécessaire de votre ordinateur et cliquez sur le bouton Save and display (Enregistrer et afficher).
    ONLYOFFICE_editfile ONLYOFFICE_editfile

    L'opération peut inclure un fichier vierge .docx, .xlsx, .pptx or .pdf.

Le fichier sera ouvert avec l'éditeur ONLYOFFICE Docs.

ONLYOFFICE_editfile ONLYOFFICE_editfile
Créer et modifier des fichiers

Les activités ONLYOFFICE sont marquées de l'icône ONLYOFFICE_editfile sur la page de cours. Pour ouvrir un document dans l'éditeur ONLYOFFICE Docs, faites un clic sur le titre.

ONLYOFFICE_readfile ONLYOFFICE_readfile

Pour ouvrir l'éditeur au mode d'affichage Plein écran, cliquez sur le bouton Open full screen (Ouvrir en mode plein écran) dans le coin supérieur droit en haut de la fenêtre de l'éditeur.

Ajouter des soumissions
Veuillez noter: le module complémentaire d'intégration Moodle Assign Submission pour ONLYOFFICE sert à créer les formulaires électroniques avancés pour les devoirs Moodle.

Pour ajouter une submission personnalisée du type ONLYOFFICE document au format .pdf,

  1. Accédez à la section My Courses (Mes cours) et recherchez le cours nécessaire.
  2. Activez l'option Edit Mode (Modifier le mode) en utilisant le sélecteur dans le coin supérieur droit.
  3. Cliquez sur Add an activity or resource (Ajouter une opération ou un source).
  4. Sélectionnez l'activité Assignment (Devoir) dans la fenêtre contextuelle.
  5. Sous l'onglet Submission types (Types de soumissions), sélectionnez ONLYOFFICE document. Une fois terminé, le générateur de formulaires (.pdf) deviendra disponible sur la page Assignment creation/editing (Création/modification du devoir)– où vous pouvez créer un formulaire à remplir par les étudiants une fois enregistré.
  6. Cliquez Save and return to course (Enregister et revenir au cours) ou Save and display (Enregistrer et afficher). Le nouveau devoir s'affichera sur la page du cours.
ONLYOFFICE_assignments ONLYOFFICE_assignments
Remplir des formulaires

Pour remplir un formulaire,

  1. Sélectionnez le devoir existant et cliquez Add submission (Ajouter une soumission).
    ONLYOFFICE_assignments ONLYOFFICE_assignments
  2. Le formulaire s'ouvrira au format .pdf (pour Docs v8.0 ou version ultérieure. Pour les versions antérieures, le format .oform est utilisé). Chaque élève reçoit sa copie du formulaire PDF et travaille sur son propre devoir.
  3. Remplissez le formulaire et cliquez sur le bouton Save changes (Enregistrer les modifications).

L'enseignant peut afficher tous les devoirs en cliquant sur le bouton (Afficher toutes les soumissions).

Protéger un fichier avec un mot de passe

C'est possible de protéger des fichiers ONLYOFFICE par un mot de passe afin de prévenir tout l'accès non autorisé. Pour ce faire,

  1. Passez à l'onglet File (Fichier) de la barre d'outils supérieure.
  2. Sélectionnez l'option Protect (Protéger).
  3. Cliquez sur le bouton Add password (Ajouter un mot de passe).
  4. Saisissez le mot de passe dans le champ Password (Mot de passe) et validez-le dans le champ Repeat password (Confirmer le mot de passe) au-dessous, ensuite cliquez sur OK.
    ImportantIl n'est pas possible de récupérer un mot de passe perdu ou oublié. Gardez vos mots de passe dans un endroit sécurisé.

Pour modifier le mot de passe,

  1. Passez à l'onglet File (Fichier) de la barre d'outils supérieure.
  2. Sélectionnez l'option Protect (Protéger).
  3. Cliquez sur le bouton Change password (Modifier un mot de passe).
  4. Saisissez le mot de passe dans le champ Password (Mot de passe) et validez-le dans le champ Repeat password (Confirmer le mot de passe) au-dessous, ensuite cliquez sur OK.

Pour supprimer un mot de passe,

  1. Passez à l'onglet File (Fichier) de la barre d'outils supérieure.
  2. Sélectionnez l'option Protect (Protéger).
  3. Cliquez sur le bouton Delete password (Supprimer un mot de passe).

Pour désactiver la protection,

  1. Passez à la page de modification des opérations.
  2. Ouvrez la section Document permissions (Permissions du document).
  3. Cochez la case Hide Protection tab (Masquer l'onglet Protection).
Gérer des permissions

Un Administrateur/Professeur peut décider si on pourra télécharger ou imprimer des documents à partir de l'éditeur ONLYOFFICE. Pour ce faire, accédez à la section Document permissions (Permissions du document).

ONLYOFFICE_editfile ONLYOFFICE_editfile

Pour modifier la permission d'accès et donner accès en lecture seule:

  1. Ouvrez le document ONLYOFFICE nécessaire.
  2. Passez à More > Permissions (Plus > Permissions).
  3. Recherchez l'élément Edit ONLYOFFICE document activity/View ONLYOFFICE document activity (Modifier les opérations sur un document ONLYOFFICE/Afficher les opérations sur un document ONLYOFFICE).
  4. Ajoutez les rôles nécessaires sous la rubrique Prohibited (Interdit) ou supprimez les rôles inutiles sous la rubrique Roles with permission (Rôles avec des permissions).
ONLYOFFICE_editfile ONLYOFFICE_editfile

Pour apprendre comment marquer des documents en tant que favori dans l'éditeur, veuillez suivre les instructions dans cet article.

Hébergez ONLYOFFICE Docs sur votre serveur ou utilisez dans le cloud

Obtenir maintenantUtiliser dans le cloud
Articles avec le tag :
Parcourir tous les tags