Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.11.x will end 14 Nov 2022 (12 months plus 6 months extension).
  • Bug fixes for security issues in 3.11.x will end 13 Nov 2023 (18 months plus 12 months extension).
  • PHP version: minimum PHP 7.3.0 Note: minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is supported too.
/theme/ -> index.php (source)
<?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/>.

/**
 * This page provides the Administration -> ... -> Theme selector UI.
 *
 * @package core
 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

require_once(__DIR__ . '/../config.php');
require_once($CFG->libdir . '/adminlib.php');

$choose = optional_param('choose', '', PARAM_PLUGIN);
$reset  = optional_param('reset', 0, PARAM_BOOL);
$device = optional_param('device', '', PARAM_TEXT);
$unsettheme = optional_param('unsettheme', 0, PARAM_BOOL);
$confirmation = optional_param('confirmation', 0, PARAM_BOOL);

admin_externalpage_setup('themeselector');

if (!empty($device)) {
    // Make sure the device requested is valid.
    $devices = core_useragent::get_device_type_list();
    if (!in_array($device, $devices)) {
        // The provided device isn't a valid device throw an error.
< print_error('invaliddevicetype');
> throw new \moodle_exception('invaliddevicetype');
} } unset($SESSION->theme);
> > $PAGE->set_primary_active_tab('siteadminnode'); if ($reset and confirm_sesskey()) { > $PAGE->navbar->add(get_string('themeselector', 'admin'), $PAGE->url);
theme_reset_all_caches(); } else if ($choose && $confirmation) { $theme = theme_config::load($choose); echo $OUTPUT->header(); echo $OUTPUT->heading(get_string('themesaved')); echo $OUTPUT->box_start(); echo format_text(get_string('choosereadme', 'theme_'.$theme->name), FORMAT_MOODLE); echo $OUTPUT->box_end(); echo $OUTPUT->continue_button($CFG->wwwroot . '/theme/index.php'); echo $OUTPUT->footer(); exit; } else if ($choose && $device && !theme_is_device_locked($device) && !$unsettheme && confirm_sesskey()) { // Load the theme to make sure it is valid. $theme = theme_config::load($choose); // Get the config argument for the chosen device. $themename = core_useragent::get_device_type_cfg_var_name($device); set_config($themename, $theme->name); $urlconfirm = new moodle_url('/theme/index.php', array('confirmation' => 1, 'choose' => $choose)); redirect($urlconfirm); } else if ($device && !theme_is_device_locked($device) && $unsettheme && confirm_sesskey() && ($device != 'default')) { // Unset the theme and continue. unset_config(core_useragent::get_device_type_cfg_var_name($device)); $device = ''; } // Otherwise, show either a list of devices, or is enabledevicedetection set to no or a // device is specified show a list of themes. $table = new html_table(); $table->data = array(); $heading = ''; if (!empty($CFG->enabledevicedetection) && empty($device)) { $heading = get_string('selectdevice', 'admin'); // Display a list of devices that a user can select a theme for. $strthemenotselected = get_string('themenoselected', 'admin'); $strthemeselect = get_string('themeselect', 'admin'); // Display the device selection screen. $table->id = 'admindeviceselector'; $table->head = array(get_string('devicetype', 'admin'), get_string('currenttheme', 'admin'), get_string('info')); $devices = core_useragent::get_device_type_list(); foreach ($devices as $thedevice) { $headingthemename = ''; // To output the picked theme name when needed. $themename = core_useragent::get_device_type_theme($thedevice); if (!$themename && $thedevice == 'default') { $themename = theme_config::DEFAULT_THEME; } $themelocked = theme_is_device_locked($thedevice); $screenshotcell = $strthemenotselected; $unsetthemebutton = ''; if ($themename) { // Check the theme exists. $themename = clean_param($themename, PARAM_THEME); if (empty($themename)) { // Likely the theme has been deleted. unset_config(core_useragent::get_device_type_cfg_var_name($thedevice)); } else { $strthemename = get_string('pluginname', 'theme_'.$themename); // Link to the screenshot, now mandatory - the image path is hardcoded because we need image from other themes, // not the current one. $screenshoturl = new moodle_url('/theme/image.php', array('theme' => $themename, 'image' => 'screenshot', 'component' => 'theme')); // Contents of the screenshot/preview cell. $screenshotcell = html_writer::empty_tag('img', array('class' => 'img-fluid', 'src' => $screenshoturl, 'alt' => $strthemename)); // Show the name of the picked theme. $headingthemename = $OUTPUT->heading($strthemename, 3); } // If not default device then show option to unset theme. if ($thedevice != 'default' && !$themelocked) { $unsetthemestr = get_string('unsettheme', 'admin'); $unsetthemeurl = new moodle_url('/theme/index.php', array('device' => $thedevice, 'sesskey' => sesskey(), 'unsettheme' => true)); $unsetthemebutton = new single_button($unsetthemeurl, $unsetthemestr, 'get'); $unsetthemebutton = $OUTPUT->render($unsetthemebutton); } } $deviceurl = new moodle_url('/theme/index.php', array('device' => $thedevice, 'sesskey' => sesskey())); $select = ''; if (!$themelocked) { $select = $OUTPUT->render(new single_button($deviceurl, $strthemeselect, 'get')); } $lockwarning = ''; if ($themelocked) { $lockwarning = html_writer::div(get_string('configoverride', 'admin'), 'alert alert-info'); } $table->data[] = array( $OUTPUT->heading(ucfirst($thedevice), 3), $screenshotcell, $headingthemename . $lockwarning . $select . $unsetthemebutton ); } } else { // Either a device has been selected of $CFG->enabledevicedetection is off so display a list // of themes to select. $heading = get_string('selecttheme', 'admin', $device); if (empty($device)) { // If $CFG->enabledevicedetection is off this will return 'default'. $device = core_useragent::get_device_type(); } $themelocked = theme_is_device_locked($device); $table->id = 'adminthemeselector'; $table->head = array(get_string('theme'), get_string('info')); $themes = array(); if ($themelocked) { $heading = get_string('currenttheme', 'admin'); $themename = theme_get_locked_theme_for_device($device); $themedirectory = core_component::get_plugin_directory('theme', $themename); $themes[$themename] = $themedirectory; } else { $themes = core_component::get_plugin_list('theme'); } foreach ($themes as $themename => $themedir) { // Load the theme config. try { $theme = theme_config::load($themename); } catch (Exception $e) { // Bad theme, just skip it for now. continue; } if ($themename !== $theme->name) { // Obsoleted or broken theme, just skip for now. continue; } if (empty($CFG->themedesignermode) && $theme->hidefromselector) { // The theme doesn't want to be shown in the theme selector and as theme // designer mode is switched off we will respect that decision. continue; } $strthemename = get_string('pluginname', 'theme_'.$themename); // Build the table row, and also a list of items to go in the second cell. $row = array(); $infoitems = array(); $rowclasses = array(); // Set up bools whether this theme is chosen either main or legacy. $ischosentheme = ($themename == core_useragent::get_device_type_theme($device)); if ($ischosentheme) { // Is the chosen main theme. $rowclasses[] = 'selectedtheme'; } // Link to the screenshot, now mandatory - the image path is hardcoded because we need image from other themes, // not the current one. $screenshotpath = new moodle_url('/theme/image.php', array('theme' => $themename, 'image' => 'screenshot', 'component' => 'theme')); // Contents of the first screenshot/preview cell. $row[] = html_writer::empty_tag('img', array('class' => 'img-fluid', 'src' => $screenshotpath, 'alt' => $strthemename)); // Contents of the second cell. $infocell = $OUTPUT->heading($strthemename, 3); if ($themelocked) { $infocell .= html_writer::div(get_string('configoverride', 'admin'), 'alert alert-info'); } // Button to choose this as the main theme or unset this theme for devices other then default. if (!$themelocked) { if (($ischosentheme) && ($device != 'default')) { $unsetthemestr = get_string('unsettheme', 'admin'); $unsetthemeurl = new moodle_url('/theme/index.php', array('device' => $device, 'unsettheme' => true, 'sesskey' => sesskey())); $unsetbutton = new single_button($unsetthemeurl, $unsetthemestr, 'get'); $infocell .= $OUTPUT->render($unsetbutton); } else if ((!$ischosentheme)) { $setthemestr = get_string('usetheme'); $setthemeurl = new moodle_url('/theme/index.php', array('device' => $device, 'choose' => $themename, 'sesskey' => sesskey())); $setthemebutton = new single_button($setthemeurl, $setthemestr, 'get'); $infocell .= $OUTPUT->render($setthemebutton); } } $row[] = $infocell; $table->data[$themename] = $row; $table->rowclasses[$themename] = join(' ', $rowclasses); } } echo $OUTPUT->header('themeselector'); echo $OUTPUT->heading($heading); $params = array('sesskey' => sesskey(), 'reset' => 1); if (!empty($device)) { $params['device'] = $device; } echo $OUTPUT->single_button(new moodle_url('index.php', $params), get_string('themeresetcaches', 'admin')); echo html_writer::table($table); echo $OUTPUT->footer();