Come collegare ONLYOFFICE Docs e Strapi CMS

Su questa pagina

Passaggio 1: installa ONLYOFFICE Docs
Passaggio 2: installa il plug-in di integrazione
Passaggio 3: configura il plug-in di integrazione
Passaggio 4: usa ONLYOFFICE Docs all'interno di Strapi

ONLYOFFICE Docs è una suite per ufficio open source distribuita sotto GNU AGPL v3.0. Comprende visualizzatori basati sul Web ed editor collaborativi per documenti di testo, fogli di calcolo, presentazioni, moduli compilabili e file PDF. Il formato principale utilizzato è OOXML (DOCX, XLSX, PPTX).

La suite per ufficio può essere integrata con vari servizi cloud come framework CMS (WordPress, Strapi), piattaforme di collaborazione (ONLYOFFICE Workspace, Nextcloud, Seafile, Confluence, Alfresco), issue tracker (Jira, Redmine), soluzioni e-learning (Moodle, Chamilo, HumHub) e altri. Gli sviluppatori sono anche in grado di incorporare gli editor nelle proprie applicazioni web.

Strapi è un CMS collaborativo open source basato su Node.js che aiuta gli sviluppatori a creare prodotti digitali. È un sistema di gestione dei contenuti back-end creato per la distribuzione di contenuti multipiattaforma su siti Web desktop e mobili, applicazioni, display interattivi ed elementi web. Con ONLYOFFICE Docs integrato, puoi modificare e collaborare sui contenuti direttamente nell'interfaccia di Strapi.

In questo tutorial impareremo come connettere le istanze di ONLYOFFICE Docs e Strapi usando un plugin di integrazione (connettore).

Tieni presente che ONLYOFFICE è compatibile con Strapi v.4.0 e versioni successive.

Passo 1: Installa ONLYOFFICE Docs

Per poter lavorare con i documenti d'ufficio in Strapi, è necessaria un'istanza di ONLYOFFICE Docs (Document Server). Il modo di installazione ufficialmente raccomandato dagli sviluppatori è utilizzare Docker. Consente di installare l'ultima versione degli editor con tutte le dipendenze eseguendo il seguente comando:

sudo docker run -i -t -d -p 8080:80 --restart=always onlyoffice/documentserver

Puoi trovare le istruzioni dettagliate in queste istruzioni.

Passaggio 2: installa il plug-in di integrazione

Sostituisci la riga strapi::security nel file middleware Strapi strapi/config/middlewares.js per consentire l'inserimento di un frame con l'editor e il caricamento di api.js:

{
  name: "strapi::security",
  config: {
    contentSecurityPolicy: {
      useDefaults: true,
      directives: {
        "script-src": ["'self'", "https:", "http:"],
        "frame-src": ["'self'", "https:", "http:"],
      },
    },
  },
},

Se tale configurazione esiste già, aggiungi solo l'elemento direttive.

Una volta pronto, installa il plugin nel tuo progetto Strapi:

npm install onlyoffice-strapi --save

Dopo l'installazione, ricostruisci l'interfaccia utente di amministrazione e riavvia l'esecuzione di Strapi:

# using yarn
yarn build
yarn develop

# using npm
npm run build
npm run develop

Il plugin di integrazione è disponibile anche nello Strapi Market ufficiale.

Passaggio 3: configurare il plug-in di integrazione

Una volta installato il plugin di integrazione, configura ONLYOFFICE Document Server tramite la Dashboard di Strapi. Vai su Impostazioni -> Impostazioni globali -> ONLYOFFICE. Specifica i parametri:

Indirizzo del document server che è l'URL del ONLYOFFICE Document Server installato.
Chiave segreta JWT del server di documenti che consente a JWT di proteggere i documenti da accessi non autorizzati. Devi anche specificare la stessa chiave segreta nel file di configurazione di ONLYOFFICE Document Server per abilitare la convalida.

Passo 4: Usa ONLYOFFICE Docs all'interno di Strapi

Puoi visualizzare, modificare e creare in collaborazione documenti di testo, fogli di calcolo e presentazioni (DOCX, XLSX, PPTX) aggiunti alla Strapi Media Library.

Tra le funzionalità collaborative sono disponibili le seguenti: modalità di co-editing in tempo reale e con blocco dei paragrafi, Track Changes, commenti, chat integrata, chiamate audio e video tramite plug-in Jitsi che deve essere installato separatamente.

I documenti disponibili per la visualizzazione/modifica possono essere trovati e ordinati nella pagina dei file di ONLYOFFICE all'interno di Strapi. L'editor si apre facendo clic sul nome del file o sull'azione Modifica in ONLYOFFICE.

I diritti di accesso sono forniti nel seguente modo:

Apertura di file per la modifica: ruoli utente con l'impostazione di autorizzazione Aggiorna (ritaglia, dettagli, sostituisci) + elimina.
Apertura di file per la visualizzazione: ruoli utente con l'impostazione di autorizzazione Accedi alla libreria multimediale.

È tutto! Ora puoi modificare e collaborare ai contenuti dell'ufficio direttamente all'interno del tuo Strapi utilizzando ONLYOFFICE Docs.