Articles with the tag:
Try in the cloud
Help Center

About the ONLYOFFICE and Moodle integration

ONLYOFFICE offers an official connector to integrate ONLYOFFICE Docs with Moodle and edit office documents attached to the course pages. You can download the ONLYOFFICE connector from the Moodle plugin library or the GitHub page.

Main features

  • Editing and viewing text documents, spreadsheets, and presentations.
  • Co-editing documents in real-time: two co-editing modes (Fast and Strict), the Track Changes mode, comments, and the built-in chat.
  • JWT support to secure your traffic so that no one can have access to your documents with the exception of the users with proper rights.

Supported formats

  • For viewing and editing: DOCX, XLSX, PPTX, TXT, CSV
  • For viewing only: PDF
  • For converting to Office Open XML formats: ODT, ODS, ODP, DOC, XLS, PPT, PPS, EPUB, RTF, HTML, HTM

What's new in version 2.1.0


  • backup api
  • privacy api


  • fixes according to markets code prechecks

The full change log is available here.

Connecting ONLYOFFICE Docs to Moodle


  • ONLYOFFICE Docs (Document Server) 4.2.7 or higher

    You need an instance of ONLYOFFICE Docs that is resolvable and connectable both from Moodle and any end clients. It must be able to POST to Moodle directly.

    Please refer to the official documentation page to learn more about installing ONLYOFFICE Docs.
  • Moodle v3.9.10 or later
  • ONLYOFFICE connector v2.1.0 for Moodle

Installing the ONLYOFFICE connector for Moodle

Using the Moodle plugin library
  1. Log as an admin into your Moodle instance and go to Site administration > Plugins > Install plugins.
    If you can’t find this location, then plugin installation is disabled on your site.
  2. Click the Install plugins from Moodle plugins directory button.
  3. Select your current Moodle version.
  4. Search for the ONLYOFFICE document plugin.
  5. Click the Install button, then click Continue.
  6. Confirm the installation request.
  7. Check the plugin validation report.
    It is extremely important that you choose your Moodle version correctly. If you mistakenly download and install the wrong version of the plugin for your Moodle server, this may lead to some serious problems, even freezing of the Moodle site.
Using the GitHub .ZIP archive
  1. Download the connector from the GitHub page.
  2. Log into your Moodle instance as an administrator, go to the Site administration section, switch to the Plugins tab, and click the Install plugins link.
  3. Upload the file via the file picker or drag-and-drop it to the corresponding field and click the Install plugin from the ZIP file button.
    ONLYOFFICE_connector ONLYOFFICE_connector
  4. Check the plugin validation report and click Continue.
    If your target directory is not writable, you will see a warning message, e.g. [Error] Write access check [/var/www/html/moodle/mod]. In this case, you can temporarily make it writable by using the following command:
    sudo chmod -R 777 /var/www/html/moodle

    After that, repeat Step 3.

    After installing the plugin, you need to revert permissions so that the directory is no longer writable. Use the following command:

    sudo chmod -R 0755 /var/www/html/moodle
  5. Click Continue on the Current release information -> Server checks page.
  6. Click Upgrade Moodle database now on the Plugins check page.
    ONLYOFFICE_connector ONLYOFFICE_connector
  7. Click Continue on the Upgrading to new version page.

Configuring the ONLYOFFICE connector for Moodle

Once the plugin is installed, the plugin settings page will be opened. Alternatively, you can find ONLYOFFICE document on the Plugins overview page and click Settings. On the Settings page, you can configure the following parameters:

  • Enter the address that is used to access Document Editing Service from Moodle into the Document Editing Service address field. This field is obligatory.
  • Optionally, specify the secret used to sign the data in the Document Server Secret field. The secret key is used to validate the JSON web token upon the request to Document Server. To learn more, check the API documentation for configuring JWT on the ONLYOFFICE Docs side.

When ready, click Save changes.

ONLYOFFICE_configure ONLYOFFICE_configure

Start using ONLYOFFICE Docs within Moodle

Adding ONLYOFFICE activities

To create a new ONLYOFFICE activity:

  1. Open the My Courses section and switch to the necessary course.
  2. Activate the Edit Mode using the switcher at the top right corner.
  3. Click Add an activity or resource.
  4. Select the ONLYOFFICE document activity in the pop-up window.
    ONLYOFFICE_editfile ONLYOFFICE_editfile
  5. Type in the activity name, upload or drag-and-drop the necessary document from your PC and click the Save and display button.
    ONLYOFFICE_editfile ONLYOFFICE_editfile

The document will be opened in the ONLYOFFICE Docs editor.


Viewing and editing files

ONLYOFFICE activities will be marked with the ONLYOFFICE_editfile icon on your course pages. To open a document in the ONLYOFFICE Docs editor, just click its title.


Managing permissions

Admins/Teachers can choose whether or not documents can be downloaded or printed from inside the ONLYOFFICE editor. This can be done in the Document permissions section.


To change the document permission to read-only:

  1. Open the needed ONLYOFFICE document.
  2. Go to More -> Permissions.
  3. Find the [[onlyoffice:editdocument]] entry.
  4. Add the required roles in the Prohibited section or remove the ones from the Roles with permission section.
Download Best editors on your website Let your site users view, edit and collaborate
on all types of text, spreadsheet and presentation files
You Might Also Like This: