weekly release 2.3dev
[moodle.git] / lib / db / events.php
1 <?php
2 // This file is part of Moodle - http://moodle.org/
3 //
4 // Moodle is free software: you can redistribute it and/or modify
5 // it under the terms of the GNU General Public License as published by
6 // the Free Software Foundation, either version 3 of the License, or
7 // (at your option) any later version.
8 //
9 // Moodle is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12 // GNU General Public License for more details.
13 //
14 // You should have received a copy of the GNU General Public License
15 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
17 /**
18  * Definition of core event handler and description of all events throws from core.
19  *
20  * @package core
21  * @category event
22  * @copyright 2007 onwards Martin Dougiamas  http://dougiamas.com
23  * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
24  */
26 defined('MOODLE_INTERNAL') || die();
28 /* List of handlers */
30 $handlers = array(
32 /*
33  * portfolio queued event - for non interactive file transfers
34  * NOTE: this is a HACK, please do not add any more things like this here
35  *       (it is just abusing cron to do very time consuming things which is wrong any way)
36  *
37  * TODO: this has to be moved into separate queueing framework....
38  */
39     'portfolio_send' => array (
40         'handlerfile'      => '/lib/portfolio.php',
41         'handlerfunction'  => 'portfolio_handle_event',    // argument to call_user_func(), could be an array
42         'schedule'         => 'cron',
43         'internal'         => 0,
44     ),
47 /* no more here please, core should not consume any events!!!!!!! */
48 );
53 /* List of events thrown from Moodle core
55 ==== user related events ====
57 user_created - object user table record
58 user_updated - object user table record
59 user_deleted - object user table record
60 user_logout - full $USER object
62 ==== course related events ====
64 course_category_updated - object course_categories table record
65 course_category_created - object course_categories table record
66 course_category_deleted - object course_categories table record
68 course_created - object course table record
69 course_updated - object course table record
70 course_content_removed - object course table record + context property
71 course_deleted - object course table record + context property
73 user_enrolled - object record from user_enrolments table + courseid,enrol
74 user_enrol_modified - object record from user_enrolments table + courseid,enrol
75 user_unenrolled - object record from user_enrolments table + courseid,enrol,lastenrol
77 ==== cohort related events ===
80 cohort_added - object cohort table record
81 cohort_updated - object cohort table record
82 cohort_deleted - object cohort table record
84 cohort_member_added - object cohortid, userid properties
85 cohort_member_removed - object cohortid, userid properties
87 ==== group related events ====
89 groups_group_created - object groups_group table record
90 groups_group_updated - object groups_group table record
91 groups_group_deleted - object groups_group table record
93 groups_member_added   - object userid, groupid properties
94 groups_member_removed - object userid, groupid properties
96 groups_grouping_created - object groups_grouping table record
97 groups_grouping_updated - object groups_grouping table record
98 groups_grouping_deleted - object groups_grouping table record
100 groups_members_removed          - object courseid+userid - removed all users (or one user) from all groups in course
101 groups_groupings_groups_removed - int course id - removed all groups from all groupings in course
102 groups_groups_deleted           - int course id - deleted all course groups
103 groups_groupings_deleted        - int course id - deleted all course groupings
105 ==== role related events ====
107 role_assigned         - object role_assignments table record
108 role_unassigned       - object role_assignments table record
110 ==== activity module events ====
112 mod_deleted - int courseid, int cmid, text modulename - happens when a module is deleted
113 mod_created - int courseid, int cmid, text modulename - happens when a module is created
114 mod_updated - int courseid, int cmid, text modulename - happens when a module is updated
116 */