Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.10.x will end 8 November 2021 (12 months).
  • Bug fixes for security issues in 3.10.x will end 9 May 2022 (18 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are supported too.
<?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/>.

/**
 * Post exporter class.
 *
 * @package    mod_forum
 * @copyright  2019 Ryan Wyllie <ryan@moodle.com>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

namespace mod_forum\local\exporters;

defined('MOODLE_INTERNAL') || die();

use mod_forum\local\entities\post as post_entity;
use mod_forum\local\entities\discussion as discussion_entity;
use mod_forum\local\exporters\author as author_exporter;
use mod_forum\local\factories\exporter as exporter_factory;
use core\external\exporter;
use core_files\external\stored_file_exporter;
use context;
use core_tag_tag;
use renderer_base;
use stdClass;

require_once($CFG->dirroot . '/mod/forum/lib.php');

/**
 * Post exporter class.
 *
 * @copyright  2019 Ryan Wyllie <ryan@moodle.com>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class post extends exporter {
    /** @var post_entity $post The post to export */
    private $post;

    /**
     * Constructor.
     *
     * @param post_entity $post The post to export
     * @param array $related List of related data
     */
    public function __construct(post_entity $post, array $related = []) {
        $this->post = $post;
        return parent::__construct([], $related);
    }

    /**
     * Return the list of additional properties.
     *
     * @return array
     */
    protected static function define_other_properties() {
        $attachmentdefinition = stored_file_exporter::read_properties_definition();
        $attachmentdefinition['urls'] = [
            'type' => [
                'export' => [
                    'type' => PARAM_URL,
                    'description' => 'The URL used to export the attachment',
                    'optional' => true,
                    'default' => null,
                    'null' => NULL_ALLOWED
                ]
            ]
        ];
        $attachmentdefinition['html'] = [
            'type' => [
                'plagiarism' => [
                    'type' => PARAM_RAW,
                    'description' => 'The HTML source for the Plagiarism Response',
                    'optional' => true,
                    'default' => null,
                    'null' => NULL_ALLOWED
                ],
            ]
        ];

        return [
            'id' => ['type' => PARAM_INT],
            'subject' => ['type' => PARAM_TEXT],
            'replysubject' => ['type' => PARAM_TEXT],
            'message' => ['type' => PARAM_RAW],
            'messageformat' => ['type' => PARAM_INT],
            'author' => ['type' => author_exporter::read_properties_definition()],
            'discussionid' => ['type' => PARAM_INT],
            'hasparent' => ['type' => PARAM_BOOL],
            'parentid' => [
                'type' => PARAM_INT,
                'optional' => true,
                'default' => null,
                'null' => NULL_ALLOWED
            ],
            'timecreated' => [
                'type' => PARAM_INT,
                'default' => null,
                'null' => NULL_ALLOWED
            ],
> 'timemodified' => [ 'unread' => [ > 'type' => PARAM_INT, 'type' => PARAM_BOOL, > 'default' => null, 'optional' => true, > 'null' => NULL_ALLOWED 'default' => null, > ],
'null' => NULL_ALLOWED ], 'isdeleted' => ['type' => PARAM_BOOL], 'isprivatereply' => ['type' => PARAM_BOOL], 'haswordcount' => ['type' => PARAM_BOOL], 'wordcount' => [ 'type' => PARAM_INT, 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED ], 'charcount' => [ 'type' => PARAM_INT, 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED ], 'capabilities' => [ 'type' => [ 'view' => [ 'type' => PARAM_BOOL, 'null' => NULL_ALLOWED, 'description' => 'Whether the user can view the post', ], 'edit' => [ 'type' => PARAM_BOOL, 'null' => NULL_ALLOWED, 'description' => 'Whether the user can edit the post', ], 'delete' => [ 'type' => PARAM_BOOL, 'null' => NULL_ALLOWED, 'description' => 'Whether the user can delete the post', ], 'split' => [ 'type' => PARAM_BOOL, 'null' => NULL_ALLOWED, 'description' => 'Whether the user can split the post', ], 'reply' => [ 'type' => PARAM_BOOL, 'null' => NULL_ALLOWED, 'description' => 'Whether the user can reply to the post', ], 'selfenrol' => [ 'type' => PARAM_BOOL, 'null' => NULL_ALLOWED, 'description' => 'Whether the user can self enrol into the course', ], 'export' => [ 'type' => PARAM_BOOL, 'null' => NULL_ALLOWED, 'description' => 'Whether the user can export the post', ], 'controlreadstatus' => [ 'type' => PARAM_BOOL, 'null' => NULL_ALLOWED, 'description' => 'Whether the user can control the read status of the post', ], 'canreplyprivately' => [ 'type' => PARAM_BOOL, 'null' => NULL_ALLOWED, 'description' => 'Whether the user can post a private reply', ] ] ], 'urls' => [ 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED, 'type' => [ 'view' => [ 'description' => 'The URL used to view the post', 'type' => PARAM_URL, 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED ], 'viewisolated' => [ 'description' => 'The URL used to view the post in isolation', 'type' => PARAM_URL, 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED ], 'viewparent' => [ 'description' => 'The URL used to view the parent of the post', 'type' => PARAM_URL, 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED ], 'edit' => [ 'description' => 'The URL used to edit the post', 'type' => PARAM_URL, 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED ], 'delete' => [ 'description' => 'The URL used to delete the post', 'type' => PARAM_URL, 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED ], 'split' => [ 'description' => 'The URL used to split the discussion ' . 'with the selected post being the first post in the new discussion', 'type' => PARAM_URL, 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED ], 'reply' => [ 'description' => 'The URL used to reply to the post', 'type' => PARAM_URL, 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED ], 'export' => [ 'description' => 'The URL used to export the post', 'type' => PARAM_URL, 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED ], 'markasread' => [ 'description' => 'The URL used to mark the post as read', 'type' => PARAM_URL, 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED ], 'markasunread' => [ 'description' => 'The URL used to mark the post as unread', 'type' => PARAM_URL, 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED ], 'discuss' => [ 'type' => PARAM_URL, 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED ] ] ], 'attachments' => [ 'multiple' => true, 'type' => $attachmentdefinition ],
> 'messageinlinefiles' => [ 'tags' => [ > 'optional' => true, 'optional' => true, > 'multiple' => true, 'default' => null, > 'type' => stored_file_exporter::read_properties_definition(), 'null' => NULL_ALLOWED, > ],
'multiple' => true, 'type' => [ 'id' => [ 'type' => PARAM_INT, 'description' => 'The ID of the Tag', 'null' => NULL_NOT_ALLOWED, ], 'tagid' => [ 'type' => PARAM_INT, 'description' => 'The tagid', 'null' => NULL_NOT_ALLOWED, ], 'isstandard' => [ 'type' => PARAM_BOOL, 'description' => 'Whether this is a standard tag', 'null' => NULL_NOT_ALLOWED, ], 'displayname' => [ 'type' => PARAM_TEXT, 'description' => 'The display name of the tag', 'null' => NULL_NOT_ALLOWED, ], 'flag' => [ 'type' => PARAM_BOOL, 'description' => 'Wehther this tag is flagged', 'null' => NULL_NOT_ALLOWED, ], 'urls' => [ 'description' => 'URLs associated with the tag', 'null' => NULL_NOT_ALLOWED, 'type' => [ 'view' => [ 'type' => PARAM_URL, 'description' => 'The URL to view the tag', 'null' => NULL_NOT_ALLOWED, ], ] ] ] ], 'html' => [ 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED, 'type' => [ 'rating' => [ 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED, 'type' => PARAM_RAW, 'description' => 'The HTML source to rate the post', ], 'taglist' => [ 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED, 'type' => PARAM_RAW, 'description' => 'The HTML source to view the list of tags', ], 'authorsubheading' => [ 'optional' => true, 'default' => null, 'null' => NULL_ALLOWED, 'type' => PARAM_RAW, 'description' => 'The HTML source to view the author details', ], ] ] ]; } /** * Get the additional values to inject while exporting. * * @param renderer_base $output The renderer. * @return array Keys are the property names, values are their values. */ protected function get_other_values(renderer_base $output) { $post = $this->post; $authorgroups = $this->related['authorgroups']; $forum = $this->related['forum']; $discussion = $this->related['discussion']; $author = $this->related['author']; $authorcontextid = $this->related['authorcontextid']; $user = $this->related['user']; $readreceiptcollection = $this->related['readreceiptcollection']; $rating = $this->related['rating']; $tags = $this->related['tags']; $attachments = $this->related['attachments'];
> $inlineattachments = $this->related['messageinlinefiles'];
$includehtml = $this->related['includehtml']; $isdeleted = $post->is_deleted(); $isprivatereply = $post->is_private_reply(); $hasrating = $rating != null; $hastags = !empty($tags); $discussionid = $post->get_discussion_id(); $parentid = $post->get_parent_id(); $capabilitymanager = $this->related['capabilitymanager']; $canview = $capabilitymanager->can_view_post($user, $discussion, $post); $canedit = $capabilitymanager->can_edit_post($user, $discussion, $post); $candelete = $capabilitymanager->can_delete_post($user, $discussion, $post); $cansplit = $capabilitymanager->can_split_post($user, $discussion, $post); $canreply = $capabilitymanager->can_reply_to_post($user, $discussion, $post); $canexport = $capabilitymanager->can_export_post($user, $post); $cancontrolreadstatus = $capabilitymanager->can_manually_control_post_read_status($user); $canselfenrol = $capabilitymanager->can_self_enrol($user); $canreplyprivately = $capabilitymanager->can_reply_privately_to_post($user, $post); $urlfactory = $this->related['urlfactory']; $viewurl = $canview ? $urlfactory->get_view_post_url_from_post($post) : null; $viewisolatedurl = $canview ? $urlfactory->get_view_isolated_post_url_from_post($post) : null; $viewparenturl = $post->has_parent() ? $urlfactory->get_view_post_url_from_post_id($discussionid, $parentid) : null; $editurl = $canedit ? $urlfactory->get_edit_post_url_from_post($forum, $post) : null; $deleteurl = $candelete ? $urlfactory->get_delete_post_url_from_post($post) : null; $spliturl = $cansplit ? $urlfactory->get_split_discussion_at_post_url_from_post($post) : null; $replyurl = $canreply || $canselfenrol ? $urlfactory->get_reply_to_post_url_from_post($post) : null; $exporturl = $canexport ? $urlfactory->get_export_post_url_from_post($post) : null; $markasreadurl = $cancontrolreadstatus ? $urlfactory->get_mark_post_as_read_url_from_post($post) : null; $markasunreadurl = $cancontrolreadstatus ? $urlfactory->get_mark_post_as_unread_url_from_post($post) : null; $discussurl = $canview ? $urlfactory->get_discussion_view_url_from_post($post) : null; $authorexporter = new author_exporter( $author, $authorcontextid, $authorgroups, $canview, $this->related ); $exportedauthor = $authorexporter->export($output); // Only bother loading the content if the user can see it. $loadcontent = $canview && !$isdeleted; $exportattachments = $loadcontent && !empty($attachments);
> $exportinlineattachments = $loadcontent && !empty($inlineattachments);
if ($loadcontent) { $subject = $post->get_subject(); $timecreated = $this->get_start_time($discussion, $post); $message = $this->get_message($post); } else { $subject = $isdeleted ? get_string('forumsubjectdeleted', 'forum') : get_string('forumsubjecthidden', 'forum'); $message = $isdeleted ? get_string('forumbodydeleted', 'forum') : get_string('forumbodyhidden', 'forum'); $timecreated = null; } $replysubject = $subject; $strre = get_string('re', 'forum'); if (!(substr($replysubject, 0, strlen($strre)) == $strre)) { $replysubject = "{$strre} {$replysubject}"; } $showwordcount = $forum->should_display_word_count(); if ($showwordcount) { $wordcount = $post->get_wordcount() ?? count_words($message); $charcount = $post->get_charcount() ?? count_letters($message); } else { $wordcount = null; $charcount = null; } return [ 'id' => $post->get_id(), 'subject' => $subject, 'replysubject' => $replysubject, 'message' => $message, 'messageformat' => $post->get_message_format(), 'author' => $exportedauthor, 'discussionid' => $post->get_discussion_id(), 'hasparent' => $post->has_parent(), 'parentid' => $post->has_parent() ? $post->get_parent_id() : null, 'timecreated' => $timecreated,
> 'timemodified' => $post->get_time_modified(),
'unread' => ($loadcontent && $readreceiptcollection) ? !$readreceiptcollection->has_user_read_post($user, $post) : null, 'isdeleted' => $isdeleted, 'isprivatereply' => $isprivatereply, 'haswordcount' => $showwordcount, 'wordcount' => $wordcount, 'charcount' => $charcount, 'capabilities' => [ 'view' => $canview, 'edit' => $canedit, 'delete' => $candelete, 'split' => $cansplit, 'reply' => $canreply, 'export' => $canexport, 'controlreadstatus' => $cancontrolreadstatus, 'canreplyprivately' => $canreplyprivately, 'selfenrol' => $canselfenrol ], 'urls' => [ 'view' => $viewurl ? $viewurl->out(false) : null, 'viewisolated' => $viewisolatedurl ? $viewisolatedurl->out(false) : null, 'viewparent' => $viewparenturl ? $viewparenturl->out(false) : null, 'edit' => $editurl ? $editurl->out(false) : null, 'delete' => $deleteurl ? $deleteurl->out(false) : null, 'split' => $spliturl ? $spliturl->out(false) : null, 'reply' => $replyurl ? $replyurl->out(false) : null, 'export' => $exporturl && $exporturl ? $exporturl->out(false) : null, 'markasread' => $markasreadurl ? $markasreadurl->out(false) : null, 'markasunread' => $markasunreadurl ? $markasunreadurl->out(false) : null, 'discuss' => $discussurl ? $discussurl->out(false) : null, ], 'attachments' => ($exportattachments) ? $this->export_attachments($attachments, $post, $output, $canexport) : [],
> 'messageinlinefiles' => ($exportinlineattachments) ? $this->export_inline_attachments($inlineattachments, 'tags' => ($loadcontent && $hastags) ? $this->export_tags($tags) : [], > $post, $output) : [],
'html' => $includehtml ? [ 'rating' => ($loadcontent && $hasrating) ? $output->render($rating) : null, 'taglist' => ($loadcontent && $hastags) ? $output->tag_list($tags) : null, 'authorsubheading' => ($loadcontent) ? $this->get_author_subheading_html($exportedauthor, $timecreated) : null ] : null ]; } /** * Returns a list of objects that are related. * * @return array */ protected static function define_related() { return [ 'capabilitymanager' => 'mod_forum\local\managers\capability', 'readreceiptcollection' => 'mod_forum\local\entities\post_read_receipt_collection?', 'urlfactory' => 'mod_forum\local\factories\url', 'forum' => 'mod_forum\local\entities\forum', 'discussion' => 'mod_forum\local\entities\discussion', 'author' => 'mod_forum\local\entities\author', 'authorcontextid' => 'int?', 'user' => 'stdClass', 'context' => 'context', 'authorgroups' => 'stdClass[]', 'attachments' => '\stored_file[]?',
> 'messageinlinefiles' => '\stored_file[]?',
'tags' => '\core_tag_tag[]?', 'rating' => 'rating?', 'includehtml' => 'bool' ]; } /** * This method returns the parameters for the post's message to
< * use with the function external_format_text().
> * use with the function \core_external\util::format_text().
* * @return array */ protected function get_format_parameters_for_message() { return [ 'component' => 'mod_forum', 'filearea' => 'post', 'itemid' => $this->post->get_id(), 'options' => [ 'para' => false, 'trusted' => $this->post->is_message_trusted() ] ]; } /** * Get the message text from a post. * * @param post_entity $post The post * @return string */ private function get_message(post_entity $post) : string { global $CFG; $message = $post->get_message(); if (!empty($CFG->enableplagiarism)) { require_once($CFG->libdir . '/plagiarismlib.php'); $forum = $this->related['forum']; $message .= plagiarism_get_links([ 'userid' => $post->get_author_id(), 'content' => $message, 'cmid' => $forum->get_course_module_record()->id, 'course' => $forum->get_course_id(), 'forum' => $forum->get_id() ]); } return $message; } /** * Get the exported attachments for a post. * * @param stored_file[] $attachments The list of attachments for the post * @param post_entity $post The post being exported * @param renderer_base $output Renderer base * @param bool $canexport If the user can export the post (relates to portfolios not exporters like this class) * @return array */ private function export_attachments(array $attachments, post_entity $post, renderer_base $output, bool $canexport) : array { global $CFG; $urlfactory = $this->related['urlfactory']; $enableplagiarism = $CFG->enableplagiarism; $forum = $this->related['forum']; $context = $this->related['context']; if ($enableplagiarism) { require_once($CFG->libdir . '/plagiarismlib.php' ); } return array_map(function($attachment) use ( $output, $enableplagiarism, $canexport, $context, $forum, $post, $urlfactory ) { $exporter = new stored_file_exporter($attachment, ['context' => $context]); $exportedattachment = $exporter->export($output); $exporturl = $canexport ? $urlfactory->get_export_attachment_url_from_post_and_attachment($post, $attachment) : null; if ($enableplagiarism) { $plagiarismhtml = plagiarism_get_links([ 'userid' => $post->get_author_id(), 'file' => $attachment, 'cmid' => $forum->get_course_module_record()->id, 'course' => $forum->get_course_id(), 'forum' => $forum->get_id() ]); } else { $plagiarismhtml = null; } $exportedattachment->urls = [ 'export' => $exporturl ? $exporturl->out(false) : null ]; $exportedattachment->html = [ 'plagiarism' => $plagiarismhtml ]; return $exportedattachment; }, $attachments);
> } } > > /** /** > * Get the exported inline attachments for a post. * Export the list of tags. > * * > * @param array $inlineattachments The list of inline attachments for the post * @param core_tag_tag[] $tags List of tags to export > * @param post_entity $post The post being exported * @return array > * @param renderer_base $output Renderer base */ > * @return array private function export_tags(array $tags) : array { > */ $user = $this->related['user']; > private function export_inline_attachments(array $inlineattachments, post_entity $post, renderer_base $output) : array { $context = $this->related['context']; > $capabilitymanager = $this->related['capabilitymanager']; > return array_map(function($attachment) use ( $canmanagetags = $capabilitymanager->can_manage_tags($user); > $output, > $post return array_values(array_map(function($tag) use ($context, $canmanagetags) { > ) { $viewurl = core_tag_tag::make_url($tag->tagcollid, $tag->rawname, 0, $context->id); > $exporter = new stored_file_exporter($attachment, ['context' => $this->related['context']]); return [ > return $exporter->export($output);; 'id' => $tag->taginstanceid, > }, $inlineattachments);
'tagid' => $tag->id, 'isstandard' => $tag->isstandard, 'displayname' => $tag->get_display_name(), 'flag' => $canmanagetags && !empty($tag->flag), 'urls' => [ 'view' => $viewurl->out(false) ] ]; }, $tags)); } /** * Get the HTML to display as a subheading in a post. * * @param stdClass $exportedauthor The exported author object * @param int $timecreated The post time created timestamp if it's to be displayed * @return string */ private function get_author_subheading_html(stdClass $exportedauthor, int $timecreated) : string { $fullname = $exportedauthor->fullname; $profileurl = $exportedauthor->urls['profile'] ?? null; $name = $profileurl ? "<a href=\"{$profileurl}\">{$fullname}</a>" : $fullname; $date = userdate_htmltime($timecreated, get_string('strftimedaydatetime', 'core_langconfig')); return get_string('bynameondate', 'mod_forum', ['name' => $name, 'date' => $date]); } /** * Get the start time for a post. * * @param discussion_entity $discussion entity * @param post_entity $post entity * @return int The start time (timestamp) for a post */ private function get_start_time(discussion_entity $discussion, post_entity $post) { global $CFG; $posttime = $post->get_time_created(); $discussiontime = $discussion->get_time_start(); if (!empty($CFG->forum_enabletimedposts) && ($discussiontime > $posttime)) { return $discussiontime; } return $posttime; } }