MDL-31502 Check whether a category has subcategories or courses within it before...
[moodle.git] / course / renderer.php
CommitLineData
24e27ac0
SH
1<?php
2
3// This file is part of Moodle - http://moodle.org/
4//
5// Moodle is free software: you can redistribute it and/or modify
6// it under the terms of the GNU General Public License as published by
7// the Free Software Foundation, either version 3 of the License, or
8// (at your option) any later version.
9//
10// Moodle is distributed in the hope that it will be useful,
11// but WITHOUT ANY WARRANTY; without even the implied warranty of
12// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13// GNU General Public License for more details.
14//
15// You should have received a copy of the GNU General Public License
16// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
17
18/**
19 * Renderer for use with the course section and all the goodness that falls
20 * within it.
21 *
22 * This renderer should contain methods useful to courses, and categories.
23 *
24 * @package moodlecore
25 * @copyright 2010 Sam Hemelryk
26 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
27 */
28
29/**
30 * The core course renderer
31 *
32 * Can be retrieved with the following:
33 * $renderer = $PAGE->get_renderer('core','course');
34 */
35class core_course_renderer extends plugin_renderer_base {
36
37 /**
38 * A cache of strings
39 * @var stdClass
40 */
41 protected $strings;
42
43 /**
44 * Override the constructor so that we can initialise the string cache
45 *
46 * @param moodle_page $page
47 * @param string $target
48 */
49 public function __construct(moodle_page $page, $target) {
50 $this->strings = new stdClass;
51 parent::__construct($page, $target);
52 }
53
54 /**
55 * Renderers a structured array of courses and categories into a nice
56 * XHTML tree structure.
57 *
58 * This method was designed initially to display the front page course/category
59 * combo view. The structure can be retrieved by get_course_category_tree()
60 *
61 * @param array $structure
62 * @return string
63 */
64 public function course_category_tree(array $structure) {
24e27ac0
SH
65 $this->strings->summary = get_string('summary');
66
67 // Generate an id and the required JS call to make this a nice widget
68 $id = html_writer::random_id('course_category_tree');
c8ffba95 69 $this->page->requires->js_init_call('M.util.init_toggle_class_on_click', array($id, '.category.with_children .category_label', 'collapsed', '.category.with_children'));
24e27ac0
SH
70
71 // Start content generation
72 $content = html_writer::start_tag('div', array('class'=>'course_category_tree', 'id'=>$id));
73 foreach ($structure as $category) {
74 $content .= $this->course_category_tree_category($category);
75 }
76 $content .= html_writer::start_tag('div', array('class'=>'controls'));
77 $content .= html_writer::tag('div', get_string('collapseall'), array('class'=>'addtoall expandall'));
78 $content .= html_writer::tag('div', get_string('expandall'), array('class'=>'removefromall collapseall'));
79 $content .= html_writer::end_tag('div');
80 $content .= html_writer::end_tag('div');
df997f84 81
24e27ac0
SH
82 // Return the course category tree HTML
83 return $content;
84 }
85
86 /**
87 * Renderers a category for use with course_category_tree
88 *
89 * @param array $category
90 * @param int $depth
91 * @return string
92 */
93 protected function course_category_tree_category(stdClass $category, $depth=1) {
94 $content = '';
3754f4f3
ARN
95 $hassubcategories = (isset($category->categories) && count($category->categories)>0);
96 $hascourses = (isset($category->courses) && count($category->courses)>0);
24e27ac0
SH
97 $classes = array('category');
98 if ($category->parent != 0) {
99 $classes[] = 'subcategory';
100 }
d703f226
SH
101 if (empty($category->visible)) {
102 $classes[] = 'dimmed_category';
103 }
24e27ac0
SH
104 if ($hassubcategories || $hascourses) {
105 $classes[] = 'with_children';
106 if ($depth > 1) {
107 $classes[] = 'collapsed';
108 }
109 }
63390481
SH
110 $categoryname = format_string($category->name, true, array('context' => get_context_instance(CONTEXT_COURSECAT, $category->id)));
111
24e27ac0
SH
112 $content .= html_writer::start_tag('div', array('class'=>join(' ', $classes)));
113 $content .= html_writer::start_tag('div', array('class'=>'category_label'));
63390481 114 $content .= html_writer::link(new moodle_url('/course/category.php', array('id'=>$category->id)), $categoryname, array('class'=>'category_link'));
24e27ac0
SH
115 $content .= html_writer::end_tag('div');
116 if ($hassubcategories) {
117 $content .= html_writer::start_tag('div', array('class'=>'subcategories'));
118 foreach ($category->categories as $subcategory) {
119 $content .= $this->course_category_tree_category($subcategory, $depth+1);
120 }
121 $content .= html_writer::end_tag('div');
122 }
123 if ($hascourses) {
124 $content .= html_writer::start_tag('div', array('class'=>'courses'));
125 $coursecount = 0;
126 foreach ($category->courses as $course) {
127 $classes = array('course');
d2fd38be
PS
128 $linkclass = 'course_link';
129 if (!$course->visible) {
130 $linkclass .= ' dimmed';
131 }
24e27ac0
SH
132 $coursecount ++;
133 $classes[] = ($coursecount%2)?'odd':'even';
134 $content .= html_writer::start_tag('div', array('class'=>join(' ', $classes)));
f4c23f03 135 $content .= html_writer::link(new moodle_url('/course/view.php', array('id'=>$course->id)), format_string($course->fullname), array('class'=>$linkclass));
24e27ac0
SH
136 $content .= html_writer::start_tag('div', array('class'=>'course_info clearfix'));
137
bf423bb1
PS
138 // print enrol info
139 if ($icons = enrol_get_course_info_icons($course)) {
140 foreach ($icons as $pix_icon) {
141 $content .= $this->render($pix_icon);
142 }
143 }
144
24e27ac0
SH
145 if ($course->summary) {
146 $image = html_writer::empty_tag('img', array('src'=>$this->output->pix_url('i/info'), 'alt'=>$this->strings->summary));
147 $content .= html_writer::link(new moodle_url('/course/info.php', array('id'=>$course->id)), $image, array('title'=>$this->strings->summary));
24e27ac0
SH
148 }
149 $content .= html_writer::end_tag('div');
150 $content .= html_writer::end_tag('div');
151 }
152 $content .= html_writer::end_tag('div');
153 }
154 $content .= html_writer::end_tag('div');
155 return $content;
156 }
f4c23f03 157}