Plone

Caratteristiche principali

• Creazione, modifica e visualizzazione di documenti di testo, fogli di calcolo e presentazioni.
• Co-editing dei documenti in tempo reale: due modalità di co-editing (Veloce e Rigida), modalità Traccia Modifiche, commenti e chat integrata.
• Supporto JWT per proteggere il tuo traffico in modo che nessuno possa accedere ai tuoi documenti, eccetto gli utenti con i diritti appropriati.

Formati supportati

• Per la modifica: DOCX, XLSX, PPTX, DOCXF, OFORM
• Per la visualizzazione: DJVU, DOC, DOCM, DOCX, DOCXF, DOT, DOTM, DOTX, EPUB, FB2, FODT, HTML, MHT, ODT, OTT, OXPS, PDF, RTF, TXT, XPS, XML, OFORM, CSV, FODS, ODS, OTS, XLS, XLSB, XLSM, XLSX, XLT, XLTM, XLTX, FODP, ODP, OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX
• Per la conversione (scarica come): DOC, DOCM, DOCX, DOCXF, DOT, DOTM, DOTX, EPUB, FB2, FODT, HTML, MHT, ODT, OTT, OXPS, PDF, RTF, XPS, XML, OFORM, FODS, ODS, OTS, XLS, XLSB, XLSM, XLSX, XLT, XLTM, XLTX, FODP, ODP, OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX
• Per la conversione in Office Open XML: DOC, DOCM, DOCXF, DOT, DOTM, DOTX, EPUB, FB2, FODT, HTML, MHT, ODT, OTT, OXPS, PDF, RTF, XPS, XML, FODS, ODS, OTS, XLS, XLSB, XLSM, XLT, XLTM, XLTX, FODP, ODP, OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM

Novità nella versione 4.0.0

Aggiunto

• Aggiunto supporto per Plone 6.

Il registro completo delle modifiche è disponibile qui.

Requisiti

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

  Hai bisogno di un'istanza di ONLYOFFICE Docs che sia risolvibile e connettibile sia da Plone che da qualsiasi client finale. Deve essere in grado di inviare POST direttamente a Plone.

  Consulta la pagina di documentazione ufficiale per saperne di più sull'installazione di ONLYOFFICE Docs.
• Python 3.4 e successivi
• Plugin di integrazione ONLYOFFICE 3.0.1 o successivo per Plone

Installazione del plugin di integrazione ONLYOFFICE per Plone

L'integrazione ONLYOFFICE per Plone è distribuita come un componente aggiuntivo standard di Plone. Il metodo di installazione raccomandato è tramite Buildout.

1. Aggiungi il plugin a Buildout.

   Apri il file buildout.cfg della tua istanza Plone e aggiungi onlyoffice.plone alla sezione eggs:

   [buildout] ... eggs = onlyoffice.plone

2. Esegui Buildout.

   Applica le modifiche eseguendo buildout dalla riga di comando come utente non superuser:

   sudo -u plone_buildout /plone/zinstance/bin/buildout

3. Riavvia l'istanza Plone.

   Riavvia la tua istanza Plone per caricare il componente aggiuntivo appena installato:

   sudo /plone/zinstance/bin/instance restart

4. Abilita il componente aggiuntivo in Plone.

   Apri il tuo sito Plone in un browser, accedi come amministratore e abilita il plugin:

   • Vai alla sezione Impostazioni del sito > Componenti aggiuntivi.
   • Trova onlyoffice.plone tra i componenti aggiuntivi disponibili.
   • Premi il pulsante Installa per abilitarlo.

Configurazione del plugin di integrazione ONLYOFFICE per Plone

Per configurare il plugin:

1. Vai a Impostazioni del sito.
2. Scorri fino alla sezione Configurazione componenti aggiuntivi.
3. Premi il pulsante Configurazione ONLYOFFICE.
4. Nel campo Servizio di modifica documenti, specifica l'indirizzo URL in cui si trova ONLYOFFICE Docs.
   L'indirizzo deve essere accessibile da Plone, così come l'indirizzo di Plone deve essere accessibile da ONLYOFFICE Docs.
5. Nel campo Chiave segreta, specifica la chiave segreta utilizzata per firmare i dati.
   A partire da ONLYOFFICE Docs v7.2, JWT è abilitato per impostazione predefinita e la chiave segreta viene generata automaticamente. Devi abilitarlo anche sul lato Plone: trova la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs, quindi specifica la stessa chiave segreta nelle impostazioni del connettore. Per ulteriori dettagli, consulta la sezione Abilitazione JWT per l'integrazione di ONLYOFFICE e Plone di questo articolo.
6. Nel campo Indirizzo del server per richieste interne dal Servizio di modifica documenti, specifica l'indirizzo utilizzato per accedere a Plone dal Servizio di modifica documenti.
7. Nel campo Indirizzo del Servizio di modifica documenti per richieste interne dal server, specifica l'indirizzo utilizzato per accedere al Servizio di modifica documenti da Plone.

Sviluppo del plugin ONLYOFFICE per Plone

1. Clona il repository e cambia directory:

   git clone --branch deploy git@github.com:ONLYOFFICE/onlyoffice-plone.git cd onlyoffice-plone

2. Crea un virtualenv nel pacchetto.
3. Installa i requisiti con pip.
4. Esegui buildout:

   virtualenv . ./bin/pip install -r requirements.txt ./bin/buildout

5. Avvia Plone in primo piano:

   ./bin/instance fg

Se hai un'istanza Plone funzionante, puoi installare il plugin aggiungendo i file del progetto alla directory scr:

1. Nella directory scr, crea la directory onlyoffice.plone.
2. Metti i file del tuo progetto ricevuti tramite Git nella directory onlyoffice.plone.
3. Modifica il file buildout.cfg:

   [buildout] ... eggs = onlyoffice.plone develop = src/onlyoffice.plone

4. Riesegui buildout affinché le modifiche abbiano effetto:

   .bin/buildout

5. Quindi avvia o riavvia la tua istanza Plone.

Plone si basa su server Zope e non verrà eseguito come utente root. Se intendi eseguirlo come utente root, devi fornire una direttiva effective-user. Per farlo, aggiungi effective-user

< username >

Aggiornamento del plugin di integrazione ONLYOFFICE per Plone

1. Se hai specificato una versione precisa del plugin nel tuo file buildout.cfg (cosiddetto pinning, e una pratica raccomandata), come onlyoffice.plone = 1.0.0, aggiorna questo riferimento per indirizzare alla versione più recente. Se la versione del plugin non è specificata, verrà automaticamente caricata l'ultima versione:

   [versions] ... onlyoffice.plone = 1.0.1

2. Esegui bin/buildout. Attendi che una nuova versione venga scaricata e installata.
3. Il tuo sito potrebbe apparire distorto o addirittura diventare inaccessibile fino a quando non completi il passaggio successivo.
4. Vai alla schermata Componenti aggiuntivi (aggiungi /prefs_install_products_form all'URL del tuo sito) e nella lista Aggiornamenti seleziona onlyoffice.plone e clicca su Aggiorna onlyoffice.plone.

Come funziona

L'integrazione ONLYOFFICE segue l'API documentata qui.

1. L'utente naviga verso un documento all'interno di Plone e seleziona l'azione Modifica con ONLYOFFICE.
2. Plone prepara un oggetto JSON per il Document Server con le seguenti proprietà:
   • url: l'URL che ONLYOFFICE Docs utilizza per scaricare il documento;
   • callbackUrl: l'URL che ONLYOFFICE Docs informa sullo stato della modifica del documento;
   • key: l'UUID+Timestamp Modificato per istruire ONLYOFFICE Docs se scaricare nuovamente il documento o meno;
   • title: il titolo del documento (nome).
3. Plone costruisce una pagina dal modello .pt, riempiendo tutti quei valori in modo che il browser del client possa caricare l'editor.
4. Il browser del client effettua una richiesta alla libreria JavaScript di ONLYOFFICE Docs e invia a ONLYOFFICE Docs la configurazione del DocEditor con le proprietà sopra menzionate.
5. Quindi ONLYOFFICE Docs scarica il documento da Plone e l'utente inizia a modificarlo.
6. ONLYOFFICE Docs invia una richiesta POST a callbackUrl per informare Plone che un utente sta modificando il documento.
7. Quando tutti gli utenti e i browser client hanno terminato la modifica, chiudono la finestra di modifica.
8. Dopo 10 secondi di inattività, ONLYOFFICE Docs invia un POST a callbackUrl informando Plone che i client hanno terminato la modifica del documento e lo hanno chiuso.
9. Plone scarica una nuova versione del documento, sostituendo quella vecchia.

Abilitazione JWT per l'integrazione di ONLYOFFICE e Plone

Per proteggere i documenti da accessi non autorizzati, gli editor di ONLYOFFICE utilizzano il JSON Web Token (JWT). Il token viene aggiunto nella configurazione quando il Document Editor viene inizializzato e durante lo scambio di comandi tra i servizi interni di ONLYOFFICE Docs. La chiave segreta viene utilizzata per firmare il token JSON e convalidare il token alla 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.

Passo 1: Trova la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs

1. Apri il file local.json con qualsiasi editor di testo disponibile.
   • Per Linux - /etc/onlyoffice/documentserver/local.json
   • Per Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
   • Per Docker – entra nel container di ONLYOFFICE Docs usando 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 apparire così:

   {"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 tre 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

Passo 2: Specifica la stessa chiave segreta nelle impostazioni del connettore

Nelle impostazioni del connettore, specifica lo stesso segreto nel campo Chiave segreta e salva le impostazioni.

Collegamento al demo di ONLYOFFICE Docs

A partire dalla versione 3.0.0 del connettore ONLYOFFICE, puoi provare gli editor online di ONLYOFFICE all'interno di Plone senza installare ONLYOFFICE Docs.

Per attivare la connessione, seleziona la casella Connetti al server demo di ONLYOFFICE Document e fai clic sul pulsante Salva.