MDL-66893 mod_forum: update navigation bar in grader UI
[moodle.git] / mod / forum / view.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 list of discussions in a forum.
19  *
20  * @package   mod_forum
21  * @copyright 2019 Andrew Nicols <andrew@nicols.co.uk>
22  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
23  */
25 use mod_forum\grades\forum_gradeitem;
27 require_once('../../config.php');
29 $managerfactory = mod_forum\local\container::get_manager_factory();
30 $legacydatamapperfactory = mod_forum\local\container::get_legacy_data_mapper_factory();
31 $vaultfactory = mod_forum\local\container::get_vault_factory();
32 $forumvault = $vaultfactory->get_forum_vault();
33 $discussionvault = $vaultfactory->get_discussion_vault();
34 $postvault = $vaultfactory->get_post_vault();
35 $discussionlistvault = $vaultfactory->get_discussions_in_forum_vault();
37 $cmid = optional_param('id', 0, PARAM_INT);
38 $forumid = optional_param('f', 0, PARAM_INT);
39 $mode = optional_param('mode', 0, PARAM_INT);
40 $showall = optional_param('showall', '', PARAM_INT);
41 $pageno = optional_param('page', 0, PARAM_INT);
42 $search = optional_param('search', '', PARAM_CLEAN);
43 $pageno = optional_param('p', $pageno, PARAM_INT);
44 $pagesize = optional_param('s', 0, PARAM_INT);
45 $sortorder = optional_param('o', null, PARAM_INT);
47 if (!$cmid && !$forumid) {
48     print_error('missingparameter');
49 }
51 if ($cmid) {
52     $forum = $forumvault->get_from_course_module_id($cmid);
53     if (empty($forum)) {
54         throw new \moodle_exception('Unable to find forum with cmid ' . $cmid);
55     }
56 } else {
57     $forum = $forumvault->get_from_id($forumid);
58     if (empty($forum)) {
59         throw new \moodle_exception('Unable to find forum with id ' . $forumid);
60     }
61 }
63 if (!empty($showall)) {
64     // The user wants to see all discussions.
65     $pageno = 0;
66     $pagesize = 0;
67 }
69 $urlfactory = mod_forum\local\container::get_url_factory();
70 $capabilitymanager = $managerfactory->get_capability_manager($forum);
72 $url = $urlfactory->get_forum_view_url_from_forum($forum);
73 $PAGE->set_url($url);
75 $course = $forum->get_course_record();
76 $coursemodule = $forum->get_course_module_record();
77 $cm = \cm_info::create($coursemodule);
79 require_course_login($course, true, $cm);
81 $istypesingle = $forum->get_type() === 'single';
82 $saveddisplaymode = get_user_preferences('forum_displaymode', $CFG->forum_displaymode);
84 if ($mode) {
85     $displaymode = $mode;
86 } else {
87     $displaymode = $saveddisplaymode;
88 }
90 if (get_user_preferences('forum_useexperimentalui', false)) {
91     if ($displaymode == FORUM_MODE_NESTED) {
92         $displaymode = FORUM_MODE_NESTED_V2;
93     }
94 } else {
95     if ($displaymode == FORUM_MODE_NESTED_V2) {
96         $displaymode = FORUM_MODE_NESTED;
97     }
98 }
100 if ($displaymode != $saveddisplaymode) {
101     set_user_preference('forum_displaymode', $displaymode);
104 $PAGE->set_context($forum->get_context());
105 $PAGE->set_title($forum->get_name());
106 $PAGE->add_body_class('forumtype-' . $forum->get_type());
107 $PAGE->set_heading($course->fullname);
109 $buttons = [];
110 if ($capabilitymanager->can_grade($USER)) {
111     $forumgradeitem = forum_gradeitem::load_from_forum_entity($forum);
112     if ($forumgradeitem->is_grading_enabled()) {
113         $groupid = groups_get_activity_group($cm, true) ?: null;
114         $gradeobj = (object) [
115             'contextid' => $forum->get_context()->id,
116             'cmid' => $cmid,
117             'name' => $forum->get_name(),
118             'courseid' => $course->id,
119             'coursename' => $course->shortname,
120             'groupid' => $groupid,
121             'gradingcomponent' => $forumgradeitem->get_grading_component_name(),
122             'gradingcomponentsubtype' => $forumgradeitem->get_grading_component_subtype(),
123         ];
124         $buttons[] = $OUTPUT->render_from_template('mod_forum/grades/grade_button', $gradeobj);
125     }
127 $buttons[] = forum_search_form($course, $search);
128 $PAGE->set_button(implode('', $buttons));
130 if ($istypesingle && $displaymode == FORUM_MODE_NESTED_V2) {
131     $PAGE->add_body_class('reset-style');
132     $settingstrigger = $OUTPUT->render_from_template('mod_forum/settings_drawer_trigger', null);
133     $PAGE->add_header_action($settingstrigger);
136 if (empty($cm->visible) && !has_capability('moodle/course:viewhiddenactivities', $forum->get_context())) {
137     redirect(
138         $urlfactory->get_course_url_from_forum($forum),
139         get_string('activityiscurrentlyhidden'),
140         null,
141         \core\output\notification::NOTIFY_WARNING
142     );
145 if (!$capabilitymanager->can_view_discussions($USER)) {
146     redirect(
147         $urlfactory->get_course_url_from_forum($forum),
148         get_string('noviewdiscussionspermission', 'forum'),
149         null,
150         \core\output\notification::NOTIFY_WARNING
151     );
154 // Mark viewed and trigger the course_module_viewed event.
155 $forumdatamapper = $legacydatamapperfactory->get_forum_data_mapper();
156 $forumrecord = $forumdatamapper->to_legacy_object($forum);
157 forum_view(
158     $forumrecord,
159     $forum->get_course_record(),
160     $forum->get_course_module_record(),
161     $forum->get_context()
162 );
164 // Return here if we post or set subscription etc.
165 $SESSION->fromdiscussion = qualified_me();
167 if (!empty($CFG->enablerssfeeds) && !empty($CFG->forum_enablerssfeeds) && $forum->get_rss_type() && $forum->get_rss_articles()) {
168     require_once("{$CFG->libdir}/rsslib.php");
170     $rsstitle = format_string($course->shortname, true, [
171             'context' => context_course::instance($course->id),
172         ]) . ': ' . format_string($forum->get_name());
173     rss_add_http_header($forum->get_context(), 'mod_forum', $forumrecord, $rsstitle);
176 echo $OUTPUT->header();
177 echo $OUTPUT->heading(format_string($forum->get_name()), 2);
179 if (!$istypesingle && !empty($forum->get_intro())) {
180     echo $OUTPUT->box(format_module_intro('forum', $forumrecord, $cm->id), 'generalbox', 'intro');
183 if ($sortorder) {
184     set_user_preference('forum_discussionlistsortorder', $sortorder);
187 $sortorder = get_user_preferences('forum_discussionlistsortorder', $discussionlistvault::SORTORDER_LASTPOST_DESC);
189 // Fetch the current groupid.
190 $groupid = groups_get_activity_group($cm, true) ?: null;
191 $rendererfactory = mod_forum\local\container::get_renderer_factory();
192 switch ($forum->get_type()) {
193     case 'single':
194         $discussion = $discussionvault->get_last_discussion_in_forum($forum);
195         $discussioncount = $discussionvault->get_count_discussions_in_forum($forum);
196         $hasmultiplediscussions = $discussioncount > 1;
197         $discussionsrenderer = $rendererfactory->get_single_discussion_list_renderer($forum, $discussion,
198             $hasmultiplediscussions, $displaymode);
199         $post = $postvault->get_from_id($discussion->get_first_post_id());
200         $orderpostsby = $displaymode == FORUM_MODE_FLATNEWEST ? 'created DESC' : 'created ASC';
201         $replies = $postvault->get_replies_to_post(
202                 $USER,
203                 $post,
204                 $capabilitymanager->can_view_any_private_reply($USER),
205                 $orderpostsby
206             );
207         echo $discussionsrenderer->render($USER, $post, $replies);
209         if (!$CFG->forum_usermarksread && forum_tp_is_tracked($forumrecord, $USER)) {
210             $postids = array_map(function($post) {
211                 return $post->get_id();
212             }, array_merge([$post], array_values($replies)));
213             forum_tp_mark_posts_read($USER, $postids);
214         }
215         break;
216     case 'blog':
217         $discussionsrenderer = $rendererfactory->get_blog_discussion_list_renderer($forum);
218         // Blog forums always show discussions newest first.
219         echo $discussionsrenderer->render($USER, $cm, $groupid, $discussionlistvault::SORTORDER_CREATED_DESC,
220             $pageno, $pagesize);
222         if (!$CFG->forum_usermarksread && forum_tp_is_tracked($forumrecord, $USER)) {
223             $discussions = mod_forum_get_discussion_summaries($forum, $USER, $groupid, null, $pageno, $pagesize);
224             $firstpostids = array_map(function($discussion) {
225                 return $discussion->get_first_post()->get_id();
226             }, array_values($discussions));
227             forum_tp_mark_posts_read($USER, $firstpostids);
228         }
229         break;
230     default:
231         $discussionsrenderer = $rendererfactory->get_discussion_list_renderer($forum);
232         echo $discussionsrenderer->render($USER, $cm, $groupid, $sortorder, $pageno, $pagesize);
235 echo $OUTPUT->footer();