| blob | 57e4887ef00cc8364690a596dcb2e17a85138280 |
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 * Constructor and clear the article
41 * @param $title Reference to a Title object.
42 * @param $oldId Integer revision ID, null to fetch from request, zero for current
43 */
48 }
50 /**
51 * Tell the page view functions that this view was redirected
52 * from another page on the wiki.
53 * @param $from Title object.
54 */
57 }
59 /**
60 * @return mixed false, Title of in-wiki target, or string with URL
61 */
66 # process if title object is valid and not special:userlogout
70 // Offsite wikis need an HTTP redirect.
71 //
72 // This can be hard to reverse and may produce loops,
73 // so they may be disabled in the site configuration.
77 }
80 // Gotta handle redirects to special pages differently:
81 // Fill the HTTP response "Location" header and ignore
82 // the rest of the page we're on.
83 //
84 // This can be hard to reverse, so they may be disabled.
87 // rolleyes
90 }
91 }
93 }
94 }
96 // No or invalid redirect
98 }
100 /**
101 * get the title object of the article
102 */
105 }
107 /**
108 * Clear the object
109 * @private
110 */
127 }
129 /**
130 * Note that getContent/loadContent do not follow redirects anymore.
131 * If you need to fetch redirectable content easily, try
132 * the shortcut in Article::followContent()
133 * FIXME
134 * @todo There are still side-effects in this!
135 * In general, you should use the Revision class, not Article,
136 * to fetch text for purposes other than page views.
137 *
138 * @return Return the text of this revision
139 */
154 }
161 }
162 }
164 /**
165 * This function returns the text of a section, specified by a number ($section).
166 * A section is text under a heading like == Heading == or \<h1\>Heading\</h1\>, or
167 * the first section before any such heading (section 0).
168 *
169 * If a section contains subsections, these are also returned.
170 *
171 * @param $text String: text to look in
172 * @param $section Integer: section number
173 * @return string text of the requested section
174 * @deprecated
175 */
179 }
181 /**
182 * @return int The oldid of the article that is to be shown, 0 for the
183 * current revision
184 */
188 }
190 }
192 /**
193 * Sets $this->mRedirectUrl to a correct URL if the query parameters are incorrect
194 *
195 * @return int The old id for the request
196 */
209 }
215 # TODO
216 }
217 }
218 # unused:
219 # $lastid = $oldid;
220 }
224 }
226 }
228 /**
229 * Load the revision (including text) into this object
230 */
234 # Query variables :P
237 # Pre-fill content with error message so that if something
238 # fails we'll have something telling us what we intended.
241 }
244 /**
245 * Fetch a page record with the given conditions
246 * @param Database $dbr
247 * @param array $conditions
248 * @private
249 */
263 );
269 __METHOD__
270 );
273 }
275 /**
276 * @param Database $dbr
277 * @param Title $title
278 */
283 }
285 /**
286 * @param Database $dbr
287 * @param int $id
288 */
291 }
293 /**
294 * Set the general counter, title etc data loaded from
295 * some source.
296 *
297 * @param object $data
298 * @private
299 */
304 }
312 # Old-fashioned restrictions.
322 }
324 }
327 }
329 /**
330 * Get text of an article from database
331 * Does *NOT* follow redirects.
332 * @param int $oldid 0 for whatever the latest revision is
333 * @return string
334 */
338 }
342 # Pre-fill content with error message so that if something
343 # fails we'll have something telling us what we intended.
347 }
355 }
360 }
367 wfDebug( __METHOD__." failed to find page data for title " . $this->mTitle->getPrefixedText() . "\n" );
369 }
371 }
376 }
377 }
379 // FIXME: Horrible, horrible! This content-loading interface just plain sucks.
380 // We should instead work with the Revision object when we need it...
395 }
397 /**
398 * Read/write accessor to select FOR UPDATE
399 *
400 * @param $x Mixed: FIXME
401 */
404 }
406 /**
407 * Get the database which should be used for reads
408 *
409 * @return Database
410 */
413 }
415 /**
416 * Get options for all SELECT statements
417 *
418 * @param $options Array: an optional options array which'll be appended to
419 * the default
420 * @return Array: options
421 */
428 }
429 }
431 }
433 /**
434 * @return int Page ID
435 */
441 }
442 }
444 /**
445 * @return bool Whether or not the page exists in the database
446 */
449 }
451 /**
452 * @return int The view count for the page
453 */
463 }
464 }
466 }
468 /**
469 * Determine whether a page would be suitable for being counted as an
470 * article in the site_stats table based on the title & its content
471 *
472 * @param $text String: text to analyze
473 * @return bool
474 */
479 return
483 }
485 /**
486 * Tests if the article text represents a redirect
487 *
488 * @param $text String: FIXME
489 * @return bool
490 */
497 }
499 }
501 /**
502 * Returns true if the currently-referenced revision is the current edit
503 * to this page (and it exists).
504 * @return bool
505 */
507 # If no oldid, this is the current version.
514 }
516 /**
517 * Loads everything except the text
518 * This isn't necessary for all uses, so it's only done if needed.
519 * @private
520 */
525 # New or non-existent articles have no user information
537 }
538 }
541 // Check if the field has been filled by ParserCache::get()
544 }
546 }
551 }
556 }
561 }
566 }
571 }
573 /**
574 * @todo Document, fixme $offset never used.
575 * @param $limit Integer: default 0.
576 * @param $offset Integer: default 0.
577 */
579 # XXX: this is expensive; cache this info somewhere.
592 GROUP BY rev_user, rev_user_text, user_real_name
602 }
606 }
608 /**
609 * This is the default action of the script: just view the page of
610 * the given title.
611 */
624 # Get variables from query string
627 # getOldID may want us to redirect somewhere else
632 }
642 # Discourage indexing of printable versions, but encourage following
648 # Honour customised robot policies for this namespace
652 }
655 # If we got diff and oldid in the query, we want to see a
656 # diff page instead of the article.
662 // DifferenceEngine directly fetched the revision:
666 // Needed to get the page's current revision
669 # Run view updates for current revision only
671 }
674 }
683 # tell wgOut that output is taken care of
688 }
689 }
691 # Should the parser cache be used?
701 }
705 // This is an internally redirected page view.
706 // We'll need a backlink to the source page for navigation.
713 // Set the fragment if one was specified in the redirect
717 }
719 }
721 // This is an externally redirected view, from some other wiki.
722 // If it was reported from a trusted site, supply a backlink.
730 }
731 }
737 // Ensure that UI elements requiring revision ID have
738 // the correct version information.
741 }
742 }
746 # Failed to load, replace text with error message
753 }
754 }
756 # Another whitelist check in case oldid is altering the title
761 }
763 # We're looking at an old revision
768 // FIXME: This would be a nice place to load the 'no such page' text.
778 // and we are allowed to see...
779 }
780 }
781 }
783 }
784 }
788 // Pages containing custom CSS or JavaScript get special treatment
792 // Give hooks a chance to customise the output
794 // Wrap the whole lot in a <pre> and don't parse
800 }
802 }
805 # Display redirect
808 # Don't overwrite the subtitle if this was an old revision
811 }
820 # Display content and save to parser cache
823 # Display content, don't attempt to save to parser cache
824 # Don't show section-edit links on old revisions... this way lies madness.
827 }
828 # Display content and don't save to parser cache
829 # With timing hack -- TS 2006-07-26
834 # Timing hack
838 }
842 }
844 }
845 }
846 /* title may have been set from the cache */
850 }
852 # check if we're displaying a [[User talk:x.x.x.x]] anonymous talk page
856 }
858 # If we have been passed an &rcid= parameter, we want to give the user a
859 # chance to mark this new article as patrolled.
860 if( !is_null( $rcid ) && $rcid != 0 && $wgUser->isAllowed( 'patrol' ) && $this->mTitle->exists() ) {
866 ) .
867 '</div>'
868 );
869 }
871 # Trackbacks
877 }
887 );
899 }
907 }
909 }
917 }
922 {
925 }
931 }
938 }
940 /**
941 * Handle action=purge
942 */
949 }
962 }
963 }
965 /**
966 * Perform the actions of a page purging
967 */
970 // Invalidate the cache
974 // Commit the transaction before the purge is sent
978 // Send purge
981 }
988 }
990 }
992 }
994 /**
995 * Insert a new empty page record for this article.
996 * This *must* be followed up by creating a revision
997 * and running $this->updateToLatest( $rev_id );
998 * or else the record will be left in a funky state.
999 * Best if all done inside a transaction.
1000 *
1001 * @param Database $dbw
1002 * @return int The newly created page_id key
1003 * @private
1004 */
1028 }
1030 /**
1031 * Update the page record to point to a newly saved revision.
1032 *
1033 * @param Database $dbw
1034 * @param Revision $revision For ID number, and text used to set
1035 length and redirect status fields
1036 * @param int $lastRevision If given, will not overwrite the page field
1037 * when different from the currently set value.
1038 * Giving 0 indicates the new page flag should
1039 * be set on.
1040 * @param bool $lastRevIsRedirect If given, will optimize adding and
1041 * removing rows in redirect table.
1042 * @return bool true on success, false on failure
1043 * @private
1044 */
1045 function updateRevisionOn( &$dbw, $revision, $lastRevision = null, $lastRevIsRedirect = null ) {
1053 # An extra check against threads stepping on each other
1055 }
1064 ),
1066 __METHOD__ );
1072 }
1076 }
1078 /**
1079 * Add row to the redirect table if this is a redirect, remove otherwise.
1080 *
1081 * @param Database $dbw
1082 * @param $redirectTitle a title object pointing to the redirect target,
1083 * or NULL if this is not a redirect
1084 * @param bool $lastRevIsRedirect If given, will optimize adding and
1085 * removing rows in redirect table.
1086 * @return bool true on success, false on failure
1087 * @private
1088 */
1091 // Always update redirects (target link might have changed)
1092 // Update/Insert if we don't know if the last revision was a redirect or not
1093 // Delete if changing from redirect to non-redirect
1101 // This title is a redirect, Add/Update row in the redirect table
1106 );
1110 // This is not a redirect, remove row from redirect table
1113 }
1117 }
1120 }
1122 /**
1123 * If the given revision is newer than the currently set page_latest,
1124 * update the page record. Otherwise, do nothing.
1125 *
1126 * @param Database $dbw
1127 * @param Revision $revision
1128 */
1138 __METHOD__ );
1143 }
1147 # No or missing previous revision; mark the page as new
1150 }
1155 }
1157 /**
1158 * @return string Complete article text, or null if error
1159 */
1164 // Whole-page edit; let the text through unmolested.
1171 }
1176 }
1180 # Inserting a new section
1186 # Replacing an existing section; roll out the big guns
1189 }
1191 }
1195 }
1197 /**
1198 * @deprecated use Article::doEdit()
1199 */
1200 function insertNewArticle( $text, $summary, $isminor, $watchthis, $suppressRC=false, $comment=false, $bot=false ) {
1206 # If this is a comment, add the summary as headline
1209 }
1219 }
1225 }
1226 }
1228 }
1230 /**
1231 * @deprecated use Article::doEdit()
1232 */
1233 function updateArticle( $text, $summary, $minor, $watchthis, $forceBot = false, $sectionanchor = '' ) {
1246 }
1252 }
1253 }
1259 }
1261 }
1263 /**
1264 * Article::doEdit()
1265 *
1266 * Change an existing article or create a new article. Updates RC and all necessary caches,
1267 * optionally via the deferred update array.
1268 *
1269 * $wgUser must be set before calling this function.
1270 *
1271 * @param string $text New text
1272 * @param string $summary Edit summary
1273 * @param integer $flags bitfield:
1274 * EDIT_NEW
1275 * Article is known or assumed to be non-existent, create a new one
1276 * EDIT_UPDATE
1277 * Article is known or assumed to be pre-existing, update it
1278 * EDIT_MINOR
1279 * Mark this edit minor, if the user is allowed to do so
1280 * EDIT_SUPPRESS_RC
1281 * Do not log the change in recentchanges
1282 * EDIT_FORCE_BOT
1283 * Mark the edit a "bot" edit regardless of user rights
1284 * EDIT_DEFER_UPDATES
1285 * Defer some of the updates until the end of index.php
1286 * EDIT_AUTOSUMMARY
1287 * Fill in blank summaries with generated text where possible
1288 *
1289 * If neither EDIT_NEW nor EDIT_UPDATE is specified, the status of the article will be detected.
1290 * If EDIT_UPDATE is specified and the article doesn't exist, the function will return false. If
1291 * EDIT_NEW is specified and the article does exist, a duplicate key error will cause an exception
1292 * to be thrown from the Database. These two conditions are also possible with auto-detection due
1293 * to MediaWiki's performance-optimised locking strategy.
1294 *
1295 * @return bool success
1296 */
1309 }
1310 }
1315 {
1319 }
1321 # Silently ignore EDIT_MINOR if not allowed
1328 # 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 }
1361 # Article gone missing
1365 }
1373 ) );
1378 # Update page
1382 /* Belated edit conflict! Run away!! */
1386 # Update recentchanges
1392 # Mark as patrolled if the user can do so
1396 }
1397 }
1400 }
1403 // Keep the same revision ID, but do some updates on it
1405 // Update page_touched, this is usually implicit in the page update
1406 // Other cache updates are done in onArticleEdit()
1408 }
1412 }
1415 # Invalidate cache of this article and all pages using this article
1416 # as a template. Partly deferred.
1419 # Update links tables, site stats, etc.
1421 }
1423 # Create new article
1425 # Set statistics members
1426 # We work out if it's countable after PST to avoid counter drift
1427 # when articles are created with {{subst:}}
1433 # Add the page record; stake our claim on this title!
1434 # This will fail with a database query exception if the article already exists
1437 # Save the revision text...
1443 ) );
1448 # Update the page record with revision data
1454 # Mark as patrolled if the user can
1455 if( ($GLOBALS['wgUseRCPatrol'] || $GLOBALS['wgUseNPPatrol']) && $wgUser->isAllowed( 'autopatrol' ) ) {
1458 }
1459 }
1463 # Update links, etc.
1466 # Clear caches
1471 }
1475 }
1480 }
1484 }
1486 /**
1487 * @deprecated wrapper for doRedirect
1488 */
1491 }
1493 /**
1494 * Output a redirect back to the article.
1495 * This is typically used after an edit.
1496 *
1497 * @param boolean $noRedir Add redirect=no
1498 * @param string $sectionAnchor section to redirect to, including "#"
1499 * @param string $extraq, extra query params
1500 */
1509 }
1511 }
1513 /**
1514 * Mark this particular edit/page as patrolled
1515 */
1520 # Check patrol config options
1525 }
1527 # If we haven't been given an rc_id value, we can't do anything
1531 {
1534 }
1537 // Only new pages can be patrolled if the general patrolling is off....???
1538 // @fixme -- is this necessary? Shouldn't we only bother controlling the
1539 // front end here?
1542 }
1544 # Check permissions
1548 {
1551 }
1553 # Handle the 'MarkPatrolled' hook
1556 }
1558 #It would be nice to see where the user had actually come from, but for now just guess
1562 # If it's left up to us, check that the user is allowed to patrol this edit
1563 # If the user has the "autopatrol" right, then we'll assume there are no
1564 # other conditions stopping them doing so
1567 # Graceful error handling, as we've done before here...
1568 # (If the recent change doesn't exist, then it doesn't matter whether
1569 # the user is allowed to patrol it or not; nothing is going to happen
1571 # The user made this edit, and can't patrol it
1572 # Tell them so, and then back off
1577 }
1578 }
1580 # Check that the revision isn't patrolled already
1581 # Prevents duplicate log entries
1583 # Mark the edit as patrolled
1587 }
1589 # Inform the user
1593 }
1595 /**
1596 * User-interface handler for the "watch" action
1597 */
1606 }
1610 }
1617 }
1620 }
1622 /**
1623 * Add this page to $wgUser's watchlist
1624 * @return bool true on successful watch operation
1625 */
1630 }
1636 }
1639 }
1641 /**
1642 * User interface handler for the "unwatch" action.
1643 */
1651 }
1655 }
1662 }
1665 }
1667 /**
1668 * Stop watching a page
1669 * @return bool true on successful unwatch
1670 */
1675 }
1681 }
1684 }
1686 /**
1687 * action=protect handler
1688 */
1692 }
1694 /**
1695 * action=unprotect handler (alias)
1696 */
1699 }
1701 /**
1702 * Update the article's restriction field, and leave a log entry.
1703 *
1704 * @param array $limit set of restriction keys
1705 * @param string $reason
1706 * @return bool true on success
1707 */
1712 if( array() != $this->mTitle->getUserPermissionsErrors( 'protect', $wgUser ) || wfReadOnly() || $id == 0 ) {
1714 }
1718 }
1720 // Take this opportunity to purge out expired restrictions
1723 # FIXME: Same limitations as described in ProtectionForm.php (line 37);
1724 # we expect a single selection, but the schema allows otherwise.
1737 # If nothing's changed, do nothing
1748 $expiry_description = ' (' . wfMsgForContent( 'protect-expiring', $wgContLang->timeanddate( $expiry, false, false ) ).')';
1749 }
1751 # Prepare a null revision to be added to the history
1757 }
1758 $comment = $wgContLang->ucfirst( wfMsgForContent( $comment_type, $this->mTitle->getPrefixedText() ) );
1761 # Check if the group level required to edit also can protect pages
1762 # Otherwise, people who cannot normally protect can "protect" pages via transclusion
1765 }
1770 }
1781 # Update restrictions table
1791 }
1792 }
1794 # Insert a null revision
1798 # Update page record
1807 );
1810 # Update the protection log
1816 $log->addEntry( $modified ? 'modify' : 'protect', $this->mTitle, trim( $reason . " [$updated]$cascade_description$expiry_description" ) );
1819 }
1825 }
1827 /**
1828 * Take an array of page restrictions and flatten it to a string
1829 * suitable for insertion into the page_restrictions field.
1830 * @param array $limit
1831 * @return string
1832 * @private
1833 */
1837 }
1843 }
1844 }
1846 }
1848 /**
1849 * Auto-generates a deletion reason
1850 * @param bool &$hasHistory Whether the page has a history
1851 */
1853 {
1856 // Get the last revision
1860 // Get the article's contents
1863 // If the page is blank, use the text from the previous revision,
1864 // which can only be blank if there's a move/import/protect dummy revision involved
1866 {
1869 {
1872 }
1873 }
1875 // Find out if there was only one contributor
1876 // Only scan the last 20 revisions
1878 $res = $dbw->select('revision', 'rev_user_text', array('rev_page' => $this->getID()), __METHOD__,
1881 // This page has no revisions, which is very weird
1885 else
1889 // Try to find a second contributor
1894 }
1895 }
1898 // Generate the summary with a '$1' placeholder
1900 // The current revision is blank and the one before is also
1901 // blank. It's just not our lucky day
1906 else
1908 }
1910 // Replace newlines with spaces to prevent uglyness
1912 // Calculate the maximum amount of chars to get
1913 // Max content length = max comment length - length of the comment (excl. $1) - '...'
1916 // Remove possible unfinished links
1918 // Now replace the '$1' placeholder
1921 }
1924 /*
1925 * UI entry point for page deletion
1926 */
1939 // Entry from drop down menu + additional comment
1943 }
1944 # Flag to hide all contents of the archived revisions
1947 # This code desperately needs to be totally rewritten
1949 # Read-only check...
1953 }
1955 # Check permissions
1961 }
1965 # Better double-check that it hasn't been deleted yet!
1972 }
1974 # Hack for big sites
1981 }
1989 }
1991 }
1993 // Generate deletion reason
1997 // If the page has a history, insert a warning
2000 $wgOut->addHTML( '<strong>' . wfMsg( 'historywarning' ) . ' ' . $skin->historyLink() . '</strong>' );
2005 }
2006 }
2009 }
2011 /**
2012 * @return bool whether or not the page surpasses $wgDeleteRevisionsLimit revisions
2013 */
2019 }
2021 }
2023 /**
2024 * @return int approximate revision count
2025 */
2028 // For an exact count...
2029 //return $dbr->selectField( 'revision', 'COUNT(*)',
2030 // array( 'rev_page' => $this->getId() ), __METHOD__ );
2033 }
2035 /**
2036 * Get the last N authors
2037 * @param int $num Number of revisions to get
2038 * @param string $revLatest The latest rev_id, selected from the master (optional)
2039 * @return array Array of authors, duplicates not removed
2040 */
2044 // First try the slave
2045 // If that doesn't have the latest revision, try the master
2054 'rev_page = page_id'
2058 ) )
2059 );
2063 }
2070 }
2076 }
2079 }
2081 /**
2082 * Output deletion confirmation dialog
2083 * @param $par string FIXME: do we need this parameter? One Call from Article::delete with '' only.
2084 * @param $reason string Prefilled reason
2085 */
2092 $wgOut->setSubtitle( wfMsg( 'delete-backlink', $wgUser->getSkin()->makeKnownLinkObj( $this->mTitle ) ) );
2098 $suppress .= Xml::checkLabel( wfMsg( 'revdelete-suppress' ), 'wpSuppress', 'wpSuppress', false, array( 'tabindex' => '2' ) );
2102 }
2104 $form = Xml::openElement( 'form', array( 'method' => 'post', 'action' => $this->mTitle->getLocalURL( 'action=delete' . $par ), 'id' => 'deleteconfirm' ) ) .
2111 "</td>
2116 "</td>
2117 </tr>
2121 "</td>
2123 Xml::input( 'wpReason', 60, $reason, array( 'type' => 'text', 'maxlength' => '255', 'tabindex' => '2', 'id' => 'wpReason' ) ) .
2124 "</td>
2125 </tr>
2126 <tr>
2127 <td></td>
2129 Xml::checkLabel( wfMsg( 'watchthis' ), 'wpWatch', 'wpWatch', $wgUser->getBoolOption( 'watchdeletion' ) || $this->mTitle->userIsWatching(), array( 'tabindex' => '3' ) ) .
2130 "</td>
2131 </tr>
2132 $suppress
2133 <tr>
2134 <td></td>
2136 Xml::submitButton( wfMsg( 'deletepage' ), array( 'name' => 'wpConfirmB', 'id' => 'wpConfirmB', 'tabindex' => '4' ) ) .
2137 "</td>
2146 $link = $skin->makeLink ( 'MediaWiki:Deletereason-dropdown', wfMsgHtml( 'delete-edit-reasonlist' ) );
2148 }
2152 }
2155 /**
2156 * Show relevant lines from the deletion log
2157 */
2161 }
2164 /**
2165 * Perform a deletion and output success or failure messages
2166 */
2185 }
2186 }
2187 }
2189 /**
2190 * Back-end article deletion
2191 * Deletes the article with database consistency, writes logs, purges caches
2192 * Returns success
2193 */
2207 }
2212 // Bitfields to further suppress the content
2215 // This should be 15...
2222 }
2224 // For now, shunt the revision data into the archive table.
2225 // Text is *not* removed from the text table; bulk storage
2226 // is left intact to avoid breaking block-compression or
2227 // immutable storage schemes.
2228 //
2229 // For backwards compatibility, note that some older archive
2230 // table entries will have ar_text and ar_flags fields still.
2231 //
2232 // In the future, we may keep revisions and mark them with
2233 // the rev_deleted field, which is reserved for this purpose.
2252 'page_id = rev_page'
2253 ), __METHOD__
2254 );
2256 # Delete restrictions for it
2259 # Fix category table counts
2265 }
2268 # Now that it's safely backed up, delete it
2271 # If using cascading deletes, we can skip some explicit deletes
2278 # Delete outgoing links
2286 }
2288 # If using cleanup triggers, we can skip some manual deletes
2291 # Clean up recentchanges entries...
2293 }
2295 # Clear caches
2298 # Log the deletion, if the page was suppressed, log it at Oversight instead
2303 # Clear the cached article id so the interface doesn't act like we exist
2307 }
2309 /**
2310 * Roll back the most recent consecutive set of edits to a page
2311 * from the same user; fails if there are no eligible edits to
2312 * roll back to, e.g. user is the sole contributor. This function
2313 * performs permissions checks on $wgUser, then calls commitRollback()
2314 * to do the dirty work
2315 *
2316 * @param string $fromP - Name of the user whose edits to rollback.
2317 * @param string $summary - Custom summary. Set to default summary if empty.
2318 * @param string $token - Rollback token.
2319 * @param bool $bot - If true, mark all reverted edits as bot.
2320 *
2321 * @param array $resultDetails contains result-specific array of additional values
2322 * 'alreadyrolled' : 'current' (rev)
2323 * success : 'summary' (str), 'current' (rev), 'target' (rev)
2324 *
2325 * @return array of errors, each error formatted as
2326 * array(messagekey, param1, param2, ...).
2327 * On success, the array is empty. This array can also be passed to
2328 * OutputPage::showPermissionsErrorPage().
2329 */
2334 # Check permissions
2342 }
2343 # If there were errors, bail out now
2348 }
2350 /**
2351 * Backend implementation of doRollback(), please refer there for parameter
2352 * and return value documentation
2353 *
2354 * NOTE: This function does NOT check ANY permissions, it just commits the
2355 * rollback to the DB Therefore, you should only call this function direct-
2356 * ly if you want to use custom permissions checks. If you don't, use
2357 * doRollback() instead.
2358 */
2365 }
2367 # Get the last editor
2370 # Something wrong... no page?
2372 }
2381 ));
2382 }
2384 # Get the last edit not by this guy
2394 );
2396 # No one else ever edited this page
2398 } else if( $s->rev_deleted & REVISION::DELETED_TEXT || $s->rev_deleted & REVISION::DELETED_USER ) {
2399 # Only admins can see this text
2401 }
2405 # Mark all reverted edits as bot
2407 }
2409 # Mark all reverted edits as patrolled
2411 }
2419 ), __METHOD__
2420 );
2421 }
2423 # Generate the edit summary if necessary
2426 {
2432 );
2433 }
2435 # Save
2451 );
2453 }
2455 /**
2456 * User interface for rollback operations
2457 */
2467 $details
2468 );
2473 }
2477 }
2478 if( isset( $result[0][0] ) && ( $result[0][0] == 'alreadyrolled' || $result[0][0] == 'cantrollback' ) ){
2486 $wgOut->addWikiMsgArray( 'editcomment', array( $wgUser->getSkin()->formatComment( $current->getComment() ) ), array( 'replaceafter' ) );
2487 }
2488 }
2490 }
2491 # Display permissions errors before read-only message -- there's no
2492 # point in misleading the user into thinking the inability to rollback
2493 # is only temporary.
2495 # array_diff is completely broken for arrays of arrays, sigh. Re-
2496 # move any 'readonlytext' error manually.
2501 }
2502 }
2505 }
2509 }
2519 $wgOut->addHtml( wfMsgExt( 'rollback-success', array( 'parse', 'replaceafter' ), $old, $new ) );
2521 }
2524 /**
2525 * Do standard deferred updates after page view
2526 * @private
2527 */
2537 }
2538 }
2540 # Update newtalk / watchlist notification status
2543 }
2545 /**
2546 * Prepare text which is about to be saved.
2547 * Returns a stdclass with source, pst and output members
2548 */
2550 if ( $this->mPreparedEdit && $this->mPreparedEdit->newText == $text && $this->mPreparedEdit->revid == $revid) {
2551 // Already prepared
2553 }
2566 }
2568 /**
2569 * Do standard deferred updates after page edit.
2570 * Update links tables, site stats, search index and message cache.
2571 * Every 100th edit, prune the recent changes table.
2572 *
2573 * @private
2574 * @param $text New text of the article
2575 * @param $summary Edit summary
2576 * @param $minoredit Minor edit
2577 * @param $timestamp_of_pagechange Timestamp associated with the page change
2578 * @param $newid rev_id value of the new revision
2579 * @param $changed Whether or not the content actually changed
2580 */
2581 function editUpdates( $text, $summary, $minoredit, $timestamp_of_pagechange, $newid, $changed = true ) {
2586 # Parse the text
2587 # Be careful not to double-PST: $text is usually already PST-ed once
2594 }
2596 # Save it to the parser cache
2600 }
2602 # Update the links tables
2608 // Flush old entries from the `recentchanges` table; we do this on
2609 // random requests so as to avoid an increase in writes for no good reason
2616 }
2617 }
2626 }
2633 # If this is another user's talk page, update newtalk
2634 # Don't do this if $changed = false otherwise some idiot can null-edit a
2635 # load of user talk pages and piss people off, nor if it's a minor edit
2636 # by a properly-flagged bot.
2637 if( $this->mTitle->getNamespace() == NS_USER_TALK && $shortTitle != $wgUser->getTitleKey() && $changed
2642 // An anonymous user
2645 }
2648 }
2649 }
2650 }
2654 }
2657 }
2659 /**
2660 * Perform article updates on a special page creation.
2661 *
2662 * @param Revision $rev
2663 *
2664 * @todo This is a shitty interface function. Kill it and replace the
2665 * other shitty functions like editUpdates and such so it's not needed
2666 * anymore.
2667 */
2673 }
2675 /**
2676 * Generate the navigation links when browsing through an article revisions
2677 * It shows the information as:
2678 * Revision as of \<date\>; view current revision
2679 * \<- Previous version | Next Version -\>
2680 *
2681 * @private
2682 * @param string $oldid Revision ID of this article revision
2683 */
2689 }
2704 ? $sk->makeKnownLinkObj( $this->mTitle, wfMsg( 'previousrevision' ), 'direction=prev&oldid='.$oldid )
2711 : $sk->makeKnownLinkObj( $this->mTitle, wfMsg( 'nextrevision' ), 'direction=next&oldid='.$oldid );
2720 // We don't handle top deleted edits too well
2723 // If revision was hidden from sysops
2730 // Bolden oversighted content
2733 }
2735 }
2736 # Show user links if allowed to see them. Normally they
2737 # are hidden regardless, but since we can already see the text here...
2742 ? 'revision-info-current'
2745 $r = "\n\t\t\t\t<div id=\"mw-{$infomsg}\">" . wfMsg( $infomsg, $td, $userlinks ) . "</div>\n" .
2747 "\n\t\t\t\t<div id=\"mw-revision-nav\">" . $cdel . wfMsg( 'revision-nav', $prevdiff, $prevlink, $lnk, $curdiff, $nextlink, $nextdiff ) . "</div>\n\t\t\t";
2749 }
2751 /**
2752 * This function is called right before saving the wikitext,
2753 * so we can do things like signatures and links-in-context.
2754 *
2755 * @param string $text
2756 */
2759 return $wgParser->preSaveTransform( $text, $this->mTitle, $wgUser, ParserOptions::newFromUser( $wgUser ) );
2760 }
2762 /* Caching functions */
2764 /**
2765 * checkLastModified returns true if it has taken care of all
2766 * output to the client that is necessary for this request.
2767 * (that is, it has sent a cached version of the page)
2768 */
2774 }
2786 }
2789 }
2790 }
2792 /**
2793 * Check if the page can be cached
2794 * @return bool
2795 */
2805 //check for non-standard user language; this covers uselang,
2806 //and extensions for auto-detecting user language.
2826 //extension may have reason to disable file caching on some pages.
2828 }
2831 }
2833 /**
2834 * Loads page_touched and returns a value indicating if it should be used
2835 *
2836 */
2840 }
2842 }
2844 /**
2845 * Get the page_touched field
2846 */
2848 # Ensure that page data has been loaded
2851 }
2853 }
2855 /**
2856 * Get the page_latest field
2857 */
2861 }
2863 }
2865 /**
2866 * Edit an article without doing all that other stuff
2867 * The article must already exist; link tables etc
2868 * are not updated, caches are not flushed.
2869 *
2870 * @param string $text text submitted
2871 * @param string $comment comment submitted
2872 * @param bool $minor whereas it's a minor modification
2873 */
2884 ) );
2890 }
2892 /**
2893 * Used to increment the view counter
2894 *
2895 * @static
2896 * @param integer $id article id
2897 */
2910 }
2912 # Not important enough to warrant an error page in case of failure
2919 # Most of the time (or on SQL errors), skip row count check
2922 }
2942 }
2946 }
2951 }
2953 }
2955 /**#@+
2956 * The onArticle*() functions are supposed to be a kind of hooks
2957 * which should be called whenever any of the specified actions
2958 * are done.
2959 *
2960 * This is a good place to put code to clear caches, for instance.
2961 *
2962 * This is called on page move and undelete, as well as edit
2963 * @static
2964 * @param $title_obj a title object
2965 */
2968 # The talk page isn't in the regular link tables, so we need to update manually:
2973 }
2980 }
2985 // Update existence markers on article/talk tabs...
2990 }
2997 # File cache
3001 }
3005 }
3009 }
3010 }
3012 /**
3013 * Purge caches on page update etc
3014 */
3018 // Invalidate caches of articles which include this page
3021 // Invalidate the caches of all pages which redirect here
3024 # Purge squid for this page only
3027 # Clear file cache
3031 }
3032 }
3034 /**#@-*/
3036 /**
3037 * Overriden by ImagePage class, only present here to avoid a fatal error
3038 * Called for ?action=revert
3039 */
3043 }
3045 /**
3046 * Info about this page
3047 * Called for ?action=info when $wgAllowPageInfo is on.
3048 *
3049 * @public
3050 */
3057 }
3068 // This doesn't quite make sense; the user is asking for
3069 // information about the _page_, not the message... -- RC
3073 ? 'noarticletext'
3076 }
3087 __METHOD__,
3093 $wgOut->addHTML( "<ul><li>" . wfMsg("numwatchers", $wgLang->formatNum( $numwatchers ) ) . '</li>' );
3094 $wgOut->addHTML( "<li>" . wfMsg('numedits', $wgLang->formatNum( $pageInfo['edits'] ) ) . '</li>');
3096 $wgOut->addHTML( '<li>' . wfMsg("numtalkedits", $wgLang->formatNum( $talkInfo['edits'] ) ) . '</li>');
3097 }
3098 $wgOut->addHTML( '<li>' . wfMsg("numauthors", $wgLang->formatNum( $pageInfo['authors'] ) ) . '</li>' );
3100 $wgOut->addHTML( '<li>' . wfMsg('numtalkauthors', $wgLang->formatNum( $talkInfo['authors'] ) ) . '</li>' );
3101 }
3104 }
3105 }
3107 /**
3108 * Return the total number of edits and number of unique editors
3109 * on a given page. If page does not exist, returns false.
3110 *
3111 * @param Title $title
3112 * @return array
3113 * @private
3114 */
3119 }
3129 __METHOD__,
3136 __METHOD__,
3140 }
3142 /**
3143 * Return a list of templates used by this article.
3144 * Uses the templatelinks table
3145 *
3146 * @return array Array of Title objects
3147 */
3153 }
3164 }
3165 }
3166 }
3169 }
3171 /**
3172 * Returns a list of hidden categories this page is a member of.
3173 * Uses the page_props and categorylinks tables.
3174 *
3175 * @return array Array of Title objects
3176 */
3182 }
3194 }
3195 }
3196 }
3199 }
3201 /**
3202 * Return an auto-generated summary if the text provided is a redirect.
3203 *
3204 * @param string $text The wikitext to check
3205 * @return string '' or an appropriate summary
3206 */
3211 else
3213 }
3215 /**
3216 * Return an auto-generated summary if the new text is much shorter than
3217 * the old text.
3218 *
3219 * @param string $oldtext The previous text of the page
3220 * @param string $text The submitted text of the page
3221 * @return string An appropriate autosummary, or an empty string.
3222 */
3227 #Removing more than 90% of the article
3229 $truncatedtext = $wgContLang->truncate($text, max(0, 200 - strlen(wfMsgForContent('autosumm-replace'))), '...');
3233 }
3234 }
3236 /**
3237 * Return an applicable autosummary if one exists for the given edit.
3238 * @param string $oldtext The previous text of the page.
3239 * @param string $newtext The submitted text of the page.
3240 * @param bitmask $flags A bitmask of flags submitted for the edit.
3241 * @return string An appropriate autosummary, or an empty string.
3242 */
3245 # This code is UGLY UGLY UGLY.
3246 # Somebody PLEASE come up with a more elegant way to do it.
3248 #Redirect autosummaries
3254 #Blanking autosummaries
3261 #New page autosummaries
3263 #If they're making a new article, give its text, truncated, in the summary.
3270 }
3276 }
3278 /**
3279 * Add the primary page-view wikitext to the output buffer
3280 * Saves the text into the parser cache if possible.
3281 * Updates templatelinks if it is out of date.
3282 *
3283 * @param string $text
3284 * @param bool $cache
3285 */
3299 }
3302 // templatelinks table may have become out of sync,
3303 // especially if using variable-based transclusions.
3304 // For paranoia, check if things have changed and if
3305 // so apply updates to the database. This will ensure
3306 // that cascaded protections apply as soon as the changes
3307 // are visible.
3309 # Get templates from templatelinks
3326 }
3327 }
3328 }
3330 # Get templates from parser output.
3336 }
3338 # Get the diff
3342 # Whee, link updates time.
3351 }
3352 }
3355 }
3357 /**
3358 * Update all the appropriate counts in the category table, given that
3359 * we've added the categories $added and deleted the categories $deleted.
3360 *
3361 * @param $added array The names of categories that were added
3362 * @param $deleted array The names of categories that were deleted
3363 * @return null
3364 */
3369 # First make sure the rows exist. If one of the "deleted" ones didn't
3370 # exist, we might legitimately not create it, but it's simpler to just
3371 # create it and then give it a negative value, since the value is bogus
3372 # anyway.
3373 #
3374 # Sometimes I wish we had INSERT ... ON DUPLICATE KEY UPDATE.
3377 # Okay, nothing to do
3379 }
3383 }
3394 }
3401 __METHOD__
3402 );
3403 }
3409 __METHOD__
3410 );
3411 }
3412 }
3413 }