course/pending.php

   1 <?php
   2
   3 ///////////////////////////////////////////////////////////////////////////
   4 //                                                                       //
   5 // NOTICE OF COPYRIGHT                                                   //
   6 //                                                                       //
   7 // Moodle - Modular Object-Oriented Dynamic Learning Environment         //
   8 //          http://moodle.org                                            //
   9 //                                                                       //
  10 // Copyright (C) 1999 onwards Martin Dougiamas  http://dougiamas.com     //
  11 //                                                                       //
  12 // This program is free software; you can redistribute it and/or modify  //
  13 // it under the terms of the GNU General Public License as published by  //
  14 // the Free Software Foundation; either version 2 of the License, or     //
  15 // (at your option) any later version.                                   //
  16 //                                                                       //
  17 // This program is distributed in the hope that it will be useful,       //
  18 // but WITHOUT ANY WARRANTY; without even the implied warranty of        //
  19 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         //
  20 // GNU General Public License for more details:                          //
  21 //                                                                       //
  22 //          http://www.gnu.org/copyleft/gpl.html                         //
  23 //                                                                       //
  24 ///////////////////////////////////////////////////////////////////////////
  25
  26 /**
  27  * Allow the administrator to look through a list of course requests and approve or reject them.
  28  *
  29  * @license http://www.gnu.org/copyleft/gpl.html GNU Public License
  30  * @package course
  31  */
  32
  33 require_once(dirname(__FILE__) . '/../config.php');
  34 require_once($CFG->libdir . '/adminlib.php');
  35 require_once($CFG->dirroot . '/course/lib.php');
  36 require_once($CFG->dirroot . '/course/request_form.php');
  37
  38 require_login();
  39 require_capability('moodle/site:approvecourse', context_system::instance());
  40
  41 $approve = optional_param('approve', 0, PARAM_INT);
  42 $reject = optional_param('reject', 0, PARAM_INT);
  43
  44 $baseurl = $CFG->wwwroot . '/course/pending.php';
  45 admin_externalpage_setup('coursespending');
  46
  47 /// Process approval of a course.
  48 if (!empty($approve) and confirm_sesskey()) {
  49     /// Load the request.
  50     $course = new course_request($approve);
  51     $courseid = $course->approve();
  52
  53     if ($courseid !== false) {
  54         redirect($CFG->wwwroot.'/course/edit.php?id=' . $courseid);
  55     } else {
  56         print_error('courseapprovedfailed');
  57     }
  58 }
  59
  60 /// Process rejection of a course.
  61 if (!empty($reject)) {
  62     // Load the request.
  63     $course = new course_request($reject);
  64
  65     // Prepare the form.
  66     $rejectform = new reject_request_form($baseurl);
  67     $default = new stdClass();
  68     $default->reject = $course->id;
  69     $rejectform->set_data($default);
  70
  71 /// Standard form processing if statement.
  72     if ($rejectform->is_cancelled()){
  73         redirect($baseurl);
  74
  75     } else if ($data = $rejectform->get_data()) {
  76
  77         /// Reject the request
  78         $course->reject($data->rejectnotice);
  79
  80         /// Redirect back to the course listing.
  81         redirect($baseurl, get_string('courserejected'));
  82     }
  83
  84 /// Display the form for giving a reason for rejecting the request.
  85     echo $OUTPUT->header($rejectform->focus());
  86     $rejectform->display();
  87     echo $OUTPUT->footer();
  88     exit;
  89 }
  90
  91 /// Print a list of all the pending requests.
  92 echo $OUTPUT->header();
  93
  94 $pending = $DB->get_records('course_request');
  95 if (empty($pending)) {
  96     echo $OUTPUT->heading(get_string('nopendingcourses'));
  97 } else {
  98     echo $OUTPUT->heading(get_string('coursespending'));
  99
 100 /// Build a table of all the requests.
 101     $table = new html_table();
 102     $table->attributes['class'] = 'pendingcourserequests generaltable';
 103     $table->align = array('center', 'center', 'center', 'center', 'center', 'center');
 104     $table->head = array(get_string('shortnamecourse'), get_string('fullnamecourse'), get_string('requestedby'),
 105             get_string('summary'), get_string('category'), get_string('requestreason'), get_string('action'));
 106
 107     foreach ($pending as $course) {
 108         $course = new course_request($course);
 109
 110         // Check here for shortname collisions and warn about them.
 111         $course->check_shortname_collision();
 112
 113         // Retreiving category name.
 114         // If the category was not set (can happen after upgrade) or if the user does not have the capability
 115         // to change the category, we fallback on the default one.
 116         // Else, the category proposed is fetched, but we fallback on the default one if we can't find it.
 117         // It is just a matter of displaying the right information because the logic when approving the category
 118         // proceeds the same way. The system context level is used as moodle/site:approvecourse uses it.
 119         if (empty($course->category) || !has_capability('moodle/course:changecategory', context_system::instance()) ||
 120                 (!$category = get_course_category($course->category))) {
 121             $category = get_course_category($CFG->defaultrequestcategory);
 122         }
 123
 124         $row = array();
 125         $row[] = format_string($course->shortname);
 126         $row[] = format_string($course->fullname);
 127         $row[] = fullname($course->get_requester());
 128         $row[] = $course->summary;
 129         $row[] = format_string($category->name);
 130         $row[] = format_string($course->reason);
 131         $row[] = $OUTPUT->single_button(new moodle_url($baseurl, array('approve' => $course->id, 'sesskey' => sesskey())), get_string('approve'), 'get') .
 132                  $OUTPUT->single_button(new moodle_url($baseurl, array('reject' => $course->id)), get_string('rejectdots'), 'get');
 133
 134     /// Add the row to the table.
 135         $table->data[] = $row;
 136     }
 137
 138 /// Display the table.
 139     echo html_writer::table($table);
 140
 141 /// Message about name collisions, if necessary.
 142     if (!empty($collision)) {
 143         print_string('shortnamecollisionwarning');
 144     }
 145 }
 146
 147 /// Finish off the page.
 148 echo $OUTPUT->single_button($CFG->wwwroot . '/course/index.php', get_string('backtocourselisting'));
 149 echo $OUTPUT->footer();