Current Path : C:/Users/Mahmood/Desktop/moodle8/lib/classes/event/ |
Current File : C:/Users/Mahmood/Desktop/moodle8/lib/classes/event/badge_awarded.php |
<?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/>. /** * Badge awarded event. * * @property-read array $other { * Extra information about event. * * - int expiredate: Badge expire timestamp. * - int badgeissuedid: Badge issued ID. * } * * @package core * @copyright 2015 James Ballard * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core\event; defined('MOODLE_INTERNAL') || die(); /** * Event triggered after a badge is awarded to a user. * * @package core * @since Moodle 2.9 * @copyright 2015 James Ballard * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class badge_awarded extends base { /** * Set basic properties for the event. */ protected function init() { $this->data['objecttable'] = 'badge'; $this->data['crud'] = 'c'; $this->data['edulevel'] = self::LEVEL_TEACHING; } /** * Returns localised general event name. * * @return string */ public static function get_name() { return get_string('eventbadgeawarded', 'badges'); } /** * Returns non-localised event description with id's for admin use only. * * @return string */ public function get_description() { return "The user with id '$this->relateduserid' has been awarded the badge with id '".$this->objectid."'."; } /** * Returns relevant URL. * @return \moodle_url */ public function get_url() { return new \moodle_url('/badges/overview.php', array('id' => $this->objectid)); } /** * Custom validations. * * @throws \coding_exception * @return void */ protected function validate_data() { parent::validate_data(); if (!isset($this->relateduserid)) { throw new \coding_exception('The \'relateduserid\' must be set.'); } if (!isset($this->objectid)) { throw new \coding_exception('The \'objectid\' must be set.'); } } public static function get_objectid_mapping() { return array('db' => 'badge', 'restore' => 'badge'); } public static function get_other_mapping() { $othermapped = array(); $othermapped['badgeissuedid'] = array('db' => 'badge_issued', 'restore' => base::NOT_MAPPED); return $othermapped; } }