1b2ccf128c79e422957043eb6dbefb622beadea1
[moodle.git] / mod / forum / classes / local / renderers / discussion.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  * Discussion renderer.
19  *
20  * @package    mod_forum
21  * @copyright  2019 Ryan Wyllie <ryan@moodle.com>
22  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
23  */
25 namespace mod_forum\local\renderers;
27 defined('MOODLE_INTERNAL') || die();
29 use mod_forum\local\entities\discussion as discussion_entity;
30 use mod_forum\local\entities\forum as forum_entity;
31 use mod_forum\local\entities\post as post_entity;
32 use mod_forum\local\entities\sorter as sorter_entity;
33 use mod_forum\local\factories\legacy_data_mapper as legacy_data_mapper_factory;
34 use mod_forum\local\factories\exporter as exporter_factory;
35 use mod_forum\local\factories\vault as vault_factory;
36 use mod_forum\local\managers\capability as capability_manager;
37 use mod_forum\local\renderers\posts as posts_renderer;
38 use core\output\notification;
39 use context;
40 use context_module;
41 use html_writer;
42 use moodle_exception;
43 use moodle_page;
44 use moodle_url;
45 use rating_manager;
46 use renderer_base;
47 use single_button;
48 use single_select;
49 use stdClass;
50 use url_select;
52 require_once($CFG->dirroot . '/mod/forum/lib.php');
54 /**
55  * Discussion renderer class.
56  *
57  * @copyright  2019 Ryan Wyllie <ryan@moodle.com>
58  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
59  */
60 class discussion {
61     /** @var forum_entity $forum The forum that the discussion belongs to */
62     private $forum;
63     /** @var discussion_entity $discussion The discussion entity */
64     private $discussion;
65     /** @var stdClass $discussionrecord Legacy discussion record */
66     private $discussionrecord;
67     /** @var stdClass $forumrecord Legacy forum record */
68     private $forumrecord;
69     /** @var int $displaymode The display mode to render the discussion in */
70     private $displaymode;
71     /** @var renderer_base $renderer Renderer base */
72     private $renderer;
73     /** @var posts_renderer $postsrenderer A posts renderer */
74     private $postsrenderer;
75     /** @var moodle_page $page The page this discussion is being rendered for */
76     private $page;
77     /** @var legacy_data_mapper_factory $legacydatamapperfactory Legacy data mapper factory */
78     private $legacydatamapperfactory;
79     /** @var exporter_factory $exporterfactory Exporter factory */
80     private $exporterfactory;
81     /** @var vault_factory $vaultfactory Vault factory */
82     private $vaultfactory;
83     /** @var capability_manager $capabilitymanager Capability manager */
84     private $capabilitymanager;
85     /** @var rating_manager $ratingmanager Rating manager */
86     private $ratingmanager;
87     /** @var moodle_url $baseurl The base URL for the discussion */
88     private $baseurl;
89     /** @var array $notifications List of HTML notifications to display */
90     private $notifications;
91     /** @var sorter_entity $exportedpostsorter Sorter for the exported posts */
92     private $exportedpostsorter;
94     /**
95      * Constructor.
96      *
97      * @param forum_entity $forum The forum that the discussion belongs to
98      * @param discussion_entity $discussion The discussion entity
99      * @param int $displaymode The display mode to render the discussion in
100      * @param renderer_base $renderer Renderer base
101      * @param posts_renderer $postsrenderer A posts renderer
102      * @param moodle_page $page The page this discussion is being rendered for
103      * @param legacy_data_mapper_factory $legacydatamapperfactory Legacy data mapper factory
104      * @param exporter_factory $exporterfactory Exporter factory
105      * @param vault_factory $vaultfactory Vault factory
106      * @param capability_manager $capabilitymanager Capability manager
107      * @param rating_manager $ratingmanager Rating manager
108      * @param sorter_entity $exportedpostsorter Sorter for the exported posts
109      * @param moodle_url $baseurl The base URL for the discussion
110      * @param array $notifications List of HTML notifications to display
111      */
112     public function __construct(
113         forum_entity $forum,
114         discussion_entity $discussion,
115         int $displaymode,
116         renderer_base $renderer,
117         posts_renderer $postsrenderer,
118         moodle_page $page,
119         legacy_data_mapper_factory $legacydatamapperfactory,
120         exporter_factory $exporterfactory,
121         vault_factory $vaultfactory,
122         capability_manager $capabilitymanager,
123         rating_manager $ratingmanager,
124         sorter_entity $exportedpostsorter,
125         moodle_url $baseurl,
126         array $notifications = []
127     ) {
128         $this->forum = $forum;
129         $this->discussion = $discussion;
130         $this->displaymode = $displaymode;
131         $this->renderer = $renderer;
132         $this->postsrenderer = $postsrenderer;
133         $this->page = $page;
134         $this->baseurl = $baseurl;
135         $this->legacydatamapperfactory = $legacydatamapperfactory;
136         $this->exporterfactory = $exporterfactory;
137         $this->vaultfactory = $vaultfactory;
138         $this->capabilitymanager = $capabilitymanager;
139         $this->ratingmanager = $ratingmanager;
140         $this->notifications = $notifications;
142         $this->exportedpostsorter = $exportedpostsorter;
144         $forumdatamapper = $this->legacydatamapperfactory->get_forum_data_mapper();
145         $this->forumrecord = $forumdatamapper->to_legacy_object($forum);
147         $discussiondatamapper = $this->legacydatamapperfactory->get_discussion_data_mapper();
148         $this->discussionrecord = $discussiondatamapper->to_legacy_object($discussion);
149     }
151     /**
152      * Render the discussion for the given user in the specified display mode.
153      *
154      * @param stdClass $user The user viewing the discussion
155      * @param post_entity $firstpost The first post in the discussion
156      * @param array $replies List of replies to the first post
157      * @return string HTML for the discussion
158      */
159     public function render(
160         stdClass $user,
161         post_entity $firstpost,
162         array $replies
163     ) : string {
164         global $CFG;
166         $displaymode = $this->displaymode;
167         $capabilitymanager = $this->capabilitymanager;
169         // Make sure we can render.
170         if (!$capabilitymanager->can_view_discussions($user)) {
171             throw new moodle_exception('noviewdiscussionspermission', 'mod_forum');
172         }
174         $posts = array_merge([$firstpost], array_values($replies));
176         $exporteddiscussion = $this->get_exported_discussion($user);
177         $exporteddiscussion = array_merge($exporteddiscussion, [
178             'notifications' => $this->get_notifications($user),
179             'html' => [
180                 'posts' => $this->postsrenderer->render($user, [$this->forum], [$this->discussion], $posts),
181                 'modeselectorform' => $this->get_display_mode_selector_html($displaymode),
182                 'subscribe' => null,
183                 'movediscussion' => null,
184                 'pindiscussion' => null,
185                 'neighbourlinks' => $this->get_neighbour_links_html(),
186                 'exportdiscussion' => !empty($CFG->enableportfolios) ? $this->get_export_discussion_html() : null
187             ]
188         ]);
190         $capabilities = (array) $exporteddiscussion['capabilities'];
192         if ($capabilities['subscribe']) {
193             $exporteddiscussion['html']['subscribe'] = $this->get_subscription_button_html();
194         }
196         if ($capabilities['move']) {
197             $exporteddiscussion['html']['movediscussion'] = $this->get_move_discussion_html();
198         }
200         if ($capabilities['pin']) {
201             $exporteddiscussion['html']['pindiscussion'] = $this->get_pin_discussion_html();
202         }
204         if ($capabilities['manage']) {
205             $exporteddiscussion['html']['lockdiscussion'] = $this->get_lock_discussion_button_html();
206         }
208         return $this->renderer->render_from_template('mod_forum/forum_discussion', $exporteddiscussion);
209     }
211     /**
212      * Get the groups details for all groups available to the forum.
213      *
214      * @return  stdClass[]
215      */
216     private function get_groups_available_in_forum() : array {
217         $course = $this->forum->get_course_record();
218         $coursemodule = $this->forum->get_course_module_record();
220         return groups_get_all_groups($course->id, 0, $coursemodule->groupingid);
221     }
223     /**
224      * Get the exported discussion.
225      *
226      * @param stdClass $user The user viewing the discussion
227      * @return array
228      */
229     private function get_exported_discussion(stdClass $user) : array {
230         $discussionexporter = $this->exporterfactory->get_discussion_exporter(
231             $user,
232             $this->forum,
233             $this->discussion,
234             $this->get_groups_available_in_forum()
235         );
237         return (array) $discussionexporter->export($this->renderer);
238     }
240     /**
241      * Get the HTML for the display mode selector.
242      *
243      * @param int $displaymode The current display mode
244      * @return string
245      */
246     private function get_display_mode_selector_html(int $displaymode) : string {
247         $baseurl = $this->baseurl;
248         $select = new single_select(
249             $baseurl,
250             'mode',
251             forum_get_layout_modes(),
252             $displaymode,
253             null,
254             'mode'
255         );
256         $select->set_label(get_string('displaymode', 'forum'), ['class' => 'accesshide']);
258         return $this->renderer->render($select);
259     }
261     /**
262      * Get the HTML to render the subscription button.
263      *
264      * @return string
265      */
266     private function get_subscription_button_html() : string {
267         global $PAGE;
269         $forumrecord = $this->forumrecord;
270         $discussion = $this->discussion;
271         $html = html_writer::div(
272             forum_get_discussion_subscription_icon($forumrecord, $discussion->get_id(), null, true),
273             'discussionsubscription'
274         );
275         $html .= forum_get_discussion_subscription_icon_preloaders();
276         // Add the subscription toggle JS.
277         $PAGE->requires->yui_module('moodle-mod_forum-subscriptiontoggle', 'Y.M.mod_forum.subscriptiontoggle.init');
278         return $html;
279     }
281     /**
282      * Get the HTML to render the subscription button.
283      *
284      * @return string
285      */
286     private function get_lock_discussion_button_html() : string {
287         global $PAGE;
289         $forumrecord = $this->forumrecord;
290         $discussionrecord = $this->discussionrecord;
292         $html = html_writer::div(
293             forum_get_lock_discussion_icon($forumrecord, $discussionrecord, null, true),
294             'discussionlock'
295         );
296         return $html;
297     }
299     /**
300      * Get the HTML to render the move discussion selector and button.
301      *
302      * @return string
303      */
304     private function get_move_discussion_html() : string {
305         global $DB;
307         $forum = $this->forum;
308         $discussion = $this->discussion;
309         $courseid = $forum->get_course_id();
311         // Popup menu to move discussions to other forums. The discussion in a
312         // single discussion forum can't be moved.
313         $modinfo = get_fast_modinfo($courseid);
314         if (isset($modinfo->instances['forum'])) {
315             $forummenu = [];
316             // Check forum types and eliminate simple discussions.
317             $forumcheck = $DB->get_records('forum', ['course' => $courseid], '', 'id, type');
318             foreach ($modinfo->instances['forum'] as $forumcm) {
319                 if (!$forumcm->uservisible || !has_capability('mod/forum:startdiscussion',
320                     context_module::instance($forumcm->id))) {
321                     continue;
322                 }
323                 $section = $forumcm->sectionnum;
324                 $sectionname = get_section_name($courseid, $section);
325                 if (empty($forummenu[$section])) {
326                     $forummenu[$section] = [$sectionname => []];
327                 }
328                 $forumidcompare = $forumcm->instance != $forum->get_id();
329                 $forumtypecheck = $forumcheck[$forumcm->instance]->type !== 'single';
331                 if ($forumidcompare and $forumtypecheck) {
332                     $url = "/mod/forum/discuss.php?d={$discussion->get_id()}&move=$forumcm->instance&sesskey=".sesskey();
333                     $forummenu[$section][$sectionname][$url] = format_string($forumcm->name);
334                 }
335             }
336             if (!empty($forummenu)) {
337                 $html = '<div class="movediscussionoption">';
338                 $select = new url_select($forummenu, '',
339                         ['/mod/forum/discuss.php?d=' . $discussion->get_id() => get_string("movethisdiscussionto", "forum")],
340                         'forummenu', get_string('move'));
341                 $html .= $this->renderer->render($select);
342                 $html .= "</div>";
343                 return $html;
344             }
345         }
347         return null;
348     }
350     /**
351      * Get the HTML to render the pin discussion button.
352      *
353      * @return string
354      */
355     private function get_pin_discussion_html() : string {
356         $discussion = $this->discussion;
358         if ($discussion->is_pinned()) {
359             $pinlink = FORUM_DISCUSSION_UNPINNED;
360             $pintext = get_string('discussionunpin', 'forum');
361         } else {
362             $pinlink = FORUM_DISCUSSION_PINNED;
363             $pintext = get_string('discussionpin', 'forum');
364         }
366         $button = new single_button(
367             new moodle_url('discuss.php', ['pin' => $pinlink, 'd' => $discussion->get_id()]),
368             $pintext,
369             'post'
370         );
371         return $this->renderer->render($button);
372     }
374     /**
375      * Get the HTML to render the export discussion button.
376      *
377      * @return string|null
378      */
379     private function get_export_discussion_html() : ?string {
380         global $CFG;
382         require_once($CFG->libdir . '/portfoliolib.php');
383         $discussion = $this->discussion;
384         $button = new \portfolio_add_button();
385         $button->set_callback_options('forum_portfolio_caller', ['discussionid' => $discussion->get_id()], 'mod_forum');
386         $button = $button->to_html(PORTFOLIO_ADD_FULL_FORM, get_string('exportdiscussion', 'mod_forum'));
387         return $button ?: null;
388     }
390     /**
391      * Get a list of notification HTML to render in the page.
392      *
393      * @param stdClass $user The user viewing the discussion
394      * @return string[]
395      */
396     private function get_notifications($user) : array {
397         $notifications = $this->notifications;
398         $discussion = $this->discussion;
399         $forum = $this->forum;
400         $renderer = $this->renderer;
402         if ($forum->is_cutoff_date_reached()) {
403             $notifications[] = (new notification(
404                     get_string('cutoffdatereached', 'forum'),
405                     notification::NOTIFY_INFO
406             ))->set_show_closebutton();
407         } else if ($forum->is_due_date_reached()) {
408             $notifications[] = (new notification(
409                     get_string('thisforumisdue', 'forum', userdate($forum->get_due_date())),
410                     notification::NOTIFY_INFO
411             ))->set_show_closebutton();
412         } else if ($forum->has_due_date()) {
413             $notifications[] = (new notification(
414                     get_string('thisforumhasduedate', 'forum', userdate($forum->get_due_date())),
415                     notification::NOTIFY_INFO
416             ))->set_show_closebutton();
417         }
419         if ($forum->is_discussion_locked($discussion)) {
420             $notifications[] = (new notification(
421                 get_string('discussionlocked', 'forum'),
422                 notification::NOTIFY_INFO
423             ))
424             ->set_extra_classes(['discussionlocked'])
425             ->set_show_closebutton();
426         }
428         if ($forum->get_type() == 'qanda') {
429             if ($this->capabilitymanager->must_post_before_viewing_discussion($user, $discussion)) {
430                 $notifications[] = (new notification(
431                     get_string('qandanotify', 'forum')
432                 ))->set_show_closebutton(true);
433             }
434         }
436         if ($forum->has_blocking_enabled()) {
437             $notifications[] = (new notification(
438                 get_string('thisforumisthrottled', 'forum', [
439                     'blockafter' => $forum->get_block_after(),
440                     'blockperiod' => get_string('secondstotime' . $forum->get_block_period())
441                 ])
442             ))->set_show_closebutton();
443         }
445         return array_map(function($notification) {
446             return $notification->export_for_template($this->renderer);
447         }, $notifications);
448     }
450     /**
451      * Get HTML to display the neighbour links.
452      *
453      * @return string
454      */
455     private function get_neighbour_links_html() : string {
456         $forum = $this->forum;
457         $coursemodule = $forum->get_course_module_record();
458         $neighbours = forum_get_discussion_neighbours($coursemodule, $this->discussionrecord, $this->forumrecord);
459         return $this->renderer->neighbouring_discussion_navigation($neighbours['prev'], $neighbours['next']);
460     }