MDL-59366 enrol: Add $onlyenabled param in enrol instances getters
[moodle.git] / user / renderer.php
CommitLineData
82af55d7 1<?php
82af55d7
MD
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
82af55d7 17/**
a2ed6e69 18 * Provides user rendering functionality such as printing private files tree and displaying a search utility
82af55d7
MD
19 *
20 * @package core_user
21 * @copyright 2010 Dongsheng Cai <dongsheng@moodle.com>
22 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
23 */
24
82af55d7
MD
25defined('MOODLE_INTERNAL') || die();
26
02d1a0a5 27/**
a2ed6e69 28 * Provides user rendering functionality such as printing private files tree and displaying a search utility
02d1a0a5
MA
29 * @copyright 2010 Dongsheng Cai <dongsheng@moodle.com>
30 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
31 */
82af55d7
MD
32class core_user_renderer extends plugin_renderer_base {
33
34 /**
35 * Prints user files tree view
36 * @return string
37 */
38 public function user_files_tree() {
39 return $this->render(new user_files_tree);
40 }
41
02d1a0a5
MA
42 /**
43 * Render user files tree
a2ed6e69 44 *
02d1a0a5 45 * @param user_files_tree $tree
a2ed6e69 46 * @return string HTML
02d1a0a5 47 */
82af55d7 48 public function render_user_files_tree(user_files_tree $tree) {
d0257a09
DC
49 if (empty($tree->dir['subdirs']) && empty($tree->dir['files'])) {
50 $html = $this->output->box(get_string('nofilesavailable', 'repository'));
51 } else {
52 $htmlid = 'user_files_tree_'.uniqid();
a2ed6e69 53 $module = array('name' => 'core_user', 'fullpath' => '/user/module.js');
d0257a09
DC
54 $this->page->requires->js_init_call('M.core_user.init_tree', array(false, $htmlid), false, $module);
55 $html = '<div id="'.$htmlid.'">';
56 $html .= $this->htmllize_tree($tree, $tree->dir);
57 $html .= '</div>';
58 }
82af55d7
MD
59 return $html;
60 }
61
62 /**
63 * Internal function - creates htmls structure suitable for YUI tree.
02d1a0a5
MA
64 * @param user_files_tree $tree
65 * @param array $dir
a2ed6e69 66 * @return string HTML
82af55d7
MD
67 */
68 protected function htmllize_tree($tree, $dir) {
69 global $CFG;
70 $yuiconfig = array();
71 $yuiconfig['type'] = 'html';
72
73 if (empty($dir['subdirs']) and empty($dir['files'])) {
74 return '';
75 }
76 $result = '<ul>';
77 foreach ($dir['subdirs'] as $subdir) {
a2ed6e69
SH
78 $image = $this->output->pix_icon(file_folder_icon(), $subdir['dirname'], 'moodle', array('class' => 'icon'));
79 $result .= '<li yuiConfig=\''.json_encode($yuiconfig).'\'><div>'.$image.' '.s($subdir['dirname']).'</div> '.
80 $this->htmllize_tree($tree, $subdir).'</li>';
82af55d7
MD
81 }
82 foreach ($dir['files'] as $file) {
a2ed6e69
SH
83 $url = file_encode_url("$CFG->wwwroot/pluginfile.php", '/'.$tree->context->id.'/user/private'.
84 $file->get_filepath().$file->get_filename(), true);
82af55d7 85 $filename = $file->get_filename();
a2ed6e69
SH
86 $image = $this->output->pix_icon(file_file_icon($file), $filename, 'moodle', array('class' => 'icon'));
87 $result .= '<li yuiConfig=\''.json_encode($yuiconfig).'\'><div>'.$image.' '.html_writer::link($url, $filename).
88 '</div></li>';
82af55d7
MD
89 }
90 $result .= '</ul>';
91
92 return $result;
93 }
cbe8e5b3
MA
94
95 /**
96 * Prints user search utility that can search user by first initial of firstname and/or first initial of lastname
97 * Prints a header with a title and the number of users found within that subset
98 * @param string $url the url to return to, complete with any parameters needed for the return
cbe8e5b3
MA
99 * @param string $firstinitial the first initial of the firstname
100 * @param string $lastinitial the first initial of the lastname
101 * @param int $usercount the amount of users meeting the search criteria
2b267d31 102 * @param int $totalcount the amount of users of the set/subset being searched
cbe8e5b3
MA
103 * @param string $heading heading of the subset being searched, default is All Participants
104 * @return string html output
105 */
41877849 106 public function user_search($url, $firstinitial, $lastinitial, $usercount, $totalcount, $heading = null) {
cbe8e5b3
MA
107 global $OUTPUT;
108
8b844f70
IT
109 if ($firstinitial !== 'all') {
110 set_user_preference('ifirst', $firstinitial);
111 }
112 if ($lastinitial !== 'all') {
113 set_user_preference('ilast', $lastinitial);
114 }
cbe8e5b3
MA
115
116 if (!isset($heading)) {
117 $heading = get_string('allparticipants');
118 }
119
120 $content = html_writer::start_tag('form', array('action' => new moodle_url($url)));
121 $content .= html_writer::start_tag('div');
122
41877849 123 // Search utility heading.
cbe8e5b3
MA
124 $content .= $OUTPUT->heading($heading.get_string('labelsep', 'langconfig').$usercount.'/'.$totalcount, 3);
125
8b844f70
IT
126 // Initials bar.
127 $prefixfirst = 'sifirst';
128 $prefixlast = 'silast';
129 $content .= $OUTPUT->initials_bar($firstinitial, 'firstinitial', get_string('firstname'), $prefixfirst, $url);
130 $content .= $OUTPUT->initials_bar($lastinitial, 'lastinitial', get_string('lastname'), $prefixlast, $url);
cbe8e5b3 131
cbe8e5b3 132 $content .= html_writer::end_tag('div');
f836166a 133 $content .= html_writer::tag('div', '&nbsp;');
cbe8e5b3
MA
134 $content .= html_writer::end_tag('form');
135
136 return $content;
137 }
138
c4e868d5
MG
139 /**
140 * Displays the list of tagged users
141 *
142 * @param array $userlist
143 * @param bool $exclusivemode if set to true it means that no other entities tagged with this tag
144 * are displayed on the page and the per-page limit may be bigger
145 * @return string
146 */
147 public function user_list($userlist, $exclusivemode) {
148 $tagfeed = new core_tag\output\tagfeed();
149 foreach ($userlist as $user) {
150 $userpicture = $this->output->user_picture($user, array('size' => $exclusivemode ? 100 : 35));
151 $fullname = fullname($user);
152 if (user_can_view_profile($user)) {
153 $profilelink = new moodle_url('/user/view.php', array('id' => $user->id));
154 $fullname = html_writer::link($profilelink, $fullname);
155 }
156 $tagfeed->add($userpicture, $fullname);
157 }
158
159 $items = $tagfeed->export_for_template($this->output);
160
161 if ($exclusivemode) {
162 $output = '<div><ul class="inline-list">';
163 foreach ($items['items'] as $item) {
164 $output .= '<li><div class="user-box">'. $item['img'] . $item['heading'] ."</div></li>\n";
165 }
166 $output .= "</ul></div>\n";
167 return $output;
168 }
169
170 return $this->output->render_from_template('core_tag/tagfeed', $items);
171 }
172
82af55d7
MD
173}
174
02d1a0a5
MA
175/**
176 * User files tree
177 * @copyright 2010 Dongsheng Cai <dongsheng@moodle.com>
178 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
179 */
82af55d7 180class user_files_tree implements renderable {
02d1a0a5 181
a2ed6e69
SH
182 /**
183 * @var context_user $context
184 */
82af55d7 185 public $context;
02d1a0a5 186
a2ed6e69
SH
187 /**
188 * @var array $dir
189 */
82af55d7 190 public $dir;
02d1a0a5
MA
191
192 /**
193 * Create user files tree object
194 */
82af55d7
MD
195 public function __construct() {
196 global $USER;
43731030 197 $this->context = context_user::instance($USER->id);
82af55d7
MD
198 $fs = get_file_storage();
199 $this->dir = $fs->get_area_tree($this->context->id, 'user', 'private', 0);
200 }
201}