Search moodle.org's
Developer Documentation


  • Bug fixes for general core bugs in 3.4.x ended 12 November 2018 (12 months).
  • Bug fixes for security issues in 3.4.x ended 13 May 2019 (18 months).
  • minimum PHP 7.0.0 Note: minimum PHP version has increased since Moodle 3.3. PHP 7.1.x and 7.2.x are supported too. PHP 7.x could have some engine limitations.
  • /admin/ -> category.php (source)

    Differences Between: [Versions 28 and 34] [Versions 29 and 34] [Versions 30 and 34] [Versions 31 and 34] [Versions 32 and 34]

       1  <?php
       2  // This file is part of Moodle - http://moodle.org/
       3  //
       4  // Moodle is free software: you can redistribute it and/or modify
       5  // it under the terms of the GNU General Public License as published by
       6  // the Free Software Foundation, either version 3 of the License, or
       7  // (at your option) any later version.
       8  //
       9  // Moodle is distributed in the hope that it will be useful,
      10  // but WITHOUT ANY WARRANTY; without even the implied warranty of
      11  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      12  // GNU General Public License for more details.
      13  //
      14  // You should have received a copy of the GNU General Public License
      15  // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
      16  
      17  /**
      18   * This file is used to display a categories sub categories, external pages, and settings.
      19   *
      20   * @since      Moodle 2.3
      21   * @package    admin
      22   * @copyright  2011 Sam Hemelryk
      23   * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
      24   */
      25  
      26  require_once('../config.php');
      27  require_once($CFG->libdir.'/adminlib.php');
      28  
      29  $category = required_param('category', PARAM_SAFEDIR);
      30  $return = optional_param('return','', PARAM_ALPHA);
      31  $adminediting = optional_param('adminedit', -1, PARAM_BOOL);
      32  
      33  /// no guest autologin
      34  require_login(0, false);
      35  $PAGE->set_context(context_system::instance());
      36  $PAGE->set_url('/admin/category.php', array('category' => $category));
      37  $PAGE->set_pagetype('admin-setting-' . $category);
      38  $PAGE->set_pagelayout('admin');
      39  $PAGE->navigation->clear_cache();
      40  
      41  $adminroot = admin_get_root(); // need all settings
      42  $settingspage = $adminroot->locate($category, true);
      43  
      44  if (empty($settingspage) or !($settingspage instanceof admin_category)) {
      45      print_error('categoryerror', 'admin', "$CFG->wwwroot/$CFG->admin/");
      46  }
      47  
      48  if (!($settingspage->check_access())) {
      49      print_error('accessdenied', 'admin');
      50  }
      51  
      52  
      53  $statusmsg = '';
      54  $errormsg  = '';
      55  
      56  if ($data = data_submitted() and confirm_sesskey()) {
      57      $count = admin_write_settings($data);
      58      if (empty($adminroot->errors)) {
      59          // No errors. Did we change any setting?  If so, then indicate success.
      60          if ($count) {
      61              $statusmsg = get_string('changessaved');
      62          } else {
      63              switch ($return) {
      64                  case 'site': redirect("$CFG->wwwroot/");
      65                  case 'admin': redirect("$CFG->wwwroot/$CFG->admin/");
      66              }
      67          }
      68      } else {
      69          $errormsg = get_string('errorwithsettings', 'admin');
      70          $firsterror = reset($adminroot->errors);
      71      }
      72      $settingspage = $adminroot->locate($category, true);
      73  }
      74  
      75  if ($PAGE->user_allowed_editing() && $adminediting != -1) {
      76      $USER->editing = $adminediting;
      77  }
      78  $buttons = null;
      79  if ($PAGE->user_allowed_editing()) {
      80      $url = clone($PAGE->url);
      81      if ($PAGE->user_is_editing()) {
      82          $caption = get_string('blockseditoff');
      83          $url->param('adminedit', 'off');
      84      } else {
      85          $caption = get_string('blocksediton');
      86          $url->param('adminedit', 'on');
      87      }
      88      $buttons = $OUTPUT->single_button($url, $caption, 'get');
      89  }
      90  
      91  $savebutton = false;
      92  $outputhtml = '';
      93  foreach ($settingspage->children as $childpage) {
      94      if ($childpage->is_hidden() || !$childpage->check_access()) {
      95          continue;
      96      }
      97      if ($childpage instanceof admin_externalpage) {
      98          $outputhtml .= $OUTPUT->heading(html_writer::link($childpage->url, $childpage->visiblename), 3);
      99      } else if ($childpage instanceof admin_settingpage) {
     100          $outputhtml .= $OUTPUT->heading(html_writer::link(new moodle_url('/'.$CFG->admin.'/settings.php', array('section' => $childpage->name)), $childpage->visiblename), 3);
     101          // If its a settings page and has settings lets display them.
     102          if (!empty($childpage->settings)) {
     103              $outputhtml .= html_writer::start_tag('fieldset', array('class' => 'adminsettings'));
     104              foreach ($childpage->settings as $setting) {
     105                  if (empty($setting->nosave)) {
     106                      $savebutton = true;
     107                  }
     108                  $fullname = $setting->get_full_name();
     109                  if (array_key_exists($fullname, $adminroot->errors)) {
     110                      $data = $adminroot->errors[$fullname]->data;
     111                  } else {
     112                      $data = $setting->get_setting();
     113                  }
     114                  $outputhtml .= html_writer::tag('div', '<!-- -->', array('class' => 'clearer'));
     115                  $outputhtml .= $setting->output_html($data);
     116              }
     117              $outputhtml .= html_writer::end_tag('fieldset');
     118          }
     119      } else if ($childpage instanceof admin_category) {
     120          $outputhtml .= $OUTPUT->heading(html_writer::link(new moodle_url('/'.$CFG->admin.'/category.php', array('category' => $childpage->name)), get_string('admincategory', 'admin', $childpage->visiblename)), 3);
     121      }
     122  }
     123  if ($savebutton) {
     124      $outputhtml .= html_writer::start_tag('div', array('class' => 'form-buttons'));
     125      $outputhtml .= html_writer::empty_tag('input', array('class' => 'btn btn-primary form-submit', 'type' => 'submit', 'value' => get_string('savechanges','admin')));
     126      $outputhtml .= html_writer::end_tag('div');
     127  }
     128  
     129  $visiblepathtosection = array_reverse($settingspage->visiblepath);
     130  $PAGE->set_title("$SITE->shortname: " . implode(": ",$visiblepathtosection));
     131  $PAGE->set_heading($SITE->fullname);
     132  if ($buttons) {
     133      $PAGE->set_button($buttons);
     134  }
     135  
     136  echo $OUTPUT->header();
     137  
     138  if ($errormsg !== '') {
     139      echo $OUTPUT->notification($errormsg);
     140  } else if ($statusmsg !== '') {
     141      echo $OUTPUT->notification($statusmsg, 'notifysuccess');
     142  }
     143  
     144  $path = array_reverse($settingspage->visiblepath);
     145  if (is_array($path)) {
     146      $visiblename = join(' / ', $path);
     147  } else {
     148      $visiblename = $path;
     149  }
     150  echo $OUTPUT->heading(get_string('admincategory', 'admin', $visiblename), 2);
     151  
     152  echo html_writer::start_tag('form', array('action' => '', 'method' => 'post', 'id' => 'adminsettings'));
     153  echo html_writer::start_tag('div');
     154  echo html_writer::input_hidden_params(new moodle_url($PAGE->url, array('sesskey' => sesskey(), 'return' => $return)));
     155  echo html_writer::end_tag('div');
     156  echo html_writer::start_tag('fieldset');
     157  echo html_writer::tag('div', '<!-- -->', array('class' => 'clearer'));
     158  echo $outputhtml;
     159  echo html_writer::end_tag('fieldset');
     160  echo html_writer::end_tag('form');
     161  
     162  echo $OUTPUT->footer();
    

    Search This Site: