AutorÃa | Ultima modificación | Ver Log |
<?php// This file is part of Moodle - http://moodle.org///// Moodle is free software: you can redistribute it and/or modify// it under the terms of the GNU General Public License as published by// the Free Software Foundation, either version 3 of the License, or// (at your option) any later version.//// Moodle is distributed in the hope that it will be useful,// but WITHOUT ANY WARRANTY; without even the implied warranty of// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the// GNU General Public License for more details.//// You should have received a copy of the GNU General Public License// along with Moodle. If not, see <http://www.gnu.org/licenses/>./*** Event observer for meta enrolment plugin.** @package enrol_meta* @copyright 2013 Rajesh Taneja <rajesh@moodle.com>* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later*/defined('MOODLE_INTERNAL') || die();require_once($CFG->dirroot.'/enrol/meta/locallib.php');/*** Event observer for enrol_meta.** @package enrol_meta* @copyright 2013 Rajesh Taneja <rajesh@moodle.com>* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later*/class enrol_meta_observer extends enrol_meta_handler {/*** Triggered via user_enrolment_created event.** @param \core\event\user_enrolment_created $event* @return bool true on success.*/public static function user_enrolment_created(\core\event\user_enrolment_created $event) {if (!enrol_is_enabled('meta')) {// No more enrolments for disabled plugins.return true;}if ($event->other['enrol'] === 'meta') {// Prevent circular dependencies - we can not sync meta enrolments recursively.return true;}self::sync_course_instances($event->courseid, $event->relateduserid);return true;}/*** Triggered via user_enrolment_deleted event.** @param \core\event\user_enrolment_deleted $event* @return bool true on success.*/public static function user_enrolment_deleted(\core\event\user_enrolment_deleted $event) {if (!enrol_is_enabled('meta')) {// This is slow, let enrol_meta_sync() deal with disabled plugin.return true;}if ($event->other['enrol'] === 'meta') {// Prevent circular dependencies - we can not sync meta enrolments recursively.return true;}self::sync_course_instances($event->courseid, $event->relateduserid);return true;}/*** Triggered via user_enrolment_updated event.** @param \core\event\user_enrolment_updated $event* @return bool true on success*/public static function user_enrolment_updated(\core\event\user_enrolment_updated $event) {if (!enrol_is_enabled('meta')) {// No modifications if plugin disabled.return true;}if ($event->other['enrol'] === 'meta') {// Prevent circular dependencies - we can not sync meta enrolments recursively.return true;}self::sync_course_instances($event->courseid, $event->relateduserid);return true;}/*** Triggered via role_assigned event.** @param \core\event\role_assigned $event* @return bool true on success.*/public static function role_assigned(\core\event\role_assigned $event) {if (!enrol_is_enabled('meta')) {return true;}// Prevent circular dependencies - we can not sync meta roles recursively.if ($event->other['component'] === 'enrol_meta') {return true;}// Only course level roles are interesting.if (!$parentcontext = context::instance_by_id($event->contextid, IGNORE_MISSING)) {return true;}if ($parentcontext->contextlevel != CONTEXT_COURSE) {return true;}self::sync_course_instances($parentcontext->instanceid, $event->relateduserid);return true;}/*** Triggered via role_unassigned event.** @param \core\event\role_unassigned $event* @return bool true on success*/public static function role_unassigned(\core\event\role_unassigned $event) {if (!enrol_is_enabled('meta')) {// All roles are removed via cron automatically.return true;}// Prevent circular dependencies - we can not sync meta roles recursively.if ($event->other['component'] === 'enrol_meta') {return true;}// Only course level roles are interesting.if (!$parentcontext = context::instance_by_id($event->contextid, IGNORE_MISSING)) {return true;}if ($parentcontext->contextlevel != CONTEXT_COURSE) {return true;}self::sync_course_instances($parentcontext->instanceid, $event->relateduserid);return true;}/*** Triggered via course_deleted event.** @param \core\event\course_deleted $event* @return bool true on success*/public static function course_deleted(\core\event\course_deleted $event) {global $DB;if (!enrol_is_enabled('meta')) {// This is slow, let enrol_meta_sync() deal with disabled plugin.return true;}// Does anything want to sync with this parent?if (!$enrols = $DB->get_records('enrol', array('customint1' => $event->objectid, 'enrol' => 'meta'),'courseid ASC, id ASC')) {return true;}$plugin = enrol_get_plugin('meta');$unenrolaction = $plugin->get_config('unenrolaction', ENROL_EXT_REMOVED_SUSPENDNOROLES);if ($unenrolaction == ENROL_EXT_REMOVED_UNENROL) {// Simple, just delete this instance which purges all enrolments,// admins were warned that this is risky setting!foreach ($enrols as $enrol) {$plugin->delete_instance($enrol);}return true;}foreach ($enrols as $enrol) {if ($unenrolaction == ENROL_EXT_REMOVED_SUSPEND or $unenrolaction == ENROL_EXT_REMOVED_SUSPENDNOROLES) {// This makes all enrolments suspended very quickly.$plugin->update_status($enrol, ENROL_INSTANCE_DISABLED);}if ($unenrolaction == ENROL_EXT_REMOVED_SUSPENDNOROLES) {$context = context_course::instance($enrol->courseid);role_unassign_all(array('contextid'=>$context->id, 'component'=>'enrol_meta', 'itemid'=>$enrol->id));}}return true;}/*** Triggered via enrol_instance_updated event.** @param \core\event\enrol_instance_updated $event* @return boolean*/public static function enrol_instance_updated(\core\event\enrol_instance_updated $event) {global $DB;if (!enrol_is_enabled('meta')) {// This is slow, let enrol_meta_sync() deal with disabled plugin.return true;}// Does anything want to sync with this parent?$affectedcourses = $DB->get_fieldset_sql('SELECT DISTINCT courseid FROM {enrol} '.'WHERE customint1 = ? AND enrol = ?',array($event->courseid, 'meta'));foreach ($affectedcourses as $courseid) {enrol_meta_sync($courseid);}return true;}}