See Release Notes
Long Term Support Release
<?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/>. /** * Class for exporting a course summary from an stdClass. * * @package core_course * @copyright 2015 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_course\external; defined('MOODLE_INTERNAL') || die(); use renderer_base; use moodle_url; /** * Class for exporting a course summary from an stdClass. * * @copyright 2015 Damyon Wiese * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class course_summary_exporter extends \core\external\exporter { /** * Constructor - saves the persistent object, and the related objects. * * @param mixed $data - Either an stdClass or an array of values. * @param array $related - An optional list of pre-loaded objects related to this object. */ public function __construct($data, $related = array()) { if (!array_key_exists('isfavourite', $related)) { $related['isfavourite'] = false; } parent::__construct($data, $related); } protected static function define_related() { // We cache the context so it does not need to be retrieved from the course. return array('context' => '\\context', 'isfavourite' => 'bool?'); } protected function get_other_values(renderer_base $output) { global $CFG; $courseimage = self::get_course_image($this->data); if (!$courseimage) { $courseimage = $output->get_generated_image_for_id($this->data->id); } $progress = self::get_course_progress($this->data); $hasprogress = false; if ($progress === 0 || $progress > 0) { $hasprogress = true; }< $progress = floor($progress);> $progress = floor($progress ?? 0);$coursecategory = \core_course_category::get($this->data->category, MUST_EXIST, true); return array( 'fullnamedisplay' => get_course_display_name_for_list($this->data), 'viewurl' => (new moodle_url('/course/view.php', array('id' => $this->data->id)))->out(false), 'courseimage' => $courseimage, 'progress' => $progress, 'hasprogress' => $hasprogress, 'isfavourite' => $this->related['isfavourite'], 'hidden' => boolval(get_user_preferences('block_myoverview_hidden_course_' . $this->data->id, 0)), 'showshortname' => $CFG->courselistshortnames ? true : false, 'coursecategory' => $coursecategory->name ); } public static function define_properties() { return array( 'id' => array( 'type' => PARAM_INT, ), 'fullname' => array( 'type' => PARAM_TEXT, ), 'shortname' => array( 'type' => PARAM_TEXT, ), 'idnumber' => array( 'type' => PARAM_RAW, ), 'summary' => array( 'type' => PARAM_RAW, 'null' => NULL_ALLOWED ), 'summaryformat' => array( 'type' => PARAM_INT, ), 'startdate' => array( 'type' => PARAM_INT, ), 'enddate' => array( 'type' => PARAM_INT, ), 'visible' => array( 'type' => PARAM_BOOL,< )> ), > 'showactivitydates' => [ > 'type' => PARAM_BOOL, > 'null' => NULL_ALLOWED > ], > 'showcompletionconditions' => [ > 'type' => PARAM_BOOL, > 'null' => NULL_ALLOWED > ],); } /** * Get the formatting parameters for the summary. * * @return array */ protected function get_format_parameters_for_summary() { return [ 'component' => 'course', 'filearea' => 'summary', ]; } public static function define_other_properties() { return array( 'fullnamedisplay' => array( 'type' => PARAM_TEXT, ), 'viewurl' => array( 'type' => PARAM_URL, ), 'courseimage' => array( 'type' => PARAM_RAW, ), 'progress' => array( 'type' => PARAM_INT, 'optional' => true ), 'hasprogress' => array( 'type' => PARAM_BOOL ), 'isfavourite' => array( 'type' => PARAM_BOOL ), 'hidden' => array( 'type' => PARAM_BOOL ), 'timeaccess' => array( 'type' => PARAM_INT, 'optional' => true ), 'showshortname' => array( 'type' => PARAM_BOOL ), 'coursecategory' => array( 'type' => PARAM_TEXT ) ); } /** * Get the course image if added to course. * * @param object $course< * @return string url of course image> * @return string|false url of course image or false if it's not exist.*/ public static function get_course_image($course) {< global $CFG; < $courseinlist = new \core_course_list_element($course); < foreach ($courseinlist->get_course_overviewfiles() as $file) { < if ($file->is_valid_image()) { < $pathcomponents = [ < '/pluginfile.php', < $file->get_contextid(), < $file->get_component(), < $file->get_filearea() . $file->get_filepath() . $file->get_filename() < ]; < $path = implode('/', $pathcomponents); < return (new moodle_url($path))->out(); < }> $image = \cache::make('core', 'course_image')->get($course->id); > > if (is_null($image)) { > $image = false;}< return false;> > return $image;} /** * Get the course pattern datauri. * * The datauri is an encoded svg that can be passed as a url. * @param object $course * @return string datauri * @deprecated 3.7 */ public static function get_course_pattern($course) { global $OUTPUT; debugging('course_summary_exporter::get_course_pattern() is deprecated. ' . 'Please use $OUTPUT->get_generated_image_for_id() instead.', DEBUG_DEVELOPER); return $OUTPUT->get_generated_image_for_id($course->id); } /** * Get the course progress percentage. * * @param object $course * @return int progress */ public static function get_course_progress($course) { return \core_completion\progress::get_course_progress_percentage($course); } /** * Get the course color. * * @param int $courseid * @return string hex color code. * @deprecated 3.7 */ public static function coursecolor($courseid) { global $OUTPUT; debugging('course_summary_exporter::coursecolor() is deprecated. ' . 'Please use $OUTPUT->get_generated_color_for_id() instead.', DEBUG_DEVELOPER); return $OUTPUT->get_generated_color_for_id($courseid); } }