| blob | 1fb2a693b03de5efd0491b60eceb615ff37f8540 |
1 <?php
2 /**
3 *
4 *
5 * Created on Oct 19, 2006
6 *
7 * Copyright © 2006 Yuri Astrakhan "<Firstname><Lastname>@gmail.com"
8 *
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License along
20 * with this program; if not, write to the Free Software Foundation, Inc.,
21 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
22 * http://www.gnu.org/copyleft/gpl.html
23 *
24 * @file
25 */
27 /**
28 * A query action to enumerate the recent changes that were done to the wiki.
29 * Various filters are supported.
30 *
31 * @ingroup API
32 */
37 }
39 private $fld_comment = false, $fld_parsedcomment = false, $fld_user = false, $fld_userid = false,
46 /**
47 * Get an array mapping token names to their handler functions.
48 * The prototype for a token function is func($pageid, $title, $rc)
49 * it should return a token or false (permission denied)
50 * @return array array(tokenname => function)
51 */
53 // Don't call the hooks twice
56 }
58 // If we're in JSON callback mode, no tokens can be obtained
61 }
65 );
69 }
71 /**
72 * @param int $pageid
73 * @param Title $title
74 * @param RecentChange|null $rc
75 * @return bool|string
76 */
85 ) {
87 }
90 }
93 // The patrol token is always the same, let's exploit that
98 }
101 }
104 }
106 /**
107 * Sets internal state to include the desired properties in the output.
108 * @param array $prop associative array of properties, only keys are used here
109 */
125 }
129 }
133 }
135 /**
136 * Generates and outputs the result of this query based upon the provided parameters.
137 *
138 * @param ApiPageSet $resultPageSet
139 */
142 /* Get the parameters of the request. */
145 /* Build our basic query. Namely, something along the lines of:
146 * SELECT * FROM recentchanges WHERE rc_timestamp > $start
147 * AND rc_timestamp < $end AND rc_namespace = $namespace
148 */
151 $this->addTimestampWhereRange( 'rc_timestamp', $params['dir'], $params['start'], $params['end'] );
165 );
166 }
172 ) );
181 }
182 }
187 /* Check for conflicting parameters. */
195 ) {
197 }
199 // Check permissions
203 ) {
207 'permissiondenied'
208 );
209 }
210 }
212 /* Add additional conditions to query depending upon parameters. */
224 // See ChangesList:isUnpatrolled
230 }
231 }
233 // Don't throw log entries out the window here
237 );
238 }
242 }
247 }
250 // We don't use the rc_user_text index here because
251 // * it would require us to sort by rc_user_text before rc_timestamp
252 // * the != condition doesn't throw out too many rows anyway
254 }
256 /* Add the fields we're concerned with to our query. */
264 'rc_deleted'
265 ) );
268 /* Determine what properties we need to display. */
272 /* Set up internal members based upon params. */
278 'permissiondenied'
279 );
280 }
282 /* Add fields to our query if they are specified as a needed parameter. */
293 );
296 }
300 $this->addJoinConds( array( 'tag_summary' => array( 'LEFT JOIN', array( 'rc_id=ts_rc_id' ) ) ) );
302 }
309 }
319 }
320 }
324 $this->addJoinConds( array( 'change_tag' => array( 'INNER JOIN', array( 'rc_id=ct_rc_id' ) ) ) );
326 }
328 // Paranoia: avoid brute force searches (bug 17342)
336 }
339 }
340 }
342 // LogPage::DELETED_ACTION hides the affected page, too.
349 }
355 }
356 }
363 /* Perform the actual query. */
370 /* Iterate through the rows, adding data extracted from them to our query result. */
373 // We've reached the one extra which shows that there are
374 // additional pages to be had. Stop here...
377 }
380 /* Extract the data from a single row. */
383 /* Add that row's data to our final output. */
386 }
391 }
394 }
395 }
398 /* Format the result */
402 }
403 }
405 /**
406 * Extracts from a single sql row the data needed to describe one recent change.
407 *
408 * @param mixed $row The row from which to extract the data.
409 * @return array An array mapping strings (descriptors) to their respective string values.
410 * @access public
411 */
413 /* Determine the title of the page that has been changed. */
417 /* Our output data. */
425 /* Create a new entry in the result for the title. */
430 }
433 ) {
436 }
441 }
442 }
443 }
447 }
449 /* Add user data and 'anon' flag, if user is anonymous. */
454 }
458 }
462 }
466 }
467 }
468 }
470 /* Add flags, such as new, minor, bot. */
474 }
477 }
480 }
481 }
483 /* Add sizes of each revision. (Only available on 1.10+) */
487 }
489 /* Add the timestamp. */
492 }
494 /* Add edit summary / log summary. */
499 }
503 }
507 }
508 }
509 }
514 }
515 }
517 /* Add the patrolled flag */
520 }
524 }
530 }
543 );
544 }
545 }
554 }
555 }
561 }
567 }
568 }
569 }
580 }
581 }
582 }
586 }
589 }
596 }
597 }
598 }
601 }
604 }
606 // formatComment() calls wfMessage() among other things
608 }
611 }
617 ),
620 ),
625 'older'
626 )
627 ),
631 ),
634 ),
637 ),
657 )
658 ),
662 ),
676 'unpatrolled'
677 )
678 ),
685 ),
692 'log'
693 )
694 ),
697 );
698 }
726 ),
731 ),
737 );
738 }
750 'move over redirect'
751 )
752 )
753 ),
760 ),
764 )
765 ),
771 ),
775 ),
779 ),
784 ),
788 ),
791 ),
796 )
797 ),
802 )
803 ),
806 ),
810 ),
815 ),
819 ),
823 )
824 ),
829 ),
833 ),
834 ),
835 );
840 }
844 }
852 ),
853 array( 'code' => 'user-excludeuser', 'info' => 'user and excludeuser cannot be used together' ),
854 ) );
855 }
859 'api.php?action=query&list=recentchanges'
860 );
861 }
865 }
866 }