See Release Notes
Long Term Support Release
<?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Displays the list of discussions in a forum. * * @package mod_forum * @copyright 2019 Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ use mod_forum\grades\forum_gradeitem; require_once('../../config.php'); $managerfactory = mod_forum\local\container::get_manager_factory(); $legacydatamapperfactory = mod_forum\local\container::get_legacy_data_mapper_factory(); $vaultfactory = mod_forum\local\container::get_vault_factory(); $forumvault = $vaultfactory->get_forum_vault(); $discussionvault = $vaultfactory->get_discussion_vault(); $postvault = $vaultfactory->get_post_vault(); $discussionlistvault = $vaultfactory->get_discussions_in_forum_vault(); $cmid = optional_param('id', 0, PARAM_INT); $forumid = optional_param('f', 0, PARAM_INT); $mode = optional_param('mode', 0, PARAM_INT); $showall = optional_param('showall', '', PARAM_INT); $pageno = optional_param('page', 0, PARAM_INT); $search = optional_param('search', '', PARAM_CLEAN); $pageno = optional_param('p', $pageno, PARAM_INT); $pagesize = optional_param('s', 0, PARAM_INT); $sortorder = optional_param('o', null, PARAM_INT); if (!$cmid && !$forumid) {< print_error('missingparameter');> throw new \moodle_exception('missingparameter');} if ($cmid) { $forum = $forumvault->get_from_course_module_id($cmid); if (empty($forum)) { throw new \moodle_exception('Unable to find forum with cmid ' . $cmid); } } else { $forum = $forumvault->get_from_id($forumid); if (empty($forum)) { throw new \moodle_exception('Unable to find forum with id ' . $forumid); } } if (!empty($showall)) { // The user wants to see all discussions. $pageno = 0; $pagesize = 0; } $urlfactory = mod_forum\local\container::get_url_factory(); $capabilitymanager = $managerfactory->get_capability_manager($forum); $url = $urlfactory->get_forum_view_url_from_forum($forum); $PAGE->set_url($url); $course = $forum->get_course_record(); $coursemodule = $forum->get_course_module_record(); $cm = \cm_info::create($coursemodule); require_course_login($course, true, $cm); $istypesingle = $forum->get_type() === 'single'; $saveddisplaymode = get_user_preferences('forum_displaymode', $CFG->forum_displaymode); if ($mode) { $displaymode = $mode; } else { $displaymode = $saveddisplaymode; } if (get_user_preferences('forum_useexperimentalui', false)) { if ($displaymode == FORUM_MODE_NESTED) { $displaymode = FORUM_MODE_NESTED_V2; } } else { if ($displaymode == FORUM_MODE_NESTED_V2) { $displaymode = FORUM_MODE_NESTED; } } if ($displaymode != $saveddisplaymode) { set_user_preference('forum_displaymode', $displaymode); } $PAGE->set_context($forum->get_context()); $PAGE->set_title($forum->get_name()); $PAGE->add_body_class('forumtype-' . $forum->get_type()); $PAGE->set_heading($course->fullname);< $PAGE->set_button(forum_search_form($course, $search));> $PAGE->add_header_action(forum_search_form($course, $search));if ($istypesingle && $displaymode == FORUM_MODE_NESTED_V2) { $PAGE->add_body_class('nested-v2-display-mode reset-style'); $settingstrigger = $OUTPUT->render_from_template('mod_forum/settings_drawer_trigger', null); $PAGE->add_header_action($settingstrigger); } if (empty($cm->visible) && !has_capability('moodle/course:viewhiddenactivities', $forum->get_context())) { redirect( $urlfactory->get_course_url_from_forum($forum), get_string('activityiscurrentlyhidden'), null, \core\output\notification::NOTIFY_WARNING ); } if (!$capabilitymanager->can_view_discussions($USER)) { redirect( $urlfactory->get_course_url_from_forum($forum), get_string('noviewdiscussionspermission', 'forum'), null, \core\output\notification::NOTIFY_WARNING ); } // Mark viewed and trigger the course_module_viewed event. $forumdatamapper = $legacydatamapperfactory->get_forum_data_mapper(); $forumrecord = $forumdatamapper->to_legacy_object($forum);> $PAGE->set_activity_record($forumrecord);forum_view( $forumrecord, $forum->get_course_record(), $forum->get_course_module_record(), $forum->get_context() ); // Return here if we post or set subscription etc. $SESSION->fromdiscussion = qualified_me(); if (!empty($CFG->enablerssfeeds) && !empty($CFG->forum_enablerssfeeds) && $forum->get_rss_type() && $forum->get_rss_articles()) { require_once("{$CFG->libdir}/rsslib.php"); $rsstitle = format_string($course->shortname, true, [ 'context' => context_course::instance($course->id), ]) . ': ' . format_string($forum->get_name()); rss_add_http_header($forum->get_context(), 'mod_forum', $forumrecord, $rsstitle); }> $activityheader = $PAGE->activityheader; > $pageheader = []; echo $OUTPUT->header(); > if ($activityheader->is_title_allowed()) { echo $OUTPUT->heading(format_string($forum->get_name()), 2); > $pageheader['title'] = format_string($forum->get_name()); > }< echo $OUTPUT->header(); < echo $OUTPUT->heading(format_string($forum->get_name()), 2); < < // Render the activity information. < $completiondetails = \core_completion\cm_completion_details::get_instance($cm, $USER->id); < $activitydates = \core\activity_dates::get_dates_for_module($cm, $USER->id); < echo $OUTPUT->activity_information($cm, $completiondetails, $activitydates);> // Fetch the current groupid. > $groupid = groups_get_activity_group($cm, true) ?: null;< if (!$istypesingle && !empty($forum->get_intro())) { < echo $OUTPUT->box(format_module_intro('forum', $forumrecord, $cm->id), 'generalbox', 'intro');> if ($istypesingle || empty($forum->get_intro())) { > $pageheader['description'] = '';if ($sortorder) {> $activityheader->set_attrs($pageheader); set_user_preference('forum_discussionlistsortorder', $sortorder); > } > echo $OUTPUT->header(); > $sortorder = get_user_preferences('forum_discussionlistsortorder', $discussionlistvault::SORTORDER_LASTPOST_DESC); > $rendererfactory = mod_forum\local\container::get_renderer_factory(); > // The elements for view action are rendered and added to the page. // Fetch the current groupid. > echo forum_activity_actionbar($forum, $groupid, $course, $search);< // Fetch the current groupid. < $groupid = groups_get_activity_group($cm, true) ?: null; < $rendererfactory = mod_forum\local\container::get_renderer_factory();case 'single': $forumgradeitem = forum_gradeitem::load_from_forum_entity($forum); if ($capabilitymanager->can_grade($USER)) { if ($forumgradeitem->is_grading_enabled()) { $groupid = groups_get_activity_group($cm, true) ?: null; $gradeobj = (object) [ 'contextid' => $forum->get_context()->id,< 'cmid' => $cmid,> 'cmid' => $forum->get_course_module_record()->id,'name' => format_string($forum->get_name()), 'courseid' => $course->id, 'coursename' => format_string($course->shortname), 'experimentaldisplaymode' => $displaymode == FORUM_MODE_NESTED_V2, 'groupid' => $groupid, 'gradingcomponent' => $forumgradeitem->get_grading_component_name(), 'gradingcomponentsubtype' => $forumgradeitem->get_grading_component_subtype(), 'sendstudentnotifications' => $forum->should_notify_students_default_when_grade_for_forum(), 'gradeonlyactiveusers' => $forumgradeitem->should_grade_only_active_users(), ]; echo $OUTPUT->render_from_template('mod_forum/grades/grade_button', $gradeobj); } } else { if ($forumgradeitem->is_grading_enabled()) { $groupid = groups_get_activity_group($cm, true) ?: null; $gradeobj = (object) [ 'contextid' => $forum->get_context()->id,< 'cmid' => $cmid,> 'cmid' => $forum->get_course_module_record()->id,'name' => format_string($forum->get_name()), 'courseid' => $course->id, 'coursename' => format_string($course->shortname), 'groupid' => $groupid, 'userid' => $USER->id, 'gradingcomponent' => $forumgradeitem->get_grading_component_name(), 'gradingcomponentsubtype' => $forumgradeitem->get_grading_component_subtype(), ]; echo $OUTPUT->render_from_template('mod_forum/grades/view_grade_button', $gradeobj); } } $discussion = $discussionvault->get_last_discussion_in_forum($forum); $discussioncount = $discussionvault->get_count_discussions_in_forum($forum); $hasmultiplediscussions = $discussioncount > 1; $discussionsrenderer = $rendererfactory->get_single_discussion_list_renderer($forum, $discussion, $hasmultiplediscussions, $displaymode); $post = $postvault->get_from_id($discussion->get_first_post_id()); $orderpostsby = $displaymode == FORUM_MODE_FLATNEWEST ? 'created DESC' : 'created ASC'; $replies = $postvault->get_replies_to_post( $USER, $post, $capabilitymanager->can_view_any_private_reply($USER), $orderpostsby ); echo $discussionsrenderer->render($USER, $post, $replies); if (!$CFG->forum_usermarksread && forum_tp_is_tracked($forumrecord, $USER)) { $postids = array_map(function($post) { return $post->get_id(); }, array_merge([$post], array_values($replies))); forum_tp_mark_posts_read($USER, $postids); } break; case 'blog': $discussionsrenderer = $rendererfactory->get_blog_discussion_list_renderer($forum); // Blog forums always show discussions newest first. echo $discussionsrenderer->render($USER, $cm, $groupid, $discussionlistvault::SORTORDER_CREATED_DESC,< $pageno, $pagesize);> $pageno, $pagesize, null, false);if (!$CFG->forum_usermarksread && forum_tp_is_tracked($forumrecord, $USER)) { $discussions = mod_forum_get_discussion_summaries($forum, $USER, $groupid, null, $pageno, $pagesize); $firstpostids = array_map(function($discussion) { return $discussion->get_first_post()->get_id(); }, array_values($discussions)); forum_tp_mark_posts_read($USER, $firstpostids); } break; default: $discussionsrenderer = $rendererfactory->get_discussion_list_renderer($forum);< echo $discussionsrenderer->render($USER, $cm, $groupid, $sortorder, $pageno, $pagesize, $displaymode);> echo $discussionsrenderer->render($USER, $cm, $groupid, $sortorder, $pageno, $pagesize, $displaymode, false);} echo $OUTPUT->footer();