CollaboraActivityModule
A teacher can add a Collabora activity in a course when editing is turned on by clicking an 'Add an activity or resource' link (or, if not present, the "Add an activity" drop down menu) and selecting Collabora.
This activity creates an office document (text, spreadsheet or presentation) that can be edited by more then one student simultaneously. Your system administrator should have hooked up a Collabora server to your Moodle installation for this to work (see section Server setup). A collabora server is a server that generates the possibility to cooperate on office documents using a web based version of LibreOffice.
Activity settings
To see all the settings expanded, click the link "Expand all" top right.
Give your Collabora name (which students see on the course page) and a description. The name will end up the name of the document that will be created with this activity. You can set a tick box to show the description of the course page.
Format
This setting determines which kind of document will be created by the Collabora activity. This option can't be changed anymore after saving the activity. Options are:
- File upload: upload a document as a start for your students to collaborate on. When this option chosen, an extra line will appear, showing the name and a download link to the original document.
- Specified text:
- Spreadsheet: create an empty spreadsheet
- Word Processor document: create an empty text document
- Presentation: create an empty presentation
Display
- Current tab: when a student enters the activity, the editor with the document are shown in the current browser tab.
- New tab: when a student enters the activity, the editor will open in a new tab. The current tab keeps showing the course page.
Width
Alters the width of the editor. 0 for automatic width.
Height
Alters the height of the editor. 0 for automatic.
By experience: 1200 gives a full A4 page editor on zoom level 100%
Display name
Set to yes displays the name of the Collabora activity above the editor when students access the activity.
Display description
Set to yes displays the description of the Collabora activity above the editor when students access the activity.
Server setup
For an initial local demo, follow the suggestions in https://github.com/learnweb/moodle-mod_collabora/blob/master/Collabora-Config.md.
Afterwards, you will want to use the Collabora-Moodle integration in production. If you are connecting Moodle to an existing Collabora server (e.g., from a Collabora-Nextcloud installation), you will need to modify the Collabora configuration to allow requests from Moodle AND Nextcloud. Here's an example configuration of the relevant section:
<wopi allow="true" desc="Allow/deny wopi storage. Mutually exclusive with webdav.">
<host allow="true" desc="Regex pattern of hostname to allow or deny.">127.0.0.1</host>
<host allow="true" desc="Regex pattern of hostname to allow or deny.">localhost</host>
<host allow="true" desc="Regex pattern of hostname to allow or deny.">nextcloud.example.be</host>
<host allow="true" desc="Regex pattern of hostname to allow or deny.">moodle.example.be</host>
<host allow="false" desc="Regex pattern of hostname to allow or deny.">10\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}</host>
<host allow="false" desc="Regex pattern of hostname to allow or deny.">172\.1[6789]\.[0-9]{1,3}\.[0-9]{1,3}</host>
<host allow="false" desc="Regex pattern of hostname to allow or deny.">172\.2[0-9]\.[0-9]{1,3}\.[0-9]{1,3}</host>
<host allow="false" desc="Regex pattern of hostname to allow or deny.">172\.3[01]\.[0-9]{1,3}\.[0-9]{1,3}</host>
<host allow="false" desc="Regex pattern of hostname to allow or deny.">192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host>
<host allow="false" desc="Regex pattern of hostname to allow or deny.">192\.168\.1\.1</host>
<max_file_size desc="Maximum document size in bytes to load. 0 for unlimited." type="uint">0</max_file_size>
</wopi>
You will notice that, in the example configuration, there are hostnames for both, Nextcloud AND Moodle. Adapt it to your hostnames and IP addresses as needed.
