6ed18982b2273c0952d11d9f59d7b176821cef55
[moodle.git] / course / category.php
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/>.
17 /**
18  * Displays the top level category or all courses
19  *
20  * @package    core
21  * @subpackage course
22  * @copyright  1999 onwards Martin Dougiamas  {@link http://moodle.com}
23  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
24  */
26 require_once("../config.php");
27 require_once($CFG->dirroot.'/course/lib.php');
28 require_once($CFG->libdir.'/textlib.class.php');
29 require_once($CFG->libdir. '/coursecatlib.php');
31 $id = required_param('id', PARAM_INT); // Category id
32 $page = optional_param('page', 0, PARAM_INT); // which page to show
34 $perpage = optional_param('perpage', $CFG->coursesperpage, PARAM_INT); // how many per page
36 if (empty($id)) {
37     print_error("unknowcategory");
38 }
40 $PAGE->set_category_by_id($id);
41 $PAGE->set_url(new moodle_url('/course/category.php', array('id' => $id)));
42 // This is sure to be the category context
43 $context = $PAGE->context;
44 // And the object has been loaded for us no need for another DB call
45 $category = $PAGE->category;
47 if ($CFG->forcelogin) {
48     require_login();
49 }
51 if (!$category->visible) {
52     require_capability('moodle/category:viewhiddencategories', $context);
53 }
55 // Prepare the standard URL params for this page. We'll need them later.
56 $urlparams = array('id' => $id);
57 if ($page) {
58     $urlparams['page'] = $page;
59 }
60 if ($perpage) {
61     $urlparams['perpage'] = $perpage;
62 }
64 // Begin output
65 $PAGE->set_pagelayout('coursecategory');
66 $site = get_site();
67 $PAGE->set_title("$site->shortname: $category->name");
68 $PAGE->set_heading($site->fullname);
69 $PAGE->set_button(print_course_search('', true, 'navbar'));
70 echo $OUTPUT->header();
72 /// Print the category selector
73 $displaylist = coursecat::make_categories_list();
75 echo '<div class="categorypicker">';
76 $select = new single_select(new moodle_url('/course/category.php'), 'id', $displaylist, $category->id, null, 'switchcategory');
77 $select->set_label(get_string('categories').':');
78 echo $OUTPUT->render($select);
79 echo '</div>';
81 /// Print current category description
82 echo $OUTPUT->box_start();
83 $options = new stdClass;
84 $options->noclean = true;
85 $options->para = false;
86 $options->overflowdiv = true;
87 if (!isset($category->descriptionformat)) {
88     $category->descriptionformat = FORMAT_MOODLE;
89 }
90 $text = file_rewrite_pluginfile_urls($category->description, 'pluginfile.php', $context->id, 'coursecat', 'description', null);
91 echo format_text($text, $category->descriptionformat, $options);
92 echo $OUTPUT->box_end();
94 // Print out all the sub-categories
95 // In order to view hidden subcategories the user must have the viewhiddencategories
96 // capability in the current category.
97 if (has_capability('moodle/category:viewhiddencategories', $context)) {
98     $categorywhere = '';
99 } else {
100     $categorywhere = 'AND cc.visible = 1';
102 // We're going to preload the context for the subcategory as we know that we
103 // need it later on for formatting.
105 $ctxselect = context_helper::get_preload_record_columns_sql('ctx');
106 $sql = "SELECT cc.*, $ctxselect
107           FROM {course_categories} cc
108           JOIN {context} ctx ON cc.id = ctx.instanceid
109          WHERE cc.parent = :parentid AND
110                ctx.contextlevel = :contextlevel
111                $categorywhere
112       ORDER BY cc.sortorder ASC";
113 $subcategories = $DB->get_recordset_sql($sql, array('parentid' => $category->id, 'contextlevel' => CONTEXT_COURSECAT));
114 // Prepare a table to display the sub categories.
115 $table = new html_table;
116 $table->attributes = array('border' => '0', 'cellspacing' => '2', 'cellpadding' => '4', 'class' => 'generalbox boxaligncenter category_subcategories');
117 $table->head = array(new lang_string('subcategories'));
118 $table->data = array();
119 $baseurl = new moodle_url('/course/category.php');
120 foreach ($subcategories as $subcategory) {
121     // Preload the context we will need it to format the category name shortly.
122     context_helper::preload_from_record($subcategory);
123     $context = context_coursecat::instance($subcategory->id);
124     // Prepare the things we need to create a link to the subcategory
125     $attributes = $subcategory->visible ? array() : array('class' => 'dimmed');
126     $text = format_string($subcategory->name, true, array('context' => $context));
127     // Add the subcategory to the table
128     $baseurl->param('id', $subcategory->id);
129     $table->data[] = array(html_writer::link($baseurl, $text, $attributes));
132 $subcategorieswereshown = (count($table->data) > 0);
133 if ($subcategorieswereshown) {
134     echo html_writer::table($table);
137 // Print out all the courses.
138 $courses = get_courses_page($category->id, 'c.sortorder ASC',
139         'c.id,c.sortorder,c.shortname,c.fullname,c.summary,c.visible',
140         $totalcount, $page*$perpage, $perpage);
141 $numcourses = count($courses);
143 // We can consider that we are using pagination when the total count of courses is different than the one returned.
144 $pagingmode = $totalcount != $numcourses;
146 if (!$courses) {
147     // There is no course to display.
148     if (empty($subcategorieswereshown)) {
149         echo $OUTPUT->heading(get_string("nocoursesyet"));
150     }
151 } else if ($numcourses <= $CFG->courseswithsummarieslimit and !$pagingmode) {
152     // We display courses with their summaries as we have not reached the limit, also we are not
153     // in paging mode and not allowed to edit either.
154     echo $OUTPUT->box_start('courseboxes');
155     print_courses($category);
156     echo $OUTPUT->box_end();
157 } else {
158     // The conditions above have failed, we display a basic list of courses with paging/editing options.
159     echo $OUTPUT->paging_bar($totalcount, $page, $perpage, "/course/category.php?id=$category->id&perpage=$perpage");
161     echo '<form id="movecourses" action="category.php" method="post"><div>';
162     echo '<input type="hidden" name="sesskey" value="'.sesskey().'" />';
163     echo '<table border="0" cellspacing="2" cellpadding="4" class="generaltable boxaligncenter"><tr>';
164     echo '<th class="header" scope="col">'.get_string('courses').'</th>';
165     echo '<th class="header" scope="col">&nbsp;</th>';
166     echo '</tr>';
168     $count = 0;
170     // Checking if we are at the first or at the last page, to allow courses to
171     // be moved up and down beyond the paging border
172     if ($totalcount > $perpage) {
173         $atfirstpage = ($page == 0);
174         if ($perpage > 0) {
175             $atlastpage = (($page + 1) == ceil($totalcount / $perpage));
176         } else {
177             $atlastpage = true;
178         }
179     } else {
180         $atfirstpage = true;
181         $atlastpage = true;
182     }
184     $baseurl = new moodle_url('/course/category.php', $urlparams + array('sesskey' => sesskey()));
185     foreach ($courses as $acourse) {
186         $coursecontext = context_course::instance($acourse->id);
188         $count++;
189         $up = ($count > 1 || !$atfirstpage);
190         $down = ($count < $numcourses || !$atlastpage);
192         $linkcss = $acourse->visible ? '' : ' class="dimmed" ';
193         echo '<tr>';
194         $coursename = get_course_display_name_for_list($acourse);
195         echo '<td><a '.$linkcss.' href="view.php?id='.$acourse->id.'">'. format_string($coursename) .'</a></td>';
196         echo '<td align="right">';
197         // print enrol info
198         if ($icons = enrol_get_course_info_icons($acourse)) {
199             foreach ($icons as $pix_icon) {
200                 echo $OUTPUT->render($pix_icon);
201             }
202         }
203         if (!empty($acourse->summary)) {
204             $url = new moodle_url("/course/info.php?id=$acourse->id");
205             echo $OUTPUT->action_link($url, '<img alt="'.get_string('info').'" class="icon" src="'.$OUTPUT->pix_url('i/info') . '" />',
206                 new popup_action('click', $url, 'courseinfo'), array('title'=>get_string('summary')));
207         }
208         echo "</td>";
209         echo "</tr>";
210     }
212     echo '</table>';
213     echo '</div></form>';
214     echo '<br />';
217 echo '<div class="buttons">';
218 if (has_capability('moodle/course:create', $context)) {
219     // Print button to create a new course
220     $url = new moodle_url('/course/edit.php', array('category' => $category->id, 'returnto' => 'category'));
221     echo $OUTPUT->single_button($url, get_string('addnewcourse'), 'get');
224 if (!empty($CFG->enablecourserequests) && $category->id == $CFG->defaultrequestcategory) {
225     print_course_request_buttons(context_system::instance());
227 echo '</div>';
229 echo $OUTPUT->footer();