Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.2.x will end 22 April 2024 (12 months).
  • Bug fixes for security issues in 4.2.x will end 7 October 2024 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.1.x is supported too.
<?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 calendar footer view options data.
 *
 * @package    core_calendar
 * @copyright  2017 Simey Lameze <simey@moodle.com>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
namespace core_calendar\external;

defined('MOODLE_INTERNAL') || die();

use core\external\exporter;
use renderer_base;
use stdClass;
use moodle_url;

/**
 * Class for exporting calendar footer view options data.
 *
 * @copyright  2017 Simey Lameze
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class footer_options_exporter extends exporter {

    /**
     * @var \calendar_information $calendar The calendar to be rendered.
     */
    protected $calendar;

    /**
     * @var int $userid The user id.
     */
    protected $userid;

    /**
     * @var string $token The user sha1 token.
     */
    protected $token;

    /**
> * @var bool $showfullcalendarlink Whether the full calendar link should be displayed or not. * Constructor for month_exporter. > */ * > protected $showfullcalendarlink; * @param \calendar_information $calendar The calendar being represented > * @param int $userid The user id > /**
* @param string $token The user sha1 token.
> * @param array $options Display options for the footer. If an option is not set, a default value will be provided. */ > * It consists of: public function __construct(\calendar_information $calendar, $userid, $token) { > * - showfullcalendarlink - bool - Whether to show the full calendar link or not. Defaults to false.
< public function __construct(\calendar_information $calendar, $userid, $token) {
> public function __construct(\calendar_information $calendar, $userid, $token, array $options = []) {
$this->userid = $userid; $this->token = $token;
> $this->showfullcalendarlink = $options['showfullcalendarlink'] ?? false;
} /**
< * Get the export calendar button.
> * Get manage subscription link.
*
< * @return \single_button The export calendar button html.
> * @return string|null The manage subscription hyperlink.
*/
< protected function get_export_calendar_button() { < $exportcalendarurl = new moodle_url('/calendar/export.php', $this->get_link_params()); < return new \single_button($exportcalendarurl, get_string('exportcalendar', 'calendar'), 'get'); < } < < /** < * Get manage subscription button. < * < * @return string The manage subscription button html. < */ < protected function get_manage_subscriptions_button() {
> protected function get_manage_subscriptions_link(): ?string {
if (calendar_user_can_add_event($this->calendar->course)) {
< $managesubscriptionurl = new moodle_url('/calendar/managesubscriptions.php', $this->get_link_params()); < return new \single_button($managesubscriptionurl, < get_string('managesubscriptions', 'calendar'), 'get'); < } < } < < /** < * Get the list of URL parameters for calendar links. < * < * @return array < */ < protected function get_link_params() { < $params = []; < if (SITEID !== $this->calendar->course->id) { < $params['course'] = $this->calendar->course->id; < } else if (null !== $this->calendar->categoryid && $this->calendar->categoryid > 0) { < $params['category'] = $this->calendar->categoryid;
> $managesubscriptionurl = new moodle_url('/calendar/managesubscriptions.php'); > return $managesubscriptionurl->out(true);
}
< < return $params;
> return null;
} /** * Get the additional values to inject while exporting. * * @param renderer_base $output The renderer. * @return array Keys are the property names, values are their values. */ protected function get_other_values(renderer_base $output) { global $CFG; $values = new stdClass();
> $values->footerlinks = [];
< if (!empty($CFG->enablecalendarexport)) { < if ($exportbutton = $this->get_export_calendar_button()) { < $values->exportcalendarbutton = $exportbutton->export_for_template($output); < } < if ($managesubscriptionbutton = $this->get_manage_subscriptions_button()) { < $values->managesubscriptionbutton = $managesubscriptionbutton->export_for_template($output);
> if ($this->showfullcalendarlink) { > $values->footerlinks[] = (object)[ > 'url' => $this->get_calendar_url(), > 'linkname' => get_string('fullcalendar', 'calendar'), > ];
}
> } > if (!empty($CFG->enablecalendarexport) && $managesubscriptionlink = $this->get_manage_subscriptions_link()) { > $values->footerlinks[] = (object)[ return (array) $values; > 'url' => $managesubscriptionlink, } > 'linkname' => get_string('managesubscriptions', 'calendar'), > ];
/** * Return the list of additional properties. * * @return array */ public static function define_other_properties() {
< return array( < 'exportcalendarbutton' => [ < 'type' => PARAM_RAW, < 'default' => null,
> return [ > 'footerlinks' => [ > 'type' => [ > 'url' => [ > 'type' => PARAM_URL, > ], > 'linkname' => [ > 'type' => PARAM_TEXT, > ],
],
< 'managesubscriptionbutton' => [ < 'type' => PARAM_RAW, < 'default' => null,
> 'multiple' => true, > 'optional' => true,
],
< );
> ]; > } > > /** > * Build the calendar URL. > * > * @return string The calendar URL. > */ > public function get_calendar_url() { > $url = new moodle_url('/calendar/view.php', [ > 'view' => 'month', > 'time' => $this->calendar->time, > ]); > > return $url->out(false);
} }