<?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);
}
}