Skip to content
A Moodle local plugin for automating email reminders for calendar events
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


=== Reminders "Local Plugin" ===

Author:    Isuru Madushanka Weerarathna (
Copyright: 2016 Isuru Madushanka Weerarathna
License: GNU GPL v3 or later
Version:   1.6.1

== Introduction ==
This plugin will create a set of reminders for Moodle calendar events and will send them automatically
to relevant users in timely manner. Reminders are very useful for both students as well as teachers 
to recall their scheduled event before the actual moment.

== Requirements ==
    This plugin has been developed in Moodle 2.2,2.3,2.4,2.5,2.6,2.7,2.8, 2.9 and 3.0 and successfully tested on a simple local server.
    This plugin should be working any Moodle version greater than or equal to v2.0.	
    Moodle logging must be enabled to operate properly. (Only if you are using a version 2.6 or below)

== Installation ==
1. Fetch the plug-in from following location.
     + Download a suitable version compatible with your Moodle server.
2. Goto the Moodle root directory and go inside 'local' directory.
3. Create a folder named 'reminders'.
4. Now extract the downloaded zip file inside to this folder. After it is extracted,
    all files and folders must compliance with given structure as shown in below.
5. Log into the Moodle site as the admin user. Usually the new plug-in must be identified
    and notified you when logged-in. If not then goto Site Administration -> Notifications
    to install the local plug-in.
6. Now you can change the plug-in specific settings via Site Administration -> Plugins -> Local Plugins -> Reminders.

== Change Log ==
    + Fix login redirect loop in Moodle v3.5, 3.6 and 3.7.
    + Support for Moodle v3.5 and above.
    + Migrated to new Moodle task API.
    + Fixed a bug where group reminders are not assigned when the event instance is empty
    + 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]:
    + Fix cron error caused by $courseroleids (thanks to [cdsmith-umn]:

    + support for moodle 2.9+
    + ability to specify a custom schedule for sending reminders for any event type.

	+ support for moodle 2.8 (thanks to [jojoob]:
	+ course specific settings added for reminders (thanks to [jojoob]:
    + now works in Moodle 2.7.*
    + fixed bug sending reminders repeatedly to users.

    + bug fixes
    + prevent users receiving alerts for an activity that they can't see. (Contributed by Julian Boulen)
    + exception handling
    + 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)

    + 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.
    + 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.

    + changed default settings
    + removed usage of deprecated functions

== Configurations ==
Since Moodle v3.5
To change the schedule of this plugin, go to Site administration -> Server -> Scheduled tasks,
and find the Local Reminders item from the list.
Click the settings icon, and change the cron expression as desired.

Before Moodle v3.5:
If you want to change the cron cycle frequency, open the version.php file in the plug-in's root
directory and change the value for $plugin->cron. This value must be indicated by seconds. The
default value is 3600 seconds (i.e. 1 hour).
This frequency will be affected to the performance of Moodle cron system. Too much small value
will be an additional overhead while large value will be a problem of flooding the message
interface because of trying to send too many reminders at once.

== Folder Structure ==
All following folders/files must be put in to the local directory of Moodle root folder to work properly.


== Feedback ==
You can tell about this plug-in directly to me ( or 
to the Moodle contributed tracker (

-Good Luck!-
You can’t perform that action at this time.