2 // This file is part of Moodle - http://moodle.org/
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.
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.
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/>.
18 * User enrolment updated event.
21 * @copyright 2013 Rajesh Taneja <rajesh@moodle.com>
22 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
26 defined('MOODLE_INTERNAL') ||
die();
29 * Event class for when user enrolment is updated.
31 * @property-read array $other {
32 * Extra information about event.
34 * - string enrol: name of enrolment instance.
39 * @copyright 2013 Rajesh Taneja <rajesh@moodle.com>
40 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
42 class user_enrolment_updated
extends base
{
45 * Initialise required event data properties.
47 protected function init() {
48 $this->data
['objecttable'] = 'user_enrolments';
49 $this->data
['crud'] = 'u';
50 $this->data
['edulevel'] = self
::LEVEL_OTHER
;
54 * Returns localised event name.
58 public static function get_name() {
59 return get_string('eventuserenrolmentupdated', 'core_enrol');
63 * Returns non-localised event description with id's for admin use only.
67 public function get_description() {
68 return "The user with id '$this->userid' updated the enrolment for the user with id '$this->relateduserid' using the " .
69 "enrolment method '{$this->other['enrol']}' in the course with id '$this->courseid'.";
73 * Returns relevant URL.
77 public function get_url() {
78 return new \
moodle_url('/enrol/editenrolment.php', array('ue' => $this->objectid
));
82 * Return name of the legacy event, which is replaced by this event.
84 * @return string legacy event name
86 public static function get_legacy_eventname() {
87 return 'user_enrol_modified';
91 * Return user_enrol_modified legacy event data.
95 protected function get_legacy_eventdata() {
96 $legacyeventdata = $this->get_record_snapshot('user_enrolments', $this->objectid
);
97 $legacyeventdata->enrol
= $this->other
['enrol'];
98 $legacyeventdata->courseid
= $this->courseid
;
99 return $legacyeventdata;
105 * @throws \coding_exception
108 protected function validate_data() {
109 parent
::validate_data();
110 if (!isset($this->other
['enrol'])) {
111 throw new \
coding_exception('The \'enrol\' value must be set in other.');
113 if (!isset($this->relateduserid
)) {
114 throw new \
coding_exception('The \'relateduserid\' must be set.');