Moodle - Local Reminders
![Build Status](https://github.com/isuru89/moodle-local_reminders/actions/workflows/moodle-ci.yml/badge.svg?branch=master)
This plugin will send email reminders for Moodle calendar events.
Reminders are very useful for both students as well as teachers to recall their scheduled events and activities before the actual moment.
Screenshots
Features
General Features:
- Ability to send reminders for site, user, course, group and activity calendar events.
- Pre-defined and customizable reminders schedule (1, 3 and 7 days in-advance).
- Ability to select roles eligible for receiving reminder emails.
In addition to that, there are lot of new features introduced in v2 of the plugin which is required to have Moodle 3.5 or later.
- Send reminders to users who unable to complete an expired activity.
- Send email reminders when a calendar event is created, updated or removed.
- Ability to enable/disable and scheduling reminders per activity basis.
- Ability to customize email header and footer contents
- Ability to exclude specific set of activity types from sending reminders.
- No reminders after a user has completed activity.
- Added event location / timezone information to the reminder email.
- New category event type support.
- Honours activity overriddes and extensions.
And many bug fixes too.
Compatibility
Plugin v2+ works in any Moodle versin 3.5 or above.
See here for older versions
Installation
To install this plugin, you must be an administrator of your Moodle site.
- Downlod an appropriate version from here based on your installed Moodle version.
- Go to Moodle
Site administration
> Plugins
> Install plugins
- Upload the downloaded zip file to the provided box.
- Click
Show more...
and select Local plugin (local)
under plugin type.
- Click
Install plugin from ZIP file
- Provide your reminders settings once asked.
- That's it!
Also don't forget to show your love for this plugin in here by clicking Add to favourites
.
Plugin Settings
Reminders are sent using Moodle's Scheduled tasks (since v3.5), and you can specify the running interval in Site administration
> Server
> Scheduled tasks
> Local Reminders
. By default, it has set to run in every 15 minutes.
Note: If you are using a Moodle version before 3.5, then you must edit $plugin->cron
value in version.php
file before uploading it for installation. This value is indicated in seconds.
To customize the plugin settings, go to Site administration
> Plugins
> Reminders
.
Each setting and its functionality is described below.
In addition to above, user can control reminders for calendar event changes per event type. Under each event type, there is an option called Enable for calendar change events
which allows user to enable/disable based on the event type.
Note: per event type settings are considered only after above change type setting considered.
-
Activity Event Reminders
Setting |
Description |
Default |
No reminders once completed |
enable/disable sending reminders if a user has completed activity. If checked, he/she won't receive reminders anymore once completed. |
true |
Activity Overdue Reminders |
enable/disable sending reminders for users who still have not completed expired events |
true |
Explicit Reminder Activation |
If checked, teachers or relevant authorities must explicitly enable reminders for each activity under course reminders settings page. |
false |
Changelog
v2.7.3
- Add plugin disabled message to course page #181
- Prevent duplicate reminders for recurring events #184
v2.7.2
- Plugin runs not on time #179
- Custom schedule for activity does not play nice with Explicit Reminder Activation #167
- Activity reminders for Zoom not working #158
- Make moodle code checker happy #177
v2.7.1
- Support for moodle 4.1, 4.2 and 4.3
- Fix: Object of class stdClass could not be converted to string #170
v2.7
- Moodle v4 support #162
- Fix: invalid db column migration #141
- Plugin uses user preference timezone rather than server timezone #159 (@doiphode)
v2.6
- Decouple activity start from activity end reminders #151
- Fix: Description of event for group activity reminders missing in email message #150 #109
- Fix: Duplicate reminder emails when a user has two or more roles in a course #149
v2.5
- Ability to customize reminder email header and footer #137 #135
- Bug fix on user and group overrides and extensions #134
- Minor bug fixes #136
v2.4
- Ability to explicitly turn on reminders instead of enabling by default for all (#129, #130)
v2.3.1
- Removed hard coded string in course settings page (#124)
- Fixed incorrect argument pass in calendar update events (#126)
v2.3
- No reminders once completed settings will support all modules which integrated with Moodle Core Completion API (#113)
- Should honour empty prefix when title prefix is set to empty in settings (#115)
- Ability to exclude reminders for a selected set of modules globally (#75)
- Ability to customize overdue texts in reminders (#118)
- Inconsistent code between reminders and overdue implementation fixed (#119)
- User reminders will be sent only to active users (#20)
v2.2.4
- Removed hardcoded strings (overdue text and moodle calendar name) #105
v2.2.3
- Added privacy provider for the plugin (#99)
v2.2.2
- Fixed plain text message format for notifications in mobile device (#87)
- Fixed legacy cron duplication issue (#91)
- Added missing language string (#94)
v2.2.1
- No reminders for hidden courses (#78)
- Fixed coursecat deprecation warning (#76)
- Fixed no-reply address not correctly being in the reminder emails (#77)
- Fixed disabled course reminders are still sending issue (#84)
v2.2
- Option to show/hide activity plugin name in reminder email subject (#71)
- Support reminder customization for course and BigBlueButton events (#69, #70)
v2.1.2
- Php 7.0 compatibility (#66)
v2.1.1
- Check for custom completion status of activities (#62)
v2.1
- Reminder interval customization per activity instance (#57)
- Support for course category events (#40)
v2.0
- Ability to send reminders after event completed for overdue students (#3)
- Ability to enable/disable reminders per activity (#48)
- Reminder email messages when calendar event created/changed/removed (#21)
- Prevent sending more email reminders once a student has completed the activity
- Added timezone/location to the email due dates (#32)
- Improved email style (#31)
- Additional cron task to clean old reminder data (#37)
- Send reminders only to students who can submit assignment (#47)
v1.7
- Excluded suspended users from course/activity events (#27)
- Renamed admin cron function so that conflicting with legacy (#26)
- Totara conflicting class name issue fixed (#25)
- Support for moodle v3.8
v1.6.2
- Fixed issue of conflicting class name
v1.6.1
- Fix login redirect loop in Moodle v3.5, 3.6 and 3.7.
v1.6
- Support for Moodle v3.5 and above.
- Migrated to new Moodle task API.
v1.5.1
- Fixed a bug where group reminders are not assigned when the event instance is empty
v1.5
- support for moodle 3.0+
- Ability to change mail sent user through configurations (#14)
- Notice: undefined variable when opening admin settings page in Moodle 2.9 (#12)
- Event reminders sent for individual quiz overrides (#11)
- Fix time formatting when user has set 24hour format in calendar preferences
- Fix cron errors resulting from new role (thanks to [colin-umn]: https://github.com/colin-umn)
- Fix cron error caused by $courseroleids (thanks to [cdsmith-umn]: https://github.com/cdsmith-umn)
v1.4.2
- support for moodle 2.9+
- ability to specify a custom schedule for sending reminders for any event type.
v1.4.1
v1.4
- now works in Moodle 2.7.*
- fixed bug sending reminders repeatedly to users.
v1.3.1
- bug fixes
- prevent users receiving alerts for an activity that they can't see. (Contributed by Julian Boulen)
- exception handling
v1.3
- now works in Moodle 2.5.*
- time zone adjustment based on recipient of the reminder
- reminder messages for activities (such as quizes, assignments, etc) are enhanced and visibility of some fields are restricted according to the constraints of such activities (eg: showing description field)
v1.2
- now works in Moodle 2.4.*
- fixed bug when sending reminders based on groups
- group reminder message content has been made richer by including course and activity details.
- added a setting to define the prefix for messages being sent, and added another setting to define to show/hide group name in the group reminder message.
- cron cycle interval for this plugin has been reduced from 1-hour to 15-minutes.
v1.1
- fixed bug of repeatedly sending reminders for same event.
- removed 'Only hidden events from calendar' option from the settings page.
- removed unused constants from the plugin.
- improved cron trace of the plugin for ignored events.
v1.0.1
- changed default settings
- removed usage of deprecated functions
License
GNU GPL v3 or later