Articles avec le tag :
Fermer
Changelog
Fermer
Essayer dans le cloud
Essayer dans le cloud
Centre d'aide
l'intégration

À propos de l'intégration de ONLYOFFICE et Chamilo

ONLYOFFICE offre un connecteur officiel pour intégrer ONLYOFFICE Docs dans Chamilo et modifier les documents de la bibliothèque. Vous pouvez télécharger le connecteur ONLYOFFICE à partir de la page sur GitHub.

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

Principales caractéristiques

  • Modifier et afficher les documents texte, les feuilles de calcul et les présentations.
  • Modifier un document en collaboration en temps réel : deux modes de collaboration (Strict et Rapide), le mode de Suivi des modifications, commentaires et un 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

  • À modifier et afficher : DOCX, PPTX, XLSX

Toutes les nouveautés de la version 1.1.2

Ajouté

  • Filtrage sécurisé
  • Option d'affichage des formats DOCX, XLSX, PPTX
  • Prise en charge de JWT

Modifié

  • Améliorations mineures du style de documentation
  • Améliorations mineures du style de code

Le journal des modifications complet est disponible ici.

Connecter ONLYOFFICE Docs à Chamilo

Exigences

  • ONLYOFFICE Docs (Document Server) 6.2 ou version ultérieure

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

    Veuillez consulter la documentation officielle pour en savoir plus sur l'installation de ONLYOFFICE Docs.

    Vous pouvez également utiliser ONLYOFFICE Docs Cloud (version SaaS).

  • Chamilo v1.11.14 ou version ultérieure
ONLYOFFICE Docs et Chamilo peuvent être installés sur différents ordinateurs 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 Chamilo utilisent le port 80. Veuillez suivre les instructions respectives pour Docker, Ubuntu, CentOS ou Windows.

Installer le connecteur ONLYOFFICE pour Chamilo

À partir de la version Chamilo v1.11.16 le connecteur ONLYOFFICE est préinstallé. Pour l'activer, procédez comme suit :

  1. Accédez à la page Administration de Chamilo et sélectionnez Plugins dans le bloc Portail.
  2. Dans la liste de plug-ins, sélectionnez ONLYOFFICE et cliquez sur le bouton Activer les plugins sélectionnés.
ONLYOFFICE_connector ONLYOFFICE_connector

Si votre version Chamilo est antérieure à la version 1.11.16, veuillez suivre ces instructions pour installer le connecteur ONLYOFFICE :

  1. Téléchargez le connecteur à partir de la page sur GitHub.
  2. Accédez à la page Administration de Chamilo, sélectionnez Plugins et cliquez sur le bouton Télécharger plugin.
  3. Téléchargez le fichier onlyoffice.zip. La liste des plug-ins s'affiche.
  4. Lancez composer install en utilisant le terminal du dossier racine Chamilo.
  5. Revenez à la liste des plug-ins, sélectionnez le plug-in ONLYOFFICE et cliquez sur Activer.

Mettre à jour le connecteur ONLYOFFICE pour Chamilo

Pour mettre à jour vers la dernière version, il faut remplacer le plug-in préinstallé par défaut par le plug-in dernier.

Étape 1 : préparez le dossier contenant la version récente du connecteur.

  • Vous pouvez le télécharger à partir de la page GitHub et décompresser l'archive :
    cd /tmp && wget https://github.com/ONLYOFFICE/onlyoffice-chamilo/releases/download/vX.X.X/onlyoffice.zip

    Où vX.X.X est la version appropriée du connecteur.

    unzip onlyoffice.zip
  • À titre subsidiaire, vous pouvez collecter le connecteur :
    1. Obtenez la dernière version du référentiel en exécutant la commande :
      git clone https://github.com/ONLYOFFICE/onlyoffice-chamilo
      cd onlyoffice-chamilo
    2. Obtenez le sous-module :
      git submodule update --init --recursive
    3. Recueillez tous les fichiers :
      mkdir /tmp/onlyoffice-deploy
      mkdir /tmp/onlyoffice-deploy/onlyoffice
      cp -r ./ /tmp/onlyoffice-deploy/onlyoffice
      cd /tmp/onlyoffice-deploy/onlyoffice
      rm -rf ./.git*
      rm -rf */.git*
                                       

Étape 2 : supprimez l'ancien dossier de connecteur :

  1. Ouvrez le terminal dans le répertoire racine.
  2. Supprimez le dossier en utilisant la commande suivante :
    rm -rf /var/www/html/chamilo-x.x.x/plugin/onlyoffice

    chamilo-x.x.x est votre version de Chamilo.

Étape 3 : déplacez le nouveau dossier de connecteur au répertoire chamilo-x.x.x/plugin/.

  1. Ouvrez le terminal dans le répertoire racine.
  2. Déplacez le dossier en utilisant la commande suivante :
    cp -r /tmp/onlyoffice-deploy/onlyoffice /var/www/html/chamilo-x.x.x/plugin/

    chamilo-x.x.x est votre version de Chamilo.

Configurer le connecteur ONLYOFFICE pour Chamilo

À la page Plugins trouvez ONLYOFFICE et cliquez sur Configurer. À la page Paramètres configurez les paramètres suivants :

  • Saisissez l'adresse utilisée pour accéder au Service de modification de documents depuis Chamilo dans le champ Adresse du Service de modification de documents.
    ImportantL'adresse de ONLYOFFICE Docs doit être accessible depuis Chamilo, ainsi que l'adresse de Chamilo doit être accessible depuis ONLYOFFICE Docs.
  • Indiquez la clé secrète utilisée pour signer les données dans le champ Clé secrète.
    À partir de la version ONLYOFFICE Docs v7.2 le jeton JWT est activé par défaut et la clé secrète est générée automatiquement. Vous devez également l'activer du côté de Chamilo : trouvez votre propre clé secrète dans le fichier de configuration ONLYOFFICE Docs et ensuite spécifiez la même clé secrète aux paramètres du connecteur. Pour en savoir plus, consultez la section de l'article Activer le jeton JWT pour intégrer ONLYOFFICE et Chamilo.
ONLYOFFICE_configure ONLYOFFICE_configure

Activer le jeton JWT pour intégrer ONLYOFFICE et Chamilo

Afin de protéger les documents de tout accès non autorisé, les éditeurs ONLYOFFICE utilisent le jeton JSON Web Token (JWT). Le jeton est ajouté à la configuration lors de l'initialisation de l'Éditeur de Documents et lors de l'échange de commandes entre les services internes de ONLYOFFICE Docs. La clé secrète est utilisée pour signer le jeton JSON et valider le jeton sur la demande à la connexion de ONLYOFFICE Docs.

À partir de la version ONLYOFFICE Docs v7.2 le jeton JWT est activé par défaut et la clé secrète est générée automatiquement. Vous avez besoin de trouver votre propre clé secrète dans le fichier de configuration ONLYOFFICE Docs et ensuite de spécifier la même clé secrète aux paramètres du connecteur.

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

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

      À titre subsidiaire, vous pouvez utiliser la commande suivante pour trouver la clé secrète par défaut sans ouvrir local.json :

      sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

    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. La valeur true est spécifiée 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 générée automatiquement est spécifiée dans trois sections. Vous pouvez remplacer la valeur secrète par défaut avec votre propre clé secrète. La clé secrète doit être identique dans trois sections.
    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string
  4. Si vous apportez des modifications, enregistrez-les et redémarrez les services pour que les modifications de configuration prennent effet.
    supervisorctl restart all

Étape 2 : Spécifier la même clé secrète aux paramètres du connecteur

Spécifiez la même clé secrète aux paramètres du connecteur dans le champ Clé secrète et enregistrez les paramètres.

Désactiver le connecteur ONLYOFFICE pour Chamilo

Si vous souhaitez désactiver le connecteur ONLYOFFICE :

  1. À la page Plugins trouvez ONLYOFFICE et cliquez sur Configurer.
  2. Cochez Non dans la section Activer.

Commencer à utiliser ONLYOFFICE Docs au sein de Chamilo

Pour ouvrir un document avec l'éditeur ONLYOFFICE Docs :

  1. Ouvrez le dossier contenant le fichier nécessaire :
  2. Cliquez sur l'icône ChamiloOO edit icon Modifier dans ONLYOFFICE afin d'ouvrir le fichier dans l'éditeur pour apporter des modifications.

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

ONLYOFFICE_editfile ONLYOFFICE_editfile

Pour modifier les autorisations d'accès et donner accès en lecture seule :

  1. Trouvez le document nécessaire.
  2. Cliquez sur l'icône Chamilo edit icon Modifier.
  3. Sur la page qui s'affiche, activez l'option Lecture seule.
  4. Cliquez sur le bouton Enregistrer le document.
ONLYOFFICE_readfile ONLYOFFICE_readfile
Download Best editors on your website Let your site users view, edit and collaborate
on all types of text, spreadsheet and presentation files
Cela peut vous aider aussi :
Fermer