MDL-42599 forum rss: Update the sql statements to return all user name fields.
[moodle.git] / mod / forum / rsslib.php
1 <?php
3 // This file is part of Moodle - http://moodle.org/
4 //
5 // Moodle is free software: you can redistribute it and/or modify
6 // it under the terms of the GNU General Public License as published by
7 // the Free Software Foundation, either version 3 of the License, or
8 // (at your option) any later version.
9 //
10 // Moodle is distributed in the hope that it will be useful,
11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 // GNU General Public License for more details.
14 //
15 // You should have received a copy of the GNU General Public License
16 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
18 /**
19  * This file adds support to rss feeds generation
20  *
21  * @package mod_forum
22  * @category rss
23  * @copyright 2001 Eloy Lafuente (stronk7) http://contiento.com
24  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
25  */
27 /* Include the core RSS lib */
28 require_once($CFG->libdir.'/rsslib.php');
30 /**
31  * Returns the path to the cached rss feed contents. Creates/updates the cache if necessary.
32  * @param stdClass $context the context
33  * @param array    $args    the arguments received in the url
34  * @return string the full path to the cached RSS feed directory. Null if there is a problem.
35  */
36 function forum_rss_get_feed($context, $args) {
37     global $CFG, $DB, $USER;
39     $status = true;
41     //are RSS feeds enabled?
42     if (empty($CFG->forum_enablerssfeeds)) {
43         debugging('DISABLED (module configuration)');
44         return null;
45     }
47     $forumid  = clean_param($args[3], PARAM_INT);
48     $cm = get_coursemodule_from_instance('forum', $forumid, 0, false, MUST_EXIST);
49     $modcontext = context_module::instance($cm->id);
51     //context id from db should match the submitted one
52     if ($context->id != $modcontext->id || !has_capability('mod/forum:viewdiscussion', $modcontext)) {
53         return null;
54     }
56     $forum = $DB->get_record('forum', array('id' => $forumid), '*', MUST_EXIST);
57     if (!rss_enabled_for_mod('forum', $forum)) {
58         return null;
59     }
61     //the sql that will retreive the data for the feed and be hashed to get the cache filename
62     list($sql, $params) = forum_rss_get_sql($forum, $cm);
64     // Hash the sql to get the cache file name.
65     $filename = rss_get_file_name($forum, $sql, $params);
66     $cachedfilepath = rss_get_file_full_name('mod_forum', $filename);
68     //Is the cache out of date?
69     $cachedfilelastmodified = 0;
70     if (file_exists($cachedfilepath)) {
71         $cachedfilelastmodified = filemtime($cachedfilepath);
72     }
73     // Used to determine if we need to generate a new RSS feed.
74     $dontrecheckcutoff = time() - 60; // Sixty seconds ago.
76     // If it hasn't been generated we need to create it.
77     // Otherwise, if it has been > 60 seconds since we last updated, check for new items.
78     if (($cachedfilelastmodified == 0) || (($dontrecheckcutoff > $cachedfilelastmodified) &&
79         forum_rss_newstuff($forum, $cm, $cachedfilelastmodified))) {
80         // Need to regenerate the cached version.
81         $result = forum_rss_feed_contents($forum, $sql, $params, $modcontext);
82         $status = rss_save_file('mod_forum', $filename, $result);
83     }
85     //return the path to the cached version
86     return $cachedfilepath;
87 }
89 /**
90  * Given a forum object, deletes all cached RSS files associated with it.
91  *
92  * @param stdClass $forum
93  */
94 function forum_rss_delete_file($forum) {
95     rss_delete_file('mod_forum', $forum);
96 }
98 ///////////////////////////////////////////////////////
99 //Utility functions
101 /**
102  * If there is new stuff in the forum since $time this returns true
103  * Otherwise it returns false.
104  *
105  * @param stdClass $forum the forum object
106  * @param stdClass $cm    Course Module object
107  * @param int      $time  check for items since this epoch timestamp
108  * @return bool True for new items
109  */
110 function forum_rss_newstuff($forum, $cm, $time) {
111     global $DB;
113     list($sql, $params) = forum_rss_get_sql($forum, $cm, $time);
115     return $DB->record_exists_sql($sql, $params);
118 /**
119  * Determines which type of SQL query is required, one for posts or one for discussions, and returns the appropriate query
120  *
121  * @param stdClass $forum the forum object
122  * @param stdClass $cm    Course Module object
123  * @param int      $time  check for items since this epoch timestamp
124  * @return string the SQL query to be used to get the Discussion/Post details from the forum table of the database
125  */
126 function forum_rss_get_sql($forum, $cm, $time=0) {
127     if ($forum->rsstype == 1) { // Discussion RSS
128         return forum_rss_feed_discussions_sql($forum, $cm, $time);
129     } else { // Post RSS
130         return forum_rss_feed_posts_sql($forum, $cm, $time);
131     }
134 /**
135  * Generates the SQL query used to get the Discussion details from the forum table of the database
136  *
137  * @param stdClass $forum     the forum object
138  * @param stdClass $cm        Course Module object
139  * @param int      $newsince  check for items since this epoch timestamp
140  * @return string the SQL query to be used to get the Discussion details from the forum table of the database
141  */
142 function forum_rss_feed_discussions_sql($forum, $cm, $newsince=0) {
143     global $CFG, $DB, $USER;
145     $timelimit = '';
147     $modcontext = null;
149     $now = round(time(), -2);
150     $params = array();
152     $modcontext = context_module::instance($cm->id);
154     if (!empty($CFG->forum_enabletimedposts)) { /// Users must fulfill timed posts
155         if (!has_capability('mod/forum:viewhiddentimedposts', $modcontext)) {
156             $timelimit = " AND ((d.timestart <= :now1 AND (d.timeend = 0 OR d.timeend > :now2))";
157             $params['now1'] = $now;
158             $params['now2'] = $now;
159             if (isloggedin()) {
160                 $timelimit .= " OR d.userid = :userid";
161                 $params['userid'] = $USER->id;
162             }
163             $timelimit .= ")";
164         }
165     }
167     // Do we only want new posts?
168     if ($newsince) {
169         $params['newsince'] = $newsince;
170         $newsince = " AND p.modified > :newsince";
171     } else {
172         $newsince = '';
173     }
175     // Get group enforcing SQL.
176     $groupmode = groups_get_activity_groupmode($cm);
177     $currentgroup = groups_get_activity_group($cm);
178     list($groupselect, $groupparams) = forum_rss_get_group_sql($cm, $groupmode, $currentgroup, $modcontext);
180     // Add the groupparams to the params array.
181     $params = array_merge($params, $groupparams);
183     $forumsort = "d.timemodified DESC";
184     $postdata = "p.id AS postid, p.subject, p.created as postcreated, p.modified, p.discussion, p.userid, p.message as postmessage, p.messageformat AS postformat, p.messagetrust AS posttrust";
185     $userpicturefields = user_picture::fields('u', null, 'userid');
187     $sql = "SELECT $postdata, d.id as discussionid, d.name as discussionname, d.timemodified, d.usermodified, d.groupid,
188                    d.timestart, d.timeend, $userpicturefields
189               FROM {forum_discussions} d
190                    JOIN {forum_posts} p ON p.discussion = d.id
191                    JOIN {user} u ON p.userid = u.id
192              WHERE d.forum = {$forum->id} AND p.parent = 0
193                    $timelimit $groupselect $newsince
194           ORDER BY $forumsort";
195     return array($sql, $params);
198 /**
199  * Generates the SQL query used to get the Post details from the forum table of the database
200  *
201  * @param stdClass $forum     the forum object
202  * @param stdClass $cm        Course Module object
203  * @param int      $newsince  check for items since this epoch timestamp
204  * @return string the SQL query to be used to get the Post details from the forum table of the database
205  */
206 function forum_rss_feed_posts_sql($forum, $cm, $newsince=0) {
207     $modcontext = context_module::instance($cm->id);
209     // Get group enforcement SQL.
210     $groupmode = groups_get_activity_groupmode($cm);
211     $currentgroup = groups_get_activity_group($cm);
212     $params = array();
214     list($groupselect, $groupparams) = forum_rss_get_group_sql($cm, $groupmode, $currentgroup, $modcontext);
216     // Add the groupparams to the params array.
217     $params = array_merge($params, $groupparams);
219     // Do we only want new posts?
220     if ($newsince) {
221         $params['newsince'] = $newsince;
222         $newsince = " AND p.modified > :newsince";
223     } else {
224         $newsince = '';
225     }
227     $usernamefields = get_all_user_name_fields(true, 'u');
228     $sql = "SELECT p.id AS postid,
229                  d.id AS discussionid,
230                  d.name AS discussionname,
231                  u.id AS userid,
232                  $usernamefields,
233                  p.subject AS postsubject,
234                  p.message AS postmessage,
235                  p.created AS postcreated,
236                  p.messageformat AS postformat,
237                  p.messagetrust AS posttrust
238             FROM {forum_discussions} d,
239                {forum_posts} p,
240                {user} u
241             WHERE d.forum = {$forum->id} AND
242                 p.discussion = d.id AND
243                 u.id = p.userid $newsince
244                 $groupselect
245             ORDER BY p.created desc";
247     return array($sql, $params);
250 /**
251  * Retrieve the correct SQL snippet for group-only forums
252  *
253  * @param stdClass $cm           Course Module object
254  * @param int      $groupmode    the mode in which the forum's groups are operating
255  * @param bool     $currentgroup true if the user is from the a group enabled on the forum
256  * @param stdClass $modcontext   The context instance of the forum module
257  * @return string SQL Query for group details of the forum
258  */
259 function forum_rss_get_group_sql($cm, $groupmode, $currentgroup, $modcontext=null) {
260     $groupselect = '';
261     $params = array();
263     if ($groupmode) {
264         if ($groupmode == VISIBLEGROUPS or has_capability('moodle/site:accessallgroups', $modcontext)) {
265             if ($currentgroup) {
266                 $groupselect = "AND (d.groupid = :groupid OR d.groupid = -1)";
267                 $params['groupid'] = $currentgroup;
268             }
269         } else {
270             // Separate groups without access all.
271             if ($currentgroup) {
272                 $groupselect = "AND (d.groupid = :groupid OR d.groupid = -1)";
273                 $params['groupid'] = $currentgroup;
274             } else {
275                 $groupselect = "AND d.groupid = -1";
276             }
277         }
278     }
280     return array($groupselect, $params);
283 /**
284  * This function return the XML rss contents about the forum
285  * It returns false if something is wrong
286  *
287  * @param stdClass $forum the forum object
288  * @param string $sql the SQL used to retrieve the contents from the database
289  * @param array $params the SQL parameters used
290  * @param object $context the context this forum relates to
291  * @return bool|string false if the contents is empty, otherwise the contents of the feed is returned
292  *
293  * @Todo MDL-31129 implement post attachment handling
294  */
296 function forum_rss_feed_contents($forum, $sql, $params, $context) {
297     global $CFG, $DB, $USER;
299     $status = true;
301     $recs = $DB->get_recordset_sql($sql, $params, 0, $forum->rssarticles);
303     //set a flag. Are we displaying discussions or posts?
304     $isdiscussion = true;
305     if (!empty($forum->rsstype) && $forum->rsstype!=1) {
306         $isdiscussion = false;
307     }
309     if (!$cm = get_coursemodule_from_instance('forum', $forum->id, $forum->course)) {
310         print_error('invalidcoursemodule');
311     }
313     $formatoptions = new stdClass();
314     $items = array();
315     foreach ($recs as $rec) {
316             $item = new stdClass();
318             if ($isdiscussion && !forum_user_can_see_discussion($forum, $rec->discussionid, $context)) {
319                 // This is a discussion which the user has no permission to view
320                 $item->title = get_string('forumsubjecthidden', 'forum');
321                 $message = get_string('forumbodyhidden', 'forum');
322                 $item->author = get_string('forumauthorhidden', 'forum');
323             } else if (!$isdiscussion && !forum_user_can_see_post($forum, $rec->discussionid, $rec->postid, $USER, $cm)) {
324                 // This is a post which the user has no permission to view
325                 $item->title = get_string('forumsubjecthidden', 'forum');
326                 $message = get_string('forumbodyhidden', 'forum');
327                 $item->author = get_string('forumauthorhidden', 'forum');
328             } else {
329                 // The user must have permission to view
330                 if ($isdiscussion && !empty($rec->discussionname)) {
331                     $item->title = format_string($rec->discussionname);
332                 } else if (!empty($rec->postsubject)) {
333                     $item->title = format_string($rec->postsubject);
334                 } else {
335                     //we should have an item title by now but if we dont somehow then substitute something somewhat meaningful
336                     $item->title = format_string($forum->name.' '.userdate($rec->postcreated,get_string('strftimedatetimeshort', 'langconfig')));
337                 }
338                 $item->author = fullname($rec);
339                 $message = file_rewrite_pluginfile_urls($rec->postmessage, 'pluginfile.php', $context->id,
340                         'mod_forum', 'post', $rec->postid);
341                 $formatoptions->trusted = $rec->posttrust;
342             }
344             if ($isdiscussion) {
345                 $item->link = $CFG->wwwroot."/mod/forum/discuss.php?d=".$rec->discussionid;
346             } else {
347                 $item->link = $CFG->wwwroot."/mod/forum/discuss.php?d=".$rec->discussionid."&parent=".$rec->postid;
348             }
350             $formatoptions->trusted = $rec->posttrust;
351             $item->description = format_text($message, $rec->postformat, $formatoptions, $forum->course);
353             //TODO: MDL-31129 implement post attachment handling
354             /*if (!$isdiscussion) {
355                 $post_file_area_name = str_replace('//', '/', "$forum->course/$CFG->moddata/forum/$forum->id/$rec->postid");
356                 $post_files = get_directory_list("$CFG->dataroot/$post_file_area_name");
358                 if (!empty($post_files)) {
359                     $item->attachments = array();
360                 }
361             }*/
362             $item->pubdate = $rec->postcreated;
364             $items[] = $item;
365         }
366     $recs->close();
368     // Create the RSS header.
369     $header = rss_standard_header(strip_tags(format_string($forum->name,true)),
370                                   $CFG->wwwroot."/mod/forum/view.php?f=".$forum->id,
371                                   format_string($forum->intro,true)); // TODO: fix format
372     // Now all the RSS items, if there are any.
373     $articles = '';
374     if (!empty($items)) {
375         $articles = rss_add_items($items);
376     }
377     // Create the RSS footer.
378     $footer = rss_standard_footer();
380     return $header . $articles . $footer;