Event Trigger

Admin tools ::: tool_trigger
Maintained by Catalyst IT
This plugin plugin allows site administrators to trigger external actions such as an http request or email when certain events happen in Moodle. Filters can be added to check if the event meets certain conditions and actions(email/http post) can include information contained within the Moodle event. Lookups can also be added to the workflow to allow information not contained within the Moodle event to be exposed to the external action.
Latest release:
643 sites
114 downloads
60 fans
Current versions available: 3
Download

Event Trigger

The Event Trigger allows Moodle Events to be monitored and a workflow to be triggered when that event occurs.
One of the main use cases of this plugin is to allow Moodle events to trigger actions in external systems.

Each workflow is made up of a series of steps. Steps can be things like:

  • Using event data to lookup user and course information
  • Filtering data based on a set of conditions
  • Performing an action like sending an email or Posting data to a HTTP endpoint or external API.

More configuration documentation can be found at the following link:

More Information on Moodle events can be found in the Moodle documentation at the following link:


Supported Moodle Versions

This plugin currently supports Moodle:

  • 3.3 (PHP 7 is required)
  • 3.4
  • 3.5

Moodle Plugin Installation

The following sections outline how to install the Moodle plugin.

Command Line Installation

To install the plugin in Moodle via the command line: (assumes a Linux based system)

  1. Get the code from GitHub or the Moodle Plugin Directory.
  2. Copy or clone code into: <moodledir>/admin/tool/trigger
  3. Run the upgrade: sudo -u www-data php admin/cli/upgrade Note: the user may be different to www-data on your system.

User Interface Installation

To install the plugin in Moodle via the Moodle User Interface:

  1. Log into your Moodle as an Administrator.
  2. Navigate to: Site administration > Plugins > Install Plugins
  3. Install plugin from Moodle Plugin directory or via zip upload.

Plugin Setup

Plugin setup and configuration documentation can be found at the following link:


Crafted by Catalyst IT

This plugin was developed by Catalyst IT:

https://www.catalyst-au.net/

Catalyst IT

Contributing and Support

Issues, and pull requests using github are welcome and encouraged!

https://github.com/catalyst/moodle-tool_trigger/issues

If you would like commercial support or would like to sponsor additional improvements to this plugin please contact us:

https://www.catalyst-au.net/contact-us


Useful links

More documentation on this plugin
Source control URL
Bug tracker

Screenshots

Screenshot #0
Screenshot #1
Screenshot #2
Screenshot #3

Contributors

Catalyst IT (Lead maintainer)
View other contributions
Catalyst logo
Aaron Wells
View other contributions
Matt Porritt
View other contributions
Dan Marsden
View other contributions
Please login to view contributors details and/or to contact them

Awards

Early bird 3.5
Early bird 3.5
Automated testing support
Automated testing support
Privacy friendly
Privacy friendly

Comments RSS

Show comments
  • Jim Valentine
    Mon, Jul 6, 2020, 11:48 PM
    Hello,

    I would like to set up an event trigger on course completion - which appears easily done. The only problem I have is that I wish to trigger different actions for course completion on different courses. Is this possible with this plugin?

    Regards
  • Kushan Rathnasekara
    Sat, Feb 20, 2021, 11:52 AM
    Dear All,

    I want to send auto-generated email to the enrolled students on new activity uploaded to the particular course. My moodle version is 3.10. Any possibility to accommodate that ? Pls Guide. Txs
  • Hossein K
    Thu, Jul 8, 2021, 11:42 PM
    Hello
    Can we use a Real user name, Real full course name, and real user email address when an email send o admin for example?
  • Dan Marsden
    Fri, Jul 9, 2021, 5:52 AM
    @Hossein/@Kushan - probably best that you install the plugin and test it to see if it does what you want.
  • Rehan Amjad
    Fri, Oct 8, 2021, 6:55 PM
    Hi,

    When will be new version release for Moodle 3.11?

    Thanks
  • Dan Marsden
    Sat, Oct 9, 2021, 5:12 AM
    @Rehan - the latest version of all our plugins is always in our github repositories - we do not regularly update the moodle.org plugins db with the latest version of all our plugins and do not provide dates/times of release dates - for some plugins we rely on the community to test the plugin and let us know if it works in a newer release - please test the plugin yourself in 3.11 and report any issues you have to our github tracker - (i;m not currently aware of any issues that would prevent it from working in 3.11)
  • Hussein Allaham
    Fri, Jan 21, 2022, 6:11 PM
    Hi

    I'm trying to send users grade through HTTP post,
    but in order to send them by HTTP post I have to add a token,
    how to GET token through HTTP request and send it back as one of the parameter with the grades in POST HTTP request

    Best
    Hussein
  • Ben Girard
    Wed, Jul 6, 2022, 2:43 AM
    Does anyone know if installing this plugin in 4.0 will work.. We're forced to upgrade ASAP.
  • Dan Marsden
    Wed, Jul 6, 2022, 3:43 AM
    @ben - we're not aware of any reason it wouldn't but as always, latest version of our plugins are in github and please report any issues you find to our issues tracker.
  • bruno silva
    Tue, Aug 9, 2022, 1:32 AM
    Hello, I can see that this plugin is essential for those who need a more automated Moodle. However, I have a situation where I want to send an email to the student when he accesses the course certificate. I can get the course name through the plugin, but I can't get the username. The "Lookup Course" parameter works correctly. The parameter "Lookup User" I can't make it work. I have Moodle 3.11.5. Would it have anything to do with it?
  • Joe Drews
    Sat, Feb 4, 2023, 2:35 AM
    The User Lookup DOES NOT WORK as the last commentor said. We've looked at the source code and cannot seem to find what the problem is. THIS WILL NOT SEND EMAILS TO ENROLLED USERS IN ITS CURRENT STATE
  • Dan Marsden
    Tue, Feb 7, 2023, 5:04 AM
    @Joe - if you have internal development capabilities, feel free to do some further investigation and submit a pull request if you track it down! - otherwise we're in the process of re-developing this plugin here: https://github.com/catalyst/moodle-tool_dataflows

    Feel free to try that one out and see if it works better for your needs!
  • Ritik Pathak
    Mon, Feb 27, 2023, 5:50 PM
    I'm done this for assignment grading but when i chose in action email the email should not be get i use {user_email}& also use user_lookup please sovle it fastly
  • Dan Marsden
    Tue, Feb 28, 2023, 7:18 AM
    @Ritik - as mentioned in the comments above, our main recent focus has been on a new plugin to replace this one called "tool_dataflows", however we welcome pull requests against the main tool_trigger repository if you have development capabilities and are able to help! - if not, you might want to try out our new plugin and see if it meets your needs. (it isn't published in the plugins db yet, only in github.)
  • Ritik Pathak
    Tue, Feb 28, 2023, 3:52 PM
    how to add a event fields in workflow steps
1 2 3
Please login to post comments