ONLYOFFICE plugin for Strapi

This plugin allows users to edit and co-author office files added to the Strapi Media Library using ONLYOFFICE Docs.

Features ⭐️

The plugin allows to:

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

Installing ONLYOFFICE Docs

To be able to work with office files within Strapi, you will need an instance of ONLYOFFICE Docs. You can install the self-hosted version of the editors or opt for ONLYOFFICE Docs Cloud which doesn't require downloading and installation.

Self-hosted editors

You can install free Community version of ONLYOFFICE Docs 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.

ONLYOFFICE Docs Cloud

To get ONLYOFFICE Docs Cloud, get started here.

Plugin installation 📥

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  name: "strapi::security",
   3  config: {
   4    contentSecurityPolicy: {
   5      useDefaults: true,
   6      directives: {
   7        "script-src": ["'self'", "https:", "http:"],
   8        "frame-src": ["'self'", "https:", "http:"],
   9      },
   10    },
   11  },
   12},

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

2. Install the plugin in your Strapi project:

   1npm 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# using yarn
   2yarn build
   3yarn develop
   4
   5# using npm
   6npm run build
   7npm run develop

Plugin configuration ⚙️

You can configure the ONLYOFFICE plugin via Strapi -> Settings -> ONLYOFFICE PLUGIN -> Configuration. On the settings page, enter:

• Document server address: The URL of the installed ONLYOFFICE Docs.
• JWT Secret: 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 ONLYOFFICE plugin for Strapi 📝

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) – Perfect for small teams and personal use.
• Enterprise Edition 🏢 (onlyoffice-documentserver-ee package) – Designed for businesses with advanced features & support.

The table below will help you make the right choice.

* If supported by DMS.

Need help? Feedback & Support 💡

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