. /** * Contains the default section availability output class. * * @package core_courseformat * @copyright 2020 Ferran Recio * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_courseformat\output\local\content\section; use core_courseformat\base as course_format; use section_info; use renderable; use templatable; use core_availability\info_section; use core_availability\info; use context_course; use stdClass; /** * Base class to render section availability. * * @package core_courseformat * @copyright 2020 Ferran Recio * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class availability implements renderable, templatable { /** @var course_format the course format class */ protected $format; /** @var section_info the section object */ protected $section; /** * Constructor. * * @param course_format $format the course format * @param section_info $section the section info */ public function __construct(course_format $format, section_info $section) { $this->format = $format; $this->section = $section; } /** * Export this data so it can be used as the context for a mustache template. * * @param \renderer_base $output typically, the renderer that's calling this function * @return stdClass data context for a mustache template */ public function export_for_template(\renderer_base $output): stdClass { $data = (object)[ 'info' => $this->get_info($output), ]; if (!empty($data->info)) { $data->hasavailability = true; } return $data; } /** * Export this data so it can be used as the context for a mustache template. * * If section is not visible, display the message about that ('Not available * until...', that sort of thing). Otherwise, returns blank. * * For users with the ability to view hidden sections, it shows the * information even though you can view the section and also may include * slightly fuller information (so that teachers can tell when sections * are going to be unavailable etc). This logic is the same as for * activities. * * @param renderer_base $output typically, the renderer that's calling this function * @return stdclass data context for a mustache template */ protected function get_info(\renderer_base $output): array { global $CFG, $USER; $section = $this->section; $context = context_course::instance($section->course); $canviewhidden = has_capability('moodle/course:viewhiddensections', $context, $USER); $info = []; if (!$section->visible) { if ($canviewhidden) { $info[] = $this->availability_info(get_string('hiddenfromstudents'), 'ishidden'); } else { // We are here because of the setting "Hidden sections are shown in collapsed form". // Student can not see the section contents but can see its name. $info[] = $this->availability_info(get_string('notavailable'), 'ishidden'); } } else if (!$section->uservisible) { if ($section->availableinfo) { // Note: We only get to this function if availableinfo is non-empty, // so there is definitely something to print. $formattedinfo = info::format_info($section->availableinfo, $section->course); $info[] = $this->availability_info($formattedinfo, 'isrestricted'); } } else if ($canviewhidden && !empty($CFG->enableavailability)) { // Check if there is an availability restriction. $ci = new info_section($section); $fullinfo = $ci->get_full_information(); if ($fullinfo) { $formattedinfo = info::format_info($fullinfo, $section->course); $info[] = $this->availability_info($formattedinfo, 'isrestricted isfullinfo'); } } return $info; } /** * Generate the basic availability information data. * * @param string $text the formatted avalability text * @param string $additionalclasses additional css classes * @return stdClass the availability information data */ protected function availability_info($text, $additionalclasses = ''): stdClass { $data = (object)[ 'text' => $text, 'classes' => $additionalclasses ]; $additionalclasses = array_filter(explode(' ', $additionalclasses)); if (in_array('ishidden', $additionalclasses)) { $data->ishidden = 1; } else if (in_array('isstealth', $additionalclasses)) { $data->isstealth = 1; } else if (in_array('isrestricted', $additionalclasses)) { $data->isrestricted = 1; if (in_array('isfullinfo', $additionalclasses)) { $data->isfullinfo = 1; } } return $data; } }