Strapi ONLYOFFICE integration plugin

This app enables users to edit office documents from Strapi using ONLYOFFICE Docs packaged as Document Server - Community or Enterprise Edition.

Features

The app allows to:

• View and edit text documents, spreadsheets, and presentations.
• Co-edit documents in real-time using two co-editing modes (Fast and Strict), Track Changes, comments, built-in chat.

Installing ONLYOFFICE Docs

You will need an instance of ONLYOFFICE Docs (Document Server). You can install free Community version or scalable Enterprise Edition.

To install free Community version, use Docker (recommended) or follow these instructions for Debian, Ubuntu, or derivatives.

To install Enterprise Edition, follow the instructions here.

Community Edition vs Enterprise Edition comparison can be found here.

Installing Strapi ONLYOFFICE integration plugin

1. You need to 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:

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   {
     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:

   1
   npm install onlyoffice-strapi --save

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

   1
   2
   3
   4
   5
   6
   7
   # 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 Document Server.
• Document server JWT secret key: Enables JWT to protect your documents from unauthorized access (further information can be found here).

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.

ONLYOFFICE Docs editions

ONLYOFFICE offers different versions of its online document editors that can be deployed on your own servers.

ONLYOFFICE Docs packaged as Document Server:

• Community Edition (onlyoffice-documentserver package)
• Enterprise Edition (onlyoffice-documentserver-ee package)

The table below will help you make the right choice.

* If supported by DMS.

In case of technical problems, the best way to get help is to submit your issues here. Alternatively, you can contact ONLYOFFICE team on forum.onlyoffice.com.