| blob | cf9072cf339cf622964cf154588693be3819d428 |
1 <?php
2 /**
3 * File for articles
4 */
6 /**
7 * Class representing a MediaWiki article and history.
8 *
9 * See design.txt for an overview.
10 * Note: edit user interface and cache support functions have been
11 * moved to separate EditPage and HTMLFileCache classes.
12 *
13 */
15 /**@{{
16 * @private
17 */
37 /**@}}*/
39 /**
40 * Constants used by internal components to get rollback results
41 */
48 const ALREADY_ROLLED = 6; // Someone else already rolled this back. $from and $summary will be set
51 /**
52 * Constructor and clear the article
53 * @param $title Reference to a Title object.
54 * @param $oldId Integer revision ID, null to fetch from request, zero for current
55 */
60 }
62 /**
63 * Tell the page view functions that this view was redirected
64 * from another page on the wiki.
65 * @param $from Title object.
66 */
69 }
71 /**
72 * @return mixed false, Title of in-wiki target, or string with URL
73 */
78 # process if title object is valid and not special:userlogout
82 // Offsite wikis need an HTTP redirect.
83 //
84 // This can be hard to reverse and may produce loops,
85 // so they may be disabled in the site configuration.
89 }
92 // Gotta handle redirects to special pages differently:
93 // Fill the HTTP response "Location" header and ignore
94 // the rest of the page we're on.
95 //
96 // This can be hard to reverse, so they may be disabled.
99 // rolleyes
102 }
103 }
105 }
106 }
108 // No or invalid redirect
110 }
112 /**
113 * get the title object of the article
114 */
117 }
119 /**
120 * Clear the object
121 * @private
122 */
138 }
140 /**
141 * Note that getContent/loadContent do not follow redirects anymore.
142 * If you need to fetch redirectable content easily, try
143 * the shortcut in Article::followContent()
144 * FIXME
145 * @todo There are still side-effects in this!
146 * In general, you should use the Revision class, not Article,
147 * to fetch text for purposes other than page views.
148 *
149 * @return Return the text of this revision
150 */
164 }
171 }
172 }
174 /**
175 * This function returns the text of a section, specified by a number ($section).
176 * A section is text under a heading like == Heading == or \<h1\>Heading\</h1\>, or
177 * the first section before any such heading (section 0).
178 *
179 * If a section contains subsections, these are also returned.
180 *
181 * @param $text String: text to look in
182 * @param $section Integer: section number
183 * @return string text of the requested section
184 * @deprecated
185 */
189 }
191 /**
192 * @return int The oldid of the article that is to be shown, 0 for the
193 * current revision
194 */
198 }
200 }
202 /**
203 * Sets $this->mRedirectUrl to a correct URL if the query parameters are incorrect
204 *
205 * @return int The old id for the request
206 */
219 }
225 # TODO
226 }
227 }
228 # unused:
229 # $lastid = $oldid;
230 }
234 }
236 }
238 /**
239 * Load the revision (including text) into this object
240 */
244 # Query variables :P
247 # Pre-fill content with error message so that if something
248 # fails we'll have something telling us what we intended.
251 }
254 /**
255 * Fetch a page record with the given conditions
256 * @param Database $dbr
257 * @param array $conditions
258 * @private
259 */
273 );
279 __METHOD__
280 );
283 }
285 /**
286 * @param Database $dbr
287 * @param Title $title
288 */
293 }
295 /**
296 * @param Database $dbr
297 * @param int $id
298 */
301 }
303 /**
304 * Set the general counter, title etc data loaded from
305 * some source.
306 *
307 * @param object $data
308 * @private
309 */
314 }
322 # Old-fashioned restrictions.
332 }
334 }
337 }
339 /**
340 * Get text of an article from database
341 * Does *NOT* follow redirects.
342 * @param int $oldid 0 for whatever the latest revision is
343 * @return string
344 */
348 }
352 # Pre-fill content with error message so that if something
353 # fails we'll have something telling us what we intended.
357 }
365 }
370 }
377 wfDebug( __METHOD__." failed to find page data for title " . $this->mTitle->getPrefixedText() . "\n" );
379 }
381 }
386 }
387 }
389 // FIXME: Horrible, horrible! This content-loading interface just plain sucks.
390 // We should instead work with the Revision object when we need it...
392 //$this->mContent = $revision->getText();
406 }
408 /**
409 * Read/write accessor to select FOR UPDATE
410 *
411 * @param $x Mixed: FIXME
412 */
415 }
417 /**
418 * Get the database which should be used for reads
419 *
420 * @return Database
421 */
424 }
426 /**
427 * Get options for all SELECT statements
428 *
429 * @param $options Array: an optional options array which'll be appended to
430 * the default
431 * @return Array: options
432 */
439 }
440 }
442 }
444 /**
445 * @return int Page ID
446 */
452 }
453 }
455 /**
456 * @return bool Whether or not the page exists in the database
457 */
460 }
462 /**
463 * @return int The view count for the page
464 */
474 }
475 }
477 }
479 /**
480 * Determine whether a page would be suitable for being counted as an
481 * article in the site_stats table based on the title & its content
482 *
483 * @param $text String: text to analyze
484 * @return bool
485 */
490 return
494 }
496 /**
497 * Tests if the article text represents a redirect
498 *
499 * @param $text String: FIXME
500 * @return bool
501 */
508 }
510 }
512 /**
513 * Returns true if the currently-referenced revision is the current edit
514 * to this page (and it exists).
515 * @return bool
516 */
518 # If no oldid, this is the current version.
525 }
527 /**
528 * Loads everything except the text
529 * This isn't necessary for all uses, so it's only done if needed.
530 * @private
531 */
536 # New or non-existent articles have no user information
548 }
549 }
552 // Check if the field has been filled by ParserCache::get()
555 }
557 }
562 }
567 }
572 }
577 }
582 }
584 /**
585 * @todo Document, fixme $offset never used.
586 * @param $limit Integer: default 0.
587 * @param $offset Integer: default 0.
588 */
590 # XXX: this is expensive; cache this info somewhere.
603 GROUP BY rev_user, rev_user_text, user_real_name
613 }
617 }
619 /**
620 * This is the default action of the script: just view the page of
621 * the given title.
622 */
634 # Get variables from query string
637 # getOldID may want us to redirect somewhere else
642 }
652 # Discourage indexing of printable versions, but encourage following
658 # Honour customised robot policies for this namespace
661 # Default to encourage indexing and following links
663 }
666 # If we got diff and oldid in the query, we want to see a
667 # diff page instead of the article.
673 // DifferenceEngine directly fetched the revision:
677 // Needed to get the page's current revision
680 # Run view updates for current revision only
682 }
685 }
694 # tell wgOut that output is taken care of
699 }
700 }
702 # Should the parser cache be used?
712 }
716 // This is an internally redirected page view.
717 // We'll need a backlink to the source page for navigation.
724 // Set the fragment if one was specified in the redirect
728 }
730 }
732 // This is an externally redirected view, from some other wiki.
733 // If it was reported from a trusted site, supply a backlink.
741 }
742 }
748 // Ensure that UI elements requiring revision ID have
749 // the correct version information.
752 }
753 }
757 # Failed to load, replace text with error message
764 }
765 }
767 # Another whitelist check in case oldid is altering the title
772 }
774 # We're looking at an old revision
779 // FIXME: This would be a nice place to load the 'no such page' text.
789 // and we are allowed to see...
790 }
791 }
792 }
794 }
795 }
799 // Pages containing custom CSS or JavaScript get special treatment
803 // Give hooks a chance to customise the output
805 // Wrap the whole lot in a <pre> and don't parse
811 }
813 }
816 # Display redirect
819 # Don't overwrite the subtitle if this was an old revision
822 }
831 # Display content and save to parser cache
834 # Display content, don't attempt to save to parser cache
835 # Don't show section-edit links on old revisions... this way lies madness.
838 }
839 # Display content and don't save to parser cache
840 # With timing hack -- TS 2006-07-26
845 # Timing hack
849 }
853 }
855 }
856 }
857 /* title may have been set from the cache */
861 }
863 # check if we're displaying a [[User talk:x.x.x.x]] anonymous talk page
867 }
869 # If we have been passed an &rcid= parameter, we want to give the user a
870 # chance to mark this new article as patrolled.
877 ) .
878 '</div>'
879 );
880 }
882 # Trackbacks
888 }
898 );
910 }
917 }
919 }
927 }
932 {
935 }
941 }
948 }
950 /**
951 * Handle action=purge
952 */
959 }
972 }
973 }
975 /**
976 * Perform the actions of a page purging
977 */
980 // Invalidate the cache
984 // Commit the transaction before the purge is sent
988 // Send purge
991 }
993 }
995 /**
996 * Insert a new empty page record for this article.
997 * This *must* be followed up by creating a revision
998 * and running $this->updateToLatest( $rev_id );
999 * or else the record will be left in a funky state.
1000 * Best if all done inside a transaction.
1001 *
1002 * @param Database $dbw
1003 * @return int The newly created page_id key
1004 * @private
1005 */
1029 }
1031 /**
1032 * Update the page record to point to a newly saved revision.
1033 *
1034 * @param Database $dbw
1035 * @param Revision $revision For ID number, and text used to set
1036 length and redirect status fields
1037 * @param int $lastRevision If given, will not overwrite the page field
1038 * when different from the currently set value.
1039 * Giving 0 indicates the new page flag should
1040 * be set on.
1041 * @param bool $lastRevIsRedirect If given, will optimize adding and
1042 * removing rows in redirect table.
1043 * @return bool true on success, false on failure
1044 * @private
1045 */
1046 function updateRevisionOn( &$dbw, $revision, $lastRevision = null, $lastRevIsRedirect = null ) {
1054 # An extra check against threads stepping on each other
1056 }
1065 ),
1067 __METHOD__ );
1072 // FIXME: Should the result from updateRedirectOn() be returned instead?
1074 }
1078 }
1080 /**
1081 * Add row to the redirect table if this is a redirect, remove otherwise.
1082 *
1083 * @param Database $dbw
1084 * @param $redirectTitle a title object pointing to the redirect target,
1085 * or NULL if this is not a redirect
1086 * @param bool $lastRevIsRedirect If given, will optimize adding and
1087 * removing rows in redirect table.
1088 * @return bool true on success, false on failure
1089 * @private
1090 */
1093 // Always update redirects (target link might have changed)
1094 // Update/Insert if we don't know if the last revision was a redirect or not
1095 // Delete if changing from redirect to non-redirect
1103 // This title is a redirect, Add/Update row in the redirect table
1108 );
1112 // This is not a redirect, remove row from redirect table
1115 }
1119 }
1122 }
1124 /**
1125 * If the given revision is newer than the currently set page_latest,
1126 * update the page record. Otherwise, do nothing.
1127 *
1128 * @param Database $dbw
1129 * @param Revision $revision
1130 */
1140 __METHOD__ );
1145 }
1149 # No or missing previous revision; mark the page as new
1152 }
1157 }
1159 /**
1160 * @return string Complete article text, or null if error
1161 */
1166 // Whole-page edit; let the text through unmolested.
1173 }
1178 }
1182 # Inserting a new section
1188 # Replacing an existing section; roll out the big guns
1191 }
1193 }
1197 }
1199 /**
1200 * @deprecated use Article::doEdit()
1201 */
1202 function insertNewArticle( $text, $summary, $isminor, $watchthis, $suppressRC=false, $comment=false ) {
1207 # If this is a comment, add the summary as headline
1210 }
1220 }
1226 }
1227 }
1229 }
1231 /**
1232 * @deprecated use Article::doEdit()
1233 */
1234 function updateArticle( $text, $summary, $minor, $watchthis, $forceBot = false, $sectionanchor = '' ) {
1247 }
1253 }
1254 }
1260 }
1262 }
1264 /**
1265 * Article::doEdit()
1266 *
1267 * Change an existing article or create a new article. Updates RC and all necessary caches,
1268 * optionally via the deferred update array.
1269 *
1270 * $wgUser must be set before calling this function.
1271 *
1272 * @param string $text New text
1273 * @param string $summary Edit summary
1274 * @param integer $flags bitfield:
1275 * EDIT_NEW
1276 * Article is known or assumed to be non-existent, create a new one
1277 * EDIT_UPDATE
1278 * Article is known or assumed to be pre-existing, update it
1279 * EDIT_MINOR
1280 * Mark this edit minor, if the user is allowed to do so
1281 * EDIT_SUPPRESS_RC
1282 * Do not log the change in recentchanges
1283 * EDIT_FORCE_BOT
1284 * Mark the edit a "bot" edit regardless of user rights
1285 * EDIT_DEFER_UPDATES
1286 * Defer some of the updates until the end of index.php
1287 * EDIT_AUTOSUMMARY
1288 * Fill in blank summaries with generated text where possible
1289 *
1290 * If neither EDIT_NEW nor EDIT_UPDATE is specified, the status of the article will be detected.
1291 * If EDIT_UPDATE is specified and the article doesn't exist, the function will return false. If
1292 * EDIT_NEW is specified and the article does exist, a duplicate key error will cause an exception
1293 * to be thrown from the Database. These two conditions are also possible with auto-detection due
1294 * to MediaWiki's performance-optimised locking strategy.
1295 *
1296 * @return bool success
1297 */
1310 }
1311 }
1316 {
1320 }
1322 # Silently ignore EDIT_MINOR if not allowed
1329 # Provide autosummaries if one is not provided.
1340 # Update article, but only if changed.
1342 # Make sure the revision is either completely inserted or not inserted at all
1345 }
1359 # Article gone missing
1363 }
1370 ) );
1375 # Update page
1379 /* Belated edit conflict! Run away!! */
1383 # Update recentchanges
1389 # Mark as patrolled if the user can do so
1393 }
1394 }
1397 }
1400 // Keep the same revision ID, but do some updates on it
1402 // Update page_touched, this is usually implicit in the page update
1403 // Other cache updates are done in onArticleEdit()
1405 }
1409 }
1412 # Invalidate cache of this article and all pages using this article
1413 # as a template. Partly deferred.
1416 # Update links tables, site stats, etc.
1419 }
1421 # Create new article
1423 # Set statistics members
1424 # We work out if it's countable after PST to avoid counter drift
1425 # when articles are created with {{subst:}}
1431 # Add the page record; stake our claim on this title!
1432 # This will fail with a database query exception if the article already exists
1435 # Save the revision text...
1441 ) );
1446 # Update the page record with revision data
1452 # Mark as patrolled if the user can
1456 }
1457 }
1461 # Update links, etc.
1464 # Clear caches
1469 }
1473 }
1478 }
1482 }
1484 /**
1485 * @deprecated wrapper for doRedirect
1486 */
1489 }
1491 /**
1492 * Output a redirect back to the article.
1493 * This is typically used after an edit.
1494 *
1495 * @param boolean $noRedir Add redirect=no
1496 * @param string $sectionAnchor section to redirect to, including "#"
1497 */
1506 }
1508 }
1510 /**
1511 * Mark this particular edit/page as patrolled
1512 */
1517 # Check patrol config options
1522 }
1524 # If we haven't been given an rc_id value, we can't do anything
1528 {
1531 }
1536 }
1541 }
1543 # Check permissions
1547 {
1550 }
1552 # Handle the 'MarkPatrolled' hook
1555 }
1557 #It would be nice to see where the user had actually come from, but for now just guess
1561 # If it's left up to us, check that the user is allowed to patrol this edit
1562 # If the user has the "autopatrol" right, then we'll assume there are no
1563 # other conditions stopping them doing so
1566 # Graceful error handling, as we've done before here...
1567 # (If the recent change doesn't exist, then it doesn't matter whether
1568 # the user is allowed to patrol it or not; nothing is going to happen
1570 # The user made this edit, and can't patrol it
1571 # Tell them so, and then back off
1576 }
1577 }
1579 # Mark the edit as patrolled
1584 # Inform the user
1588 }
1590 /**
1591 * User-interface handler for the "watch" action
1592 */
1601 }
1605 }
1614 }
1617 }
1619 /**
1620 * Add this page to $wgUser's watchlist
1621 * @return bool true on successful watch operation
1622 */
1627 }
1633 }
1636 }
1638 /**
1639 * User interface handler for the "unwatch" action.
1640 */
1648 }
1652 }
1661 }
1664 }
1666 /**
1667 * Stop watching a page
1668 * @return bool true on successful unwatch
1669 */
1674 }
1680 }
1683 }
1685 /**
1686 * action=protect handler
1687 */
1691 }
1693 /**
1694 * action=unprotect handler (alias)
1695 */
1698 }
1700 /**
1701 * Update the article's restriction field, and leave a log entry.
1702 *
1703 * @param array $limit set of restriction keys
1704 * @param string $reason
1705 * @return bool true on success
1706 */
1713 }
1717 }
1719 // Take this opportunity to purge out expired restrictions
1722 # FIXME: Same limitations as described in ProtectionForm.php (line 37);
1723 # we expect a single selection, but the schema allows otherwise.
1736 # If nothing's changed, do nothing
1747 $expiry_description = ' (' . wfMsgForContent( 'protect-expiring', $wgContLang->timeanddate( $expiry ) ).')';
1748 }
1750 # Prepare a null revision to be added to the history
1756 }
1757 $comment = $wgContLang->ucfirst( wfMsgForContent( $comment_type, $this->mTitle->getPrefixedText() ) );
1760 # Check if the group level required to edit also can protect pages
1761 # Otherwise, people who cannot normally protect can "protect" pages via transclusion
1762 $cascade = ( $cascade && isset($wgGroupPermissions[$restrictions]['protect']) && $wgGroupPermissions[$restrictions]['protect'] );
1763 }
1768 }
1782 # Update restrictions table
1792 }
1793 }
1795 # Update page record
1804 );
1807 # Update the protection log
1811 $log->addEntry( $modified ? 'modify' : 'protect', $this->mTitle, trim( $reason . " [$updated]$cascade_description$expiry_description" ) );
1814 }
1820 }
1822 /**
1823 * Take an array of page restrictions and flatten it to a string
1824 * suitable for insertion into the page_restrictions field.
1825 * @param array $limit
1826 * @return string
1827 * @private
1828 */
1832 }
1838 }
1839 }
1841 }
1843 /*
1844 * UI entry point for page deletion
1845 */
1852 # This code desperately needs to be totally rewritten
1854 # Check permissions
1858 {
1861 }
1865 # Better double-check that it hasn't been deleted yet!
1872 }
1880 }
1882 }
1884 # determine whether this page has earlier revisions
1885 # and insert a warning if it does
1891 $wgOut->addHTML( '<strong>' . wfMsg( 'historywarning' ) . ' ' . $skin->historyLink() . '</strong>' );
1892 }
1894 # If a single user is responsible for all revisions, find out who they are
1896 // Query bailed out, too many revisions to find out if they're all the same
1904 }
1905 }
1906 }
1907 # Fetch article text
1911 # if this is a mini-text, we can paste part of it into the deletion reason
1914 #if this is empty, an earlier revision may contain "useful" text
1921 }
1922 }
1926 # this should not happen, since it is not possible to store an empty, new
1927 # page. Let's insert a standard text in case it does, though
1930 }
1933 # comment field=255, let's grep the first 150 to have some user
1934 # space left
1938 # let's strip out newlines
1946 }
1949 }
1950 }
1951 }
1954 }
1956 /**
1957 * Get the last N authors
1958 * @param int $num Number of revisions to get
1959 * @param string $revLatest The latest rev_id, selected from the master (optional)
1960 * @return array Array of authors, duplicates not removed
1961 */
1965 // First try the slave
1966 // If that doesn't have the latest revision, try the master
1975 'rev_page = page_id'
1979 ) )
1980 );
1984 }
1991 }
1997 }
2000 }
2002 /**
2003 * Output deletion confirmation dialog
2004 */
2020 $watch = Xml::checkLabel( wfMsg( 'watchthis' ), 'wpWatch', 'wpWatch', $wgUser->getBoolOption( 'watchdeletion' ) || $this->mTitle->userIsWatching(), array( 'tabindex' => '2' ) );
2024 <table border='0'>
2025 <tr>
2026 <td align='right'>
2028 </td>
2029 <td align='left'>
2030 <input type='text' size='60' name='wpReason' id='wpReason' value=\"" . htmlspecialchars( $reason ) . "\" tabindex=\"1\" />
2031 </td>
2032 </tr>
2033 <tr>
2034 <td> </td>
2036 </tr>
2037 <tr>
2038 <td> </td>
2039 <td>
2041 </td>
2042 </tr>
2043 </table>
2050 }
2053 /**
2054 * Show relevant lines from the deletion log
2055 */
2064 }
2067 /**
2068 * Perform a deletion and output success or failure messages
2069 */
2089 }
2090 }
2091 }
2093 /**
2094 * Back-end article deletion
2095 * Deletes the article with database consistency, writes logs, purges caches
2096 * Returns success
2097 */
2111 }
2116 // For now, shunt the revision data into the archive table.
2117 // Text is *not* removed from the text table; bulk storage
2118 // is left intact to avoid breaking block-compression or
2119 // immutable storage schemes.
2120 //
2121 // For backwards compatibility, note that some older archive
2122 // table entries will have ar_text and ar_flags fields still.
2123 //
2124 // In the future, we may keep revisions and mark them with
2125 // the rev_deleted field, which is reserved for this purpose.
2143 'page_id = rev_page'
2144 ), __METHOD__
2145 );
2147 # Delete restrictions for it
2150 # Now that it's safely backed up, delete it
2153 # If using cascading deletes, we can skip some explicit deletes
2161 # Delete outgoing links
2169 }
2171 # If using cleanup triggers, we can skip some manual deletes
2174 # Clean up recentchanges entries...
2176 }
2178 # Clear caches
2181 # Log the deletion
2185 # Clear the cached article id so the interface doesn't act like we exist
2189 }
2191 /**
2192 * Roll back the most recent consecutive set of edits to a page
2193 * from the same user; fails if there are no eligible edits to
2194 * roll back to, e.g. user is the sole contributor
2195 *
2196 * @param string $fromP - Name of the user whose edits to rollback.
2197 * @param string $summary - Custom summary. Set to default summary if empty.
2198 * @param string $token - Rollback token.
2199 * @param bool $bot - If true, mark all reverted edits as bot.
2200 *
2201 * @param array $resultDetails contains result-specific dict of additional values
2202 * ALREADY_ROLLED : 'current' (rev)
2203 * SUCCESS : 'summary' (str), 'current' (rev), 'target' (rev)
2204 *
2205 * @return self::SUCCESS on succes, self::* on failure
2206 */
2211 # Just in case it's being called from elsewhere
2216 }
2219 }
2223 }
2230 # Get the last editor
2233 # Something wrong... no page?
2235 }
2241 }
2243 # Get the last edit not by this guy
2255 );
2257 # Something wrong
2259 }
2263 # Mark all reverted edits as bot
2265 }
2267 # Mark all reverted edits as patrolled
2269 }
2277 ), __METHOD__
2278 );
2279 }
2281 # Get the edit summary
2286 # Save
2298 );
2300 }
2302 /**
2303 * User interface for rollback operations
2304 */
2310 # Skip the permissions-checking in doRollback() itself, by checking permissions here.
2318 }
2325 $details
2326 );
2353 )
2354 );
2358 }
2373 $wgOut->addHtml( wfMsgExt( 'rollback-success', array( 'parse', 'replaceafter' ), $old, $new ) );
2378 }
2380 }
2383 /**
2384 * Do standard deferred updates after page view
2385 * @private
2386 */
2396 }
2397 }
2399 # Update newtalk / watchlist notification status
2402 }
2404 /**
2405 * Do standard deferred updates after page edit.
2406 * Update links tables, site stats, search index and message cache.
2407 * Every 100th edit, prune the recent changes table.
2408 *
2409 * @private
2410 * @param $text New text of the article
2411 * @param $summary Edit summary
2412 * @param $minoredit Minor edit
2413 * @param $timestamp_of_pagechange Timestamp associated with the page change
2414 * @param $newid rev_id value of the new revision
2415 * @param $changed Whether or not the content actually changed
2416 */
2417 function editUpdates( $text, $summary, $minoredit, $timestamp_of_pagechange, $newid, $changed = true ) {
2422 # Parse the text
2427 # Save it to the parser cache
2431 # Update the links tables
2437 // Flush old entries from the `recentchanges` table; we do this on
2438 // random requests so as to avoid an increase in writes for no good reason
2445 }
2446 }
2455 }
2462 # If this is another user's talk page, update newtalk
2463 # Don't do this if $changed = false otherwise some idiot can null-edit a
2464 # load of user talk pages and piss people off, nor if it's a minor edit
2465 # by a properly-flagged bot.
2466 if( $this->mTitle->getNamespace() == NS_USER_TALK && $shortTitle != $wgUser->getTitleKey() && $changed
2471 // An anonymous user
2474 }
2477 }
2478 }
2479 }
2483 }
2486 }
2488 /**
2489 * Perform article updates on a special page creation.
2490 *
2491 * @param Revision $rev
2492 *
2493 * @todo This is a shitty interface function. Kill it and replace the
2494 * other shitty functions like editUpdates and such so it's not needed
2495 * anymore.
2496 */
2502 }
2504 /**
2505 * Generate the navigation links when browsing through an article revisions
2506 * It shows the information as:
2507 * Revision as of \<date\>; view current revision
2508 * \<- Previous version | Next Version -\>
2509 *
2510 * @private
2511 * @param string $oldid Revision ID of this article revision
2512 */
2518 }
2533 ? $sk->makeKnownLinkObj( $this->mTitle, wfMsg( 'previousrevision' ), 'direction=prev&oldid='.$oldid )
2540 : $sk->makeKnownLinkObj( $this->mTitle, wfMsg( 'nextrevision' ), 'direction=next&oldid='.$oldid );
2550 ? 'revision-info-current'
2553 $r = "\n\t\t\t\t<div id=\"mw-{$infomsg}\">" . wfMsg( $infomsg, $td, $userlinks ) . "</div>\n" .
2554 "\n\t\t\t\t<div id=\"mw-revision-nav\">" . wfMsg( 'revision-nav', $prevdiff, $prevlink, $lnk, $curdiff, $nextlink, $nextdiff ) . "</div>\n\t\t\t";
2556 }
2558 /**
2559 * This function is called right before saving the wikitext,
2560 * so we can do things like signatures and links-in-context.
2561 *
2562 * @param string $text
2563 */
2566 return $wgParser->preSaveTransform( $text, $this->mTitle, $wgUser, ParserOptions::newFromUser( $wgUser ) );
2567 }
2569 /* Caching functions */
2571 /**
2572 * checkLastModified returns true if it has taken care of all
2573 * output to the client that is necessary for this request.
2574 * (that is, it has sent a cached version of the page)
2575 */
2581 }
2593 }
2596 }
2597 }
2599 /**
2600 * Check if the page can be cached
2601 * @return bool
2602 */
2612 //check for non-standard user language; this covers uselang,
2613 //and extensions for auto-detecting user language.
2633 //extension may have reason to disable file caching on some pages.
2635 }
2638 }
2640 /**
2641 * Loads page_touched and returns a value indicating if it should be used
2642 *
2643 */
2647 }
2649 }
2651 /**
2652 * Get the page_touched field
2653 */
2655 # Ensure that page data has been loaded
2658 }
2660 }
2662 /**
2663 * Get the page_latest field
2664 */
2668 }
2670 }
2672 /**
2673 * Edit an article without doing all that other stuff
2674 * The article must already exist; link tables etc
2675 * are not updated, caches are not flushed.
2676 *
2677 * @param string $text text submitted
2678 * @param string $comment comment submitted
2679 * @param bool $minor whereas it's a minor modification
2680 */
2691 ) );
2697 }
2699 /**
2700 * Used to increment the view counter
2701 *
2702 * @static
2703 * @param integer $id article id
2704 */
2717 }
2719 # Not important enough to warrant an error page in case of failure
2726 # Most of the time (or on SQL errors), skip row count check
2729 }
2749 }
2753 }
2758 }
2760 }
2762 /**#@+
2763 * The onArticle*() functions are supposed to be a kind of hooks
2764 * which should be called whenever any of the specified actions
2765 * are done.
2766 *
2767 * This is a good place to put code to clear caches, for instance.
2768 *
2769 * This is called on page move and undelete, as well as edit
2770 * @static
2771 * @param $title_obj a title object
2772 */
2775 # The talk page isn't in the regular link tables, so we need to update manually:
2780 }
2786 }
2794 # File cache
2798 }
2802 }
2803 }
2805 /**
2806 * Purge caches on page update etc
2807 */
2811 // Invalidate caches of articles which include this page
2815 # Purge squid for this page only
2818 # Clear file cache
2822 }
2823 }
2825 /**#@-*/
2827 /**
2828 * Info about this page
2829 * Called for ?action=info when $wgAllowPageInfo is on.
2830 *
2831 * @public
2832 */
2839 }
2850 // This doesn't quite make sense; the user is asking for
2851 // information about the _page_, not the message... -- RC
2855 ? 'noarticletext'
2858 }
2869 __METHOD__,
2875 $wgOut->addHTML( "<ul><li>" . wfMsg("numwatchers", $wgLang->formatNum( $numwatchers ) ) . '</li>' );
2876 $wgOut->addHTML( "<li>" . wfMsg('numedits', $wgLang->formatNum( $pageInfo['edits'] ) ) . '</li>');
2878 $wgOut->addHTML( '<li>' . wfMsg("numtalkedits", $wgLang->formatNum( $talkInfo['edits'] ) ) . '</li>');
2879 }
2880 $wgOut->addHTML( '<li>' . wfMsg("numauthors", $wgLang->formatNum( $pageInfo['authors'] ) ) . '</li>' );
2882 $wgOut->addHTML( '<li>' . wfMsg('numtalkauthors', $wgLang->formatNum( $talkInfo['authors'] ) ) . '</li>' );
2883 }
2886 }
2887 }
2889 /**
2890 * Return the total number of edits and number of unique editors
2891 * on a given page. If page does not exist, returns false.
2892 *
2893 * @param Title $title
2894 * @return array
2895 * @private
2896 */
2901 }
2911 __METHOD__,
2918 __METHOD__,
2922 }
2924 /**
2925 * Return a list of templates used by this article.
2926 * Uses the templatelinks table
2927 *
2928 * @return array Array of Title objects
2929 */
2935 }
2946 }
2947 }
2948 }
2951 }
2953 /**
2954 * Return an auto-generated summary if the text provided is a redirect.
2955 *
2956 * @param string $text The wikitext to check
2957 * @return string '' or an appropriate summary
2958 */
2963 else
2965 }
2967 /**
2968 * Return an auto-generated summary if the new text is much shorter than
2969 * the old text.
2970 *
2971 * @param string $oldtext The previous text of the page
2972 * @param string $text The submitted text of the page
2973 * @return string An appropriate autosummary, or an empty string.
2974 */
2979 #Removing more than 90% of the article
2981 $truncatedtext = $wgContLang->truncate($text, max(0, 200 - strlen(wfMsgForContent('autosumm-replace'))), '...');
2985 }
2986 }
2988 /**
2989 * Return an applicable autosummary if one exists for the given edit.
2990 * @param string $oldtext The previous text of the page.
2991 * @param string $newtext The submitted text of the page.
2992 * @param bitmask $flags A bitmask of flags submitted for the edit.
2993 * @return string An appropriate autosummary, or an empty string.
2994 */
2997 # This code is UGLY UGLY UGLY.
2998 # Somebody PLEASE come up with a more elegant way to do it.
3000 #Redirect autosummaries
3006 #Blanking autosummaries
3013 #New page autosummaries
3015 #If they're making a new article, give its text, truncated, in the summary.
3022 }
3028 }
3030 /**
3031 * Add the primary page-view wikitext to the output buffer
3032 * Saves the text into the parser cache if possible.
3033 * Updates templatelinks if it is out of date.
3034 *
3035 * @param string $text
3036 * @param bool $cache
3037 */
3049 }
3052 // templatelinks table may have become out of sync,
3053 // especially if using variable-based transclusions.
3054 // For paranoia, check if things have changed and if
3055 // so apply updates to the database. This will ensure
3056 // that cascaded protections apply as soon as the changes
3057 // are visible.
3059 # Get templates from templatelinks
3076 }
3077 }
3078 }
3080 # Get templates from parser output.
3086 }
3088 # Get the diff
3092 # Whee, link updates time.
3101 }
3102 }
3105 }
3107 }