tutor-contrib-notifications 20.0.0

Tutor plugin that enables email notifications for Open edX

Tutor plugin that enables email notifications for Open edX on Teak / Tutor 20.x. Open edX offers three main types of notifications:

• Course updates

• Recurring nudges

• Daily digests

• Weekly digests

This plugin will enable all of them by default.

Deprecation notice

This repository is deprecated starting with Ulmo.

For Ulmo and later releases, use the official Tutor plugin instead: openedx/tutor-contrib-platform-notifications.

This repository is kept for Teak / Tutor 20.x compatibility only.

Course updates (aka course highlight emails)

If your Open edX system adminstrator has configured your instance of the Open edX platform to send course highlight emails, you can send automatic email messages to learners in your course that contain three to five “highlights” of upcoming course content. A highlight is a brief description of an important concept, idea, or activity in the section. Your Open edX system administrator provides the template for this course highlight email, and you enter the highlights for the email in Studio.

To learn more about this feature, see Course Highlight Email.

Recurring nudges

Recurring nudges are emails that are sent 3 and 10 days after a learner enrolls in a course.

To learn more about this feature, see Recurring Nudges.

Email notifications

Notifications help you stay updated on important activity in your courses. You can receive notifications via the notification tray in real time, or through email summaries delivered periodically.

Notifications are sent daily and weekly, and can be configured in the account settings page.

Event that trigger notifications are course updates, forum activities and ORA submissions.

To learn more about this feature, see Email Notifications.

Installation

For Ulmo and later, install and use the official plugin instead of this repository.

pip install git+https://github.com/aulasneo/tutor-contrib-notifications.git

Usage

To enable the plugin, run:

tutor plugins enable notifications
tutor {local|k8s} do init --limit notifications
tutor {local|k8s} start

The tutor {local|k8s} do init command will set the waffle flags for the notifications plugin.

You can run the following commands to trigger the notifications manually:

tutor {local|k8s} do send-daily-digest
tutor {local|k8s} do send-weekly-digest
tutor {local|k8s} do send-course-update
tutor {local|k8s} do send-recurring-nudge

For Kubernetes users, this plugin will setup a cronjob to run the daily and weekly digests at the configured schedules. Users of a tutor local installation will have to set up a cronjob manually.

Configuration

• NOTIFICATIONS_DAILY_SCHEDULE: Set the schedule for the daily emails. Default is “0 10 * * *” (every day at 10am UTC).

• NOTIFICATIONS_WEEKLY_SCHEDULE: Set the schedule for the weekly emails. Default is “0 10 * * 0” (every Sunday at 10am UTC).

• NOTIFICATIONS_SEND_COURSE_UPDATE: Enable course updates. Default is True.

• NOTIFICATIONS_SEND_RECURRING_NUDGE: Enable recurring nudges. Default is True.

• NOTIFICATIONS_SEND_DAILY_DIGEST: Enable daily digests. Default is True.

• NOTIFICATIONS_SEND_WEEKLY_DIGEST: Enable weekly digests. Default is True.

• NOTIFICATIONS_ENABLE_ORA_GRADE_NOTIFICATIONS: Enable ORA grade notifications. Default is True.

• NOTIFICATIONS_ENABLE_NOTIFICATIONS: Enable notifications. Default is True.

• NOTIFICATIONS_ENABLE_EMAIL_NOTIFICATIONS: Enable email notifications. Default is True.

• NOTIFICATIONS_ENABLE_GROUPING: Enable grouping. Default is True.

• NOTIFICATIONS_DEFAULT_FROM_EMAIL: Set the default from email. Default is “{{ CONTACT_EMAIL }}”.

Notes:

• After modifying NOTIFICATIONS_ENABLE_GROUPING, you will need to run tutor {local|k8s} do init –limit notifications to apply the changes.

• After changing the schedules, you will need to restart the cronjobs with tutor k8s start.

License

This software is licensed under the terms of the AGPLv3.