MDL-26392 WIKI added file managment support to wiki editor
[moodle.git] / mod / wiki / renderer.php
1 <?php
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/>.
18 /**
19  * Moodle Wiki 2.0 Renderer
20  *
21  * @package   mod-wiki
22  * @copyright 2010 Dongsheng Cai <dongsheng@moodle.com>
23  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
24  */
26 defined('MOODLE_INTERNAL') || die();
28 class mod_wiki_renderer extends plugin_renderer_base {
29     public function page_index() {
30         global $CFG;
31         $output = '';
32         // Checking wiki instance
33         if (!$wiki = wiki_get_wiki($this->page->cm->instance)) {
34             return false;
35         }
37         // @TODO: Fix call to wiki_get_subwiki_by_group
38         $gid = groups_get_activity_group($this->page->cm);
39         $gid = !empty($gid) ? $gid : 0;
40         if (!$subwiki = wiki_get_subwiki_by_group($this->page->cm->instance, $gid)) {
41             return false;
42         }
43         $swid = $subwiki->id;
44         $pages = wiki_get_page_list($swid);
45         $selectoptions = array();
46         foreach ($pages as $page) {
47             $selectoptions[$page->id] = $page->title;
48         }
49         $label = get_string('pageindex', 'wiki') . ': ';
50         $select = new single_select(new moodle_url('/mod/wiki/view.php'), 'pageid', $selectoptions);
51         $select->label = $label;
52         return $this->output->container($this->output->render($select), 'wiki_index');
53     }
55     public function search_result($records, $subwiki) {
56         global $CFG, $PAGE;
57         $table = new html_table();
58         $context = get_context_instance(CONTEXT_MODULE, $PAGE->cm->id);
59         $strsearchresults = get_string('searchresult', 'wiki');
60         $totalcount = count($records);
61         $html = $this->output->heading("$strsearchresults $totalcount");
62         foreach ($records as $page) {
63             $table->head = array('title' => format_string($page->title) . ' (' . html_writer::link($CFG->wwwroot . '/mod/wiki/view.php?pageid=' . $page->id, get_string('view', 'wiki')) . ')');
64             $table->align = array('title' => 'left');
65             $table->width = '100%';
66             $table->data = array(array(file_rewrite_pluginfile_urls(format_text($page->cachedcontent, FORMAT_HTML), 'pluginfile.php', $context->id, 'mod_wiki', 'attachments', $subwiki->id)));
67             $table->colclasses = array('wikisearchresults');
68             $html .= html_writer::table($table);
69         }
70         $html = html_writer::tag('div', $html, array('class'=>'no-overflow'));
71         return $this->output->container($html);
72     }
74     public function diff($pageid, $old, $new, $options = array()) {
75         global $CFG;
76         if (!empty($options['total'])) {
77             $total = $options['total'];
78         } else {
79             $total = 0;
80         }
81         $diff1 = format_text($old->diff, FORMAT_HTML, array('overflowdiv'=>true));
82         $diff2 = format_text($new->diff, FORMAT_HTML, array('overflowdiv'=>true));
83         $strdatetime = get_string('strftimedatetime', 'langconfig');
85         $olduser = $old->user;
86         $versionlink = new moodle_url('/mod/wiki/viewversion.php', array('pageid' => $pageid, 'versionid' => $old->id));
87         $restorelink = new moodle_url('/mod/wiki/restoreversion.php', array('pageid' => $pageid, 'versionid' => $old->id));
88         $userlink = new moodle_url('/user/view.php', array('id' => $olduser->id));
89         // view version link
90         $oldversionview = ' ';
91         $oldversionview .= html_writer::link($versionlink->out(false), get_string('view', 'wiki'), array('class' => 'wiki_diffview'));
92         $oldversionview .= ' ';
93         // restore version link
94         $oldversionview .= html_writer::link($restorelink->out(false), get_string('restore', 'wiki'), array('class' => 'wiki_diffview'));
96         // userinfo container
97         $oldheading = $this->output->container_start('wiki_diffuserleft');
98         // username
99         $oldheading .= html_writer::link($CFG->wwwroot . '/user/view.php?id=' . $olduser->id, fullname($olduser)) . '&nbsp;';
100         // user picture
101         $oldheading .= html_writer::link($userlink->out(false), $this->output->user_picture($olduser, array('popup' => true)), array('class' => 'notunderlined'));
102         $oldheading .= $this->output->container_end();
104         // version number container
105         $oldheading .= $this->output->container_start('wiki_diffversion');
106         $oldheading .= get_string('version') . ' ' . $old->version . $oldversionview;
107         $oldheading .= $this->output->container_end();
108         // userdate container
109         $oldheading .= $this->output->container_start('wiki_difftime');
110         $oldheading .= userdate($old->timecreated, $strdatetime);
111         $oldheading .= $this->output->container_end();
113         $newuser = $new->user;
114         $versionlink = new moodle_url('/mod/wiki/viewversion.php', array('pageid' => $pageid, 'versionid' => $new->id));
115         $restorelink = new moodle_url('/mod/wiki/restoreversion.php', array('pageid' => $pageid, 'versionid' => $new->id));
116         $userlink = new moodle_url('/user/view.php', array('id' => $newuser->id));
118         $newversionview = ' ';
119         $newversionview .= html_writer::link($versionlink->out(false), get_string('view', 'wiki'), array('class' => 'wiki_diffview'));
120         // new user info
121         $newheading = $this->output->container_start('wiki_diffuserright');
122         $newheading .= $this->output->user_picture($newuser, array('popup' => true));
124         $newheading .= html_writer::link($userlink->out(false), fullname($newuser), array('class' => 'notunderlined'));
125         $newheading .= $this->output->container_end();
127         // version
128         $newheading .= $this->output->container_start('wiki_diffversion');
129         $newheading .= get_string('version') . '&nbsp;' . $new->version . $newversionview;
130         $newheading .= $this->output->container_end();
131         // userdate
132         $newheading .= $this->output->container_start('wiki_difftime');
133         $newheading .= userdate($new->timecreated, $strdatetime);
134         $newheading .= $this->output->container_end();
136         $oldheading = html_writer::tag('div', $oldheading, array('class'=>'wiki-diff-heading header clearfix'));
137         $newheading = html_writer::tag('div', $newheading, array('class'=>'wiki-diff-heading header clearfix'));
139         $output  = '';
140         $output .= html_writer::start_tag('div', array('class'=>'wiki-diff-container clearfix'));
141         $output .= html_writer::tag('div', $oldheading.$diff1, array('class'=>'wiki-diff-leftside'));
142         $output .= html_writer::tag('div', $newheading.$diff2, array('class'=>'wiki-diff-rightside'));
143         $output .= html_writer::end_tag('div');
145         if (!empty($total)) {
146             $output .= '<div class="wiki_diff_paging">';
147             $output .= $this->output->container($this->diff_paging_bar(1, $new->version - 1, $old->version, $CFG->wwwroot . '/mod/wiki/diff.php?pageid=' . $pageid . '&amp;comparewith=' . $new->version . '&amp;', 'compare', false, true), 'wiki_diff_oldpaging');
148             $output .= $this->output->container($this->diff_paging_bar($old->version + 1, $total, $new->version, $CFG->wwwroot . '/mod/wiki/diff.php?pageid=' . $pageid . '&amp;compare=' . $old->version . '&amp;', 'comparewith', false, true), 'wiki_diff_newpaging');
149             $output .= '</div>';
150         }
152         return $output;
153     }
155     /**
156      * Prints a single paging bar to provide access to other versions
157      *
158      * @param int $minpage First page to be displayed in the bar
159      * @param int $maxpage Last page to be displayed in the bar
160      * @param int $page The page you are currently viewing
161      * @param mixed $baseurl If this  is a string then it is the url which will be appended with $pagevar, an equals sign and the page number.
162      *                          If this is a moodle_url object then the pagevar param will be replaced by the page no, for each page.
163      * @param string $pagevar This is the variable name that you use for the page number in your code (ie. 'tablepage', 'blogpage', etc)
164      * @param bool $nocurr do not display the current page as a link
165      * @param bool $return whether to return an output string or echo now
166      * @return bool or string
167      */
168     public function diff_paging_bar($minpage, $maxpage, $page, $baseurl, $pagevar = 'page', $nocurr = false) {
169         $totalcount = $maxpage - $minpage;
170         $maxdisplay = 2;
171         $output = '';
173         if ($totalcount > 0) {
174             $output .= '<div class="paging">';
175             $output .= get_string('version', 'wiki') . ':';
176             if ($page - $minpage > 0) {
177                 $pagenum = $page - 1;
178                 if (!is_a($baseurl, 'moodle_url')) {
179                     $output .= '&nbsp;(<a class="previous" href="' . $baseurl . $pagevar . '=' . $pagenum . '">' . get_string('previous') . '</a>)&nbsp;';
180                 } else {
181                     $output .= '&nbsp;(<a class="previous" href="' . $baseurl->out(false, array($pagevar => $pagenum)) . '">' . get_string('previous') . '</a>)&nbsp;';
182                 }
183             }
185             if ($page - $minpage > 4) {
186                 $startpage = $page - 3;
187                 if (!is_a($baseurl, 'moodle_url')) {
188                     $output .= '&nbsp;<a href="' . $baseurl . $pagevar . '=' . $minpage . '">' . $minpage . '</a>&nbsp;...';
189                 } else {
190                     $output .= '&nbsp;<a href="' . $baseurl->out(false, array($pagevar => $minpage)) . '">' . $minpage . '</a>&nbsp;...';
191                 }
192             } else {
193                 $startpage = $minpage;
194             }
195             $currpage = $startpage;
196             $displaycount = 0;
197             while ($displaycount < $maxdisplay and $currpage <= $maxpage) {
198                 if ($page == $currpage && empty($nocurr)) {
199                     $output .= '&nbsp;&nbsp;' . $currpage;
200                 } else {
201                     if (!is_a($baseurl, 'moodle_url')) {
202                         $output .= '&nbsp;&nbsp;<a href="' . $baseurl . $pagevar . '=' . $currpage . '">' . $currpage . '</a>';
203                     } else {
204                         $output .= '&nbsp;&nbsp;<a href="' . $baseurl->out(false, array($pagevar => $currpage)) . '">' . $currpage . '</a>';
205                     }
207                 }
208                 $displaycount++;
209                 $currpage++;
210             }
211             if ($currpage < $maxpage) {
212                 if (!is_a($baseurl, 'moodle_url')) {
213                     $output .= '&nbsp;...<a href="' . $baseurl . $pagevar . '=' . $maxpage . '">' . $maxpage . '</a>&nbsp;';
214                 } else {
215                     $output .= '&nbsp;...<a href="' . $baseurl->out(false, array($pagevar => $maxpage)) . '">' . $maxpage . '</a>&nbsp;';
216                 }
217             } else if ($currpage == $maxpage) {
218                 if (!is_a($baseurl, 'moodle_url')) {
219                     $output .= '&nbsp;&nbsp;<a href="' . $baseurl . $pagevar . '=' . $currpage . '">' . $currpage . '</a>';
220                 } else {
221                     $output .= '&nbsp;&nbsp;<a href="' . $baseurl->out(false, array($pagevar => $currpage)) . '">' . $currpage . '</a>';
222                 }
223             }
224             $pagenum = $page + 1;
225             if ($page != $maxpage) {
226                 if (!is_a($baseurl, 'moodle_url')) {
227                     $output .= '&nbsp;&nbsp;(<a class="next" href="' . $baseurl . $pagevar . '=' . $pagenum . '">' . get_string('next') . '</a>)';
228                 } else {
229                     $output .= '&nbsp;&nbsp;(<a class="next" href="' . $baseurl->out(false, array($pagevar => $pagenum)) . '">' . get_string('next') . '</a>)';
230                 }
231             }
232             $output .= '</div>';
233         }
235         return $output;
236     }
237     public function wiki_info() {
238         global $PAGE;
239         return $this->output->box(format_module_intro('wiki', $this->page->activityrecord, $PAGE->cm->id), 'generalbox', 'intro');
240     }
242     public function tabs($page, $tabitems, $options) {
243         global $CFG;
244         $tabs = array();
245         $baseurl = $CFG->wwwroot . '/mod/wiki/';
246         $context = get_context_instance(CONTEXT_MODULE, $this->page->cm->id);
248         $pageid = null;
249         if (!empty($page)) {
250             $pageid = $page->id;
251         }
253         $selected = $options['activetab'];
255         // make specific tab linked even it is active
256         if (!empty($options['linkedwhenactive'])) {
257             $linked = $options['linkedwhenactive'];
258         } else {
259             $linked = '';
260         }
262         if (!empty($options['inactivetabs'])) {
263             $inactive = $options['inactivetabs'];
264         } else {
265             $inactive = array();
266         }
268         foreach ($tabitems as $tab) {
269             if ($tab == 'edit' && !has_capability('mod/wiki:editpage', $context)) {
270                 continue;
271             }
272             if ($tab == 'comments' && !has_capability('mod/wiki:viewcomment', $context)) {
273                 continue;
274             }
275             if ($tab == 'files' && !has_capability('mod/wiki:viewpage', $context)) {
276                 continue;
277             }
278             if (($tab == 'view' || $tab == 'map' || $tab == 'history') && !has_capability('mod/wiki:viewpage', $context)) {
279                 continue;
280             }
281             $link = $baseurl . $tab . '.php?pageid=' . $pageid;
282             if ($linked == $tab) {
283                 $tabs[] = new tabobject($tab, $link, get_string($tab, 'wiki'), '', true);
284             } else {
285                 $tabs[] = new tabobject($tab, $link, get_string($tab, 'wiki'));
286             }
287         }
289         return print_tabs(array($tabs), $selected, $inactive, null, true);
290     }
292     public function prettyview_link($page) {
293         $html = '';
294         $link = new moodle_url('/mod/wiki/prettyview.php', array('pageid' => $page->id));
295         $html .= $this->output->container_start('wiki_right');
296         $html .= $this->output->action_link($link, get_string('prettyprint', 'wiki'), new popup_action('click', $link));
297         $html .= $this->output->container_end();
298         return $html;
299     }
301     public function wiki_print_subwiki_selector($wiki, $subwiki, $page, $pagetype) {
302         global $CFG, $USER;
303         require_once($CFG->dirroot . '/user/lib.php');
304         switch ($pagetype) {
305         case 'view':
306             $baseurl = new moodle_url('/mod/wiki/view.php');
307             break;
308         case 'files':
309             $baseurl = new moodle_url('/mod/wiki/files.php');
310             break;
311         default:
312             $baseurl = null;
313         }
315         $cm = get_coursemodule_from_instance('wiki', $wiki->id);
316         $context = get_context_instance(CONTEXT_MODULE, $cm->id);
317         // @TODO: A plenty of duplicated code below this lines.
318         // Create private functions.
319         switch (groups_get_activity_groupmode($cm)) {
320         case NOGROUPS:
321             if ($wiki->wikimode == 'collaborative') {
322                 // No need to print anything
323                 return;
324             } else if ($wiki->wikimode == 'individual') {
325                 // We have private wikis here
327                 $view = has_capability('mod/wiki:viewpage', $context);
328                 $manage = has_capability('mod/wiki:managewiki', $context);
330                 // Only people with these capabilities can view all wikis
331                 if ($view && $manage) {
332                     // @TODO: Print here a combo that contains all users.
333                     $users = get_enrolled_users($context);
334                     $options = array();
335                     foreach ($users as $user) {
336                         $options[$user->id] = fullname($user);
337                     }
339                     echo $this->output->container_start('wiki_right');
340                     $params = array('wid' => $wiki->id, 'title' => $page->title);
341                     if ($pagetype == 'files') {
342                         $params['pageid'] = $page->id;
343                     }
344                     $baseurl->params($params);
345                     $name = 'uid';
346                     $selected = $subwiki->userid;
347                     echo $this->output->single_select($baseurl, $name, $options, $selected);
348                     echo $this->output->container_end();
349                 }
350                 return;
351             } else {
352                 // error
353                 return;
354             }
355         case SEPARATEGROUPS:
356             if ($wiki->wikimode == 'collaborative') {
357                 // We need to print a select to choose a course group
359                 $params = array('wid'=>$wiki->id, 'title'=>$page->title);
360                 if ($pagetype == 'files') {
361                     $params['pageid'] = $page->id;
362                 }
363                 $baseurl->params($params);
365                 echo $this->output->container_start('wiki_right');
366                 groups_print_activity_menu($cm, $baseurl->out());
367                 echo $this->output->container_end();
368                 return;
369             } else if ($wiki->wikimode == 'individual') {
370                 //  @TODO: Print here a combo that contains all users of that subwiki.
371                 $view = has_capability('mod/wiki:viewpage', $context);
372                 $manage = has_capability('mod/wiki:managewiki', $context);
374                 // Only people with these capabilities can view all wikis
375                 if ($view && $manage) {
376                     $users = get_enrolled_users($context);
377                     $options = array();
378                     foreach ($users as $user) {
379                         $groups = groups_get_all_groups($cm->course, $user->id);
380                         if (!empty($groups)) {
381                             foreach ($groups as $group) {
382                                 $options[$group->id][$group->name][$group->id . '-' . $user->id] = fullname($user);
383                             }
384                         } else {
385                             $name = get_string('notingroup', 'wiki');
386                             $options[0][$name]['0' . '-' . $user->id] = fullname($user);
387                         }
388                     }
389                 } else {
390                     $group = groups_get_group($subwiki->groupid);
391                     $users = groups_get_members($subwiki->groupid);
392                     foreach ($users as $user) {
393                         $options[$group->id][$group->name][$group->id . '-' . $user->id] = fullname($user);
394                     }
395                 }
396                 echo $this->output->container_start('wiki_right');
397                 $params = array('wid' => $wiki->id, 'title' => $page->title);
398                 if ($pagetype == 'files') {
399                     $params['pageid'] = $page->id;
400                 }
401                 $baseurl->params($params);
402                 $name = 'groupanduser';
403                 $selected = $subwiki->groupid . '-' . $subwiki->userid;
404                 echo $this->output->single_select($baseurl, $name, $options, $selected);
405                 echo $this->output->container_end();
407                 return;
409             } else {
410                 // error
411                 return;
412             }
413         CASE VISIBLEGROUPS:
414             if ($wiki->wikimode == 'collaborative') {
415                 // We need to print a select to choose a course group
416                 $params = array('wid'=>$wiki->id, 'title'=>urlencode($page->title));
417                 if ($pagetype == 'files') {
418                     $params['pageid'] = $page->id;
419                 }
420                 $baseurl->params($params);
422                 echo $this->output->container_start('wiki_right');
423                 groups_print_activity_menu($cm, $baseurl->out());
424                 echo $this->output->container_end();
425                 return;
427             } else if ($wiki->wikimode == 'individual') {
428                 $users = get_enrolled_users($context);
429                 $options = array();
430                 foreach ($users as $user) {
431                     $groups = groups_get_all_groups($cm->course, $user->id);
432                     if (!empty($groups)) {
433                         foreach ($groups as $group) {
434                             $options[$group->id][$group->name][$group->id . '-' . $user->id] = fullname($user);
435                         }
436                     } else {
437                         $name = get_string('notingroup', 'wiki');
438                         $options[0][$name]['0' . '-' . $user->id] = fullname($user);
439                     }
440                 }
442                 echo $this->output->container_start('wiki_right');
443                 $params = array('wid' => $wiki->id, 'title' => $page->title);
444                 if ($pagetype == 'files') {
445                     $params['pageid'] = $page->id;
446                 }
447                 $baseurl->params($params);
448                 $name = 'groupanduser';
449                 $selected = $subwiki->groupid . '-' . $subwiki->userid;
450                 echo $this->output->single_select($baseurl, $name, $options, $selected);
451                 echo $this->output->container_end();
453                 return;
455             } else {
456                 // error
457                 return;
458             }
459         default:
460             // error
461             return;
463         }
465     }
467     function menu_map($pageid, $currentselect) {
468         $options = array('contributions', 'links', 'orphaned', 'pageindex', 'pagelist', 'updatedpages');
469         $items = array();
470         foreach ($options as $opt) {
471             $items[] = get_string($opt, 'wiki');
472         }
473         $selectoptions = array();
474         foreach ($items as $key => $item) {
475             $selectoptions[$key + 1] = $item;
476         }
477         $select = new single_select(new moodle_url('/mod/wiki/map.php', array('pageid' => $pageid)), 'option', $selectoptions, $currentselect);
478         $select->label = get_string('mapmenu', 'wiki') . ': ';
479         return $this->output->container($this->output->render($select), 'midpad');
480     }
481     function wiki_files_tree($context, $subwiki) {
482         return $this->render(new wiki_files_tree($context, $subwiki));
483     }
484     public function render_wiki_files_tree(wiki_files_tree $tree) {
485         if (empty($tree->dir['subdirs']) && empty($tree->dir['files'])) {
486             $html = $this->output->box(get_string('nofilesavailable', 'repository'));
487         } else {
488             $htmlid = 'wiki_files_tree_'.uniqid();
489             $module = array('name'=>'mod_wiki', 'fullpath'=>'/mod/wiki/module.js');
490             $this->page->requires->js_init_call('M.mod_wiki.init_tree', array(false, $htmlid), false, $module);
491             $html = '<div id="'.$htmlid.'">';
492             $html .= $this->htmllize_tree($tree, $tree->dir);
493             $html .= '</div>';
494         }
495         return $html;
496     }
498     /**
499      * Internal function - creates htmls structure suitable for YUI tree.
500      */
501     protected function htmllize_tree($tree, $dir) {
502         global $CFG;
503         $yuiconfig = array();
504         $yuiconfig['type'] = 'html';
506         if (empty($dir['subdirs']) and empty($dir['files'])) {
507             return '';
508         }
509         $result = '<ul>';
510         foreach ($dir['subdirs'] as $subdir) {
511             $image = $this->output->pix_icon("f/folder", $subdir['dirname'], 'moodle', array('class'=>'icon'));
512             $result .= '<li yuiConfig=\''.json_encode($yuiconfig).'\'><div>'.$image.' '.s($subdir['dirname']).'</div> '.$this->htmllize_tree($tree, $subdir).'</li>';
513         }
514         foreach ($dir['files'] as $file) {
515             $url = file_encode_url("$CFG->wwwroot/pluginfile.php", '/'.$tree->context->id.'/mod_wiki/attachments/' . $tree->subwiki->id . '/'. $file->get_filepath() . $file->get_filename(), true);
516             $filename = $file->get_filename();
517             $icon = mimeinfo("icon", $filename);
518             $image = $this->output->pix_icon("f/$icon", $filename, 'moodle', array('class'=>'icon'));
519             $result .= '<li yuiConfig=\''.json_encode($yuiconfig).'\'><div>'.$image.' '.html_writer::link($url, $filename).'</div></li>';
520         }
521         $result .= '</ul>';
523         return $result;
524     }
527 class wiki_files_tree implements renderable {
528     public $context;
529     public $dir;
530     public $subwiki;
531     public function __construct($context, $subwiki) {
532         $fs = get_file_storage();
533         $this->context = $context;
534         $this->subwiki = $subwiki;
535         $this->dir = $fs->get_area_tree($context->id, 'mod_wiki', 'attachments', $subwiki->id);
536     }