Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.x is supported too.
/course/ -> request.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/>.

/**
 * Allows a user to request a course be created for them.
 *
 * @copyright 1999 Martin Dougiamas  http://dougiamas.com
 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 * @package course
 */

require_once(__DIR__ . '/../config.php');
require_once($CFG->dirroot . '/course/lib.php');
require_once($CFG->dirroot . '/course/request_form.php');

// Where we came from. Used in a number of redirects.
$url = new moodle_url('/course/request.php');
$return = optional_param('return', null, PARAM_ALPHANUMEXT);
$categoryid = optional_param('category', null, PARAM_INT);
if ($return === 'management') {
    $url->param('return', $return);
    $returnurl = new moodle_url('/course/management.php', array('categoryid' => $CFG->defaultrequestcategory));
} else {
    $returnurl = new moodle_url('/course/index.php');
}

$PAGE->set_url($url);

// Check permissions.
require_login(null, false);
if (isguestuser()) {
< print_error('guestsarenotallowed', '', $returnurl);
> throw new \moodle_exception('guestsarenotallowed', '', $returnurl);
} if (empty($CFG->enablecourserequests)) {
< print_error('courserequestdisabled', '', $returnurl);
> throw new \moodle_exception('courserequestdisabled', '', $returnurl);
} if ($CFG->lockrequestcategory) { // Course request category is locked, user will always request in the default request category. $categoryid = null; } else if (!$categoryid) { // Category selection is enabled but category is not specified. // Find a category where user has capability to request courses (preferably the default category). $list = core_course_category::make_categories_list('moodle/course:request'); $categoryid = array_key_exists($CFG->defaultrequestcategory, $list) ? $CFG->defaultrequestcategory : key($list); } $context = context_coursecat::instance($categoryid ?: $CFG->defaultrequestcategory); $PAGE->set_context($context); require_capability('moodle/course:request', $context); // Set up the form. $data = $categoryid ? (object)['category' => $categoryid] : null; $data = course_request::prepare($data); $requestform = new course_request_form($url); $requestform->set_data($data); $strtitle = get_string('courserequest'); $PAGE->set_title($strtitle);
< $PAGE->set_heading($strtitle);
> $coursecategory = core_course_category::get($categoryid, MUST_EXIST, true); > $PAGE->set_heading($coursecategory->get_formatted_name()); > $PAGE->set_primary_active_tab('home');
// Standard form processing if statement. if ($requestform->is_cancelled()){ redirect($returnurl); } else if ($data = $requestform->get_data()) { $request = course_request::create($data); // And redirect back to the course listing. notice(get_string('courserequestsuccess'), $returnurl); }
> > $categoryurl = new moodle_url('/course/index.php'); $PAGE->navbar->add($strtitle); > if ($categoryid) { echo $OUTPUT->header(); > $categoryurl->param('categoryid', $categoryid); echo $OUTPUT->heading($strtitle); > } // Show the request form. > navigation_node::override_active_url($categoryurl);
$requestform->display(); echo $OUTPUT->footer();