Skip to content
Student notes plugin for Tutor
Python Dockerfile
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
tutornotes Get rid of mysql strict trans mode warnings Oct 7, 2019
.gitignore 🌅 Aug 21, 2019
.gitlab-ci.yml 🌅 Aug 21, 2019
MANIFEST.in 🌅 Aug 21, 2019
README.rst Fix incorrect docker image version Sep 2, 2019
setup.py 🌅 Aug 21, 2019

README.rst

Students notes plugin for Tutor

This is a plugin for Tutor to easily add the Open edX note-taking app to an Open edX platform. This app allows students to annotate portions of the courseware (see the official documentation).

Notes in action

Installation

The plugin is currently bundled with the binary releases of Tutor. If you have installed Tutor from source, you will have to install this plugin from source, too:

pip install tutor-notes

Then, to enable this plugin, run:

tutor plugins enable notes

You should beware that the notes.<LMS_HOST> domain name should exist and point to your server. For instance, if your LMS is hosted at http://myopenedx.com, the notes service should be found at http://notes.myopenedx.com.

If you would like to host the notes service at a different domain name, you can set the NOTES_HOST configuration variable (see below). In particular, in development you should set this configuration variable to notes.localhost in order to be able to access the notes service from the LMS. Otherwise you will get a "Sorry, we could not search the store for annotations" error.

Configuration

  • NOTES_MYSQL_PASSWORD (default: "{{ 8|random_string }}")
  • NOTES_SECRET_KEY (default: "{{ 24|random_string }}")
  • NOTES_OAUTH2_SECRET (default: "{{ 24|random_string }}")
  • NOTES_DOCKER_IMAGE (default: "overhangio/openedx-notes:{{ NOTES_VERSION }}")
  • NOTES_HOST (default: "notes.{{ LMS_HOST }}")
  • NOTES_MYSQL_DATABASE (default: "notes")
  • NOTES_MYSQL_USERNAME (default: "notes")

These values can be modified with tutor config save --set PARAM_NAME=VALUE commands.

You can’t perform that action at this time.