Skip to main content

A Tutor plugin for student notes

Project description

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:

tutor plugins install notes

Then, to enable this plugin, run:

tutor plugins enable notes

Then, to make migrations & tasks:

tutor local launch

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). When testing Tutor on a local computer, this will be automatically set to notes.local.openedx.io.

To enable student notes for a specific course, you should go to the course advanced settings in the studio, and set “Enable Student Notes” to “true”. Then, hit “save changes”.

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: "{{ DOCKER_REGISTRY }}overhangio/openedx-notes:{{ NOTES_VERSION }}")

  • NOTES_HOST (default: "notes.{{ LMS_HOST }}")

  • NOTES_MYSQL_DATABASE (default: "notes")

  • NOTES_MYSQL_USERNAME (default: "notes")

  • NOTES_REPOSITORY (default: "https://github.com/openedx/edx-notes-api")

  • NOTES_REPOSITORY_VERSION (default: "{{ OPENEDX_COMMON_VERSION }}")

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

Debugging

To debug the notes API service, you are encouraged to mount the edx-notes-api repo from the host in the development container:

tutor dev start –mount /path/to/edx-notes-api

Feel free to add breakpoints (breakpoint()) anywhere in your source code to debug your application.

Troubleshooting

This Tutor plugin is maintained by Jhony Avella from eduNEXT. Community support is available from the official Open edX forum. Do you need help with this plugin? See the troubleshooting section from the Tutor documentation.

License

This software is licensed under the terms of the GNU Affero General Public License (AGPL).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tutor_notes-20.0.0.tar.gz (19.0 kB view details)

Uploaded Source

File details

Details for the file tutor_notes-20.0.0.tar.gz.

File metadata

  • Download URL: tutor_notes-20.0.0.tar.gz
  • Upload date:
  • Size: 19.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.20

File hashes

Hashes for tutor_notes-20.0.0.tar.gz
Algorithm Hash digest
SHA256 4b8ca65a7b79accbc8f2bada7631a6fdb6eddca2a5be9d994aa871697cfe395e
MD5 2eadf780865ca17656dd8978c5a8a8e9
BLAKE2b-256 9254f61f47f00de21edacb647f2014876c65eb1c2a25163426f391ece253162b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page