Passa al contenuto principale

Chamilo

Informazioni sull'integrazione di ONLYOFFICE e Chamilo​

ONLYOFFICE offre un connettore ufficiale per integrare ONLYOFFICE Docs con Chamilo e modificare documenti di office all'interno della libreria dei documenti. Puoi scaricare il connettore ONLYOFFICE dalla pagina GitHub.

note

Per saperne di più sul funzionamento del connettore ONLYOFFICE per Chamilo, visita la nostra documentazione API.

Funzionalità principali​

  • Modifica e visualizzazione di documenti di testo, fogli di calcolo, presentazioni e moduli PDF.
  • Co-modifica dei documenti in tempo reale: due modalità di co-modifica (Veloce e Rigorosa), la modalità Revisione delle modifiche, i commenti e la chat integrata.
  • Supporto JWT per proteggere il tuo traffico in modo che nessuno possa accedere ai tuoi documenti, ad eccezione degli utenti con i diritti appropriati.

Formati supportati​

  • Per la modifica: DOCX, XLSX, PPTX, PPSX, modulo PDF
  • Solo per la visualizzazione: PDF, DJVU, TXT, CSV, ODT, ODS, ODP, DOC, XLS, PPT, PPS, EPUB, RTF, HTML, HTM, MHT, XPS

Novità della versione 1.5.0​

Aggiunto

  • Supporto per i percorsi di apprendimento

Modificato

  • Correzioni minori

Il changelog completo è disponibile qui.

Collegare ONLYOFFICE Docs a Chamilo​

Requisiti​

  • ONLYOFFICE Document Server v6.2 (versione server o cloud) o successiva

    Hai bisogno di un'istanza di ONLYOFFICE Docs risolvibile e raggiungibile sia da Chamilo sia da qualsiasi client finale. Deve poter inviare richieste POST direttamente a Chamilo.

    note

    Consulta la pagina della documentazione ufficiale per saperne di più sull'installazione di ONLYOFFICE Docs.

  • Chamilo v1.11.16 o successiva

note

ONLYOFFICE Docs e Chamilo possono essere installati su computer diversi o sulla stessa macchina. Se scegli quest'ultima soluzione, configura una porta personalizzata per ONLYOFFICE Docs, poiché per impostazione predefinita sia ONLYOFFICE Docs sia Chamilo funzionano sulla porta 80. Consulta le istruzioni corrispondenti per Docker, Ubuntu, CentOS o Windows.

Installare il connettore ONLYOFFICE per Chamilo​

A partire da Chamilo v1.11.16, il connettore ONLYOFFICE è preinstallato. Per abilitarlo, esegui i seguenti passaggi:

  1. Vai alla pagina Administration (Amministrazione) di Chamilo e scegli la sezione Plugins nel blocco Portal (Portale).
  2. Nell'elenco dei plugin, seleziona il plugin ONLYOFFICE e fai clic sul pulsante Enable the selected plugins (Abilita i plugin selezionati).

Connettore ONLYOFFICE

note

Se la tua versione di Chamilo è precedente alla 1.11.16, segui queste istruzioni per installare il connettore ONLYOFFICE:

  1. Scarica il connettore dalla pagina GitHub.
  2. Vai su Administration (Amministrazione) di Chamilo, scegli Plugins e fai clic sul pulsante Upload plugin (Carica plugin).
  3. Carica il file onlyoffice.zip. Vedrai l'elenco dei plugin.
  4. Avvia composer install dal terminale nella cartella root di Chamilo.
  5. Torna all'elenco dei plugin, seleziona il plugin ONLYOFFICE e fai clic su Enable (Abilita).

Aggiornare il connettore ONLYOFFICE per Chamilo​

Per aggiornare il connettore all'ultima versione, devi sostituire la cartella del plugin predefinito preinstallato con il plugin appena compilato.

Passaggio 1: prepara la cartella con la nuova versione del connettore.

  • Puoi scaricarlo dalla pagina GitHub e decomprimere l'archivio:

    cd /tmp && wget https://github.com/ONLYOFFICE/onlyoffice-chamilo/releases/download/vX.X.X/onlyoffice.zip

    Dove vX.X.X è la versione del connettore necessaria.

    unzip onlyoffice.zip

  • In alternativa, puoi compilare il connettore:

    1. Ottieni l'ultima versione di questo repository eseguendo il comando:

      git clone https://github.com/ONLYOFFICE/onlyoffice-chamilo
      cd onlyoffice-chamilo

    2. Ottieni un sottomodulo:

      git submodule update --init --recursive

    3. Ottieni le dipendenze del plugin:

      composer install

    4. Raccogli tutti i file:

      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*

Passaggio 2: rimuovi la vecchia cartella del connettore.

  1. Apri il terminale nella cartella root.

  2. Rimuovi la cartella con il seguente comando:

    rm -rf /var/www/html/chamilo-x.x.x/plugin/onlyoffice

    Dove chamilo-x.x.x è la tua versione di Chamilo.

Passaggio 3: sposta la nuova cartella del connettore nella directory chamilo-x.x.x/plugin/.

  1. Apri il terminale nella cartella root.

  2. Sposta la cartella con i seguenti comandi:

    cp -r /tmp/onlyoffice-deploy/onlyoffice /var/www/html/chamilo-x.x.x/plugin/

    Dove chamilo-x.x.x è la tua versione di Chamilo.

Configurare il connettore ONLYOFFICE per Chamilo​

Nella pagina Plugins, trova ONLYOFFICE e fai clic su Configure (Configura). Vedrai la pagina Settings (Impostazioni) in cui puoi configurare i seguenti parametri:

  • Inserisci l'indirizzo utilizzato per accedere al Document Editing Service da Chamilo nel campo Document Editing Service address (Indirizzo del Document Editing Service).

    Importante

    L'indirizzo di ONLYOFFICE Docs deve essere accessibile da Chamilo, così come l'indirizzo di Chamilo deve essere accessibile da ONLYOFFICE Docs.

  • Specifica il segreto utilizzato per firmare i dati nel campo Secret Key (Chiave segreta).

    note

    A partire da ONLYOFFICE Docs v7.2, JWT è abilitato per impostazione predefinita e la chiave segreta viene generata automaticamente. Devi abilitarlo anche lato Chamilo: trova la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs, quindi specifica la stessa chiave segreta nelle impostazioni del connettore. Per maggiori dettagli, consulta la sezione Abilitare JWT per l'integrazione di ONLYOFFICE e Chamilo di questo articolo.

Configurazione di ONLYOFFICE

Come funziona​

L'integrazione di ONLYOFFICE segue l'API documentata qui.

  1. Per creare un nuovo file, l'insegnante apre la cartella necessaria e fa clic sull'icona ONLYOFFICE Create new (Crea nuovo).

  2. L'utente viene reindirizzato alla pagina di creazione del file, dove deve inserire il nome e il formato del file (documento di testo, foglio di calcolo o presentazione). Il browser richiama il metodo /plugin/onlyoffice/create.php, che aggiunge una copia di un file vuoto alla cartella del corso.

  3. Per aprire un file esistente, l'utente sceglie l'icona Open with ONLYOFFICE (Apri con ONLYOFFICE).

  4. La richiesta viene inviata a /plugin/onlyoffice/editor.php?docId="document identificator". Il server elabora la richiesta e genera la configurazione di inizializzazione dell'editor con le seguenti proprietà:

    • url: l'URL che ONLYOFFICE Docs utilizza per scaricare il documento;
    • callbackUrl: l'URL che ONLYOFFICE Docs utilizza per informare sullo stato della modifica del documento;
    • documentServerUrl: l'URL a cui il client deve rispondere per ONLYOFFICE Docs (può essere impostato nella pagina delle impostazioni di amministrazione);
    • key: l'etag per indicare a ONLYOFFICE Docs se scaricare nuovamente il documento o meno.

  5. Il server restituisce una pagina con uno script per aprire l'editor.

  6. Il browser apre questa pagina e carica l'editor.

  7. Il browser effettua una richiesta a ONLYOFFICE Docs e gli passa la configurazione del documento.

  8. ONLYOFFICE Docs carica il documento e l'utente inizia a modificarlo.

  9. ONLYOFFICE Docs invia una richiesta POST a callbackUrl per informare Chamilo che l'utente sta modificando il documento.

  10. Quando tutti gli utenti hanno terminato la modifica, chiudono la finestra dell'editor.

  11. Dopo 10 secondi, ONLYOFFICE Docs effettua una richiesta POST a callbackUrl per notificare che la sessione di modifica è terminata e invia un link alla nuova versione del documento.

  12. Chamilo carica la nuova versione del documento e sovrascrive il file.

Abilitare JWT per l'integrazione di ONLYOFFICE e Chamilo​

Per proteggere i documenti dagli accessi non autorizzati, gli editor ONLYOFFICE utilizzano il JSON Web Token (JWT). Il token viene aggiunto alla configurazione quando l'editor di documenti viene inizializzato e durante lo scambio di comandi tra i servizi interni di ONLYOFFICE Docs. La chiave segreta viene utilizzata per firmare il token web JSON e convalidare il token al momento della richiesta a ONLYOFFICE Docs.

A partire da ONLYOFFICE Docs v7.2, JWT è abilitato per impostazione predefinita e la chiave segreta viene generata automaticamente. Devi trovare la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs, quindi specificare la stessa chiave segreta nelle impostazioni del connettore.

Passaggio 1: trova la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs

  1. Apri il file local.json con un qualsiasi editor di testo disponibile.

    • Per Linux - /etc/onlyoffice/documentserver/local.json

    • Per Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json

    • Per Docker: accedi al container di ONLYOFFICE Docs con il comando docker exec -it <containerID> bash e apri /etc/onlyoffice/documentserver/local.json

      In alternativa, puoi usare il seguente comando per trovare la chiave segreta predefinita senza aprire local.json:

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

    Il file local.json dovrebbe avere questo aspetto:

    {
      "services": {
        "CoAuthoring": {
          "token": {
            "enable": {
              "request": {
                "inbox": true,
                "outbox": true
              },
              "browser": true
            }
          },
          "secret": {
            "inbox": {
              "string": "yoursecret"
            },
            "outbox": {
              "string": "yoursecret"
            },
            "session": {
              "string": "yoursecret"
            }
          }
        }
      }
    }

  2. Il valore true è specificato in tre sezioni. Significa che la convalida del token è abilitata.

    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox

  3. La chiave segreta generata automaticamente è specificata in tre sezioni. Puoi sostituire il valore segreto predefinito con la tua chiave segreta. La chiave segreta deve essere la stessa in tutte e tre le sezioni.

    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string

  4. Se apporti modifiche, salvale e riavvia i servizi affinché le modifiche alla configurazione abbiano effetto.

    supervisorctl restart all

Passaggio 2: specifica la stessa chiave segreta nelle impostazioni del connettore

Nelle impostazioni del connettore, specifica la stessa chiave segreta nel campo Secret key (Chiave segreta) e salva le impostazioni.

Disabilitare il connettore ONLYOFFICE per Chamilo​

Se hai bisogno di disabilitare il connettore ONLYOFFICE:

  1. Nella pagina Plugins, trova ONLYOFFICE e fai clic su Configure (Configura).
  2. Seleziona la casella No nella sezione Enable (Abilita).

Iniziare a usare ONLYOFFICE Docs in Chamilo​

Per aprire un documento per la modifica con gli editor di ONLYOFFICE Docs:

  1. Apri la cartella con il file necessario.
  2. Fai clic sull'icona Icona di modifica ChamiloOO Edit in ONLYOFFICE (Modifica in ONLYOFFICE) per aprire il file nell'editor per la modifica.

Il documento verrà aperto nell'editor di ONLYOFFICE Docs.

Modifica del file in ONLYOFFICE

Per impostare il permesso del documento su sola lettura:

  1. Trova il documento necessario.
  2. Fai clic sull'icona Icona di modifica Chamilo Edit (Modifica).
  3. Nella pagina che si apre, seleziona la casella Read only (Sola lettura).
  4. Fai clic sul pulsante Save document (Salva documento).

Lettura del file in ONLYOFFICE

note

Per saperne di più sui problemi più comuni e sui modi per risolverli, visita la nostra guida alla risoluzione dei problemi.