Strapi integration

This plugin enables users to edit office documents from Strapi using ONLYOFFICE Docs.

Features

• Currently, the following document formats can be edited: DOCX, XLSX, PPTX.
• The following formats are available for viewing: DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, FODT, OTT, RTF, TXT, HTML, HTM, MHT, XML, PDF, DJVU, FB2, EPUB, XPS, OXPS, XLS, XLSX, XLSM, XLT, XLTX, XLTM, ODS, FODS, OTS, CSV, PPS, PPSX, PPSM, PPT, PPTX, PPTM, POT, POTX, POTM, ODP, FODP, OTP.
• The plugin will create a new Edit in ONLYOFFICE menu option within the document library for office documents. This allows multiple users to collaborate in real time and save back those changes to Strapi.

Installing ONLYOFFICE Docs

You need an instance of ONLYOFFICE Docs (Document Server) that is resolvable and connectable both from Strapi and any end clients. If that is not the case, use the official ONLYOFFICE Docs documentation page. ONLYOFFICE Docs must also be able to POST to Strapi directly.

The easiest way to install an instance of ONLYOFFICE Docs is to use Docker.

Installing Strapi ONLYOFFICE integration plugin

To start using ONLYOFFICE Docs with Strapi, follow these steps:

1. Change the Strapi middlewares file: strapi/config/middlewares.js.

   To allow inserting a frame with the editor and loading api.js, replace the strapi::security line in this file with the following:

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

   If such a config already exists, you just need to add directives.

2. Install the plugin in your Strapi project:

   npm install onlyoffice-stapi --save
   

3. After successful installation, you have to rebuild the admin UI so it'll include this plugin. To rebuild and restart Strapi, run:

   # using yarn
   yarn build
   yarn develop
   
   # using npm
   npm run build
   npm run develop
   

Configuring Strapi ONLYOFFICE integration plugin

You can configure ONLYOFFICE app via Strapi Dashboard -> Settings -> Global settings -> ONLYOFFICE. On the settings page, enter:

• Document server address. The URL of the installed ONLYOFFICE Docs.
• Document server JWT secret key. Starting from version 7.2, JWT is enabled by default and the secret key is generated automatically to restrict the access to ONLYOFFICE Docs and for security reasons and data integrity. Specify your own secret key on the Strapi settings page. In the ONLYOFFICE Docs config file, specify the same secret key and enable the validation.

Using Strapi ONLYOFFICE integration plugin

Users are able to view, edit, and co-author documents added to the Strapi Media Library. Documents available for viewing/editing can be found and sorted on the ONLYOFFICE file page within Strapi. The editor opens by clicking on the file name.

Access rights

• Opening files for editing: roles with the Update (crop, details, replace) + delete permission setting.
• Opening files for viewing: roles with the Access the Media Library permission setting.

How it works

The ONLYOFFICE integration follows the API documented here.

Download the Strapi ONLYOFFICE integration plugin here.