Moodle Plugins directory: ONLYOFFICE document | Moodle.org
ONLYOFFICE document
Moodle ONLYOFFICE Integration plugin
This plugin enables multiple users to collaboratively edit office documents from Moodle in real time using ONLYOFFICE Document Server online editor, and to save back those changes back to Moodle.
Currently the following document formats can be edited with this plugin: DOCX, XLSX, PPTX, TXT, CSV.
The above mentioned formats are also available for viewing, as well as PDF.
The edited files of the corresponding type can be converted into the Office Open XML formats: ODT, ODS, ODP, DOC, XLS, PPT, PPS, EPUB, RTF, HTML, HTM.
Installing ONLYOFFICE Document Server
You will need an instance of ONLYOFFICE Document Server that is resolvable and connectable both from your Moodle server. ONLYOFFICE version 4.2.7 and later are supported for use with the plugin. The ONLYOFFICE Document Server must also be able to POST to your Moodle server directly. That generally means opening port 80 or 443 on your firewall to allow inbound connections.
The easiest way to start an instance of ONLYOFFICE Document Server is to use Docker. Further information on ONLYOFFICE Document Server packages for various platforms is available at https://helpcenter.onlyoffice.com/server/document.aspx
Installing the Moodle ONLYOFFICE Integration plugin
This plugin is an activity module.
Follow the usual Moodle plugin installation steps to install this plugin into your mod/onlyoffice directory.
Configuring the Moodle ONLYOFFICE Integration plugin
Document Server Address
Once the plugin is installed, you will need to tell it your ONLYOFFICE Document Server address (URL).
Document Server Secret
You can set a secret to be used for generating a token that the Document Server will use to verify commands from the client/editor. Refer to https://api.onlyoffice.com/editors/signature/ if you decide to use a secret.
The secret is not required in order for the plugin to work. If you are not using a secret, the values of services.CoAuthoring.secret.inbox.string and services.CoAuthoring.secret.outbox.string in the Document server configuration should be set to empty strings, and the token.enable.* should be set to false. Refer to Refer to this page - https://api.onlyoffice.com/editors/signature/ for instructions on how to set those values.
If your ONLYOFFICE Document Server is configured to use a token, then you must set a value for Document Server Secret in the plugin's configuration, and the secret must match the secret configured on the ONLYOFFICE Document Server. Also check and ensure that the token.enable.* values in the document server configuration are set to true.Using the Moodle ONLYOFFICE Integration plugin
Once installed, you can add instances of ONLYOFFICE activity to your course pages as per usual Moodle practice.
Admins/Teachers can choose whether or not documents can be downloaded or printed from inside the ONLYOFFICE editor.
Clicking the activity name/link in the course page opens the ONLYOFFICE editor in the user's browser, ready for collaborative editing.
Useful links
Screenshots
First the warning appears:
"The document could not be saved. Please check the connection settings or contact your administator. When you click the 'OK' button, you will be prompted to download the document.
Shortly after the warning the error message appears:
Download failed.
Press "OK" to return to document list.
In Moodle 3.11.11+ the same plugin version is working properly with exactly the same document.
I tested the plugin on Moodle 4.1 and Onlyoffice 7.1 and it works correctly.
What version of Onlyoffice are you using?
Also, can you check that the Document Server Secret is set correctly in the ONLYOFFICE Document plugin configuration in Moodle.
You have to upgrade the plugin to the most recent version - v4.0_6.4 (2022043000)
We use onlyoffice version: 7.2.1-34
The Document Server Secret is empty.
Thanks and regards
This activity could be revolutionary for schools and save a lot of time when we reset courses but I have 2 suggestions to make it even better.
We use collaborative documents as flipped classroom activities and sometimes as live workshop activities. In these instances, students are given a discussion and asked to give thoughts on a subject. We set up a table and each student can throw their name down, a few thoughts and the teacher can use the comments to respond and chat. Out of all our activities, including very high end stuff, again and again the students say they enjoy shared doc activities the best. So here's a few suggestions:
1. Completion tracking - Look at activities like Database. It would be great to be able to harness completion tracking more. For instance, a student must contribute to a collaborative document to mark as complete.
2. Grading - Make the document a graded activity. This could be set up for groups. Grading could be based on a rating system like Database. Or could grade students based on their contributions. Think about a way for a teacher to navigate through submissions. Not everything has to go through assignment. For instance, a document could be used as a Journal with 6 headings for 6 weeks and a teacher could drop in and give formative feedback. At the end of the module, the document becomes read only and is then graded.
3. Integration - work with BigBlueButton and Blackboard Collaborate. If either live video call could feature a doc during classes, it would mean students do not have to work in two separate windows. Butter.us is leading the way for this at the moment.
4. For non developers who want to play and use this, it would be amazing if we could have access to a working moodle site.
Thanks again for your contribution to the community and look forward to testing one day!
You'll see that the suggestions on support for grading and groups are already in the issue tracker at https://github.com/logicexpertise/moodle-mod_onlyoffice/issues, although not quite the same as your suggestions. If you don't mind could you please add your suggestions to the tracker, including the suggestion on BBB integration.
Is the error known? If so, will there be a new update in the foreseeable future?
We are using the plugin version 2022120300.
That's likely because starting with Onlyoffice Editor 7.2, a token is set automatically, which may have replaced your previous token.
Version 2022120300 of the plugin has been tested to work with OO versions from 7.1.x - 7.5.x