mod/forum/lib.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/>.
  16
  17 /**
  18  * @package   mod_forum
  19  * @copyright 1999 onwards Martin Dougiamas  {@link http://moodle.com}
  20  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  21  */
  22
  23 defined('MOODLE_INTERNAL') || die();
  24
  25 /** Include required files */
  26 require_once(__DIR__ . '/deprecatedlib.php');
  27 require_once($CFG->libdir.'/filelib.php');
  28 require_once($CFG->libdir.'/eventslib.php');
  29
  30 /// CONSTANTS ///////////////////////////////////////////////////////////
  31
  32 define('FORUM_MODE_FLATOLDEST', 1);
  33 define('FORUM_MODE_FLATNEWEST', -1);
  34 define('FORUM_MODE_THREADED', 2);
  35 define('FORUM_MODE_NESTED', 3);
  36
  37 define('FORUM_CHOOSESUBSCRIBE', 0);
  38 define('FORUM_FORCESUBSCRIBE', 1);
  39 define('FORUM_INITIALSUBSCRIBE', 2);
  40 define('FORUM_DISALLOWSUBSCRIBE',3);
  41
  42 /**
  43  * FORUM_TRACKING_OFF - Tracking is not available for this forum.
  44  */
  45 define('FORUM_TRACKING_OFF', 0);
  46
  47 /**
  48  * FORUM_TRACKING_OPTIONAL - Tracking is based on user preference.
  49  */
  50 define('FORUM_TRACKING_OPTIONAL', 1);
  51
  52 /**
  53  * FORUM_TRACKING_FORCED - Tracking is on, regardless of user setting.
  54  * Treated as FORUM_TRACKING_OPTIONAL if $CFG->forum_allowforcedreadtracking is off.
  55  */
  56 define('FORUM_TRACKING_FORCED', 2);
  57
  58 define('FORUM_MAILED_PENDING', 0);
  59 define('FORUM_MAILED_SUCCESS', 1);
  60 define('FORUM_MAILED_ERROR', 2);
  61
  62 if (!defined('FORUM_CRON_USER_CACHE')) {
  63     /** Defines how many full user records are cached in forum cron. */
  64     define('FORUM_CRON_USER_CACHE', 5000);
  65 }
  66
  67 /**
  68  * FORUM_POSTS_ALL_USER_GROUPS - All the posts in groups where the user is enrolled.
  69  */
  70 define('FORUM_POSTS_ALL_USER_GROUPS', -2);
  71
  72 define('FORUM_DISCUSSION_PINNED', 1);
  73 define('FORUM_DISCUSSION_UNPINNED', 0);
  74
  75 /// STANDARD FUNCTIONS ///////////////////////////////////////////////////////////
  76
  77 /**
  78  * Given an object containing all the necessary data,
  79  * (defined by the form in mod_form.php) this function
  80  * will create a new instance and return the id number
  81  * of the new instance.
  82  *
  83  * @param stdClass $forum add forum instance
  84  * @param mod_forum_mod_form $mform
  85  * @return int intance id
  86  */
  87 function forum_add_instance($forum, $mform = null) {
  88     global $CFG, $DB;
  89
  90     $forum->timemodified = time();
  91
  92     if (empty($forum->assessed)) {
  93         $forum->assessed = 0;
  94     }
  95
  96     if (empty($forum->ratingtime) or empty($forum->assessed)) {
  97         $forum->assesstimestart  = 0;
  98         $forum->assesstimefinish = 0;
  99     }
 100
 101     $forum->id = $DB->insert_record('forum', $forum);
 102     $modcontext = context_module::instance($forum->coursemodule);
 103
 104     if ($forum->type == 'single') {  // Create related discussion.
 105         $discussion = new stdClass();
 106         $discussion->course        = $forum->course;
 107         $discussion->forum         = $forum->id;
 108         $discussion->name          = $forum->name;
 109         $discussion->assessed      = $forum->assessed;
 110         $discussion->message       = $forum->intro;
 111         $discussion->messageformat = $forum->introformat;
 112         $discussion->messagetrust  = trusttext_trusted(context_course::instance($forum->course));
 113         $discussion->mailnow       = false;
 114         $discussion->groupid       = -1;
 115
 116         $message = '';
 117
 118         $discussion->id = forum_add_discussion($discussion, null, $message);
 119
 120         if ($mform and $draftid = file_get_submitted_draft_itemid('introeditor')) {
 121             // Ugly hack - we need to copy the files somehow.
 122             $discussion = $DB->get_record('forum_discussions', array('id'=>$discussion->id), '*', MUST_EXIST);
 123             $post = $DB->get_record('forum_posts', array('id'=>$discussion->firstpost), '*', MUST_EXIST);
 124
 125             $options = array('subdirs'=>true); // Use the same options as intro field!
 126             $post->message = file_save_draft_area_files($draftid, $modcontext->id, 'mod_forum', 'post', $post->id, $options, $post->message);
 127             $DB->set_field('forum_posts', 'message', $post->message, array('id'=>$post->id));
 128         }
 129     }
 130
 131     forum_grade_item_update($forum);
 132
 133     return $forum->id;
 134 }
 135
 136 /**
 137  * Handle changes following the creation of a forum instance.
 138  * This function is typically called by the course_module_created observer.
 139  *
 140  * @param object $context the forum context
 141  * @param stdClass $forum The forum object
 142  * @return void
 143  */
 144 function forum_instance_created($context, $forum) {
 145     if ($forum->forcesubscribe == FORUM_INITIALSUBSCRIBE) {
 146         $users = \mod_forum\subscriptions::get_potential_subscribers($context, 0, 'u.id, u.email');
 147         foreach ($users as $user) {
 148             \mod_forum\subscriptions::subscribe_user($user->id, $forum, $context);
 149         }
 150     }
 151 }
 152
 153 /**
 154  * Given an object containing all the necessary data,
 155  * (defined by the form in mod_form.php) this function
 156  * will update an existing instance with new data.
 157  *
 158  * @global object
 159  * @param object $forum forum instance (with magic quotes)
 160  * @return bool success
 161  */
 162 function forum_update_instance($forum, $mform) {
 163     global $DB, $OUTPUT, $USER;
 164
 165     $forum->timemodified = time();
 166     $forum->id           = $forum->instance;
 167
 168     if (empty($forum->assessed)) {
 169         $forum->assessed = 0;
 170     }
 171
 172     if (empty($forum->ratingtime) or empty($forum->assessed)) {
 173         $forum->assesstimestart  = 0;
 174         $forum->assesstimefinish = 0;
 175     }
 176
 177     $oldforum = $DB->get_record('forum', array('id'=>$forum->id));
 178
 179     // MDL-3942 - if the aggregation type or scale (i.e. max grade) changes then recalculate the grades for the entire forum
 180     // if  scale changes - do we need to recheck the ratings, if ratings higher than scale how do we want to respond?
 181     // for count and sum aggregation types the grade we check to make sure they do not exceed the scale (i.e. max score) when calculating the grade
 182     if (($oldforum->assessed<>$forum->assessed) or ($oldforum->scale<>$forum->scale)) {
 183         forum_update_grades($forum); // recalculate grades for the forum
 184     }
 185
 186     if ($forum->type == 'single') {  // Update related discussion and post.
 187         $discussions = $DB->get_records('forum_discussions', array('forum'=>$forum->id), 'timemodified ASC');
 188         if (!empty($discussions)) {
 189             if (count($discussions) > 1) {
 190                 echo $OUTPUT->notification(get_string('warnformorepost', 'forum'));
 191             }
 192             $discussion = array_pop($discussions);
 193         } else {
 194             // try to recover by creating initial discussion - MDL-16262
 195             $discussion = new stdClass();
 196             $discussion->course          = $forum->course;
 197             $discussion->forum           = $forum->id;
 198             $discussion->name            = $forum->name;
 199             $discussion->assessed        = $forum->assessed;
 200             $discussion->message         = $forum->intro;
 201             $discussion->messageformat   = $forum->introformat;
 202             $discussion->messagetrust    = true;
 203             $discussion->mailnow         = false;
 204             $discussion->groupid         = -1;
 205
 206             $message = '';
 207
 208             forum_add_discussion($discussion, null, $message);
 209
 210             if (! $discussion = $DB->get_record('forum_discussions', array('forum'=>$forum->id))) {
 211                 print_error('cannotadd', 'forum');
 212             }
 213         }
 214         if (! $post = $DB->get_record('forum_posts', array('id'=>$discussion->firstpost))) {
 215             print_error('cannotfindfirstpost', 'forum');
 216         }
 217
 218         $cm         = get_coursemodule_from_instance('forum', $forum->id);
 219         $modcontext = context_module::instance($cm->id, MUST_EXIST);
 220
 221         $post = $DB->get_record('forum_posts', array('id'=>$discussion->firstpost), '*', MUST_EXIST);
 222         $post->subject       = $forum->name;
 223         $post->message       = $forum->intro;
 224         $post->messageformat = $forum->introformat;
 225         $post->messagetrust  = trusttext_trusted($modcontext);
 226         $post->modified      = $forum->timemodified;
 227         $post->userid        = $USER->id;    // MDL-18599, so that current teacher can take ownership of activities.
 228
 229         if ($mform and $draftid = file_get_submitted_draft_itemid('introeditor')) {
 230             // Ugly hack - we need to copy the files somehow.
 231             $options = array('subdirs'=>true); // Use the same options as intro field!
 232             $post->message = file_save_draft_area_files($draftid, $modcontext->id, 'mod_forum', 'post', $post->id, $options, $post->message);
 233         }
 234
 235         $DB->update_record('forum_posts', $post);
 236         $discussion->name = $forum->name;
 237         $DB->update_record('forum_discussions', $discussion);
 238     }
 239
 240     $DB->update_record('forum', $forum);
 241
 242     $modcontext = context_module::instance($forum->coursemodule);
 243     if (($forum->forcesubscribe == FORUM_INITIALSUBSCRIBE) && ($oldforum->forcesubscribe <> $forum->forcesubscribe)) {
 244         $users = \mod_forum\subscriptions::get_potential_subscribers($modcontext, 0, 'u.id, u.email', '');
 245         foreach ($users as $user) {
 246             \mod_forum\subscriptions::subscribe_user($user->id, $forum, $modcontext);
 247         }
 248     }
 249
 250     forum_grade_item_update($forum);
 251
 252     return true;
 253 }
 254
 255
 256 /**
 257  * Given an ID of an instance of this module,
 258  * this function will permanently delete the instance
 259  * and any data that depends on it.
 260  *
 261  * @global object
 262  * @param int $id forum instance id
 263  * @return bool success
 264  */
 265 function forum_delete_instance($id) {
 266     global $DB;
 267
 268     if (!$forum = $DB->get_record('forum', array('id'=>$id))) {
 269         return false;
 270     }
 271     if (!$cm = get_coursemodule_from_instance('forum', $forum->id)) {
 272         return false;
 273     }
 274     if (!$course = $DB->get_record('course', array('id'=>$cm->course))) {
 275         return false;
 276     }
 277
 278     $context = context_module::instance($cm->id);
 279
 280     // now get rid of all files
 281     $fs = get_file_storage();
 282     $fs->delete_area_files($context->id);
 283
 284     $result = true;
 285
 286     // Delete digest and subscription preferences.
 287     $DB->delete_records('forum_digests', array('forum' => $forum->id));
 288     $DB->delete_records('forum_subscriptions', array('forum'=>$forum->id));
 289     $DB->delete_records('forum_discussion_subs', array('forum' => $forum->id));
 290
 291     if ($discussions = $DB->get_records('forum_discussions', array('forum'=>$forum->id))) {
 292         foreach ($discussions as $discussion) {
 293             if (!forum_delete_discussion($discussion, true, $course, $cm, $forum)) {
 294                 $result = false;
 295             }
 296         }
 297     }
 298
 299     forum_tp_delete_read_records(-1, -1, -1, $forum->id);
 300
 301     if (!$DB->delete_records('forum', array('id'=>$forum->id))) {
 302         $result = false;
 303     }
 304
 305     forum_grade_item_delete($forum);
 306
 307     return $result;
 308 }
 309
 310
 311 /**
 312  * Indicates API features that the forum supports.
 313  *
 314  * @uses FEATURE_GROUPS
 315  * @uses FEATURE_GROUPINGS
 316  * @uses FEATURE_MOD_INTRO
 317  * @uses FEATURE_COMPLETION_TRACKS_VIEWS
 318  * @uses FEATURE_COMPLETION_HAS_RULES
 319  * @uses FEATURE_GRADE_HAS_GRADE
 320  * @uses FEATURE_GRADE_OUTCOMES
 321  * @param string $feature
 322  * @return mixed True if yes (some features may use other values)
 323  */
 324 function forum_supports($feature) {
 325     switch($feature) {
 326         case FEATURE_GROUPS:                  return true;
 327         case FEATURE_GROUPINGS:               return true;
 328         case FEATURE_MOD_INTRO:               return true;
 329         case FEATURE_COMPLETION_TRACKS_VIEWS: return true;
 330         case FEATURE_COMPLETION_HAS_RULES:    return true;
 331         case FEATURE_GRADE_HAS_GRADE:         return true;
 332         case FEATURE_GRADE_OUTCOMES:          return true;
 333         case FEATURE_RATE:                    return true;
 334         case FEATURE_BACKUP_MOODLE2:          return true;
 335         case FEATURE_SHOW_DESCRIPTION:        return true;
 336         case FEATURE_PLAGIARISM:              return true;
 337
 338         default: return null;
 339     }
 340 }
 341
 342
 343 /**
 344  * Obtains the automatic completion state for this forum based on any conditions
 345  * in forum settings.
 346  *
 347  * @global object
 348  * @global object
 349  * @param object $course Course
 350  * @param object $cm Course-module
 351  * @param int $userid User ID
 352  * @param bool $type Type of comparison (or/and; can be used as return value if no conditions)
 353  * @return bool True if completed, false if not. (If no conditions, then return
 354  *   value depends on comparison type)
 355  */
 356 function forum_get_completion_state($course,$cm,$userid,$type) {
 357     global $CFG,$DB;
 358
 359     // Get forum details
 360     if (!($forum=$DB->get_record('forum',array('id'=>$cm->instance)))) {
 361         throw new Exception("Can't find forum {$cm->instance}");
 362     }
 363
 364     $result=$type; // Default return value
 365
 366     $postcountparams=array('userid'=>$userid,'forumid'=>$forum->id);
 367     $postcountsql="
 368 SELECT
 369     COUNT(1)
 370 FROM
 371     {forum_posts} fp
 372     INNER JOIN {forum_discussions} fd ON fp.discussion=fd.id
 373 WHERE
 374     fp.userid=:userid AND fd.forum=:forumid";
 375
 376     if ($forum->completiondiscussions) {
 377         $value = $forum->completiondiscussions <=
 378                  $DB->count_records('forum_discussions',array('forum'=>$forum->id,'userid'=>$userid));
 379         if ($type == COMPLETION_AND) {
 380             $result = $result && $value;
 381         } else {
 382             $result = $result || $value;
 383         }
 384     }
 385     if ($forum->completionreplies) {
 386         $value = $forum->completionreplies <=
 387                  $DB->get_field_sql( $postcountsql.' AND fp.parent<>0',$postcountparams);
 388         if ($type==COMPLETION_AND) {
 389             $result = $result && $value;
 390         } else {
 391             $result = $result || $value;
 392         }
 393     }
 394     if ($forum->completionposts) {
 395         $value = $forum->completionposts <= $DB->get_field_sql($postcountsql,$postcountparams);
 396         if ($type == COMPLETION_AND) {
 397             $result = $result && $value;
 398         } else {
 399             $result = $result || $value;
 400         }
 401     }
 402
 403     return $result;
 404 }
 405
 406 /**
 407  * Create a message-id string to use in the custom headers of forum notification emails
 408  *
 409  * message-id is used by email clients to identify emails and to nest conversations
 410  *
 411  * @param int $postid The ID of the forum post we are notifying the user about
 412  * @param int $usertoid The ID of the user being notified
 413  * @return string A unique message-id
 414  */
 415 function forum_get_email_message_id($postid, $usertoid) {
 416     return generate_email_messageid(hash('sha256', $postid . 'to' . $usertoid));
 417 }
 418
 419 /**
 420  * Removes properties from user record that are not necessary
 421  * for sending post notifications.
 422  * @param stdClass $user
 423  * @return void, $user parameter is modified
 424  */
 425 function forum_cron_minimise_user_record(stdClass $user) {
 426
 427     // We store large amount of users in one huge array,
 428     // make sure we do not store info there we do not actually need
 429     // in mail generation code or messaging.
 430
 431     unset($user->institution);
 432     unset($user->department);
 433     unset($user->address);
 434     unset($user->city);
 435     unset($user->url);
 436     unset($user->currentlogin);
 437     unset($user->description);
 438     unset($user->descriptionformat);
 439 }
 440
 441 /**
 442  * Function to be run periodically according to the scheduled task.
 443  *
 444  * Finds all posts that have yet to be mailed out, and mails them
 445  * out to all subscribers as well as other maintance tasks.
 446  *
 447  * NOTE: Since 2.7.2 this function is run by scheduled task rather
 448  * than standard cron.
 449  *
 450  * @todo MDL-44734 The function will be split up into seperate tasks.
 451  */
 452 function forum_cron() {
 453     global $CFG, $USER, $DB, $PAGE;
 454
 455     $site = get_site();
 456
 457     // The main renderers.
 458     $htmlout = $PAGE->get_renderer('mod_forum', 'email', 'htmlemail');
 459     $textout = $PAGE->get_renderer('mod_forum', 'email', 'textemail');
 460     $htmldigestfullout = $PAGE->get_renderer('mod_forum', 'emaildigestfull', 'htmlemail');
 461     $textdigestfullout = $PAGE->get_renderer('mod_forum', 'emaildigestfull', 'textemail');
 462     $htmldigestbasicout = $PAGE->get_renderer('mod_forum', 'emaildigestbasic', 'htmlemail');
 463     $textdigestbasicout = $PAGE->get_renderer('mod_forum', 'emaildigestbasic', 'textemail');
 464
 465     // All users that are subscribed to any post that needs sending,
 466     // please increase $CFG->extramemorylimit on large sites that
 467     // send notifications to a large number of users.
 468     $users = array();
 469     $userscount = 0; // Cached user counter - count($users) in PHP is horribly slow!!!
 470
 471     // Status arrays.
 472     $mailcount  = array();
 473     $errorcount = array();
 474
 475     // caches
 476     $discussions        = array();
 477     $forums             = array();
 478     $courses            = array();
 479     $coursemodules      = array();
 480     $subscribedusers    = array();
 481     $messageinboundhandlers = array();
 482
 483     // Posts older than 2 days will not be mailed.  This is to avoid the problem where
 484     // cron has not been running for a long time, and then suddenly people are flooded
 485     // with mail from the past few weeks or months
 486     $timenow   = time();
 487     $endtime   = $timenow - $CFG->maxeditingtime;
 488     $starttime = $endtime - 48 * 3600;   // Two days earlier
 489
 490     // Get the list of forum subscriptions for per-user per-forum maildigest settings.
 491     $digestsset = $DB->get_recordset('forum_digests', null, '', 'id, userid, forum, maildigest');
 492     $digests = array();
 493     foreach ($digestsset as $thisrow) {
 494         if (!isset($digests[$thisrow->forum])) {
 495             $digests[$thisrow->forum] = array();
 496         }
 497         $digests[$thisrow->forum][$thisrow->userid] = $thisrow->maildigest;
 498     }
 499     $digestsset->close();
 500
 501     // Create the generic messageinboundgenerator.
 502     $messageinboundgenerator = new \core\message\inbound\address_manager();
 503     $messageinboundgenerator->set_handler('\mod_forum\message\inbound\reply_handler');
 504
 505     if ($posts = forum_get_unmailed_posts($starttime, $endtime, $timenow)) {
 506         // Mark them all now as being mailed.  It's unlikely but possible there
 507         // might be an error later so that a post is NOT actually mailed out,
 508         // but since mail isn't crucial, we can accept this risk.  Doing it now
 509         // prevents the risk of duplicated mails, which is a worse problem.
 510
 511         if (!forum_mark_old_posts_as_mailed($endtime)) {
 512             mtrace('Errors occurred while trying to mark some posts as being mailed.');
 513             return false;  // Don't continue trying to mail them, in case we are in a cron loop
 514         }
 515
 516         // checking post validity, and adding users to loop through later
 517         foreach ($posts as $pid => $post) {
 518
 519             $discussionid = $post->discussion;
 520             if (!isset($discussions[$discussionid])) {
 521                 if ($discussion = $DB->get_record('forum_discussions', array('id'=> $post->discussion))) {
 522                     $discussions[$discussionid] = $discussion;
 523                     \mod_forum\subscriptions::fill_subscription_cache($discussion->forum);
 524                     \mod_forum\subscriptions::fill_discussion_subscription_cache($discussion->forum);
 525
 526                 } else {
 527                     mtrace('Could not find discussion ' . $discussionid);
 528                     unset($posts[$pid]);
 529                     continue;
 530                 }
 531             }
 532             $forumid = $discussions[$discussionid]->forum;
 533             if (!isset($forums[$forumid])) {
 534                 if ($forum = $DB->get_record('forum', array('id' => $forumid))) {
 535                     $forums[$forumid] = $forum;
 536                 } else {
 537                     mtrace('Could not find forum '.$forumid);
 538                     unset($posts[$pid]);
 539                     continue;
 540                 }
 541             }
 542             $courseid = $forums[$forumid]->course;
 543             if (!isset($courses[$courseid])) {
 544                 if ($course = $DB->get_record('course', array('id' => $courseid))) {
 545                     $courses[$courseid] = $course;
 546                 } else {
 547                     mtrace('Could not find course '.$courseid);
 548                     unset($posts[$pid]);
 549                     continue;
 550                 }
 551             }
 552             if (!isset($coursemodules[$forumid])) {
 553                 if ($cm = get_coursemodule_from_instance('forum', $forumid, $courseid)) {
 554                     $coursemodules[$forumid] = $cm;
 555                 } else {
 556                     mtrace('Could not find course module for forum '.$forumid);
 557                     unset($posts[$pid]);
 558                     continue;
 559                 }
 560             }
 561
 562             // Save the Inbound Message datakey here to reduce DB queries later.
 563             $messageinboundgenerator->set_data($pid);
 564             $messageinboundhandlers[$pid] = $messageinboundgenerator->fetch_data_key();
 565
 566             // Caching subscribed users of each forum.
 567             if (!isset($subscribedusers[$forumid])) {
 568                 $modcontext = context_module::instance($coursemodules[$forumid]->id);
 569                 if ($subusers = \mod_forum\subscriptions::fetch_subscribed_users($forums[$forumid], 0, $modcontext, 'u.*', true)) {
 570
 571                     foreach ($subusers as $postuser) {
 572                         // this user is subscribed to this forum
 573                         $subscribedusers[$forumid][$postuser->id] = $postuser->id;
 574                         $userscount++;
 575                         if ($userscount > FORUM_CRON_USER_CACHE) {
 576                             // Store minimal user info.
 577                             $minuser = new stdClass();
 578                             $minuser->id = $postuser->id;
 579                             $users[$postuser->id] = $minuser;
 580                         } else {
 581                             // Cache full user record.
 582                             forum_cron_minimise_user_record($postuser);
 583                             $users[$postuser->id] = $postuser;
 584                         }
 585                     }
 586                     // Release memory.
 587                     unset($subusers);
 588                     unset($postuser);
 589                 }
 590             }
 591             $mailcount[$pid] = 0;
 592             $errorcount[$pid] = 0;
 593         }
 594     }
 595
 596     if ($users && $posts) {
 597
 598         foreach ($users as $userto) {
 599             // Terminate if processing of any account takes longer than 2 minutes.
 600             core_php_time_limit::raise(120);
 601
 602             mtrace('Processing user ' . $userto->id);
 603
 604             // Init user caches - we keep the cache for one cycle only, otherwise it could consume too much memory.
 605             if (isset($userto->username)) {
 606                 $userto = clone($userto);
 607             } else {
 608                 $userto = $DB->get_record('user', array('id' => $userto->id));
 609                 forum_cron_minimise_user_record($userto);
 610             }
 611             $userto->viewfullnames = array();
 612             $userto->canpost       = array();
 613             $userto->markposts     = array();
 614
 615             // Setup this user so that the capabilities are cached, and environment matches receiving user.
 616             cron_setup_user($userto);
 617
 618             // Reset the caches.
 619             foreach ($coursemodules as $forumid => $unused) {
 620                 $coursemodules[$forumid]->cache       = new stdClass();
 621                 $coursemodules[$forumid]->cache->caps = array();
 622                 unset($coursemodules[$forumid]->uservisible);
 623             }
 624
 625             foreach ($posts as $pid => $post) {
 626                 $discussion = $discussions[$post->discussion];
 627                 $forum      = $forums[$discussion->forum];
 628                 $course     = $courses[$forum->course];
 629                 $cm         =& $coursemodules[$forum->id];
 630
 631                 // Do some checks to see if we can bail out now.
 632
 633                 // Only active enrolled users are in the list of subscribers.
 634                 // This does not necessarily mean that the user is subscribed to the forum or to the discussion though.
 635                 if (!isset($subscribedusers[$forum->id][$userto->id])) {
 636                     // The user does not subscribe to this forum.
 637                     continue;
 638                 }
 639
 640                 if (!\mod_forum\subscriptions::is_subscribed($userto->id, $forum, $post->discussion, $coursemodules[$forum->id])) {
 641                     // The user does not subscribe to this forum, or to this specific discussion.
 642                     continue;
 643                 }
 644
 645                 if ($subscriptiontime = \mod_forum\subscriptions::fetch_discussion_subscription($forum->id, $userto->id)) {
 646                     // Skip posts if the user subscribed to the discussion after it was created.
 647                     if (isset($subscriptiontime[$post->discussion]) && ($subscriptiontime[$post->discussion] > $post->created)) {
 648                         continue;
 649                     }
 650                 }
 651
 652                 // Don't send email if the forum is Q&A and the user has not posted.
 653                 // Initial topics are still mailed.
 654                 if ($forum->type == 'qanda' && !forum_get_user_posted_time($discussion->id, $userto->id) && $pid != $discussion->firstpost) {
 655                     mtrace('Did not email ' . $userto->id.' because user has not posted in discussion');
 656                     continue;
 657                 }
 658
 659                 // Get info about the sending user.
 660                 if (array_key_exists($post->userid, $users)) {
 661                     // We might know the user already.
 662                     $userfrom = $users[$post->userid];
 663                     if (!isset($userfrom->idnumber)) {
 664                         // Minimalised user info, fetch full record.
 665                         $userfrom = $DB->get_record('user', array('id' => $userfrom->id));
 666                         forum_cron_minimise_user_record($userfrom);
 667                     }
 668
 669                 } else if ($userfrom = $DB->get_record('user', array('id' => $post->userid))) {
 670                     forum_cron_minimise_user_record($userfrom);
 671                     // Fetch only once if possible, we can add it to user list, it will be skipped anyway.
 672                     if ($userscount <= FORUM_CRON_USER_CACHE) {
 673                         $userscount++;
 674                         $users[$userfrom->id] = $userfrom;
 675                     }
 676                 } else {
 677                     mtrace('Could not find user ' . $post->userid . ', author of post ' . $post->id . '. Unable to send message.');
 678                     continue;
 679                 }
 680
 681                 // Note: If we want to check that userto and userfrom are not the same person this is probably the spot to do it.
 682
 683                 // Setup global $COURSE properly - needed for roles and languages.
 684                 cron_setup_user($userto, $course);
 685
 686                 // Fill caches.
 687                 if (!isset($userto->viewfullnames[$forum->id])) {
 688                     $modcontext = context_module::instance($cm->id);
 689                     $userto->viewfullnames[$forum->id] = has_capability('moodle/site:viewfullnames', $modcontext);
 690                 }
 691                 if (!isset($userto->canpost[$discussion->id])) {
 692                     $modcontext = context_module::instance($cm->id);
 693                     $userto->canpost[$discussion->id] = forum_user_can_post($forum, $discussion, $userto, $cm, $course, $modcontext);
 694                 }
 695                 if (!isset($userfrom->groups[$forum->id])) {
 696                     if (!isset($userfrom->groups)) {
 697                         $userfrom->groups = array();
 698                         if (isset($users[$userfrom->id])) {
 699                             $users[$userfrom->id]->groups = array();
 700                         }
 701                     }
 702                     $userfrom->groups[$forum->id] = groups_get_all_groups($course->id, $userfrom->id, $cm->groupingid);
 703                     if (isset($users[$userfrom->id])) {
 704                         $users[$userfrom->id]->groups[$forum->id] = $userfrom->groups[$forum->id];
 705                     }
 706                 }
 707
 708                 // Make sure groups allow this user to see this email.
 709                 if ($discussion->groupid > 0 and $groupmode = groups_get_activity_groupmode($cm, $course)) {
 710                     // Groups are being used.
 711                     if (!groups_group_exists($discussion->groupid)) {
 712                         // Can't find group - be safe and don't this message.
 713                         continue;
 714                     }
 715
 716                     if (!groups_is_member($discussion->groupid) and !has_capability('moodle/site:accessallgroups', $modcontext)) {
 717                         // Do not send posts from other groups when in SEPARATEGROUPS or VISIBLEGROUPS.
 718                         continue;
 719                     }
 720                 }
 721
 722                 // Make sure we're allowed to see the post.
 723                 if (!forum_user_can_see_post($forum, $discussion, $post, null, $cm)) {
 724                     mtrace('User ' . $userto->id .' can not see ' . $post->id . '. Not sending message.');
 725                     continue;
 726                 }
 727
 728                 // OK so we need to send the email.
 729
 730                 // Does the user want this post in a digest?  If so postpone it for now.
 731                 $maildigest = forum_get_user_maildigest_bulk($digests, $userto, $forum->id);
 732
 733                 if ($maildigest > 0) {
 734                     // This user wants the mails to be in digest form.
 735                     $queue = new stdClass();
 736                     $queue->userid       = $userto->id;
 737                     $queue->discussionid = $discussion->id;
 738                     $queue->postid       = $post->id;
 739                     $queue->timemodified = $post->created;
 740                     $DB->insert_record('forum_queue', $queue);
 741                     continue;
 742                 }
 743
 744                 // Prepare to actually send the post now, and build up the content.
 745
 746                 $cleanforumname = str_replace('"', "'", strip_tags(format_string($forum->name)));
 747
 748                 $userfrom->customheaders = array (
 749                     // Headers to make emails easier to track.
 750                     'List-Id: "'        . $cleanforumname . '" ' . generate_email_messageid('moodleforum' . $forum->id),
 751                     'List-Help: '       . $CFG->wwwroot . '/mod/forum/view.php?f=' . $forum->id,
 752                     'Message-ID: '      . forum_get_email_message_id($post->id, $userto->id),
 753                     'X-Course-Id: '     . $course->id,
 754                     'X-Course-Name: '   . format_string($course->fullname, true),
 755
 756                     // Headers to help prevent auto-responders.
 757                     'Precedence: Bulk',
 758                     'X-Auto-Response-Suppress: All',
 759                     'Auto-Submitted: auto-generated',
 760                 );
 761
 762                 $shortname = format_string($course->shortname, true, array('context' => context_course::instance($course->id)));
 763
 764                 // Generate a reply-to address from using the Inbound Message handler.
 765                 $replyaddress = null;
 766                 if ($userto->canpost[$discussion->id] && array_key_exists($post->id, $messageinboundhandlers)) {
 767                     $messageinboundgenerator->set_data($post->id, $messageinboundhandlers[$post->id]);
 768                     $replyaddress = $messageinboundgenerator->generate($userto->id);
 769                 }
 770
 771                 if (!isset($userto->canpost[$discussion->id])) {
 772                     $canreply = forum_user_can_post($forum, $discussion, $userto, $cm, $course, $modcontext);
 773                 } else {
 774                     $canreply = $userto->canpost[$discussion->id];
 775                 }
 776
 777                 $data = new \mod_forum\output\forum_post_email(
 778                         $course,
 779                         $cm,
 780                         $forum,
 781                         $discussion,
 782                         $post,
 783                         $userfrom,
 784                         $userto,
 785                         $canreply
 786                     );
 787
 788                 $userfrom->customheaders[] = sprintf('List-Unsubscribe: <%s>',
 789                     $data->get_unsubscribediscussionlink());
 790
 791                 if (!isset($userto->viewfullnames[$forum->id])) {
 792                     $data->viewfullnames = has_capability('moodle/site:viewfullnames', $modcontext, $userto->id);
 793                 } else {
 794                     $data->viewfullnames = $userto->viewfullnames[$forum->id];
 795                 }
 796
 797                 // Not all of these variables are used in the default language
 798                 // string but are made available to support custom subjects.
 799                 $a = new stdClass();
 800                 $a->subject = $data->get_subject();
 801                 $a->forumname = $cleanforumname;
 802                 $a->sitefullname = format_string($site->fullname);
 803                 $a->siteshortname = format_string($site->shortname);
 804                 $a->courseidnumber = $data->get_courseidnumber();
 805                 $a->coursefullname = $data->get_coursefullname();
 806                 $a->courseshortname = $data->get_coursename();
 807                 $postsubject = html_to_text(get_string('postmailsubject', 'forum', $a), 0);
 808
 809                 $rootid = forum_get_email_message_id($discussion->firstpost, $userto->id);
 810
 811                 if ($post->parent) {
 812                     // This post is a reply, so add reply header (RFC 2822).
 813                     $parentid = forum_get_email_message_id($post->parent, $userto->id);
 814                     $userfrom->customheaders[] = "In-Reply-To: $parentid";
 815
 816                     // If the post is deeply nested we also reference the parent message id and
 817                     // the root message id (if different) to aid threading when parts of the email
 818                     // conversation have been deleted (RFC1036).
 819                     if ($post->parent != $discussion->firstpost) {
 820                         $userfrom->customheaders[] = "References: $rootid $parentid";
 821                     } else {
 822                         $userfrom->customheaders[] = "References: $parentid";
 823                     }
 824                 }
 825
 826                 // MS Outlook / Office uses poorly documented and non standard headers, including
 827                 // Thread-Topic which overrides the Subject and shouldn't contain Re: or Fwd: etc.
 828                 $a->subject = $discussion->name;
 829                 $threadtopic = html_to_text(get_string('postmailsubject', 'forum', $a), 0);
 830                 $userfrom->customheaders[] = "Thread-Topic: $threadtopic";
 831                 $userfrom->customheaders[] = "Thread-Index: " . substr($rootid, 1, 28);
 832
 833                 // Send the post now!
 834                 mtrace('Sending ', '');
 835
 836                 $eventdata = new \core\message\message();
 837                 $eventdata->courseid            = $course->id;
 838                 $eventdata->component           = 'mod_forum';
 839                 $eventdata->name                = 'posts';
 840                 $eventdata->userfrom            = $userfrom;
 841                 $eventdata->userto              = $userto;
 842                 $eventdata->subject             = $postsubject;
 843                 $eventdata->fullmessage         = $textout->render($data);
 844                 $eventdata->fullmessageformat   = FORMAT_PLAIN;
 845                 $eventdata->fullmessagehtml     = $htmlout->render($data);
 846                 $eventdata->notification        = 1;
 847                 $eventdata->replyto             = $replyaddress;
 848                 if (!empty($replyaddress)) {
 849                     // Add extra text to email messages if they can reply back.
 850                     $textfooter = "\n\n" . get_string('replytopostbyemail', 'mod_forum');
 851                     $htmlfooter = html_writer::tag('p', get_string('replytopostbyemail', 'mod_forum'));
 852                     $additionalcontent = array('fullmessage' => array('footer' => $textfooter),
 853                                      'fullmessagehtml' => array('footer' => $htmlfooter));
 854                     $eventdata->set_additional_content('email', $additionalcontent);
 855                 }
 856
 857                 $smallmessagestrings = new stdClass();
 858                 $smallmessagestrings->user          = fullname($userfrom);
 859                 $smallmessagestrings->forumname     = "$shortname: " . format_string($forum->name, true) . ": " . $discussion->name;
 860                 $smallmessagestrings->message       = $post->message;
 861
 862                 // Make sure strings are in message recipients language.
 863                 $eventdata->smallmessage = get_string_manager()->get_string('smallmessage', 'forum', $smallmessagestrings, $userto->lang);
 864
 865                 $contexturl = new moodle_url('/mod/forum/discuss.php', array('d' => $discussion->id), 'p' . $post->id);
 866                 $eventdata->contexturl = $contexturl->out();
 867                 $eventdata->contexturlname = $discussion->name;
 868
 869                 $mailresult = message_send($eventdata);
 870                 if (!$mailresult) {
 871                     mtrace("Error: mod/forum/lib.php forum_cron(): Could not send out mail for id $post->id to user $userto->id".
 872                             " ($userto->email) .. not trying again.");
 873                     $errorcount[$post->id]++;
 874                 } else {
 875                     $mailcount[$post->id]++;
 876
 877                     // Mark post as read if forum_usermarksread is set off.
 878                     if (!$CFG->forum_usermarksread) {
 879                         $userto->markposts[$post->id] = $post->id;
 880                     }
 881                 }
 882
 883                 mtrace('post ' . $post->id . ': ' . $post->subject);
 884             }
 885
 886             // Mark processed posts as read.
 887             if (get_user_preferences('forum_markasreadonnotification', 1, $userto->id) == 1) {
 888                 forum_tp_mark_posts_read($userto, $userto->markposts);
 889             }
 890
 891             unset($userto);
 892         }
 893     }
 894
 895     if ($posts) {
 896         foreach ($posts as $post) {
 897             mtrace($mailcount[$post->id]." users were sent post $post->id, '$post->subject'");
 898             if ($errorcount[$post->id]) {
 899                 $DB->set_field('forum_posts', 'mailed', FORUM_MAILED_ERROR, array('id' => $post->id));
 900             }
 901         }
 902     }
 903
 904     // release some memory
 905     unset($subscribedusers);
 906     unset($mailcount);
 907     unset($errorcount);
 908
 909     cron_setup_user();
 910
 911     $sitetimezone = core_date::get_server_timezone();
 912
 913     // Now see if there are any digest mails waiting to be sent, and if we should send them
 914
 915     mtrace('Starting digest processing...');
 916
 917     core_php_time_limit::raise(300); // terminate if not able to fetch all digests in 5 minutes
 918
 919     if (!isset($CFG->digestmailtimelast)) {    // To catch the first time
 920         set_config('digestmailtimelast', 0);
 921     }
 922
 923     $timenow = time();
 924     $digesttime = usergetmidnight($timenow, $sitetimezone) + ($CFG->digestmailtime * 3600);
 925
 926     // Delete any really old ones (normally there shouldn't be any)
 927     $weekago = $timenow - (7 * 24 * 3600);
 928     $DB->delete_records_select('forum_queue', "timemodified < ?", array($weekago));
 929     mtrace ('Cleaned old digest records');
 930
 931     if ($CFG->digestmailtimelast < $digesttime and $timenow > $digesttime) {
 932
 933         mtrace('Sending forum digests: '.userdate($timenow, '', $sitetimezone));
 934
 935         $digestposts_rs = $DB->get_recordset_select('forum_queue', "timemodified < ?", array($digesttime));
 936
 937         if ($digestposts_rs->valid()) {
 938
 939             // We have work to do
 940             $usermailcount = 0;
 941
 942             //caches - reuse the those filled before too
 943             $discussionposts = array();
 944             $userdiscussions = array();
 945
 946             foreach ($digestposts_rs as $digestpost) {
 947                 if (!isset($posts[$digestpost->postid])) {
 948                     if ($post = $DB->get_record('forum_posts', array('id' => $digestpost->postid))) {
 949                         $posts[$digestpost->postid] = $post;
 950                     } else {
 951                         continue;
 952                     }
 953                 }
 954                 $discussionid = $digestpost->discussionid;
 955                 if (!isset($discussions[$discussionid])) {
 956                     if ($discussion = $DB->get_record('forum_discussions', array('id' => $discussionid))) {
 957                         $discussions[$discussionid] = $discussion;
 958                     } else {
 959                         continue;
 960                     }
 961                 }
 962                 $forumid = $discussions[$discussionid]->forum;
 963                 if (!isset($forums[$forumid])) {
 964                     if ($forum = $DB->get_record('forum', array('id' => $forumid))) {
 965                         $forums[$forumid] = $forum;
 966                     } else {
 967                         continue;
 968                     }
 969                 }
 970
 971                 $courseid = $forums[$forumid]->course;
 972                 if (!isset($courses[$courseid])) {
 973                     if ($course = $DB->get_record('course', array('id' => $courseid))) {
 974                         $courses[$courseid] = $course;
 975                     } else {
 976                         continue;
 977                     }
 978                 }
 979
 980                 if (!isset($coursemodules[$forumid])) {
 981                     if ($cm = get_coursemodule_from_instance('forum', $forumid, $courseid)) {
 982                         $coursemodules[$forumid] = $cm;
 983                     } else {
 984                         continue;
 985                     }
 986                 }
 987                 $userdiscussions[$digestpost->userid][$digestpost->discussionid] = $digestpost->discussionid;
 988                 $discussionposts[$digestpost->discussionid][$digestpost->postid] = $digestpost->postid;
 989             }
 990             $digestposts_rs->close(); /// Finished iteration, let's close the resultset
 991
 992             // Data collected, start sending out emails to each user
 993             foreach ($userdiscussions as $userid => $thesediscussions) {
 994
 995                 core_php_time_limit::raise(120); // terminate if processing of any account takes longer than 2 minutes
 996
 997                 cron_setup_user();
 998
 999                 mtrace(get_string('processingdigest', 'forum', $userid), '... ');
1000
1001                 // First of all delete all the queue entries for this user
1002                 $DB->delete_records_select('forum_queue', "userid = ? AND timemodified < ?", array($userid, $digesttime));
1003
1004                 // Init user caches - we keep the cache for one cycle only,
1005                 // otherwise it would unnecessarily consume memory.
1006                 if (array_key_exists($userid, $users) and isset($users[$userid]->username)) {
1007                     $userto = clone($users[$userid]);
1008                 } else {
1009                     $userto = $DB->get_record('user', array('id' => $userid));
1010                     forum_cron_minimise_user_record($userto);
1011                 }
1012                 $userto->viewfullnames = array();
1013                 $userto->canpost       = array();
1014                 $userto->markposts     = array();
1015
1016                 // Override the language and timezone of the "current" user, so that
1017                 // mail is customised for the receiver.
1018                 cron_setup_user($userto);
1019
1020                 $postsubject = get_string('digestmailsubject', 'forum', format_string($site->shortname, true));
1021
1022                 $headerdata = new stdClass();
1023                 $headerdata->sitename = format_string($site->fullname, true);
1024                 $headerdata->userprefs = $CFG->wwwroot.'/user/forum.php?id='.$userid.'&amp;course='.$site->id;
1025
1026                 $posttext = get_string('digestmailheader', 'forum', $headerdata)."\n\n";
1027                 $headerdata->userprefs = '<a target="_blank" href="'.$headerdata->userprefs.'">'.get_string('digestmailprefs', 'forum').'</a>';
1028
1029                 $posthtml = '<p>'.get_string('digestmailheader', 'forum', $headerdata).'</p>'
1030                     . '<br /><hr size="1" noshade="noshade" />';
1031
1032                 foreach ($thesediscussions as $discussionid) {
1033
1034                     core_php_time_limit::raise(120);   // to be reset for each post
1035
1036                     $discussion = $discussions[$discussionid];
1037                     $forum      = $forums[$discussion->forum];
1038                     $course     = $courses[$forum->course];
1039                     $cm         = $coursemodules[$forum->id];
1040
1041                     //override language
1042                     cron_setup_user($userto, $course);
1043
1044                     // Fill caches
1045                     if (!isset($userto->viewfullnames[$forum->id])) {
1046                         $modcontext = context_module::instance($cm->id);
1047                         $userto->viewfullnames[$forum->id] = has_capability('moodle/site:viewfullnames', $modcontext);
1048                     }
1049                     if (!isset($userto->canpost[$discussion->id])) {
1050                         $modcontext = context_module::instance($cm->id);
1051                         $userto->canpost[$discussion->id] = forum_user_can_post($forum, $discussion, $userto, $cm, $course, $modcontext);
1052                     }
1053
1054                     $strforums      = get_string('forums', 'forum');
1055                     $canunsubscribe = ! \mod_forum\subscriptions::is_forcesubscribed($forum);
1056                     $canreply       = $userto->canpost[$discussion->id];
1057                     $shortname = format_string($course->shortname, true, array('context' => context_course::instance($course->id)));
1058
1059                     $posttext .= "\n \n";
1060                     $posttext .= '=====================================================================';
1061                     $posttext .= "\n \n";
1062                     $posttext .= "$shortname -> $strforums -> ".format_string($forum->name,true);
1063                     if ($discussion->name != $forum->name) {
1064                         $posttext  .= " -> ".format_string($discussion->name,true);
1065                     }
1066                     $posttext .= "\n";
1067                     $posttext .= $CFG->wwwroot.'/mod/forum/discuss.php?d='.$discussion->id;
1068                     $posttext .= "\n";
1069
1070                     $posthtml .= "<p><font face=\"sans-serif\">".
1071                     "<a target=\"_blank\" href=\"$CFG->wwwroot/course/view.php?id=$course->id\">$shortname</a> -> ".
1072                     "<a target=\"_blank\" href=\"$CFG->wwwroot/mod/forum/index.php?id=$course->id\">$strforums</a> -> ".
1073                     "<a target=\"_blank\" href=\"$CFG->wwwroot/mod/forum/view.php?f=$forum->id\">".format_string($forum->name,true)."</a>";
1074                     if ($discussion->name == $forum->name) {
1075                         $posthtml .= "</font></p>";
1076                     } else {
1077                         $posthtml .= " -> <a target=\"_blank\" href=\"$CFG->wwwroot/mod/forum/discuss.php?d=$discussion->id\">".format_string($discussion->name,true)."</a></font></p>";
1078                     }
1079                     $posthtml .= '<p>';
1080
1081                     $postsarray = $discussionposts[$discussionid];
1082                     sort($postsarray);
1083                     $sentcount = 0;
1084
1085                     foreach ($postsarray as $postid) {
1086                         $post = $posts[$postid];
1087
1088                         if (array_key_exists($post->userid, $users)) { // we might know him/her already
1089                             $userfrom = $users[$post->userid];
1090                             if (!isset($userfrom->idnumber)) {
1091                                 $userfrom = $DB->get_record('user', array('id' => $userfrom->id));
1092                                 forum_cron_minimise_user_record($userfrom);
1093                             }
1094
1095                         } else if ($userfrom = $DB->get_record('user', array('id' => $post->userid))) {
1096                             forum_cron_minimise_user_record($userfrom);
1097                             if ($userscount <= FORUM_CRON_USER_CACHE) {
1098                                 $userscount++;
1099                                 $users[$userfrom->id] = $userfrom;
1100                             }
1101
1102                         } else {
1103                             mtrace('Could not find user '.$post->userid);
1104                             continue;
1105                         }
1106
1107                         if (!isset($userfrom->groups[$forum->id])) {
1108                             if (!isset($userfrom->groups)) {
1109                                 $userfrom->groups = array();
1110                                 if (isset($users[$userfrom->id])) {
1111                                     $users[$userfrom->id]->groups = array();
1112                                 }
1113                             }
1114                             $userfrom->groups[$forum->id] = groups_get_all_groups($course->id, $userfrom->id, $cm->groupingid);
1115                             if (isset($users[$userfrom->id])) {
1116                                 $users[$userfrom->id]->groups[$forum->id] = $userfrom->groups[$forum->id];
1117                             }
1118                         }
1119
1120                         // Headers to help prevent auto-responders.
1121                         $userfrom->customheaders = array(
1122                                 "Precedence: Bulk",
1123                                 'X-Auto-Response-Suppress: All',
1124                                 'Auto-Submitted: auto-generated',
1125                             );
1126
1127                         $maildigest = forum_get_user_maildigest_bulk($digests, $userto, $forum->id);
1128                         if (!isset($userto->canpost[$discussion->id])) {
1129                             $canreply = forum_user_can_post($forum, $discussion, $userto, $cm, $course, $modcontext);
1130                         } else {
1131                             $canreply = $userto->canpost[$discussion->id];
1132                         }
1133
1134                         $data = new \mod_forum\output\forum_post_email(
1135                                 $course,
1136                                 $cm,
1137                                 $forum,
1138                                 $discussion,
1139                                 $post,
1140                                 $userfrom,
1141                                 $userto,
1142                                 $canreply
1143                             );
1144
1145                         if (!isset($userto->viewfullnames[$forum->id])) {
1146                             $data->viewfullnames = has_capability('moodle/site:viewfullnames', $modcontext, $userto->id);
1147                         } else {
1148                             $data->viewfullnames = $userto->viewfullnames[$forum->id];
1149                         }
1150
1151                         if ($maildigest == 2) {
1152                             // Subjects and link only.
1153                             $posttext .= $textdigestbasicout->render($data);
1154                             $posthtml .= $htmldigestbasicout->render($data);
1155                         } else {
1156                             // The full treatment.
1157                             $posttext .= $textdigestfullout->render($data);
1158                             $posthtml .= $htmldigestfullout->render($data);
1159
1160                             // Create an array of postid's for this user to mark as read.
1161                             if (!$CFG->forum_usermarksread) {
1162                                 $userto->markposts[$post->id] = $post->id;
1163                             }
1164                         }
1165                         $sentcount++;
1166                     }
1167                     $footerlinks = array();
1168                     if ($canunsubscribe) {
1169                         $footerlinks[] = "<a href=\"$CFG->wwwroot/mod/forum/subscribe.php?id=$forum->id\">" . get_string("unsubscribe", "forum") . "</a>";
1170                     } else {
1171                         $footerlinks[] = get_string("everyoneissubscribed", "forum");
1172                     }
1173                     $footerlinks[] = "<a href='{$CFG->wwwroot}/mod/forum/index.php?id={$forum->course}'>" . get_string("digestmailpost", "forum") . '</a>';
1174                     $posthtml .= "\n<div class='mdl-right'><font size=\"1\">" . implode('&nbsp;', $footerlinks) . '</font></div>';
1175                     $posthtml .= '<hr size="1" noshade="noshade" /></p>';
1176                 }
1177
1178                 if (empty($userto->mailformat) || $userto->mailformat != 1) {
1179                     // This user DOESN'T want to receive HTML
1180                     $posthtml = '';
1181                 }
1182
1183                 $eventdata = new \core\message\message();
1184                 $eventdata->courseid            = SITEID;
1185                 $eventdata->component           = 'mod_forum';
1186                 $eventdata->name                = 'digests';
1187                 $eventdata->userfrom            = core_user::get_noreply_user();
1188                 $eventdata->userto              = $userto;
1189                 $eventdata->subject             = $postsubject;
1190                 $eventdata->fullmessage         = $posttext;
1191                 $eventdata->fullmessageformat   = FORMAT_PLAIN;
1192                 $eventdata->fullmessagehtml     = $posthtml;
1193                 $eventdata->notification        = 1;
1194                 $eventdata->smallmessage        = get_string('smallmessagedigest', 'forum', $sentcount);
1195                 $mailresult = message_send($eventdata);
1196
1197                 if (!$mailresult) {
1198                     mtrace("ERROR: mod/forum/cron.php: Could not send out digest mail to user $userto->id ".
1199                         "($userto->email)... not trying again.");
1200                 } else {
1201                     mtrace("success.");
1202                     $usermailcount++;
1203
1204                     // Mark post as read if forum_usermarksread is set off
1205                     if (get_user_preferences('forum_markasreadonnotification', 1, $userto->id) == 1) {
1206                         forum_tp_mark_posts_read($userto, $userto->markposts);
1207                     }
1208                 }
1209             }
1210         }
1211     /// We have finishied all digest emails, update $CFG->digestmailtimelast
1212         set_config('digestmailtimelast', $timenow);
1213     }
1214
1215     cron_setup_user();
1216
1217     if (!empty($usermailcount)) {
1218         mtrace(get_string('digestsentusers', 'forum', $usermailcount));
1219     }
1220
1221     if (!empty($CFG->forum_lastreadclean)) {
1222         $timenow = time();
1223         if ($CFG->forum_lastreadclean + (24*3600) < $timenow) {
1224             set_config('forum_lastreadclean', $timenow);
1225             mtrace('Removing old forum read tracking info...');
1226             forum_tp_clean_read_records();
1227         }
1228     } else {
1229         set_config('forum_lastreadclean', time());
1230     }
1231
1232     return true;
1233 }
1234
1235 /**
1236  *
1237  * @param object $course
1238  * @param object $user
1239  * @param object $mod TODO this is not used in this function, refactor
1240  * @param object $forum
1241  * @return object A standard object with 2 variables: info (number of posts for this user) and time (last modified)
1242  */
1243 function forum_user_outline($course, $user, $mod, $forum) {
1244     global $CFG;
1245     require_once("$CFG->libdir/gradelib.php");
1246     $grades = grade_get_grades($course->id, 'mod', 'forum', $forum->id, $user->id);
1247     if (empty($grades->items[0]->grades)) {
1248         $grade = false;
1249     } else {
1250         $grade = reset($grades->items[0]->grades);
1251     }
1252
1253     $count = forum_count_user_posts($forum->id, $user->id);
1254
1255     if ($count && $count->postcount > 0) {
1256         $result = new stdClass();
1257         $result->info = get_string("numposts", "forum", $count->postcount);
1258         $result->time = $count->lastpost;
1259         if ($grade) {
1260             $result->info .= ', ' . get_string('grade') . ': ' . $grade->str_long_grade;
1261         }
1262         return $result;
1263     } else if ($grade) {
1264         $result = new stdClass();
1265         $result->info = get_string('grade') . ': ' . $grade->str_long_grade;
1266
1267         //datesubmitted == time created. dategraded == time modified or time overridden
1268         //if grade was last modified by the user themselves use date graded. Otherwise use date submitted
1269         //TODO: move this copied & pasted code somewhere in the grades API. See MDL-26704
1270         if ($grade->usermodified == $user->id || empty($grade->datesubmitted)) {
1271             $result->time = $grade->dategraded;
1272         } else {
1273             $result->time = $grade->datesubmitted;
1274         }
1275
1276         return $result;
1277     }
1278     return NULL;
1279 }
1280
1281
1282 /**
1283  * @global object
1284  * @global object
1285  * @param object $coure
1286  * @param object $user
1287  * @param object $mod
1288  * @param object $forum
1289  */
1290 function forum_user_complete($course, $user, $mod, $forum) {
1291     global $CFG,$USER, $OUTPUT;
1292     require_once("$CFG->libdir/gradelib.php");
1293
1294     $grades = grade_get_grades($course->id, 'mod', 'forum', $forum->id, $user->id);
1295     if (!empty($grades->items[0]->grades)) {
1296         $grade = reset($grades->items[0]->grades);
1297         echo $OUTPUT->container(get_string('grade').': '.$grade->str_long_grade);
1298         if ($grade->str_feedback) {
1299             echo $OUTPUT->container(get_string('feedback').': '.$grade->str_feedback);
1300         }
1301     }
1302
1303     if ($posts = forum_get_user_posts($forum->id, $user->id)) {
1304
1305         if (!$cm = get_coursemodule_from_instance('forum', $forum->id, $course->id)) {
1306             print_error('invalidcoursemodule');
1307         }
1308         $discussions = forum_get_user_involved_discussions($forum->id, $user->id);
1309
1310         foreach ($posts as $post) {
1311             if (!isset($discussions[$post->discussion])) {
1312                 continue;
1313             }
1314             $discussion = $discussions[$post->discussion];
1315
1316             forum_print_post($post, $discussion, $forum, $cm, $course, false, false, false);
1317         }
1318     } else {
1319         echo "<p>".get_string("noposts", "forum")."</p>";
1320     }
1321 }
1322
1323 /**
1324  * Filters the forum discussions according to groups membership and config.
1325  *
1326  * @since  Moodle 2.8, 2.7.1, 2.6.4
1327  * @param  array $discussions Discussions with new posts array
1328  * @return array Forums with the number of new posts
1329  */
1330 function forum_filter_user_groups_discussions($discussions) {
1331
1332     // Group the remaining discussions posts by their forumid.
1333     $filteredforums = array();
1334
1335     // Discard not visible groups.
1336     foreach ($discussions as $discussion) {
1337
1338         // Course data is already cached.
1339         $instances = get_fast_modinfo($discussion->course)->get_instances();
1340         $forum = $instances['forum'][$discussion->forum];
1341
1342         // Continue if the user should not see this discussion.
1343         if (!forum_is_user_group_discussion($forum, $discussion->groupid)) {
1344             continue;
1345         }
1346
1347         // Grouping results by forum.
1348         if (empty($filteredforums[$forum->instance])) {
1349             $filteredforums[$forum->instance] = new stdClass();
1350             $filteredforums[$forum->instance]->id = $forum->id;
1351             $filteredforums[$forum->instance]->count = 0;
1352         }
1353         $filteredforums[$forum->instance]->count += $discussion->count;
1354
1355     }
1356
1357     return $filteredforums;
1358 }
1359
1360 /**
1361  * Returns whether the discussion group is visible by the current user or not.
1362  *
1363  * @since Moodle 2.8, 2.7.1, 2.6.4
1364  * @param cm_info $cm The discussion course module
1365  * @param int $discussiongroupid The discussion groupid
1366  * @return bool
1367  */
1368 function forum_is_user_group_discussion(cm_info $cm, $discussiongroupid) {
1369
1370     if ($discussiongroupid == -1 || $cm->effectivegroupmode != SEPARATEGROUPS) {
1371         return true;
1372     }
1373
1374     if (isguestuser()) {
1375         return false;
1376     }
1377
1378     if (has_capability('moodle/site:accessallgroups', context_module::instance($cm->id)) ||
1379             in_array($discussiongroupid, $cm->get_modinfo()->get_groups($cm->groupingid))) {
1380         return true;
1381     }
1382
1383     return false;
1384 }
1385
1386 /**
1387  * @global object
1388  * @global object
1389  * @global object
1390  * @param array $courses
1391  * @param array $htmlarray
1392  */
1393 function forum_print_overview($courses,&$htmlarray) {
1394     global $USER, $CFG, $DB, $SESSION;
1395
1396     if (empty($courses) || !is_array($courses) || count($courses) == 0) {
1397         return array();
1398     }
1399
1400     if (!$forums = get_all_instances_in_courses('forum',$courses)) {
1401         return;
1402     }
1403
1404     // Courses to search for new posts
1405     $coursessqls = array();
1406     $params = array();
1407     foreach ($courses as $course) {
1408
1409         // If the user has never entered into the course all posts are pending
1410         if ($course->lastaccess == 0) {
1411             $coursessqls[] = '(d.course = ?)';
1412             $params[] = $course->id;
1413
1414         // Only posts created after the course last access
1415         } else {
1416             $coursessqls[] = '(d.course = ? AND p.created > ?)';
1417             $params[] = $course->id;
1418             $params[] = $course->lastaccess;
1419         }
1420     }
1421     $params[] = $USER->id;
1422     $coursessql = implode(' OR ', $coursessqls);
1423
1424     $sql = "SELECT d.id, d.forum, d.course, d.groupid, COUNT(*) as count "
1425                 .'FROM {forum_discussions} d '
1426                 .'JOIN {forum_posts} p ON p.discussion = d.id '
1427                 ."WHERE ($coursessql) "
1428                 .'AND p.userid != ? '
1429                 .'AND (d.timestart <= ? AND (d.timeend = 0 OR d.timeend > ?)) '
1430                 .'GROUP BY d.id, d.forum, d.course, d.groupid '
1431                 .'ORDER BY d.course, d.forum';
1432     $params[] = time();
1433     $params[] = time();
1434
1435     // Avoid warnings.
1436     if (!$discussions = $DB->get_records_sql($sql, $params)) {
1437         $discussions = array();
1438     }
1439
1440     $forumsnewposts = forum_filter_user_groups_discussions($discussions);
1441
1442     // also get all forum tracking stuff ONCE.
1443     $trackingforums = array();
1444     foreach ($forums as $forum) {
1445         if (forum_tp_can_track_forums($forum)) {
1446             $trackingforums[$forum->id] = $forum;
1447         }
1448     }
1449
1450     if (count($trackingforums) > 0) {
1451         $cutoffdate = isset($CFG->forum_oldpostdays) ? (time() - ($CFG->forum_oldpostdays*24*60*60)) : 0;
1452         $sql = 'SELECT d.forum,d.course,COUNT(p.id) AS count '.
1453             ' FROM {forum_posts} p '.
1454             ' JOIN {forum_discussions} d ON p.discussion = d.id '.
1455             ' LEFT JOIN {forum_read} r ON r.postid = p.id AND r.userid = ? WHERE (';
1456         $params = array($USER->id);
1457
1458         foreach ($trackingforums as $track) {
1459             $sql .= '(d.forum = ? AND (d.groupid = -1 OR d.groupid = 0 OR d.groupid = ?)) OR ';
1460             $params[] = $track->id;
1461             if (isset($SESSION->currentgroup[$track->course])) {
1462                 $groupid =  $SESSION->currentgroup[$track->course];
1463             } else {
1464                 // get first groupid
1465                 $groupids = groups_get_all_groups($track->course, $USER->id);
1466                 if ($groupids) {
1467                     reset($groupids);
1468                     $groupid = key($groupids);
1469                     $SESSION->currentgroup[$track->course] = $groupid;
1470                 } else {
1471                     $groupid = 0;
1472                 }
1473                 unset($groupids);
1474             }
1475             $params[] = $groupid;
1476         }
1477         $sql = substr($sql,0,-3); // take off the last OR
1478         $sql .= ') AND p.modified >= ? AND r.id is NULL ';
1479         $sql .= 'AND (d.timestart < ? AND (d.timeend = 0 OR d.timeend > ?)) ';
1480         $sql .= 'GROUP BY d.forum,d.course';
1481         $params[] = $cutoffdate;
1482         $params[] = time();
1483         $params[] = time();
1484
1485         if (!$unread = $DB->get_records_sql($sql, $params)) {
1486             $unread = array();
1487         }
1488     } else {
1489         $unread = array();
1490     }
1491
1492     if (empty($unread) and empty($forumsnewposts)) {
1493         return;
1494     }
1495
1496     $strforum = get_string('modulename','forum');
1497
1498     foreach ($forums as $forum) {
1499         $str = '';
1500         $count = 0;
1501         $thisunread = 0;
1502         $showunread = false;
1503         // either we have something from logs, or trackposts, or nothing.
1504         if (array_key_exists($forum->id, $forumsnewposts) && !empty($forumsnewposts[$forum->id])) {
1505             $count = $forumsnewposts[$forum->id]->count;
1506         }
1507         if (array_key_exists($forum->id,$unread)) {
1508             $thisunread = $unread[$forum->id]->count;
1509             $showunread = true;
1510         }
1511         if ($count > 0 || $thisunread > 0) {
1512             $str .= '<div class="overview forum"><div class="name">'.$strforum.': <a title="'.$strforum.'" href="'.$CFG->wwwroot.'/mod/forum/view.php?f='.$forum->id.'">'.
1513                 $forum->name.'</a></div>';
1514             $str .= '<div class="info"><span class="postsincelogin">';
1515             $str .= get_string('overviewnumpostssince', 'forum', $count)."</span>";
1516             if (!empty($showunread)) {
1517                 $str .= '<div class="unreadposts">'.get_string('overviewnumunread', 'forum', $thisunread).'</div>';
1518             }
1519             $str .= '</div></div>';
1520         }
1521         if (!empty($str)) {
1522             if (!array_key_exists($forum->course,$htmlarray)) {
1523                 $htmlarray[$forum->course] = array();
1524             }
1525             if (!array_key_exists('forum',$htmlarray[$forum->course])) {
1526                 $htmlarray[$forum->course]['forum'] = ''; // initialize, avoid warnings
1527             }
1528             $htmlarray[$forum->course]['forum'] .= $str;
1529         }
1530     }
1531 }
1532
1533 /**
1534  * Given a course and a date, prints a summary of all the new
1535  * messages posted in the course since that date
1536  *
1537  * @global object
1538  * @global object
1539  * @global object
1540  * @uses CONTEXT_MODULE
1541  * @uses VISIBLEGROUPS
1542  * @param object $course
1543  * @param bool $viewfullnames capability
1544  * @param int $timestart
1545  * @return bool success
1546  */
1547 function forum_print_recent_activity($course, $viewfullnames, $timestart) {
1548     global $CFG, $USER, $DB, $OUTPUT;
1549
1550     // do not use log table if possible, it may be huge and is expensive to join with other tables
1551
1552     $allnamefields = user_picture::fields('u', null, 'duserid');
1553     if (!$posts = $DB->get_records_sql("SELECT p.*, f.type AS forumtype, d.forum, d.groupid,
1554                                               d.timestart, d.timeend, $allnamefields
1555                                          FROM {forum_posts} p
1556                                               JOIN {forum_discussions} d ON d.id = p.discussion
1557                                               JOIN {forum} f             ON f.id = d.forum
1558                                               JOIN {user} u              ON u.id = p.userid
1559                                         WHERE p.created > ? AND f.course = ?
1560                                      ORDER BY p.id ASC", array($timestart, $course->id))) { // order by initial posting date
1561          return false;
1562     }
1563
1564     $modinfo = get_fast_modinfo($course);
1565
1566     $groupmodes = array();
1567     $cms    = array();
1568
1569     $strftimerecent = get_string('strftimerecent');
1570
1571     $printposts = array();
1572     foreach ($posts as $post) {
1573         if (!isset($modinfo->instances['forum'][$post->forum])) {
1574             // not visible
1575             continue;
1576         }
1577         $cm = $modinfo->instances['forum'][$post->forum];
1578         if (!$cm->uservisible) {
1579             continue;
1580         }
1581         $context = context_module::instance($cm->id);
1582
1583         if (!has_capability('mod/forum:viewdiscussion', $context)) {
1584             continue;
1585         }
1586
1587         if (!empty($CFG->forum_enabletimedposts) and $USER->id != $post->duserid
1588           and (($post->timestart > 0 and $post->timestart > time()) or ($post->timeend > 0 and $post->timeend < time()))) {
1589             if (!has_capability('mod/forum:viewhiddentimedposts', $context)) {
1590                 continue;
1591             }
1592         }
1593
1594         // Check that the user can see the discussion.
1595         if (forum_is_user_group_discussion($cm, $post->groupid)) {
1596             $printposts[] = $post;
1597         }
1598
1599     }
1600     unset($posts);
1601
1602     if (!$printposts) {
1603         return false;
1604     }
1605
1606     echo $OUTPUT->heading(get_string('newforumposts', 'forum').':', 3);
1607     $list = html_writer::start_tag('ul', ['class' => 'unlist']);
1608
1609     foreach ($printposts as $post) {
1610         $subjectclass = empty($post->parent) ? ' bold' : '';
1611         $authorhidden = forum_is_author_hidden($post, (object) ['type' => $post->forumtype]);
1612
1613         $list .= html_writer::start_tag('li');
1614         $list .= html_writer::start_div('head');
1615         $list .= html_writer::div(userdate($post->modified, $strftimerecent), 'date');
1616         if (!$authorhidden) {
1617             $list .= html_writer::div(fullname($post, $viewfullnames), 'name');
1618         }
1619         $list .= html_writer::end_div(); // Head.
1620
1621         $list .= html_writer::start_div('info' . $subjectclass);
1622         $discussionurl = new moodle_url('/mod/forum/discuss.php', ['d' => $post->discussion]);
1623         if (!empty($post->parent)) {
1624             $discussionurl->param('parent', $post->parent);
1625             $discussionurl->set_anchor('p'. $post->id);
1626         }
1627         $post->subject = break_up_long_words(format_string($post->subject, true));
1628         $list .= html_writer::link($discussionurl, $post->subject);
1629         $list .= html_writer::end_div(); // Info.
1630         $list .= html_writer::end_tag('li');
1631     }
1632
1633     $list .= html_writer::end_tag('ul');
1634     echo $list;
1635
1636     return true;
1637 }
1638
1639 /**
1640  * Return grade for given user or all users.
1641  *
1642  * @global object
1643  * @global object
1644  * @param object $forum
1645  * @param int $userid optional user id, 0 means all users
1646  * @return array array of grades, false if none
1647  */
1648 function forum_get_user_grades($forum, $userid = 0) {
1649     global $CFG;
1650
1651     require_once($CFG->dirroot.'/rating/lib.php');
1652
1653     $ratingoptions = new stdClass;
1654     $ratingoptions->component = 'mod_forum';
1655     $ratingoptions->ratingarea = 'post';
1656
1657     //need these to work backwards to get a context id. Is there a better way to get contextid from a module instance?
1658     $ratingoptions->modulename = 'forum';
1659     $ratingoptions->moduleid   = $forum->id;
1660     $ratingoptions->userid = $userid;
1661     $ratingoptions->aggregationmethod = $forum->assessed;
1662     $ratingoptions->scaleid = $forum->scale;
1663     $ratingoptions->itemtable = 'forum_posts';
1664     $ratingoptions->itemtableusercolumn = 'userid';
1665
1666     $rm = new rating_manager();
1667     return $rm->get_user_grades($ratingoptions);
1668 }
1669
1670 /**
1671  * Update activity grades
1672  *
1673  * @category grade
1674  * @param object $forum
1675  * @param int $userid specific user only, 0 means all
1676  * @param boolean $nullifnone return null if grade does not exist
1677  * @return void
1678  */
1679 function forum_update_grades($forum, $userid=0, $nullifnone=true) {
1680     global $CFG, $DB;
1681     require_once($CFG->libdir.'/gradelib.php');
1682
1683     if (!$forum->assessed) {
1684         forum_grade_item_update($forum);
1685
1686     } else if ($grades = forum_get_user_grades($forum, $userid)) {
1687         forum_grade_item_update($forum, $grades);
1688
1689     } else if ($userid and $nullifnone) {
1690         $grade = new stdClass();
1691         $grade->userid   = $userid;
1692         $grade->rawgrade = NULL;
1693         forum_grade_item_update($forum, $grade);
1694
1695     } else {
1696         forum_grade_item_update($forum);
1697     }
1698 }
1699
1700 /**
1701  * Create/update grade item for given forum
1702  *
1703  * @category grade
1704  * @uses GRADE_TYPE_NONE
1705  * @uses GRADE_TYPE_VALUE
1706  * @uses GRADE_TYPE_SCALE
1707  * @param stdClass $forum Forum object with extra cmidnumber
1708  * @param mixed $grades Optional array/object of grade(s); 'reset' means reset grades in gradebook
1709  * @return int 0 if ok
1710  */
1711 function forum_grade_item_update($forum, $grades=NULL) {
1712     global $CFG;
1713     if (!function_exists('grade_update')) { //workaround for buggy PHP versions
1714         require_once($CFG->libdir.'/gradelib.php');
1715     }
1716
1717     $params = array('itemname'=>$forum->name, 'idnumber'=>$forum->cmidnumber);
1718
1719     if (!$forum->assessed or $forum->scale == 0) {
1720         $params['gradetype'] = GRADE_TYPE_NONE;
1721
1722     } else if ($forum->scale > 0) {
1723         $params['gradetype'] = GRADE_TYPE_VALUE;
1724         $params['grademax']  = $forum->scale;
1725         $params['grademin']  = 0;
1726
1727     } else if ($forum->scale < 0) {
1728         $params['gradetype'] = GRADE_TYPE_SCALE;
1729         $params['scaleid']   = -$forum->scale;
1730     }
1731
1732     if ($grades  === 'reset') {
1733         $params['reset'] = true;
1734         $grades = NULL;
1735     }
1736
1737     return grade_update('mod/forum', $forum->course, 'mod', 'forum', $forum->id, 0, $grades, $params);
1738 }
1739
1740 /**
1741  * Delete grade item for given forum
1742  *
1743  * @category grade
1744  * @param stdClass $forum Forum object
1745  * @return grade_item
1746  */
1747 function forum_grade_item_delete($forum) {
1748     global $CFG;
1749     require_once($CFG->libdir.'/gradelib.php');
1750
1751     return grade_update('mod/forum', $forum->course, 'mod', 'forum', $forum->id, 0, NULL, array('deleted'=>1));
1752 }
1753
1754
1755 /**
1756  * This function returns if a scale is being used by one forum
1757  *
1758  * @global object
1759  * @param int $forumid
1760  * @param int $scaleid negative number
1761  * @return bool
1762  */
1763 function forum_scale_used ($forumid,$scaleid) {
1764     global $DB;
1765     $return = false;
1766
1767     $rec = $DB->get_record("forum",array("id" => "$forumid","scale" => "-$scaleid"));
1768
1769     if (!empty($rec) && !empty($scaleid)) {
1770         $return = true;
1771     }
1772
1773     return $return;
1774 }
1775
1776 /**
1777  * Checks if scale is being used by any instance of forum
1778  *
1779  * This is used to find out if scale used anywhere
1780  *
1781  * @global object
1782  * @param $scaleid int
1783  * @return boolean True if the scale is used by any forum
1784  */
1785 function forum_scale_used_anywhere($scaleid) {
1786     global $DB;
1787     if ($scaleid and $DB->record_exists('forum', array('scale' => -$scaleid))) {
1788         return true;
1789     } else {
1790         return false;
1791     }
1792 }
1793
1794 // SQL FUNCTIONS ///////////////////////////////////////////////////////////
1795
1796 /**
1797  * Gets a post with all info ready for forum_print_post
1798  * Most of these joins are just to get the forum id
1799  *
1800  * @global object
1801  * @global object
1802  * @param int $postid
1803  * @return mixed array of posts or false
1804  */
1805 function forum_get_post_full($postid) {
1806     global $CFG, $DB;
1807
1808     $allnames = get_all_user_name_fields(true, 'u');
1809     return $DB->get_record_sql("SELECT p.*, d.forum, $allnames, u.email, u.picture, u.imagealt
1810                              FROM {forum_posts} p
1811                                   JOIN {forum_discussions} d ON p.discussion = d.id
1812                                   LEFT JOIN {user} u ON p.userid = u.id
1813                             WHERE p.id = ?", array($postid));
1814 }
1815
1816 /**
1817  * Gets all posts in discussion including top parent.
1818  *
1819  * @global object
1820  * @global object
1821  * @global object
1822  * @param int $discussionid
1823  * @param string $sort
1824  * @param bool $tracking does user track the forum?
1825  * @return array of posts
1826  */
1827 function forum_get_all_discussion_posts($discussionid, $sort, $tracking=false) {
1828     global $CFG, $DB, $USER;
1829
1830     $tr_sel  = "";
1831     $tr_join = "";
1832     $params = array();
1833
1834     if ($tracking) {
1835         $tr_sel  = ", fr.id AS postread";
1836         $tr_join = "LEFT JOIN {forum_read} fr ON (fr.postid = p.id AND fr.userid = ?)";
1837         $params[] = $USER->id;
1838     }
1839
1840     $allnames = get_all_user_name_fields(true, 'u');
1841     $params[] = $discussionid;
1842     if (!$posts = $DB->get_records_sql("SELECT p.*, $allnames, u.email, u.picture, u.imagealt $tr_sel
1843                                      FROM {forum_posts} p
1844                                           LEFT JOIN {user} u ON p.userid = u.id
1845                                           $tr_join
1846                                     WHERE p.discussion = ?
1847                                  ORDER BY $sort", $params)) {
1848         return array();
1849     }
1850
1851     foreach ($posts as $pid=>$p) {
1852         if ($tracking) {
1853             if (forum_tp_is_post_old($p)) {
1854                  $posts[$pid]->postread = true;
1855             }
1856         }
1857         if (!$p->parent) {
1858             continue;
1859         }
1860         if (!isset($posts[$p->parent])) {
1861             continue; // parent does not exist??
1862         }
1863         if (!isset($posts[$p->parent]->children)) {
1864             $posts[$p->parent]->children = array();
1865         }
1866         $posts[$p->parent]->children[$pid] =& $posts[$pid];
1867     }
1868
1869     // Start with the last child of the first post.
1870     $post = &$posts[reset($posts)->id];
1871
1872     $lastpost = false;
1873     while (!$lastpost) {
1874         if (!isset($post->children)) {
1875             $post->lastpost = true;
1876             $lastpost = true;
1877         } else {
1878              // Go to the last child of this post.
1879             $post = &$posts[end($post->children)->id];
1880         }
1881     }
1882
1883     return $posts;
1884 }
1885
1886 /**
1887  * An array of forum objects that the user is allowed to read/search through.
1888  *
1889  * @global object
1890  * @global object
1891  * @global object
1892  * @param int $userid
1893  * @param int $courseid if 0, we look for forums throughout the whole site.
1894  * @return array of forum objects, or false if no matches
1895  *         Forum objects have the following attributes:
1896  *         id, type, course, cmid, cmvisible, cmgroupmode, accessallgroups,
1897  *         viewhiddentimedposts
1898  */
1899 function forum_get_readable_forums($userid, $courseid=0) {
1900
1901     global $CFG, $DB, $USER;
1902     require_once($CFG->dirroot.'/course/lib.php');
1903
1904     if (!$forummod = $DB->get_record('modules', array('name' => 'forum'))) {
1905         print_error('notinstalled', 'forum');
1906     }
1907
1908     if ($courseid) {
1909         $courses = $DB->get_records('course', array('id' => $courseid));
1910     } else {
1911         // If no course is specified, then the user can see SITE + his courses.
1912         $courses1 = $DB->get_records('course', array('id' => SITEID));
1913         $courses2 = enrol_get_users_courses($userid, true, array('modinfo'));
1914         $courses = array_merge($courses1, $courses2);
1915     }
1916     if (!$courses) {
1917         return array();
1918     }
1919
1920     $readableforums = array();
1921
1922     foreach ($courses as $course) {
1923
1924         $modinfo = get_fast_modinfo($course);
1925
1926         if (empty($modinfo->instances['forum'])) {
1927             // hmm, no forums?
1928             continue;
1929         }
1930
1931         $courseforums = $DB->get_records('forum', array('course' => $course->id));
1932
1933         foreach ($modinfo->instances['forum'] as $forumid => $cm) {
1934             if (!$cm->uservisible or !isset($courseforums[$forumid])) {
1935                 continue;
1936             }
1937             $context = context_module::instance($cm->id);
1938             $forum = $courseforums[$forumid];
1939             $forum->context = $context;
1940             $forum->cm = $cm;
1941
1942             if (!has_capability('mod/forum:viewdiscussion', $context)) {
1943                 continue;
1944             }
1945
1946          /// group access
1947             if (groups_get_activity_groupmode($cm, $course) == SEPARATEGROUPS and !has_capability('moodle/site:accessallgroups', $context)) {
1948
1949                 $forum->onlygroups = $modinfo->get_groups($cm->groupingid);
1950                 $forum->onlygroups[] = -1;
1951             }
1952
1953         /// hidden timed discussions
1954             $forum->viewhiddentimedposts = true;
1955             if (!empty($CFG->forum_enabletimedposts)) {
1956                 if (!has_capability('mod/forum:viewhiddentimedposts', $context)) {
1957                     $forum->viewhiddentimedposts = false;
1958                 }
1959             }
1960
1961         /// qanda access
1962             if ($forum->type == 'qanda'
1963                     && !has_capability('mod/forum:viewqandawithoutposting', $context)) {
1964
1965                 // We need to check whether the user has posted in the qanda forum.
1966                 $forum->onlydiscussions = array();  // Holds discussion ids for the discussions
1967                                                     // the user is allowed to see in this forum.
1968                 if ($discussionspostedin = forum_discussions_user_has_posted_in($forum->id, $USER->id)) {
1969                     foreach ($discussionspostedin as $d) {
1970                         $forum->onlydiscussions[] = $d->id;
1971                     }
1972                 }
1973             }
1974
1975             $readableforums[$forum->id] = $forum;
1976         }
1977
1978         unset($modinfo);
1979
1980     } // End foreach $courses
1981
1982     return $readableforums;
1983 }
1984
1985 /**
1986  * Returns a list of posts found using an array of search terms.
1987  *
1988  * @global object
1989  * @global object
1990  * @global object
1991  * @param array $searchterms array of search terms, e.g. word +word -word
1992  * @param int $courseid if 0, we search through the whole site
1993  * @param int $limitfrom
1994  * @param int $limitnum
1995  * @param int &$totalcount
1996  * @param string $extrasql
1997  * @return array|bool Array of posts found or false
1998  */
1999 function forum_search_posts($searchterms, $courseid=0, $limitfrom=0, $limitnum=50,
2000                             &$totalcount, $extrasql='') {
2001     global $CFG, $DB, $USER;
2002     require_once($CFG->libdir.'/searchlib.php');
2003
2004     $forums = forum_get_readable_forums($USER->id, $courseid);
2005
2006     if (count($forums) == 0) {
2007         $totalcount = 0;
2008         return false;
2009     }
2010
2011     $now = round(time(), -2); // db friendly
2012
2013     $fullaccess = array();
2014     $where = array();
2015     $params = array();
2016
2017     foreach ($forums as $forumid => $forum) {
2018         $select = array();
2019
2020         if (!$forum->viewhiddentimedposts) {
2021             $select[] = "(d.userid = :userid{$forumid} OR (d.timestart < :timestart{$forumid} AND (d.timeend = 0 OR d.timeend > :timeend{$forumid})))";
2022             $params = array_merge($params, array('userid'.$forumid=>$USER->id, 'timestart'.$forumid=>$now, 'timeend'.$forumid=>$now));
2023         }
2024
2025         $cm = $forum->cm;
2026         $context = $forum->context;
2027
2028         if ($forum->type == 'qanda'
2029             && !has_capability('mod/forum:viewqandawithoutposting', $context)) {
2030             if (!empty($forum->onlydiscussions)) {
2031                 list($discussionid_sql, $discussionid_params) = $DB->get_in_or_equal($forum->onlydiscussions, SQL_PARAMS_NAMED, 'qanda'.$forumid.'_');
2032                 $params = array_merge($params, $discussionid_params);
2033                 $select[] = "(d.id $discussionid_sql OR p.parent = 0)";
2034             } else {
2035                 $select[] = "p.parent = 0";
2036             }
2037         }
2038
2039         if (!empty($forum->onlygroups)) {
2040             list($groupid_sql, $groupid_params) = $DB->get_in_or_equal($forum->onlygroups, SQL_PARAMS_NAMED, 'grps'.$forumid.'_');
2041             $params = array_merge($params, $groupid_params);
2042             $select[] = "d.groupid $groupid_sql";
2043         }
2044
2045         if ($select) {
2046             $selects = implode(" AND ", $select);
2047             $where[] = "(d.forum = :forum{$forumid} AND $selects)";
2048             $params['forum'.$forumid] = $forumid;
2049         } else {
2050             $fullaccess[] = $forumid;
2051         }
2052     }
2053
2054     if ($fullaccess) {
2055         list($fullid_sql, $fullid_params) = $DB->get_in_or_equal($fullaccess, SQL_PARAMS_NAMED, 'fula');
2056         $params = array_merge($params, $fullid_params);
2057         $where[] = "(d.forum $fullid_sql)";
2058     }
2059
2060     $selectdiscussion = "(".implode(" OR ", $where).")";
2061
2062     $messagesearch = '';
2063     $searchstring = '';
2064
2065     // Need to concat these back together for parser to work.
2066     foreach($searchterms as $searchterm){
2067         if ($searchstring != '') {
2068             $searchstring .= ' ';
2069         }
2070         $searchstring .= $searchterm;
2071     }
2072
2073     // We need to allow quoted strings for the search. The quotes *should* be stripped
2074     // by the parser, but this should be examined carefully for security implications.
2075     $searchstring = str_replace("\\\"","\"",$searchstring);
2076     $parser = new search_parser();
2077     $lexer = new search_lexer($parser);
2078
2079     if ($lexer->parse($searchstring)) {
2080         $parsearray = $parser->get_parsed_array();
2081         list($messagesearch, $msparams) = search_generate_SQL($parsearray, 'p.message', 'p.subject',
2082                                                               'p.userid', 'u.id', 'u.firstname',
2083                                                               'u.lastname', 'p.modified', 'd.forum');
2084         $params = array_merge($params, $msparams);
2085     }
2086
2087     $fromsql = "{forum_posts} p,
2088                   {forum_discussions} d,
2089                   {user} u";
2090
2091     $selectsql = " $messagesearch
2092                AND p.discussion = d.id
2093                AND p.userid = u.id
2094                AND $selectdiscussion
2095                    $extrasql";
2096
2097     $countsql = "SELECT COUNT(*)
2098                    FROM $fromsql
2099                   WHERE $selectsql";
2100
2101     $allnames = get_all_user_name_fields(true, 'u');
2102     $searchsql = "SELECT p.*,
2103                          d.forum,
2104                          $allnames,
2105                          u.email,
2106                          u.picture,
2107                          u.imagealt
2108                     FROM $fromsql
2109                    WHERE $selectsql
2110                 ORDER BY p.modified DESC";
2111
2112     $totalcount = $DB->count_records_sql($countsql, $params);
2113
2114     return $DB->get_records_sql($searchsql, $params, $limitfrom, $limitnum);
2115 }
2116
2117 /**
2118  * Returns a list of all new posts that have not been mailed yet
2119  *
2120  * @param int $starttime posts created after this time
2121  * @param int $endtime posts created before this
2122  * @param int $now used for timed discussions only
2123  * @return array
2124  */
2125 function forum_get_unmailed_posts($starttime, $endtime, $now=null) {
2126     global $CFG, $DB;
2127
2128     $params = array();
2129     $params['mailed'] = FORUM_MAILED_PENDING;
2130     $params['ptimestart'] = $starttime;
2131     $params['ptimeend'] = $endtime;
2132     $params['mailnow'] = 1;
2133
2134     if (!empty($CFG->forum_enabletimedposts)) {
2135         if (empty($now)) {
2136             $now = time();
2137         }
2138         $selectsql = "AND (p.created >= :ptimestart OR d.timestart >= :pptimestart)";
2139         $params['pptimestart'] = $starttime;
2140         $timedsql = "AND (d.timestart < :dtimestart AND (d.timeend = 0 OR d.timeend > :dtimeend))";
2141         $params['dtimestart'] = $now;
2142         $params['dtimeend'] = $now;
2143     } else {
2144         $timedsql = "";
2145         $selectsql = "AND p.created >= :ptimestart";
2146     }
2147
2148     return $DB->get_records_sql("SELECT p.*, d.course, d.forum
2149                                  FROM {forum_posts} p
2150                                  JOIN {forum_discussions} d ON d.id = p.discussion
2151                                  WHERE p.mailed = :mailed
2152                                  $selectsql
2153                                  AND (p.created < :ptimeend OR p.mailnow = :mailnow)
2154                                  $timedsql
2155                                  ORDER BY p.modified ASC", $params);
2156 }
2157
2158 /**
2159  * Marks posts before a certain time as being mailed already
2160  *
2161  * @global object
2162  * @global object
2163  * @param int $endtime
2164  * @param int $now Defaults to time()
2165  * @return bool
2166  */
2167 function forum_mark_old_posts_as_mailed($endtime, $now=null) {
2168     global $CFG, $DB;
2169
2170     if (empty($now)) {
2171         $now = time();
2172     }
2173
2174     $params = array();
2175     $params['mailedsuccess'] = FORUM_MAILED_SUCCESS;
2176     $params['now'] = $now;
2177     $params['endtime'] = $endtime;
2178     $params['mailnow'] = 1;
2179     $params['mailedpending'] = FORUM_MAILED_PENDING;
2180
2181     if (empty($CFG->forum_enabletimedposts)) {
2182         return $DB->execute("UPDATE {forum_posts}
2183                              SET mailed = :mailedsuccess
2184                              WHERE (created < :endtime OR mailnow = :mailnow)
2185                              AND mailed = :mailedpending", $params);
2186     } else {
2187         return $DB->execute("UPDATE {forum_posts}
2188                              SET mailed = :mailedsuccess
2189                              WHERE discussion NOT IN (SELECT d.id
2190                                                       FROM {forum_discussions} d
2191                                                       WHERE d.timestart > :now)
2192                              AND (created < :endtime OR mailnow = :mailnow)
2193                              AND mailed = :mailedpending", $params);
2194     }
2195 }
2196
2197 /**
2198  * Get all the posts for a user in a forum suitable for forum_print_post
2199  *
2200  * @global object
2201  * @global object
2202  * @uses CONTEXT_MODULE
2203  * @return array
2204  */
2205 function forum_get_user_posts($forumid, $userid) {
2206     global $CFG, $DB;
2207
2208     $timedsql = "";
2209     $params = array($forumid, $userid);
2210
2211     if (!empty($CFG->forum_enabletimedposts)) {
2212         $cm = get_coursemodule_from_instance('forum', $forumid);
2213         if (!has_capability('mod/forum:viewhiddentimedposts' , context_module::instance($cm->id))) {
2214             $now = time();
2215             $timedsql = "AND (d.timestart < ? AND (d.timeend = 0 OR d.timeend > ?))";
2216             $params[] = $now;
2217             $params[] = $now;
2218         }
2219     }
2220
2221     $allnames = get_all_user_name_fields(true, 'u');
2222     return $DB->get_records_sql("SELECT p.*, d.forum, $allnames, u.email, u.picture, u.imagealt
2223                               FROM {forum} f
2224                                    JOIN {forum_discussions} d ON d.forum = f.id
2225                                    JOIN {forum_posts} p       ON p.discussion = d.id
2226                                    JOIN {user} u              ON u.id = p.userid
2227                              WHERE f.id = ?
2228                                    AND p.userid = ?
2229                                    $timedsql
2230                           ORDER BY p.modified ASC", $params);
2231 }
2232
2233 /**
2234  * Get all the discussions user participated in
2235  *
2236  * @global object
2237  * @global object
2238  * @uses CONTEXT_MODULE
2239  * @param int $forumid
2240  * @param int $userid
2241  * @return array Array or false
2242  */
2243 function forum_get_user_involved_discussions($forumid, $userid) {
2244     global $CFG, $DB;
2245
2246     $timedsql = "";
2247     $params = array($forumid, $userid);
2248     if (!empty($CFG->forum_enabletimedposts)) {
2249         $cm = get_coursemodule_from_instance('forum', $forumid);
2250         if (!has_capability('mod/forum:viewhiddentimedposts' , context_module::instance($cm->id))) {
2251             $now = time();
2252             $timedsql = "AND (d.timestart < ? AND (d.timeend = 0 OR d.timeend > ?))";
2253             $params[] = $now;
2254             $params[] = $now;
2255         }
2256     }
2257
2258     return $DB->get_records_sql("SELECT DISTINCT d.*
2259                               FROM {forum} f
2260                                    JOIN {forum_discussions} d ON d.forum = f.id
2261                                    JOIN {forum_posts} p       ON p.discussion = d.id
2262                              WHERE f.id = ?
2263                                    AND p.userid = ?
2264                                    $timedsql", $params);
2265 }
2266
2267 /**
2268  * Get all the posts for a user in a forum suitable for forum_print_post
2269  *
2270  * @global object
2271  * @global object
2272  * @param int $forumid
2273  * @param int $userid
2274  * @return array of counts or false
2275  */
2276 function forum_count_user_posts($forumid, $userid) {
2277     global $CFG, $DB;
2278
2279     $timedsql = "";
2280     $params = array($forumid, $userid);
2281     if (!empty($CFG->forum_enabletimedposts)) {
2282         $cm = get_coursemodule_from_instance('forum', $forumid);
2283         if (!has_capability('mod/forum:viewhiddentimedposts' , context_module::instance($cm->id))) {
2284             $now = time();
2285             $timedsql = "AND (d.timestart < ? AND (d.timeend = 0 OR d.timeend > ?))";
2286             $params[] = $now;
2287             $params[] = $now;
2288         }
2289     }
2290
2291     return $DB->get_record_sql("SELECT COUNT(p.id) AS postcount, MAX(p.modified) AS lastpost
2292                              FROM {forum} f
2293                                   JOIN {forum_discussions} d ON d.forum = f.id
2294                                   JOIN {forum_posts} p       ON p.discussion = d.id
2295                                   JOIN {user} u              ON u.id = p.userid
2296                             WHERE f.id = ?
2297                                   AND p.userid = ?
2298                                   $timedsql", $params);
2299 }
2300
2301 /**
2302  * Given a log entry, return the forum post details for it.
2303  *
2304  * @global object
2305  * @global object
2306  * @param object $log
2307  * @return array|null
2308  */
2309 function forum_get_post_from_log($log) {
2310     global $CFG, $DB;
2311
2312     $allnames = get_all_user_name_fields(true, 'u');
2313     if ($log->action == "add post") {
2314
2315         return $DB->get_record_sql("SELECT p.*, f.type AS forumtype, d.forum, d.groupid, $allnames, u.email, u.picture
2316                                  FROM {forum_discussions} d,
2317                                       {forum_posts} p,
2318                                       {forum} f,
2319                                       {user} u
2320                                 WHERE p.id = ?
2321                                   AND d.id = p.discussion
2322                                   AND p.userid = u.id
2323                                   AND u.deleted <> '1'
2324                                   AND f.id = d.forum", array($log->info));
2325
2326
2327     } else if ($log->action == "add discussion") {
2328
2329         return $DB->get_record_sql("SELECT p.*, f.type AS forumtype, d.forum, d.groupid, $allnames, u.email, u.picture
2330                                  FROM {forum_discussions} d,
2331                                       {forum_posts} p,
2332                                       {forum} f,
2333                                       {user} u
2334                                 WHERE d.id = ?
2335                                   AND d.firstpost = p.id
2336                                   AND p.userid = u.id
2337                                   AND u.deleted <> '1'
2338                                   AND f.id = d.forum", array($log->info));
2339     }
2340     return NULL;
2341 }
2342
2343 /**
2344  * Given a discussion id, return the first post from the discussion
2345  *
2346  * @global object
2347  * @global object
2348  * @param int $dicsussionid
2349  * @return array
2350  */
2351 function forum_get_firstpost_from_discussion($discussionid) {
2352     global $CFG, $DB;
2353
2354     return $DB->get_record_sql("SELECT p.*
2355                              FROM {forum_discussions} d,
2356                                   {forum_posts} p
2357                             WHERE d.id = ?
2358                               AND d.firstpost = p.id ", array($discussionid));
2359 }
2360
2361 /**
2362  * Returns an array of counts of replies to each discussion
2363  *
2364  * @global object
2365  * @global object
2366  * @param int $forumid
2367  * @param string $forumsort
2368  * @param int $limit
2369  * @param int $page
2370  * @param int $perpage
2371  * @return array
2372  */
2373 function forum_count_discussion_replies($forumid, $forumsort="", $limit=-1, $page=-1, $perpage=0) {
2374     global $CFG, $DB;
2375
2376     if ($limit > 0) {
2377         $limitfrom = 0;
2378         $limitnum  = $limit;
2379     } else if ($page != -1) {
2380         $limitfrom = $page*$perpage;
2381         $limitnum  = $perpage;
2382     } else {
2383         $limitfrom = 0;
2384         $limitnum  = 0;
2385     }
2386
2387     if ($forumsort == "") {
2388         $orderby = "";
2389         $groupby = "";
2390
2391     } else {
2392         $orderby = "ORDER BY $forumsort";
2393         $groupby = ", ".strtolower($forumsort);
2394         $groupby = str_replace('desc', '', $groupby);
2395         $groupby = str_replace('asc', '', $groupby);
2396     }
2397
2398     if (($limitfrom == 0 and $limitnum == 0) or $forumsort == "") {
2399         $sql = "SELECT p.discussion, COUNT(p.id) AS replies, MAX(p.id) AS lastpostid
2400                   FROM {forum_posts} p
2401                        JOIN {forum_discussions} d ON p.discussion = d.id
2402                  WHERE p.parent > 0 AND d.forum = ?
2403               GROUP BY p.discussion";
2404         return $DB->get_records_sql($sql, array($forumid));
2405
2406     } else {
2407         $sql = "SELECT p.discussion, (COUNT(p.id) - 1) AS replies, MAX(p.id) AS lastpostid
2408                   FROM {forum_posts} p
2409                        JOIN {forum_discussions} d ON p.discussion = d.id
2410                  WHERE d.forum = ?
2411               GROUP BY p.discussion $groupby $orderby";
2412         return $DB->get_records_sql($sql, array($forumid), $limitfrom, $limitnum);
2413     }
2414 }
2415
2416 /**
2417  * @global object
2418  * @global object
2419  * @global object
2420  * @staticvar array $cache
2421  * @param object $forum
2422  * @param object $cm
2423  * @param object $course
2424  * @return mixed
2425  */
2426 function forum_count_discussions($forum, $cm, $course) {
2427     global $CFG, $DB, $USER;
2428
2429     static $cache = array();
2430
2431     $now = round(time(), -2); // db cache friendliness
2432
2433     $params = array($course->id);
2434
2435     if (!isset($cache[$course->id])) {
2436         if (!empty($CFG->forum_enabletimedposts)) {
2437             $timedsql = "AND d.timestart < ? AND (d.timeend = 0 OR d.timeend > ?)";
2438             $params[] = $now;
2439             $params[] = $now;
2440         } else {
2441             $timedsql = "";
2442         }
2443
2444         $sql = "SELECT f.id, COUNT(d.id) as dcount
2445                   FROM {forum} f
2446                        JOIN {forum_discussions} d ON d.forum = f.id
2447                  WHERE f.course = ?
2448                        $timedsql
2449               GROUP BY f.id";
2450
2451         if ($counts = $DB->get_records_sql($sql, $params)) {
2452             foreach ($counts as $count) {
2453                 $counts[$count->id] = $count->dcount;
2454             }
2455             $cache[$course->id] = $counts;
2456         } else {
2457             $cache[$course->id] = array();
2458         }
2459     }
2460
2461     if (empty($cache[$course->id][$forum->id])) {
2462         return 0;
2463     }
2464
2465     $groupmode = groups_get_activity_groupmode($cm, $course);
2466
2467     if ($groupmode != SEPARATEGROUPS) {
2468         return $cache[$course->id][$forum->id];
2469     }
2470
2471     if (has_capability('moodle/site:accessallgroups', context_module::instance($cm->id))) {
2472         return $cache[$course->id][$forum->id];
2473     }
2474
2475     require_once($CFG->dirroot.'/course/lib.php');
2476
2477     $modinfo = get_fast_modinfo($course);
2478
2479     $mygroups = $modinfo->get_groups($cm->groupingid);
2480
2481     // add all groups posts
2482     $mygroups[-1] = -1;
2483
2484     list($mygroups_sql, $params) = $DB->get_in_or_equal($mygroups);
2485     $params[] = $forum->id;
2486
2487     if (!empty($CFG->forum_enabletimedposts)) {
2488         $timedsql = "AND d.timestart < $now AND (d.timeend = 0 OR d.timeend > $now)";
2489         $params[] = $now;
2490         $params[] = $now;
2491     } else {
2492         $timedsql = "";
2493     }
2494
2495     $sql = "SELECT COUNT(d.id)
2496               FROM {forum_discussions} d
2497              WHERE d.groupid $mygroups_sql AND d.forum = ?
2498                    $timedsql";
2499
2500     return $DB->get_field_sql($sql, $params);
2501 }
2502
2503 /**
2504  * Get all discussions in a forum
2505  *
2506  * @global object
2507  * @global object
2508  * @global object
2509  * @uses CONTEXT_MODULE
2510  * @uses VISIBLEGROUPS
2511  * @param object $cm
2512  * @param string $forumsort
2513  * @param bool $fullpost
2514  * @param int $unused
2515  * @param int $limit
2516  * @param bool $userlastmodified
2517  * @param int $page
2518  * @param int $perpage
2519  * @param int $groupid if groups enabled, get discussions for this group overriding the current group.
2520  *                     Use FORUM_POSTS_ALL_USER_GROUPS for all the user groups
2521  * @param int $updatedsince retrieve only discussions updated since the given time
2522  * @return array
2523  */
2524 function forum_get_discussions($cm, $forumsort="", $fullpost=true, $unused=-1, $limit=-1,
2525                                 $userlastmodified=false, $page=-1, $perpage=0, $groupid = -1,
2526                                 $updatedsince = 0) {
2527     global $CFG, $DB, $USER;
2528
2529     $timelimit = '';
2530
2531     $now = round(time(), -2);
2532     $params = array($cm->instance);
2533
2534     $modcontext = context_module::instance($cm->id);
2535
2536     if (!has_capability('mod/forum:viewdiscussion', $modcontext)) { /// User must have perms to view discussions
2537         return array();
2538     }
2539
2540     if (!empty($CFG->forum_enabletimedposts)) { /// Users must fulfill timed posts
2541
2542         if (!has_capability('mod/forum:viewhiddentimedposts', $modcontext)) {
2543             $timelimit = " AND ((d.timestart <= ? AND (d.timeend = 0 OR d.timeend > ?))";
2544             $params[] = $now;
2545             $params[] = $now;
2546             if (isloggedin()) {
2547                 $timelimit .= " OR d.userid = ?";
2548                 $params[] = $USER->id;
2549             }
2550             $timelimit .= ")";
2551         }
2552     }
2553
2554     if ($limit > 0) {
2555         $limitfrom = 0;
2556         $limitnum  = $limit;
2557     } else if ($page != -1) {
2558         $limitfrom = $page*$perpage;
2559         $limitnum  = $perpage;
2560     } else {
2561         $limitfrom = 0;
2562         $limitnum  = 0;
2563     }
2564
2565     $groupmode    = groups_get_activity_groupmode($cm);
2566
2567     if ($groupmode) {
2568
2569         if (empty($modcontext)) {
2570             $modcontext = context_module::instance($cm->id);
2571         }
2572
2573         // Special case, we received a groupid to override currentgroup.
2574         if ($groupid > 0) {
2575             $course = get_course($cm->course);
2576             if (!groups_group_visible($groupid, $course, $cm)) {
2577                 // User doesn't belong to this group, return nothing.
2578                 return array();
2579             }
2580             $currentgroup = $groupid;
2581         } else if ($groupid === -1) {
2582             $currentgroup = groups_get_activity_group($cm);
2583         } else {
2584             // Get discussions for all groups current user can see.
2585             $currentgroup = null;
2586         }
2587
2588         if ($groupmode == VISIBLEGROUPS or has_capability('moodle/site:accessallgroups', $modcontext)) {
2589             if ($currentgroup) {
2590                 $groupselect = "AND (d.groupid = ? OR d.groupid = -1)";
2591                 $params[] = $currentgroup;
2592             } else {
2593                 $groupselect = "";
2594             }
2595
2596         } else {
2597             // Separate groups.
2598
2599             // Get discussions for all groups current user can see.
2600             if ($currentgroup === null) {
2601                 $mygroups = array_keys(groups_get_all_groups($cm->course, $USER->id, $cm->groupingid, 'g.id'));
2602                 if (empty($mygroups)) {
2603                      $groupselect = "AND d.groupid = -1";
2604                 } else {
2605                     list($insqlgroups, $inparamsgroups) = $DB->get_in_or_equal($mygroups);
2606                     $groupselect = "AND (d.groupid = -1 OR d.groupid $insqlgroups)";
2607                     $params = array_merge($params, $inparamsgroups);
2608                 }
2609             } else if ($currentgroup) {
2610                 $groupselect = "AND (d.groupid = ? OR d.groupid = -1)";
2611                 $params[] = $currentgroup;
2612             } else {
2613                 $groupselect = "AND d.groupid = -1";
2614             }
2615         }
2616     } else {
2617         $groupselect = "";
2618     }
2619     if (empty($forumsort)) {
2620         $forumsort = forum_get_default_sort_order();
2621     }
2622     if (empty($fullpost)) {
2623         $postdata = "p.id,p.subject,p.modified,p.discussion,p.userid";
2624     } else {
2625         $postdata = "p.*";
2626     }
2627
2628     if (empty($userlastmodified)) {  // We don't need to know this
2629         $umfields = "";
2630         $umtable  = "";
2631     } else {
2632         $umfields = ', ' . get_all_user_name_fields(true, 'um', null, 'um') . ', um.email AS umemail, um.picture AS umpicture,
2633                         um.imagealt AS umimagealt';
2634         $umtable  = " LEFT JOIN {user} um ON (d.usermodified = um.id)";
2635     }
2636
2637     $updatedsincesql = '';
2638     if (!empty($updatedsince)) {
2639         $updatedsincesql = 'AND d.timemodified > ?';
2640         $params[] = $updatedsince;
2641     }
2642
2643     $allnames = get_all_user_name_fields(true, 'u');
2644     $sql = "SELECT $postdata, d.name, d.timemodified, d.usermodified, d.groupid, d.timestart, d.timeend, d.pinned, $allnames,
2645                    u.email, u.picture, u.imagealt $umfields
2646               FROM {forum_discussions} d
2647                    JOIN {forum_posts} p ON p.discussion = d.id
2648                    JOIN {user} u ON p.userid = u.id
2649                    $umtable
2650              WHERE d.forum = ? AND p.parent = 0
2651                    $timelimit $groupselect $updatedsincesql
2652           ORDER BY $forumsort, d.id DESC";
2653
2654     return $DB->get_records_sql($sql, $params, $limitfrom, $limitnum);
2655 }
2656
2657 /**
2658  * Gets the neighbours (previous and next) of a discussion.
2659  *
2660  * The calculation is based on the timemodified when time modified or time created is identical
2661  * It will revert to using the ID to sort consistently. This is better tha skipping a discussion.
2662  *
2663  * For blog-style forums, the calculation is based on the original creation time of the
2664  * blog post.
2665  *
2666  * Please note that this does not check whether or not the discussion passed is accessible
2667  * by the user, it simply uses it as a reference to find the neighbours. On the other hand,
2668  * the returned neighbours are checked and are accessible to the current user.
2669  *
2670  * @param object $cm The CM record.
2671  * @param object $discussion The discussion record.
2672  * @param object $forum The forum instance record.
2673  * @return array That always contains the keys 'prev' and 'next'. When there is a result
2674  *               they contain the record with minimal information such as 'id' and 'name'.
2675  *               When the neighbour is not found the value is false.
2676  */
2677 function forum_get_discussion_neighbours($cm, $discussion, $forum) {
2678     global $CFG, $DB, $USER;
2679
2680     if ($cm->instance != $discussion->forum or $discussion->forum != $forum->id or $forum->id != $cm->instance) {
2681         throw new coding_exception('Discussion is not part of the same forum.');
2682     }
2683
2684     $neighbours = array('prev' => false, 'next' => false);
2685     $now = round(time(), -2);
2686     $params = array();
2687
2688     $modcontext = context_module::instance($cm->id);
2689     $groupmode    = groups_get_activity_groupmode($cm);
2690     $currentgroup = groups_get_activity_group($cm);
2691
2692     // Users must fulfill timed posts.
2693     $timelimit = '';
2694     if (!empty($CFG->forum_enabletimedposts)) {
2695         if (!has_capability('mod/forum:viewhiddentimedposts', $modcontext)) {
2696             $timelimit = ' AND ((d.timestart <= :tltimestart AND (d.timeend = 0 OR d.timeend > :tltimeend))';
2697             $params['tltimestart'] = $now;
2698             $params['tltimeend'] = $now;
2699             if (isloggedin()) {
2700                 $timelimit .= ' OR d.userid = :tluserid';
2701                 $params['tluserid'] = $USER->id;
2702             }
2703             $timelimit .= ')';
2704         }
2705     }
2706
2707     // Limiting to posts accessible according to groups.
2708     $groupselect = '';
2709     if ($groupmode) {
2710         if ($groupmode == VISIBLEGROUPS || has_capability('moodle/site:accessallgroups', $modcontext)) {
2711             if ($currentgroup) {
2712                 $groupselect = 'AND (d.groupid = :groupid OR d.groupid = -1)';
2713                 $params['groupid'] = $currentgroup;
2714             }
2715         } else {
2716             if ($currentgroup) {
2717                 $groupselect = 'AND (d.groupid = :groupid OR d.groupid = -1)';
2718                 $params['groupid'] = $currentgroup;
2719             } else {
2720                 $groupselect = 'AND d.groupid = -1';
2721             }
2722         }
2723     }
2724
2725     $params['forumid'] = $cm->instance;
2726     $params['discid1'] = $discussion->id;
2727     $params['discid2'] = $discussion->id;
2728     $params['discid3'] = $discussion->id;
2729     $params['discid4'] = $discussion->id;
2730     $params['disctimecompare1'] = $discussion->timemodified;
2731     $params['disctimecompare2'] = $discussion->timemodified;
2732     $params['pinnedstate1'] = (int) $discussion->pinned;
2733     $params['pinnedstate2'] = (int) $discussion->pinned;
2734     $params['pinnedstate3'] = (int) $discussion->pinned;
2735     $params['pinnedstate4'] = (int) $discussion->pinned;
2736
2737     $sql = "SELECT d.id, d.name, d.timemodified, d.groupid, d.timestart, d.timeend
2738               FROM {forum_discussions} d
2739               JOIN {forum_posts} p ON d.firstpost = p.id
2740              WHERE d.forum = :forumid
2741                AND d.id <> :discid1
2742                    $timelimit
2743                    $groupselect";
2744     $comparefield = "d.timemodified";
2745     $comparevalue = ":disctimecompare1";
2746     $comparevalue2  = ":disctimecompare2";
2747     if (!empty($CFG->forum_enabletimedposts)) {
2748         // Here we need to take into account the release time (timestart)
2749         // if one is set, of the neighbouring posts and compare it to the
2750         // timestart or timemodified of *this* post depending on if the
2751         // release date of this post is in the future or not.
2752         // This stops discussions that appear later because of the
2753         // timestart value from being buried under discussions that were
2754         // made afterwards.
2755         $comparefield = "CASE WHEN d.timemodified < d.timestart
2756                                 THEN d.timestart ELSE d.timemodified END";
2757         if ($discussion->timemodified < $discussion->timestart) {
2758             // Normally we would just use the timemodified for sorting
2759             // discussion posts. However, when timed discussions are enabled,
2760             // then posts need to be sorted base on the later of timemodified
2761             // or the release date of the post (timestart).
2762             $params['disctimecompare1'] = $discussion->timestart;
2763             $params['disctimecompare2'] = $discussion->timestart;
2764         }
2765     }
2766     $orderbydesc = forum_get_default_sort_order(true, $comparefield, 'd', false);
2767     $orderbyasc = forum_get_default_sort_order(false, $comparefield, 'd', false);
2768
2769     if ($forum->type === 'blog') {
2770          $subselect = "SELECT pp.created
2771                    FROM {forum_discussions} dd
2772                    JOIN {forum_posts} pp ON dd.firstpost = pp.id ";
2773
2774          $subselectwhere1 = " WHERE dd.id = :discid3";
2775          $subselectwhere2 = " WHERE dd.id = :discid4";
2776
2777          $comparefield = "p.created";
2778
2779          $sub1 = $subselect.$subselectwhere1;
2780          $comparevalue = "($sub1)";
2781
2782          $sub2 = $subselect.$subselectwhere2;
2783          $comparevalue2 = "($sub2)";
2784
2785          $orderbydesc = "d.pinned, p.created DESC";
2786          $orderbyasc = "d.pinned, p.created ASC";
2787     }
2788
2789     $prevsql = $sql . " AND ( (($comparefield < $comparevalue) AND :pinnedstate1 = d.pinned)
2790                          OR ($comparefield = $comparevalue2 AND (d.pinned = 0 OR d.pinned = :pinnedstate4) AND d.id < :discid2)
2791                          OR (d.pinned = 0 AND d.pinned <> :pinnedstate2))
2792                    ORDER BY CASE WHEN d.pinned = :pinnedstate3 THEN 1 ELSE 0 END DESC, $orderbydesc, d.id DESC";
2793
2794     $nextsql = $sql . " AND ( (($comparefield > $comparevalue) AND :pinnedstate1 = d.pinned)
2795                          OR ($comparefield = $comparevalue2 AND (d.pinned = 1 OR d.pinned = :pinnedstate4) AND d.id > :discid2)
2796                          OR (d.pinned = 1 AND d.pinned <> :pinnedstate2))
2797                    ORDER BY CASE WHEN d.pinned = :pinnedstate3 THEN 1 ELSE 0 END DESC, $orderbyasc, d.id ASC";
2798
2799     $neighbours['prev'] = $DB->get_record_sql($prevsql, $params, IGNORE_MULTIPLE);
2800     $neighbours['next'] = $DB->get_record_sql($nextsql, $params, IGNORE_MULTIPLE);
2801     return $neighbours;
2802 }
2803
2804 /**
2805  * Get the sql to use in the ORDER BY clause for forum discussions.
2806  *
2807  * This has the ordering take timed discussion windows into account.
2808  *
2809  * @param bool $desc True for DESC, False for ASC.
2810  * @param string $compare The field in the SQL to compare to normally sort by.
2811  * @param string $prefix The prefix being used for the discussion table.
2812  * @param bool $pinned sort pinned posts to the top
2813  * @return string
2814  */
2815 function forum_get_default_sort_order($desc = true, $compare = 'd.timemodified', $prefix = 'd', $pinned = true) {
2816     global $CFG;
2817
2818     if (!empty($prefix)) {
2819         $prefix .= '.';
2820     }
2821
2822     $dir = $desc ? 'DESC' : 'ASC';
2823
2824     if ($pinned == true) {
2825         $pinned = "{$prefix}pinned DESC,";
2826     } else {
2827         $pinned = '';
2828     }
2829
2830     $sort = "{$prefix}timemodified";
2831     if (!empty($CFG->forum_enabletimedposts)) {
2832         $sort = "CASE WHEN {$compare} < {$prefix}timestart
2833                  THEN {$prefix}timestart
2834                  ELSE {$compare}
2835                  END";
2836     }
2837     return "$pinned $sort $dir";
2838 }
2839
2840 /**
2841  *
2842  * @global object
2843  * @global object
2844  * @global object
2845  * @uses CONTEXT_MODULE
2846  * @uses VISIBLEGROUPS
2847  * @param object $cm
2848  * @return array
2849  */
2850 function forum_get_discussions_unread($cm) {
2851     global $CFG, $DB, $USER;
2852
2853     $now = round(time(), -2);
2854     $cutoffdate = $now - ($CFG->forum_oldpostdays*24*60*60);
2855
2856     $params = array();
2857     $groupmode    = groups_get_activity_groupmode($cm);
2858     $currentgroup = groups_get_activity_group($cm);
2859
2860     if ($groupmode) {
2861         $modcontext = context_module::instance($cm->id);
2862
2863         if ($groupmode == VISIBLEGROUPS or has_capability('moodle/site:accessallgroups', $modcontext)) {
2864             if ($currentgroup) {
2865                 $groupselect = "AND (d.groupid = :currentgroup OR d.groupid = -1)";
2866                 $params['currentgroup'] = $currentgroup;
2867             } else {
2868                 $groupselect = "";
2869             }
2870
2871         } else {
2872             //separate groups without access all
2873             if ($currentgroup) {
2874                 $groupselect = "AND (d.groupid = :currentgroup OR d.groupid = -1)";
2875                 $params['currentgroup'] = $currentgroup;
2876             } else {
2877                 $groupselect = "AND d.groupid = -1";
2878             }
2879         }
2880     } else {
2881         $groupselect = "";
2882     }
2883
2884     if (!empty($CFG->forum_enabletimedposts)) {
2885         $timedsql = "AND d.timestart < :now1 AND (d.timeend = 0 OR d.timeend > :now2)";
2886         $params['now1'] = $now;
2887         $params['now2'] = $now;
2888     } else {
2889         $timedsql = "";
2890     }
2891
2892     $sql = "SELECT d.id, COUNT(p.id) AS unread
2893               FROM {forum_discussions} d
2894                    JOIN {forum_posts} p     ON p.discussion = d.id
2895                    LEFT JOIN {forum_read} r ON (r.postid = p.id AND r.userid = $USER->id)
2896              WHERE d.forum = {$cm->instance}
2897                    AND p.modified >= :cutoffdate AND r.id is NULL
2898                    $groupselect
2899                    $timedsql
2900           GROUP BY d.id";
2901     $params['cutoffdate'] = $cutoffdate;
2902
2903     if ($unreads = $DB->get_records_sql($sql, $params)) {
2904         foreach ($unreads as $unread) {
2905             $unreads[$unread->id] = $unread->unread;
2906         }
2907         return $unreads;
2908     } else {
2909         return array();
2910     }
2911 }
2912
2913 /**
2914  * @global object
2915  * @global object
2916  * @global object
2917  * @uses CONEXT_MODULE
2918  * @uses VISIBLEGROUPS
2919  * @param object $cm
2920  * @return array
2921  */
2922 function forum_get_discussions_count($cm) {
2923     global $CFG, $DB, $USER;
2924
2925     $now = round(time(), -2);
2926     $params = array($cm->instance);
2927     $groupmode    = groups_get_activity_groupmode($cm);
2928     $currentgroup = groups_get_activity_group($cm);
2929
2930     if ($groupmode) {
2931         $modcontext = context_module::instance($cm->id);
2932
2933         if ($groupmode == VISIBLEGROUPS or has_capability('moodle/site:accessallgroups', $modcontext)) {
2934             if ($currentgroup) {
2935                 $groupselect = "AND (d.groupid = ? OR d.groupid = -1)";
2936                 $params[] = $currentgroup;
2937             } else {
2938                 $groupselect = "";
2939             }
2940
2941         } else {
2942             //seprate groups without access all
2943             if ($currentgroup) {
2944                 $groupselect = "AND (d.groupid = ? OR d.groupid = -1)";
2945                 $params[] = $currentgroup;
2946             } else {
2947                 $groupselect = "AND d.groupid = -1";
2948             }
2949         }
2950     } else {
2951         $groupselect = "";
2952     }
2953
2954     $timelimit = "";
2955
2956     if (!empty($CFG->forum_enabletimedposts)) {
2957
2958         $modcontext = context_module::instance($cm->id);
2959
2960         if (!has_capability('mod/forum:viewhiddentimedposts', $modcontext)) {
2961             $timelimit = " AND ((d.timestart <= ? AND (d.timeend = 0 OR d.timeend > ?))";
2962             $params[] = $now;
2963             $params[] = $now;
2964             if (isloggedin()) {
2965                 $timelimit .= " OR d.userid = ?";
2966                 $params[] = $USER->id;
2967             }
2968             $timelimit .= ")";
2969         }
2970     }
2971
2972     $sql = "SELECT COUNT(d.id)
2973               FROM {forum_discussions} d
2974                    JOIN {forum_posts} p ON p.discussion = d.id
2975              WHERE d.forum = ? AND p.parent = 0
2976                    $groupselect $timelimit";
2977
2978     return $DB->get_field_sql($sql, $params);
2979 }
2980
2981
2982 // OTHER FUNCTIONS ///////////////////////////////////////////////////////////
2983
2984
2985 /**
2986  * @global object
2987  * @global object
2988  * @param int $courseid
2989  * @param string $type
2990  */
2991 function forum_get_course_forum($courseid, $type) {
2992 // How to set up special 1-per-course forums
2993     global $CFG, $DB, $OUTPUT, $USER;
2994
2995     if ($forums = $DB->get_records_select("forum", "course = ? AND type = ?", array($courseid, $type), "id ASC")) {
2996         // There should always only be ONE, but with the right combination of
2997         // errors there might be more.  In this case, just return the oldest one (lowest ID).
2998         foreach ($forums as $forum) {
2999             return $forum;   // ie the first one
3000         }
3001     }
3002
3003     // Doesn't exist, so create one now.
3004     $forum = new stdClass();
3005     $forum->course = $courseid;
3006     $forum->type = "$type";
3007     if (!empty($USER->htmleditor)) {
3008         $forum->introformat = $USER->htmleditor;
3009     }
3010     switch ($forum->type) {
3011         case "news":
3012             $forum->name  = get_string("namenews", "forum");
3013             $forum->intro = get_string("intronews", "forum");
3014             $forum->forcesubscribe = FORUM_FORCESUBSCRIBE;
3015             $forum->assessed = 0;
3016             if ($courseid == SITEID) {
3017                 $forum->name  = get_string("sitenews");
3018                 $forum->forcesubscribe = 0;
3019             }
3020             break;
3021         case "social":
3022             $forum->name  = get_string("namesocial", "forum");
3023             $forum->intro = get_string("introsocial", "forum");
3024             $forum->assessed = 0;
3025             $forum->forcesubscribe = 0;
3026             break;
3027         case "blog":
3028             $forum->name = get_string('blogforum', 'forum');
3029             $forum->intro = get_string('introblog', 'forum');
3030             $forum->assessed = 0;
3031             $forum->forcesubscribe = 0;
3032             break;
3033         default:
3034             echo $OUTPUT->notification("That forum type doesn't exist!");
3035             return false;
3036             break;
3037     }
3038
3039     $forum->timemodified = time();
3040     $forum->id = $DB->insert_record("forum", $forum);
3041
3042     if (! $module = $DB->get_record("modules", array("name" => "forum"))) {
3043         echo $OUTPUT->notification("Could not find forum module!!");
3044         return false;
3045     }
3046     $mod = new stdClass();
3047     $mod->course = $courseid;
3048     $mod->module = $module->id;
3049     $mod->instance = $forum->id;
3050     $mod->section = 0;
3051     include_once("$CFG->dirroot/course/lib.php");
3052     if (! $mod->coursemodule = add_course_module($mod) ) {
3053         echo $OUTPUT->notification("Could not add a new course module to the course '" . $courseid . "'");
3054         return false;
3055     }
3056     $sectionid = course_add_cm_to_section($courseid, $mod->coursemodule, 0);
3057     return $DB->get_record("forum", array("id" => "$forum->id"));
3058 }
3059
3060 /**
3061  * Print a forum post
3062  *
3063  * @global object
3064  * @global object
3065  * @uses FORUM_MODE_THREADED
3066  * @uses PORTFOLIO_FORMAT_PLAINHTML
3067  * @uses PORTFOLIO_FORMAT_FILE
3068  * @uses PORTFOLIO_FORMAT_RICHHTML
3069  * @uses PORTFOLIO_ADD_TEXT_LINK
3070  * @uses CONTEXT_MODULE
3071  * @param object $post The post to print.
3072  * @param object $discussion
3073  * @param object $forum
3074  * @param object $cm
3075  * @param object $course
3076  * @param boolean $ownpost Whether this post belongs to the current user.
3077  * @param boolean $reply Whether to print a 'reply' link at the bottom of the message.
3078  * @param boolean $link Just print a shortened version of the post as a link to the full post.
3079  * @param string $footer Extra stuff to print after the message.
3080  * @param string $highlight Space-separated list of terms to highlight.
3081  * @param int $post_read true, false or -99. If we already know whether this user
3082  *          has read this post, pass that in, otherwise, pass in -99, and this
3083  *          function will work it out.
3084  * @param boolean $dummyifcantsee When forum_user_can_see_post says that
3085  *          the current user can't see this post, if this argument is true
3086  *          (the default) then print a dummy 'you can't see this post' post.
3087  *          If false, don't output anything at all.
3088  * @param bool|null $istracked
3089  * @return void
3090  */
3091 function forum_print_post($post, $discussion, $forum, &$cm, $course, $ownpost=false, $reply=false, $link=false,
3092                           $footer="", $highlight="", $postisread=null, $dummyifcantsee=true, $istracked=null, $return=false) {
3093     global $USER, $CFG, $OUTPUT;
3094
3095     require_once($CFG->libdir . '/filelib.php');
3096
3097     // String cache
3098     static $str;
3099     // This is an extremely hacky way to ensure we only print the 'unread' anchor
3100     // the first time we encounter an unread post on a page. Ideally this would
3101     // be moved into the caller somehow, and be better testable. But at the time
3102     // of dealing with this bug, this static workaround was the most surgical and
3103     // it fits together with only printing th unread anchor id once on a given page.
3104     static $firstunreadanchorprinted = false;
3105
3106     $modcontext = context_module::instance($cm->id);
3107
3108     $post->course = $course->id;
3109     $post->forum  = $forum->id;
3110     $post->message = file_rewrite_pluginfile_urls($post->message, 'pluginfile.php', $modcontext->id, 'mod_forum', 'post', $post->id);
3111     if (!empty($CFG->enableplagiarism)) {
3112         require_once($CFG->libdir.'/plagiarismlib.php');
3113         $post->message .= plagiarism_get_links(array('userid' => $post->userid,
3114             'content' => $post->message,
3115             'cmid' => $cm->id,
3116             'course' => $post->course,
3117             'forum' => $post->forum));
3118     }
3119
3120     // caching
3121     if (!isset($cm->cache)) {
3122         $cm->cache = new stdClass;
3123     }
3124
3125     if (!isset($cm->cache->caps)) {
3126         $cm->cache->caps = array();
3127         $cm->cache->caps['mod/forum:viewdiscussion']   = has_capability('mod/forum:viewdiscussion', $modcontext);
3128         $cm->cache->caps['moodle/site:viewfullnames']  = has_capability('moodle/site:viewfullnames', $modcontext);
3129         $cm->cache->caps['mod/forum:editanypost']      = has_capability('mod/forum:editanypost', $modcontext);
3130         $cm->cache->caps['mod/forum:splitdiscussions'] = has_capability('mod/forum:splitdiscussions', $modcontext);
3131         $cm->cache->caps['mod/forum:deleteownpost']    = has_capability('mod/forum:deleteownpost', $modcontext);
3132         $cm->cache->caps['mod/forum:deleteanypost']    = has_capability('mod/forum:deleteanypost', $modcontext);
3133         $cm->cache->caps['mod/forum:viewanyrating']    = has_capability('mod/forum:viewanyrating', $modcontext);
3134         $cm->cache->caps['mod/forum:exportpost']       = has_capability('mod/forum:exportpost', $modcontext);
3135         $cm->cache->caps['mod/forum:exportownpost']    = has_capability('mod/forum:exportownpost', $modcontext);
3136     }
3137
3138     if (!isset($cm->uservisible)) {
3139         $cm->uservisible = \core_availability\info_module::is_user_visible($cm, 0, false);
3140     }
3141
3142     if ($istracked && is_null($postisread)) {
3143         $postisread = forum_tp_is_post_read($USER->id, $post);
3144     }
3145
3146     if (!forum_user_can_see_post($forum, $discussion, $post, NULL, $cm)) {
3147         $output = '';
3148         if (!$dummyifcantsee) {
3149             if ($return) {
3150                 return $output;
3151             }
3152             echo $output;
3153             return;
3154         }
3155         $output .= html_writer::tag('a', '', array('id'=>'p'.$post->id));
3156         $output .= html_writer::start_tag('div', array('class'=>'forumpost clearfix',
3157                                                        'role' => 'region',
3158                                                        'aria-label' => get_string('hiddenforumpost', 'forum')));
3159         $output .= html_writer::start_tag('div', array('class'=>'row header'));
3160         $output .= html_writer::tag('div', '', array('class'=>'left picture')); // Picture
3161         if ($post->parent) {
3162             $output .= html_writer::start_tag('div', array('class'=>'topic'));
3163         } else {
3164             $output .= html_writer::start_tag('div', array('class'=>'topic starter'));
3165         }
3166         $output .= html_writer::tag('div', get_string('forumsubjecthidden','forum'), array('class' => 'subject',
3167                                                                                            'role' => 'header')); // Subject.
3168         $output .= html_writer::tag('div', get_string('forumauthorhidden', 'forum'), array('class' => 'author',
3169                                                                                            'role' => 'header')); // Author.
3170         $output .= html_writer::end_tag('div');
3171         $output .= html_writer::end_tag('div'); // row
3172         $output .= html_writer::start_tag('div', array('class'=>'row'));
3173         $output .= html_writer::tag('div', '&nbsp;', array('class'=>'left side')); // Groups
3174         $output .= html_writer::tag('div', get_string('forumbodyhidden','forum'), array('class'=>'content')); // Content
3175         $output .= html_writer::end_tag('div'); // row
3176         $output .= html_writer::end_tag('div'); // forumpost
3177
3178         if ($return) {
3179             return $output;
3180         }
3181         echo $output;
3182         return;
3183     }
3184
3185     if (empty($str)) {
3186         $str = new stdClass;
3187         $str->edit         = get_string('edit', 'forum');
3188         $str->delete       = get_string('delete', 'forum');
3189         $str->reply        = get_string('reply', 'forum');
3190         $str->parent       = get_string('parent', 'forum');
3191         $str->pruneheading = get_string('pruneheading', 'forum');
3192         $str->prune        = get_string('prune', 'forum');
3193         $str->displaymode     = get_user_preferences('forum_displaymode', $CFG->forum_displaymode);
3194         $str->markread     = get_string('markread', 'forum');
3195         $str->markunread   = get_string('markunread', 'forum');
3196     }
3197
3198     $discussionlink = new moodle_url('/mod/forum/discuss.php', array('d'=>$post->discussion));
3199
3200     // Build an object that represents the posting user
3201     $postuser = new stdClass;
3202     $postuserfields = explode(',', user_picture::fields());
3203     $postuser = username_load_fields_from_object($postuser, $post, null, $postuserfields);
3204     $postuser->id = $post->userid;
3205     $postuser->fullname    = fullname($postuser, $cm->cache->caps['moodle/site:viewfullnames']);
3206     $postuser->profilelink = new moodle_url('/user/view.php', array('id'=>$post->userid, 'course'=>$course->id));
3207
3208     // Prepare the groups the posting user belongs to
3209     if (isset($cm->cache->usersgroups)) {
3210         $groups = array();
3211         if (isset($cm->cache->usersgroups[$post->userid])) {
3212             foreach ($cm->cache->usersgroups[$post->userid] as $gid) {
3213                 $groups[$gid] = $cm->cache->groups[$gid];
3214             }
3215         }
3216     } else {
3217         $groups = groups_get_all_groups($course->id, $post->userid, $cm->groupingid);
3218     }
3219
3220     // Prepare the attachements for the post, files then images
3221     list($attachments, $attachedimages) = forum_print_attachments($post, $cm, 'separateimages');
3222
3223     // Determine if we need to shorten this post
3224     $shortenpost = ($link && (strlen(strip_tags($post->message)) > $CFG->forum_longpost));
3225
3226
3227     // Prepare an array of commands
3228     $commands = array();
3229
3230     // Add a permalink.
3231     $permalink = new moodle_url($discussionlink);
3232     $permalink->set_anchor('p' . $post->id);
3233     $commands[] = array('url' => $permalink, 'text' => get_string('permalink', 'forum'));
3234
3235     // SPECIAL CASE: The front page can display a news item post to non-logged in users.
3236     // Don't display the mark read / unread controls in this case.
3237     if ($istracked && $CFG->forum_usermarksread && isloggedin()) {
3238         $url = new moodle_url($discussionlink, array('postid'=>$post->id, 'mark'=>'unread'));
3239         $text = $str->markunread;
3240         if (!$postisread) {
3241             $url->param('mark', 'read');
3242             $text = $str->markread;
3243         }
3244         if ($str->displaymode == FORUM_MODE_THREADED) {
3245             $url->param('parent', $post->parent);
3246         } else {
3247             $url->set_anchor('p'.$post->id);
3248         }
3249         $commands[] = array('url'=>$url, 'text'=>$text);
3250     }
3251
3252     // Zoom in to the parent specifically
3253     if ($post->parent) {
3254         $url = new moodle_url($discussionlink);
3255         if ($str->displaymode == FORUM_MODE_THREADED) {
3256             $url->param('parent', $post->parent);
3257         } else {
3258             $url->set_anchor('p'.$post->parent);
3259         }
3260         $commands[] = array('url'=>$url, 'text'=>$str->parent);
3261     }
3262
3263     // Hack for allow to edit news posts those are not displayed yet until they are displayed
3264     $age = time() - $post->created;
3265     if (!$post->parent && $forum->type == 'news' && $discussion->timestart > time()) {
3266         $age = 0;
3267     }
3268
3269     if ($forum->type == 'single' and $discussion->firstpost == $post->id) {
3270         if (has_capability('moodle/course:manageactivities', $modcontext)) {
3271             // The first post in single simple is the forum description.
3272             $commands[] = array('url'=>new moodle_url('/course/modedit.php', array('update'=>$cm->id, 'sesskey'=>sesskey(), 'return'=>1)), 'text'=>$str->edit);
3273         }
3274     } else if (($ownpost && $age < $CFG->maxeditingtime) || $cm->cache->caps['mod/forum:editanypost']) {
3275         $commands[] = array('url'=>new moodle_url('/mod/forum/post.php', array('edit'=>$post->id)), 'text'=>$str->edit);
3276     }
3277
3278     if ($cm->cache->caps['mod/forum:splitdiscussions'] && $post->parent && $forum->type != 'single') {
3279         $commands[] = array('url'=>new moodle_url('/mod/forum/post.php', array('prune'=>$post->id)), 'text'=>$str->prune, 'title'=>$str->pruneheading);
3280     }
3281
3282     if ($forum->type == 'single' and $discussion->firstpost == $post->id) {
3283         // Do not allow deleting of first post in single simple type.
3284     } else if (($ownpost && $age < $CFG->maxeditingtime && $cm->cache->caps['mod/forum:deleteownpost']) || $cm->cache->caps['mod/forum:deleteanypost']) {
3285         $commands[] = array('url'=>new moodle_url('/mod/forum/post.php', array('delete'=>$post->id)), 'text'=>$str->delete);
3286     }
3287
3288     if ($reply) {
3289         $commands[] = array('url'=>new moodle_url('/mod/forum/post.php#mformforum', array('reply'=>$post->id)), 'text'=>$str->reply);
3290     }
3291
3292     if ($CFG->enableportfolios && ($cm->cache->caps['mod/forum:exportpost'] || ($ownpost && $cm->cache->caps['mod/forum:exportownpost']))) {
3293         $p = array('postid' => $post->id);
3294         require_once($CFG->libdir.'/portfoliolib.php');
3295         $button = new portfolio_add_button();
3296         $button->set_callback_options('forum_portfolio_caller', array('postid' => $post->id), 'mod_forum');
3297         if (empty($attachments)) {
3298             $button->set_formats(PORTFOLIO_FORMAT_PLAINHTML);
3299         } else {
3300             $button->set_formats(PORTFOLIO_FORMAT_RICHHTML);
3301         }
3302
3303         $porfoliohtml = $button->to_html(PORTFOLIO_ADD_TEXT_LINK);
3304         if (!empty($porfoliohtml)) {
3305             $commands[] = $porfoliohtml;
3306         }
3307     }
3308     // Finished building commands
3309
3310
3311     // Begin output
3312
3313     $output  = '';
3314
3315     if ($istracked) {
3316         if ($postisread) {
3317             $forumpostclass = ' read';
3318         } else {
3319             $forumpostclass = ' unread';
3320             // If this is the first unread post printed then give it an anchor and id of unread.
3321             if (!$firstunreadanchorprinted) {
3322                 $output .= html_writer::tag('a', '', array('id' => 'unread'));
3323                 $firstunreadanchorprinted = true;
3324             }
3325         }
3326     } else {
3327         // ignore trackign status if not tracked or tracked param missing
3328         $forumpostclass = '';
3329     }
3330
3331     $topicclass = '';
3332     if (empty($post->parent)) {
3333         $topicclass = ' firstpost starter';
3334     }
3335
3336     if (!empty($post->lastpost)) {
3337         $forumpostclass .= ' lastpost';
3338     }
3339
3340     // Flag to indicate whether we should hide the author or not.
3341     $authorhidden = forum_is_author_hidden($post, $forum);
3342     $postbyuser = new stdClass;
3343     $postbyuser->post = $post->subject;
3344     $postbyuser->user = $postuser->fullname;
3345     $discussionbyuser = get_string('postbyuser', 'forum', $postbyuser);
3346     $output .= html_writer::tag('a', '', array('id'=>'p'.$post->id));
3347     // Begin forum post.
3348     $output .= html_writer::start_div('forumpost clearfix' . $forumpostclass . $topicclass,
3349         ['role' => 'region', 'aria-label' => $discussionbyuser]);
3350     // Begin header row.
3351     $output .= html_writer::start_div('row header clearfix');
3352
3353     // User picture.
3354     if (!$authorhidden) {
3355         $picture = $OUTPUT->user_picture($postuser, ['courseid' => $course->id]);
3356         $output .= html_writer::div($picture, 'left picture');
3357         $topicclass = 'topic' . $topicclass;
3358     }
3359
3360     // Begin topic column.
3361     $output .= html_writer::start_div($topicclass);
3362     $postsubject = $post->subject;
3363     if (empty($post->subjectnoformat)) {
3364         $postsubject = format_string($postsubject);
3365     }
3366     $output .= html_writer::div($postsubject, 'subject', ['role' => 'heading', 'aria-level' => '2']);
3367
3368     if ($authorhidden) {
3369         $bytext = userdate($post->modified);
3370     } else {
3371         $by = new stdClass();
3372         $by->date = userdate($post->modified);
3373         $by->name = html_writer::link($postuser->profilelink, $postuser->fullname);
3374         $bytext = get_string('bynameondate', 'forum', $by);
3375     }
3376     $bytextoptions = [
3377         'role' => 'heading',
3378         'aria-level' => '2',
3379     ];
3380     $output .= html_writer::div($bytext, 'author', $bytextoptions);
3381     // End topic column.
3382     $output .= html_writer::end_div();
3383
3384     // End header row.
3385     $output .= html_writer::end_div();
3386
3387     // Row with the forum post content.
3388     $output .= html_writer::start_div('row maincontent clearfix');
3389     // Show if author is not hidden or we have groups.
3390     if (!$authorhidden || $groups) {
3391         $output .= html_writer::start_div('left');
3392         $groupoutput = '';
3393         if ($groups) {
3394             $groupoutput = print_group_picture($groups, $course->id, false, true, true);
3395         }
3396         if (empty($groupoutput)) {
3397             $groupoutput = '&nbsp;';
3398         }
3399         $output .= html_writer::div($groupoutput, 'grouppictures');
3400         $output .= html_writer::end_div(); // Left side.
3401     }
3402
3403     $output .= html_writer::start_tag('div', array('class'=>'no-overflow'));
3404     $output .= html_writer::start_tag('div', array('class'=>'content'));
3405
3406     $options = new stdClass;
3407     $options->para    = false;
3408     $options->trusted = $post->messagetrust;
3409     $options->context = $modcontext;
3410     if ($shortenpost) {
3411         // Prepare shortened version by filtering the text then shortening it.
3412         $postclass    = 'shortenedpost';
3413         $postcontent  = format_text($post->message, $post->messageformat, $options);
3414         $postcontent  = shorten_text($postcontent, $CFG->forum_shortpost);
3415         $postcontent .= html_writer::link($discussionlink, get_string('readtherest', 'forum'));
3416         $postcontent .= html_writer::tag('div', '('.get_string('numwords', 'moodle', count_words($post->message)).')',
3417             array('class'=>'post-word-count'));
3418     } else {
3419         // Prepare whole post
3420         $postclass    = 'fullpost';
3421         $postcontent  = format_text($post->message, $post->messageformat, $options, $course->id);
3422         if (!empty($highlight)) {
3423             $postcontent = highlight($highlight, $postcontent);
3424         }
3425         if (!empty($forum->displaywordcount)) {
3426             $postcontent .= html_writer::tag('div', get_string('numwords', 'moodle', count_words($post->message)),
3427                 array('class'=>'post-word-count'));
3428         }
3429         $postcontent .= html_writer::tag('div', $attachedimages, array('class'=>'attachedimages'));
3430     }
3431
3432     // Output the post content
3433     $output .= html_writer::tag('div', $postcontent, array('class'=>'posting '.$postclass));
3434     $output .= html_writer::end_tag('div'); // Content
3435     $output .= html_writer::end_tag('div'); // Content mask
3436     $output .= html_writer::end_tag('div'); // Row
3437
3438     $output .= html_writer::start_tag('div', array('class'=>'row side'));
3439     $output .= html_writer::tag('div','&nbsp;', array('class'=>'left'));
3440     $output .= html_writer::start_tag('div', array('class'=>'options clearfix'));
3441
3442     if (!empty($attachments)) {
3443         $output .= html_writer::tag('div', $attachments, array('class' => 'attachments'));
3444     }
3445
3446     // Output ratings
3447     if (!empty($post->rating)) {
3448         $output .= html_writer::tag('div', $OUTPUT->render($post->rating), array('class'=>'forum-post-rating'));
3449     }
3450
3451     // Output the commands
3452     $commandhtml = array();
3453     foreach ($commands as $command) {
3454         if (is_array($command)) {
3455             $commandhtml[] = html_writer::link($command['url'], $command['text']);
3456         } else {
3457             $commandhtml[] = $command;
3458         }
3459     }
3460     $output .= html_writer::tag('div', implode(' | ', $commandhtml), array('class'=>'commands'));
3461
3462     // Output link to post if required
3463     if ($link) {
3464         if (forum_user_can_post($forum, $discussion, $USER, $cm, $course, $modcontext)) {
3465             $langstring = 'discussthistopic';
3466         } else {
3467             $langstring = 'viewthediscussion';
3468         }
3469         if ($post->replies == 1) {
3470             $replystring = get_string('repliesone', 'forum', $post->replies);
3471         } else {
3472             $replystring = get_string('repliesmany', 'forum', $post->replies);
3473         }
3474         if (!empty($discussion->unread) && $discussion->unread !== '-') {
3475             $replystring .= ' <span class="sep">/</span> <span class="unread">';
3476             if ($discussion->unread == 1) {
3477                 $replystring .= get_string('unreadpostsone', 'forum');
3478             } else {
3479                 $replystring .= get_string('unreadpostsnumber', 'forum', $discussion->unread);
3480             }
3481             $replystring .= '</span>';
3482         }
3483
3484         $output .= html_writer::start_tag('div', array('class'=>'link'));
3485         $output .= html_writer::link($discussionlink, get_string($langstring, 'forum'));
3486         $output .= '&nbsp;('.$replystring.')';
3487         $output .= html_writer::end_tag('div'); // link
3488     }
3489
3490     // Output footer if required
3491     if ($footer) {
3492         $output .= html_writer::tag('div', $footer, array('class'=>'footer'));
3493     }
3494
3495     // Close remaining open divs
3496     $output .= html_writer::end_tag('div'); // content
3497     $output .= html_writer::end_tag('div'); // row
3498     $output .= html_writer::end_tag('div'); // forumpost
3499
3500     // Mark the forum post as read if required
3501     if ($istracked && !$CFG->forum_usermarksread && !$postisread) {
3502         forum_tp_mark_post_read($USER->id, $post, $forum->id);
3503     }
3504
3505     if ($return) {
3506         return $output;
3507     }
3508     echo $output;
3509     return;
3510 }
3511
3512 /**
3513  * Return rating related permissions
3514  *
3515  * @param string $options the context id
3516  * @return array an associative array of the user's rating permissions
3517  */
3518 function forum_rating_permissions($contextid, $component, $ratingarea) {
3519     $context = context::instance_by_id($contextid, MUST_EXIST);
3520     if ($component != 'mod_forum' || $ratingarea != 'post') {
3521         // We don't know about this component/ratingarea so just return null to get the
3522         // default restrictive permissions.
3523         return null;
3524     }
3525     return array(
3526         'view'    => has_capability('mod/forum:viewrating', $context),
3527         'viewany' => has_capability('mod/forum:viewanyrating', $context),
3528         'viewall' => has_capability('mod/forum:viewallratings', $context),
3529         'rate'    => has_capability('mod/forum:rate', $context)
3530     );
3531 }
3532
3533 /**
3534  * Validates a submitted rating
3535  * @param array $params submitted data
3536  *            context => object the context in which the rated items exists [required]
3537  *            component => The component for this module - should always be mod_forum [required]
3538  *            ratingarea => object the context in which the rated items exists [required]
3539  *            itemid => int the ID of the object being rated [required]
3540  *            scaleid => int the scale from which the user can select a rating. Used for bounds checking. [required]
3541  *            rating => int the submitted rating [required]
3542  *            rateduserid => int the id of the user whose items have been rated. NOT the user who submitted the ratings. 0 to update all. [required]
3543  *            aggregation => int the aggregation method to apply when calculating grades ie RATING_AGGREGATE_AVERAGE [required]
3544  * @return boolean true if the rating is valid. Will throw rating_exception if not
3545  */
3546 function forum_rating_validate($params) {
3547     global $DB, $USER;
3548
3549     // Check the component is mod_forum
3550     if ($params['component'] != 'mod_forum') {
3551         throw new rating_exception('invalidcomponent');
3552     }
3553
3554     // Check the ratingarea is post (the only rating area in forum)
3555     if ($params['ratingarea'] != 'post') {
3556         throw new rating_exception('invalidratingarea');
3557     }
3558
3559     // Check the rateduserid is not the current user .. you can't rate your own posts
3560     if ($params['rateduserid'] == $USER->id) {
3561         throw new rating_exception('nopermissiontorate');
3562     }
3563
3564     // Fetch all the related records ... we need to do this anyway to call forum_user_can_see_post
3565     $post = $DB->get_record('forum_posts', array('id' => $params['itemid'], 'userid' => $params['rateduserid']), '*', MUST_EXIST);
3566     $discussion = $DB->get_record('forum_discussions', array('id' => $post->discussion), '*', MUST_EXIST);
3567     $forum = $DB->get_record('forum', array('id' => $discussion->forum), '*', MUST_EXIST);
3568     $course = $DB->get_record('course', array('id' => $forum->course), '*', MUST_EXIST);
3569     $cm = get_coursemodule_from_instance('forum', $forum->id, $course->id , false, MUST_EXIST);
3570     $context = context_module::instance($cm->id);
3571
3572     // Make sure the context provided is the context of the forum
3573     if ($context->id != $params['context']->id) {
3574         throw new rating_exception('invalidcontext');
3575     }
3576
3577     if ($forum->scale != $params['scaleid']) {
3578         //the scale being submitted doesnt match the one in the database
3579         throw new rating_exception('invalidscaleid');
3580     }
3581
3582     // check the item we're rating was created in the assessable time window
3583     if (!empty($forum->assesstimestart) && !empty($forum->assesstimefinish)) {
3584         if ($post->created < $forum->assesstimestart || $post->created > $forum->assesstimefinish) {
3585             throw new rating_exception('notavailable');
3586         }
3587     }
3588
3589     //check that the submitted rating is valid for the scale
3590
3591     // lower limit
3592     if ($params['rating'] < 0  && $params['rating'] != RATING_UNSET_RATING) {
3593         throw new rating_exception('invalidnum');
3594     }
3595
3596     // upper limit
3597     if ($forum->scale < 0) {
3598         //its a custom scale
3599         $scalerecord = $DB->get_record('scale', array('id' => -$forum->scale));
3600         if ($scalerecord) {
3601             $scalearray = explode(',', $scalerecord->scale);
3602             if ($params['rating'] > count($scalearray)) {
3603                 throw new rating_exception('invalidnum');
3604             }
3605         } else {
3606             throw new rating_exception('invalidscaleid');
3607         }
3608     } else if ($params['rating'] > $forum->scale) {
3609         //if its numeric and submitted rating is above maximum
3610         throw new rating_exception('invalidnum');
3611     }
3612
3613     // Make sure groups allow this user to see the item they're rating
3614     if ($discussion->groupid > 0 and $groupmode = groups_get_activity_groupmode($cm, $course)) {   // Groups are being used
3615         if (!groups_group_exists($discussion->groupid)) { // Can't find group
3616             throw new rating_exception('cannotfindgroup');//something is wrong
3617         }
3618
3619         if (!groups_is_member($discussion->groupid) and !has_capability('moodle/site:accessallgroups', $context)) {
3620             // do not allow rating of posts from other groups when in SEPARATEGROUPS or VISIBLEGROUPS
3621             throw new rating_exception('notmemberofgroup');
3622         }
3623     }
3624
3625     // perform some final capability checks
3626     if (!forum_user_can_see_post($forum, $discussion, $post, $USER, $cm)) {
3627         throw new rating_exception('nopermissiontorate');
3628     }
3629
3630     return true;
3631 }
3632
3633 /**
3634  * Can the current user see ratings for a given itemid?
3635  *
3636  * @param array $params submitted data
3637  *            contextid => int contextid [required]
3638  *            component => The component for this module - should always be mod_forum [required]
3639  *            ratingarea => object the context in which the rated items exists [required]
3640  *            itemid => int the ID of the object being rated [required]
3641  *            scaleid => int scale id [optional]
3642  * @return bool
3643  * @throws coding_exception
3644  * @throws rating_exception
3645  */
3646 function mod_forum_rating_can_see_item_ratings($params) {
3647     global $DB, $USER;
3648
3649     // Check the component is mod_forum.
3650     if (!isset($params['component']) || $params['component'] != 'mod_forum') {
3651         throw new rating_exception('invalidcomponent');
3652     }
3653
3654     // Check the ratingarea is post (the only rating area in forum).
3655     if (!isset($params['ratingarea']) || $params['ratingarea'] != 'post') {
3656         throw new rating_exception('invalidratingarea');
3657     }
3658
3659     if (!isset($params['itemid'])) {
3660         throw new rating_exception('invaliditemid');
3661     }
3662
3663     $post = $DB->get_record('forum_posts', array('id' => $params['itemid']), '*', MUST_EXIST);
3664     $discussion = $DB->get_record('forum_discussions', array('id' => $post->discussion), '*', MUST_EXIST);
3665     $forum = $DB->get_record('forum', array('id' => $discussion->forum), '*', MUST_EXIST);
3666     $course = $DB->get_record('course', array('id' => $forum->course), '*', MUST_EXIST);
3667     $cm = get_coursemodule_from_instance('forum', $forum->id, $course->id , false, MUST_EXIST);
3668
3669     // Perform some final capability checks.
3670     if (!forum_user_can_see_post($forum, $discussion, $post, $USER, $cm)) {
3671         return false;
3672     }
3673     return true;
3674 }
3675
3676 /**
3677  * This function prints the overview of a discussion in the forum listing.
3678  * It needs some discussion information and some post information, these
3679  * happen to be combined for efficiency in the $post parameter by the function
3680  * that calls this one: forum_print_latest_discussions()
3681  *
3682  * @global object
3683  * @global object
3684  * @param object $post The post object (passed by reference for speed).
3685  * @param object $forum The forum object.
3686  * @param int $group Current group.
3687  * @param string $datestring Format to use for the dates.
3688  * @param boolean $cantrack Is tracking enabled for this forum.
3689  * @param boolean $forumtracked Is the user tracking this forum.
3690  * @param boolean $canviewparticipants True if user has the viewparticipants permission for this course
3691  * @param boolean $canviewhiddentimedposts True if user has the viewhiddentimedposts permission for this forum
3692  */
3693 function forum_print_discussion_header(&$post, $forum, $group = -1, $datestring = "",
3694                                         $cantrack = true, $forumtracked = true, $canviewparticipants = true, $modcontext = null,
3695                                         $canviewhiddentimedposts = false) {
3696
3697     global $COURSE, $USER, $CFG, $OUTPUT, $PAGE;
3698
3699     static $rowcount;
3700     static $strmarkalldread;
3701
3702     if (empty($modcontext)) {
3703         if (!$cm = get_coursemodule_from_instance('forum', $forum->id, $forum->course)) {
3704             print_error('invalidcoursemodule');
3705         }
3706         $modcontext = context_module::instance($cm->id);
3707     }
3708
3709     if (!isset($rowcount)) {
3710         $rowcount = 0;
3711         $strmarkalldread = get_string('markalldread', 'forum');
3712     } else {
3713         $rowcount = ($rowcount + 1) % 2;
3714     }
3715
3716     $post->subject = format_string($post->subject,true);
3717
3718     $timeddiscussion = !empty($CFG->forum_enabletimedposts) && ($post->timestart || $post->timeend);
3719     $timedoutsidewindow = '';
3720     if ($timeddiscussion && ($post->timestart > time() || ($post->timeend != 0 && $post->timeend < time()))) {
3721         $timedoutsidewindow = ' dimmed_text';
3722     }
3723
3724     echo "\n\n";
3725     echo '<tr class="discussion r'.$rowcount.$timedoutsidewindow.'">';
3726
3727     $topicclass = 'topic starter';
3728     if (FORUM_DISCUSSION_PINNED == $post->pinned) {
3729         $topicclass .= ' pinned';
3730     }
3731     echo '<td class="'.$topicclass.'">';
3732     if (FORUM_DISCUSSION_PINNED == $post->pinned) {
3733         echo $OUTPUT->pix_icon('i/pinned', get_string('discussionpinned', 'forum'), 'mod_forum');
3734     }
3735     $canalwaysseetimedpost = $USER->id == $post->userid || $canviewhiddentimedposts;
3736     if ($timeddiscussion && $canalwaysseetimedpost) {
3737         echo $PAGE->get_renderer('mod_forum')->timed_discussion_tooltip($post, empty($timedoutsidewindow));
3738     }
3739
3740     echo '<a href="'.$CFG->wwwroot.'/mod/forum/discuss.php?d='.$post->discussion.'">'.$post->subject.'</a>';
3741     echo "</td>\n";
3742
3743     // Picture
3744     $postuser = new stdClass();
3745     $postuserfields = explode(',', user_picture::fields());
3746     $postuser = username_load_fields_from_object($postuser, $post, null, $postuserfields);
3747     $postuser->id = $post->userid;
3748     echo '<td class="picture">';
3749     echo $OUTPUT->user_picture($postuser, array('courseid'=>$forum->course));
3750     echo "</td>\n";
3751
3752     // User name
3753     $fullname = fullname($postuser, has_capability('moodle/site:viewfullnames', $modcontext));
3754     echo '<td class="author">';
3755     echo '<a href="'.$CFG->wwwroot.'/user/view.php?id='.$post->userid.'&amp;course='.$forum->course.'">'.$fullname.'</a>';
3756     echo "</td>\n";
3757
3758     // Group picture
3759     if ($group !== -1) {  // Groups are active - group is a group data object or NULL
3760         echo '<td class="picture group">';
3761         if (!empty($group->picture) and empty($group->hidepicture)) {
3762             if ($canviewparticipants && $COURSE->groupmode) {
3763                 $picturelink = true;
3764             } else {
3765                 $picturelink = false;
3766             }
3767             print_group_picture($group, $forum->course, false, false, $picturelink);
3768         } else if (isset($group->id)) {
3769             if ($canviewparticipants && $COURSE->groupmode) {
3770                 echo '<a href="'.$CFG->wwwroot.'/user/index.php?id='.$forum->course.'&amp;group='.$group->id.'">'.$group->name.'</a>';
3771             } else {
3772                 echo $group->name;
3773             }
3774         }
3775         echo "</td>\n";
3776     }
3777
3778     if (has_capability('mod/forum:viewdiscussion', $modcontext)) {   // Show the column with replies
3779         echo '<td class="replies">';
3780         echo '<a href="'.$CFG->wwwroot.'/mod/forum/discuss.php?d='.$post->discussion.'">';
3781         echo $post->replies.'</a>';
3782         echo "</td>\n";
3783
3784         if ($cantrack) {
3785             echo '<td class="replies">';
3786             if ($forumtracked) {
3787                 if ($post->unread > 0) {
3788                     echo '<span class="unread">';
3789                     echo '<a href="'.$CFG->wwwroot.'/mod/forum/discuss.php?d='.$post->discussion.'#unread">';
3790                     echo $post->unread;
3791                     echo '</a>';
3792                     echo '<a title="'.$strmarkalldread.'" href="'.$CFG->wwwroot.'/mod/forum/markposts.php?f='.
3793                          $forum->id.'&amp;d='.$post->discussion.'&amp;mark=read&amp;returnpage=view.php&amp;sesskey=' . sesskey() . '">' .
3794                          '<img src="'.$OUTPUT->pix_url('t/markasread') . '" class="iconsmall" alt="'.$strmarkalldread.'" /></a>';
3795                     echo '</span>';
3796                 } else {
3797                     echo '<span class="read">';
3798                     echo $post->unread;
3799                     echo '</span>';
3800                 }
3801             } else {
3802                 echo '<span class="read">';
3803                 echo '-';
3804                 echo '</span>';
3805             }
3806             echo "</td>\n";
3807         }
3808     }
3809
3810     echo '<td class="lastpost">';
3811     $usedate = (empty($post->timemodified)) ? $post->modified : $post->timemodified;  // Just in case
3812     $parenturl = '';
3813     $usermodified = new stdClass();
3814     $usermodified->id = $post->usermodified;
3815     $usermodified = username_load_fields_from_object($usermodified, $post, 'um');
3816
3817     // In QA forums we check that the user can view participants.
3818     if ($forum->type !== 'qanda' || $canviewparticipants) {
3819         echo '<a href="'.$CFG->wwwroot.'/user/view.php?id='.$post->usermodified.'&amp;course='.$forum->course.'">'.
3820              fullname($usermodified).'</a><br />';
3821         $parenturl = (empty($post->lastpostid)) ? '' : '&amp;parent='.$post->lastpostid;
3822     }
3823
3824     echo '<a href="'.$CFG->wwwroot.'/mod/forum/discuss.php?d='.$post->discussion.$parenturl.'">'.
3825           userdate($usedate, $datestring).'</a>';
3826     echo "</td>\n";
3827
3828     // is_guest should be used here as this also checks whether the user is a guest in the current course.
3829     // Guests and visitors cannot subscribe - only enrolled users.
3830     if ((!is_guest($modcontext, $USER) && isloggedin()) && has_capability('mod/forum:viewdiscussion', $modcontext)) {
3831         // Discussion subscription.
3832         if (\mod_forum\subscriptions::is_subscribable($forum)) {
3833             echo '<td class="discussionsubscription">';
3834             echo forum_get_discussion_subscription_icon($forum, $post->discussion);
3835             echo '</td>';
3836         }
3837     }
3838
3839     echo "</tr>\n\n";
3840
3841 }
3842
3843 /**
3844  * Return the markup for the discussion subscription toggling icon.
3845  *
3846  * @param stdClass $forum The forum object.
3847  * @param int $discussionid The discussion to create an icon for.
3848  * @return string The generated markup.
3849  */
3850 function forum_get_discussion_subscription_icon($forum, $discussionid, $returnurl = null, $includetext = false) {
3851     global $USER, $OUTPUT, $PAGE;
3852
3853     if ($returnurl === null && $PAGE->url) {
3854         $returnurl = $PAGE->url->out();
3855     }
3856
3857     $o = '';
3858     $subscriptionstatus = \mod_forum\subscriptions::is_subscribed($USER->id, $forum, $discussionid);
3859     $subscriptionlink = new moodle_url('/mod/forum/subscribe.php', array(
3860         'sesskey' => sesskey(),
3861         'id' => $forum->id,
3862         'd' => $discussionid,
3863         'returnurl' => $returnurl,
3864     ));
3865
3866     if ($includetext) {
3867         $o .= $subscriptionstatus ? get_string('subscribed', 'mod_forum') : get_string('notsubscribed', 'mod_forum');
3868     }
3869
3870     if ($subscriptionstatus) {
3871         $output = $OUTPUT->pix_icon('t/subscribed', get_string('clicktounsubscribe', 'forum'), 'mod_forum');
3872         if ($includetext) {
3873             $output .= get_string('subscribed', 'mod_forum');
3874         }
3875
3876         return html_writer::link($subscriptionlink, $output, array(
3877                 'title' => get_string('clicktounsubscribe', 'forum'),
3878                 'class' => 'discussiontoggle iconsmall',
3879                 'data-forumid' => $forum->id,
3880                 'data-discussionid' => $discussionid,
3881                 'data-includetext' => $includetext,
3882             ));
3883
3884     } else {
3885         $output = $OUTPUT->pix_icon('t/unsubscribed', get_string('clicktosubscribe', 'forum'), 'mod_forum');
3886         if ($includetext) {
3887             $output .= get_string('notsubscribed', 'mod_forum');
3888         }
3889
3890         return html_writer::link($subscriptionlink, $output, array(
3891                 'title' => get_string('clicktosubscribe', 'forum'),
3892                 'class' => 'discussiontoggle iconsmall',
3893                 'data-forumid' => $forum->id,
3894                 'data-discussionid' => $discussionid,
3895                 'data-includetext' => $includetext,
3896             ));
3897     }
3898 }
3899
3900 /**
3901  * Return a pair of spans containing classes to allow the subscribe and
3902  * unsubscribe icons to be pre-loaded by a browser.
3903  *
3904  * @return string The generated markup
3905  */
3906 function forum_get_discussion_subscription_icon_preloaders() {
3907     $o = '';
3908     $o .= html_writer::span('&nbsp;', 'preload-subscribe');
3909     $o .= html_writer::span('&nbsp;', 'preload-unsubscribe');
3910     return $o;
3911 }
3912
3913 /**
3914  * Print the drop down that allows the user to select how they want to have
3915  * the discussion displayed.
3916  *
3917  * @param int $id forum id if $forumtype is 'single',
3918  *              discussion id for any other forum type
3919  * @param mixed $mode forum layout mode
3920  * @param string $forumtype optional
3921  */
3922 function forum_print_mode_form($id, $mode, $forumtype='') {
3923     global $OUTPUT;
3924     if ($forumtype == 'single') {
3925         $select = new single_select(new moodle_url("/mod/forum/view.php", array('f'=>$id)), 'mode', forum_get_layout_modes(), $mode, null, "mode");
3926         $select->set_label(get_string('displaymode', 'forum'), array('class' => 'accesshide'));
3927         $select->class = "forummode";
3928     } else {
3929         $select = new single_select(new moodle_url("/mod/forum/discuss.php", array('d'=>$id)), 'mode', forum_get_layout_modes(), $mode, null, "mode");
3930         $select->set_label(get_string('displaymode', 'forum'), array('class' => 'accesshide'));
3931     }
3932     echo $OUTPUT->render($select);
3933 }
3934
3935 /**
3936  * @global object
3937  * @param object $course
3938  * @param string $search
3939  * @return string
3940  */
3941 function forum_search_form($course, $search='') {
3942     global $CFG, $PAGE;
3943     $forumsearch = new \mod_forum\output\quick_search_form($course->id, $search);
3944     $output = $PAGE->get_renderer('mod_forum');
3945     return $output->render($forumsearch);
3946 }
3947
3948
3949 /**
3950  * @global object
3951  * @global object
3952  */
3953 function forum_set_return() {
3954     global $CFG, $SESSION;
3955
3956     if (! isset($SESSION->fromdiscussion)) {
3957         $referer = get_local_referer(false);
3958         // If the referer is NOT a login screen then save it.
3959         if (! strncasecmp("$CFG->wwwroot/login", $referer, 300)) {
3960             $SESSION->fromdiscussion = $referer;
3961         }
3962     }
3963 }
3964
3965
3966 /**
3967  * @global object
3968  * @param string|\moodle_url $default
3969  * @return string
3970  */
3971 function forum_go_back_to($default) {
3972     global $SESSION;
3973
3974     if (!empty($SESSION->fromdiscussion)) {
3975         $returnto = $SESSION->fromdiscussion;
3976         unset($SESSION->fromdiscussion);
3977         return $returnto;
3978     } else {
3979         return $default;
3980     }
3981 }
3982
3983 /**
3984  * Given a discussion object that is being moved to $forumto,
3985  * this function checks all posts in that discussion
3986  * for attachments, and if any are found, these are
3987  * moved to the new forum directory.
3988  *
3989  * @global object
3990  * @param object $discussion
3991  * @param int $forumfrom source forum id
3992  * @param int $forumto target forum id
3993  * @return bool success
3994  */
3995 function forum_move_attachments($discussion, $forumfrom, $forumto) {
3996     global $DB;
3997
3998     $fs = get_file_storage();
3999
4000     $newcm = get_coursemodule_from_instance('forum', $forumto);
4001     $oldcm = get_coursemodule_from_instance('forum', $forumfrom);
4002
4003     $newcontext = context_module::instance($newcm->id);
4004     $oldcontext = context_module::instance($oldcm->id);
4005
4006     // loop through all posts, better not use attachment flag ;-)
4007     if ($posts = $DB->get_records('forum_posts', array('discussion'=>$discussion->id), '', 'id, attachment')) {
4008         foreach ($posts as $post) {
4009             $fs->move_area_files_to_new_context($oldcontext->id,
4010                     $newcontext->id, 'mod_forum', 'post', $post->id);
4011             $attachmentsmoved = $fs->move_area_files_to_new_context($oldcontext->id,
4012                     $newcontext->id, 'mod_forum', 'attachment', $post->id);
4013             if ($attachmentsmoved > 0 && $post->attachment != '1') {
4014                 // Weird - let's fix it
4015                 $post->attachment = '1';
4016                 $DB->update_record('forum_posts', $post);
4017             } else if ($attachmentsmoved == 0 && $post->attachment != '') {
4018                 // Weird - let's fix it
4019                 $post->attachment = '';
4020                 $DB->update_record('forum_posts', $post);
4021             }
4022         }
4023     }
4024
4025     return true;
4026 }
4027
4028 /**
4029  * Returns attachments as formated text/html optionally with separate images
4030  *
4031  * @global object
4032  * @global object
4033  * @global object
4034  * @param object $post
4035  * @param object $cm
4036  * @param string $type html/text/separateimages
4037  * @return mixed string or array of (html text withouth images and image HTML)
4038  */
4039 function forum_print_attachments($post, $cm, $type) {
4040     global $CFG, $DB, $USER, $OUTPUT;
4041
4042     if (empty($post->attachment)) {
4043         return $type !== 'separateimages' ? '' : array('', '');
4044     }
4045
4046     if (!in_array($type, array('separateimages', 'html', 'text'))) {
4047         return $type !== 'separateimages' ? '' : array('', '');
4048     }
4049
4050     if (!$context = context_module::instance($cm->id)) {
4051         return $type !== 'separateimages' ? '' : array('', '');
4052     }
4053     $strattachment = get_string('attachment', 'forum');