https://github.com/moodlehu/moodle-mod_etherpadlite

This is a moodle plugin for etherpadlite, developed at the Humboldt Universität zu Berlin
https://github.com/moodlehu/moodle-mod_etherpadlite

Last synced: 3 months ago
JSON representation

This is a moodle plugin for etherpadlite, developed at the Humboldt Universität zu Berlin

• Host: GitHub
• URL: https://github.com/moodlehu/moodle-mod_etherpadlite
• Owner: moodlehu
• Created: 2012-12-19T14:37:26.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2024-07-10T16:18:47.000Z (6 months ago)
• Last Synced: 2024-08-02T12:44:09.661Z (6 months ago)
• Language: PHP
• Size: 336 KB
• Stars: 20
• Watchers: 13
• Forks: 27
• Open Issues: 17
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.md

Awesome Lists containing this project

• awesome-starred - moodlehu/moodle-mod_etherpadlite - This is a moodle plugin for etherpadlite, developed at the Humboldt Universität zu Berlin (others)

README

        
# About

This is a module, which integrates etherpad-lite in Moodle 3.5 or higher

Features:

- Add / View / Delete Pads

- Users have the same name & writing color in all pads

- Moodle Import / Export support

- optional guest allowance

- It supports etherpad-lite servers, which can only be accessed through the API (access only through Moodle)

- It can check the HTTPS certificate of the ep-lite server for full security (man in the middle attacks)

## Prerequirement

You need an etherpad-lite server, which is running on at least the same 2nd-level-domain as your moodle server.

On the github page you'll find all information you need, to install the server: https://github.com/ether/etherpad-lite

We recommend to use the etherpad-lite version 1.8.0 or higher

It's also recommended to use the latest stable release of nodejs

(http://nodejs.org/)

*we are using nodejs 0.8.26. But we test new ep-lite versions always with this node version, before updating productive*

When you want, that the server is only accessible via Moodle, then I recommend to install ep_remove_embed over the ep-lite admin interface. This removes the embed link.


*To access the admin area, uncomment the user section in settings.json*

### Working ep-lite installation

- Ubuntu 12.04

- apt-get git, nginx, abiword, make, g++

- donwload nodejs from nodejs.org and compile it (you can use 'n' to switch between versions )

- etherpad-lite from git

- ep-lite settings.json:

    -    "requireSession":true

    -    "editOnly":true

    -    "abiword": "/usr/bin/abiword"

- ep-lite plugin: *ep_remove_embed* via admin interface

- upstart script

- logrotate

- nginx as reverse proxy with https

# INSTALLATION

1. Copy this repository to the moodle subfolder: **mod/etherpadlite**

2. open your admin/index.php page and follow the instructions

# Configuration

1. Server Url from your etherpadlite server *Make sure, that your moodle server can access this URL (don't forget to include a trailing slash!)*

2. ApiKey: this is stored in the file: `APIKEY.txt` on your etherpadlite server

3. Padname: this is optional and maybe just for debugging the databse

4. Cookie Domain: Enter the domain as described

5. Session elapse time: How long should one session be valid?

6. Https Redirect: This redirects moodle to https, so that the user feels secure 
(later this should be used to delete sessions on the etherpadlite server)

7. Verify HTTPS cert: This lets curl check, if the https cert of the etherpadlite server is valid, to prevent man in the middle attacks

8. Guests allowed to write?: As described

## [Sponsors](id:sponsors)

Browsertesting is kindly provided by [BrowserStack](https://browserstack.com)