| blob | 88a7bfa33f1a253f131ba7f5b8758b6696af7c61 |
1 <?php
2 /**
3 * File for articles
4 * @file
5 */
7 /**
8 * Class representing a MediaWiki article and history.
9 *
10 * See design.txt for an overview.
11 * Note: edit user interface and cache support functions have been
12 * moved to separate EditPage and HTMLFileCache classes.
13 *
14 */
16 /**@{{
17 * @private
18 */
43 /**@}}*/
45 /**
46 * Constructor and clear the article
47 * @param $title Reference to a Title object.
48 * @param $oldId Integer revision ID, null to fetch from request, zero for current
49 */
53 }
55 /**
56 * Constructor from an article article
57 * @param $id The article ID to load
58 */
63 }
65 /**
66 * Tell the page view functions that this view was redirected
67 * from another page on the wiki.
68 * @param $from Title object.
69 */
72 }
74 /**
75 * If this page is a redirect, get its target
76 *
77 * The target will be fetched from the redirect table if possible.
78 * If this page doesn't have an entry there, call insertRedirect()
79 * @return mixed Title object, or null if this page is not a redirect
80 */
87 # Query the redirect table
92 __METHOD__
93 );
98 # This page doesn't have an entry in the redirect table
100 }
102 /**
103 * Insert an entry for this page into the redirect table.
104 *
105 * Don't call this function directly unless you know what you're doing.
106 * @return Title object
107 */
119 }
121 /**
122 * Get the Title object this page redirects to
123 *
124 * @return mixed false, Title of in-wiki target, or string with URL
125 */
129 }
131 /**
132 * Get the Title object this text redirects to
133 *
134 * @return mixed false, Title of in-wiki target, or string with URL
135 */
138 # process if title object is valid and not special:userlogout
142 // Offsite wikis need an HTTP redirect.
143 //
144 // This can be hard to reverse and may produce loops,
145 // so they may be disabled in the site configuration.
149 }
152 // Gotta handle redirects to special pages differently:
153 // Fill the HTTP response "Location" header and ignore
154 // the rest of the page we're on.
155 //
156 // This can be hard to reverse, so they may be disabled.
159 // rolleyes
162 }
163 }
165 }
166 }
167 // No or invalid redirect
169 }
171 /**
172 * get the title object of the article
173 */
176 }
178 /**
179 * Clear the object
180 * @private
181 */
199 }
201 /**
202 * Note that getContent/loadContent do not follow redirects anymore.
203 * If you need to fetch redirectable content easily, try
204 * the shortcut in Article::followContent()
205 * FIXME
206 * @todo There are still side-effects in this!
207 * In general, you should use the Revision class, not Article,
208 * to fetch text for purposes other than page views.
209 *
210 * @return Return the text of this revision
211 */
226 }
233 }
234 }
236 /**
237 * This function returns the text of a section, specified by a number ($section).
238 * A section is text under a heading like == Heading == or \<h1\>Heading\</h1\>, or
239 * the first section before any such heading (section 0).
240 *
241 * If a section contains subsections, these are also returned.
242 *
243 * @param $text String: text to look in
244 * @param $section Integer: section number
245 * @return string text of the requested section
246 * @deprecated
247 */
251 }
253 /**
254 * @return int The oldid of the article that is to be shown, 0 for the
255 * current revision
256 */
260 }
262 }
264 /**
265 * Sets $this->mRedirectUrl to a correct URL if the query parameters are incorrect
266 *
267 * @return int The old id for the request
268 */
281 }
287 # TODO
288 }
289 }
290 # unused:
291 # $lastid = $oldid;
292 }
296 }
298 }
300 /**
301 * Load the revision (including text) into this object
302 */
306 # Query variables :P
309 # Pre-fill content with error message so that if something
310 # fails we'll have something telling us what we intended.
313 }
316 /**
317 * Fetch a page record with the given conditions
318 * @param Database $dbr
319 * @param array $conditions
320 * @private
321 */
335 );
341 __METHOD__
342 );
345 }
347 /**
348 * @param Database $dbr
349 * @param Title $title
350 */
355 }
357 /**
358 * @param Database $dbr
359 * @param int $id
360 */
363 }
365 /**
366 * Set the general counter, title etc data loaded from
367 * some source.
368 *
369 * @param object $data
370 * @private
371 */
376 }
384 # Old-fashioned restrictions.
394 }
396 }
399 }
401 /**
402 * Get text of an article from database
403 * Does *NOT* follow redirects.
404 * @param int $oldid 0 for whatever the latest revision is
405 * @return string
406 */
410 }
414 # Pre-fill content with error message so that if something
415 # fails we'll have something telling us what we intended.
425 }
430 }
437 wfDebug( __METHOD__." failed to find page data for title " . $this->mTitle->getPrefixedText() . "\n" );
439 }
441 }
446 }
447 }
449 // FIXME: Horrible, horrible! This content-loading interface just plain sucks.
450 // We should instead work with the Revision object when we need it...
465 }
467 /**
468 * Read/write accessor to select FOR UPDATE
469 *
470 * @param $x Mixed: FIXME
471 */
474 }
476 /**
477 * Get the database which should be used for reads
478 *
479 * @return Database
480 * @deprecated - just call wfGetDB( DB_MASTER ) instead
481 */
485 }
487 /**
488 * Get options for all SELECT statements
489 *
490 * @param $options Array: an optional options array which'll be appended to
491 * the default
492 * @return Array: options
493 */
500 }
501 }
503 }
505 /**
506 * @return int Page ID
507 */
513 }
514 }
516 /**
517 * @return bool Whether or not the page exists in the database
518 */
521 }
523 /**
524 * @return int The view count for the page
525 */
535 }
536 }
538 }
540 /**
541 * Determine whether a page would be suitable for being counted as an
542 * article in the site_stats table based on the title & its content
543 *
544 * @param $text String: text to analyze
545 * @return bool
546 */
551 return
555 }
557 /**
558 * Tests if the article text represents a redirect
559 *
560 * @param $text String: FIXME
561 * @return bool
562 */
568 // Apparently loadPageData was never called
573 }
575 }
577 /**
578 * Returns true if the currently-referenced revision is the current edit
579 * to this page (and it exists).
580 * @return bool
581 */
583 # If no oldid, this is the current version.
590 }
592 /**
593 * Loads everything except the text
594 * This isn't necessary for all uses, so it's only done if needed.
595 * @private
596 */
601 # New or non-existent articles have no user information
613 }
614 }
617 // Check if the field has been filled by ParserCache::get()
620 }
622 }
627 }
632 }
637 }
642 }
647 }
649 /**
650 * @param $limit Integer: default 0.
651 * @param $offset Integer: default 0.
652 */
654 # XXX: this is expensive; cache this info somewhere.
667 GROUP BY rev_user, rev_user_text, user_real_name
678 }
680 /**
681 * This is the default action of the script: just view the page of
682 * the given title.
683 */
696 # Get variables from query string
699 # getOldID may want us to redirect somewhere else
704 }
714 # Discourage indexing of printable versions, but encourage following
720 # Honour customised robot policies for this namespace
724 }
727 # If we got diff and oldid in the query, we want to see a
728 # diff page instead of the article.
736 // DifferenceEngine directly fetched the revision:
740 // Needed to get the page's current revision
743 # Run view updates for current revision only
745 }
748 }
757 # tell wgOut that output is taken care of
762 }
763 }
765 # Should the parser cache be used?
770 }
774 // This is an internally redirected page view.
775 // We'll need a backlink to the source page for navigation.
781 // Set the fragment if one was specified in the redirect
785 }
787 }
789 // This is an externally redirected view, from some other wiki.
790 // If it was reported from a trusted site, supply a backlink.
797 }
798 }
800 # Optional notices on a per-namespace and per-page basis
806 }
811 }
820 }
821 }
822 } else if ( !wfEmptyMsg( $pageheader_page, wfMsgForContent( $pageheader_page ) ) && !$ignoreheader ) {
824 }
830 // Ensure that UI elements requiring revision ID have
831 // the correct version information.
834 }
835 }
836 # Fetch content and check for errors
838 # If the article does not exist and was deleted, show the log
851 );
860 }
862 }
863 }
865 # Failed to load, replace text with error message
872 }
873 }
875 # Another whitelist check in case oldid is altering the title
881 }
883 # We're looking at an old revision
887 // FIXME: This would be a nice place to load the 'no such page' text.
898 // and we are allowed to see...
899 }
900 }
901 }
902 }
906 // Pages containing custom CSS or JavaScript get special treatment
909 // Give hooks a chance to customise the output
911 // Wrap the whole lot in a <pre> and don't parse
917 }
919 # Don't append the subtitle if this was an old revision
924 # Display content and save to parser cache
927 # Display content, don't attempt to save to parser cache
928 # Don't show section-edit links on old revisions... this way lies madness.
931 }
932 # Display content and don't save to parser cache
933 # With timing hack -- TS 2006-07-26
938 # Timing hack
942 }
946 }
947 }
948 }
949 /* title may have been set from the cache */
954 # For the main page, overwrite the <title> element with the con-
955 # tents of 'pagetitle-view-mainpage' instead of the default (if
956 # that's not empty).
960 }
961 }
963 # check if we're displaying a [[User talk:x.x.x.x]] anonymous talk page
966 }
968 # If we have been passed an &rcid= parameter, we want to give the user a
969 # chance to mark this new article as patrolled.
970 if( !is_null( $rcid ) && $rcid != 0 && $wgUser->isAllowed( 'patrol' ) && $this->mTitle->exists() ) {
976 ) .
977 '</div>'
978 );
979 }
981 # Trackbacks
987 }
989 /*
990 * Should the parser cache be used?
991 */
1001 }
1003 /**
1004 * View redirect
1005 * @param Title $target Title of destination to redirect
1006 * @param Bool $appendSubtitle Object[optional]
1007 * @param Bool $forceKnown Should the image be shown as a bluelink regardless of existence?
1008 */
1012 # Display redirect
1018 }
1022 else
1028 }
1038 );
1050 }
1058 }
1060 }
1068 }
1073 {
1076 }
1082 }
1089 }
1091 /**
1092 * Handle action=purge
1093 */
1101 }
1114 }
1115 }
1117 /**
1118 * Perform the actions of a page purging
1119 */
1122 // Invalidate the cache
1126 // Commit the transaction before the purge is sent
1130 // Send purge
1133 }
1140 }
1142 }
1143 }
1145 /**
1146 * Insert a new empty page record for this article.
1147 * This *must* be followed up by creating a revision
1148 * and running $this->updateToLatest( $rev_id );
1149 * or else the record will be left in a funky state.
1150 * Best if all done inside a transaction.
1151 *
1152 * @param Database $dbw
1153 * @return int The newly created page_id key, or false if the title already existed
1154 * @private
1155 */
1178 }
1181 }
1183 /**
1184 * Update the page record to point to a newly saved revision.
1185 *
1186 * @param Database $dbw
1187 * @param Revision $revision For ID number, and text used to set
1188 length and redirect status fields
1189 * @param int $lastRevision If given, will not overwrite the page field
1190 * when different from the currently set value.
1191 * Giving 0 indicates the new page flag should
1192 * be set on.
1193 * @param bool $lastRevIsRedirect If given, will optimize adding and
1194 * removing rows in redirect table.
1195 * @return bool true on success, false on failure
1196 * @private
1197 */
1198 function updateRevisionOn( &$dbw, $revision, $lastRevision = null, $lastRevIsRedirect = null ) {
1206 # An extra check against threads stepping on each other
1208 }
1217 ),
1219 __METHOD__ );
1225 }
1229 }
1231 /**
1232 * Add row to the redirect table if this is a redirect, remove otherwise.
1233 *
1234 * @param Database $dbw
1235 * @param $redirectTitle a title object pointing to the redirect target,
1236 * or NULL if this is not a redirect
1237 * @param bool $lastRevIsRedirect If given, will optimize adding and
1238 * removing rows in redirect table.
1239 * @return bool true on success, false on failure
1240 * @private
1241 */
1244 // Always update redirects (target link might have changed)
1245 // Update/Insert if we don't know if the last revision was a redirect or not
1246 // Delete if changing from redirect to non-redirect
1254 // This title is a redirect, Add/Update row in the redirect table
1259 );
1263 // This is not a redirect, remove row from redirect table
1266 }
1272 }
1275 }
1277 /**
1278 * If the given revision is newer than the currently set page_latest,
1279 * update the page record. Otherwise, do nothing.
1280 *
1281 * @param Database $dbw
1282 * @param Revision $revision
1283 */
1293 __METHOD__ );
1298 }
1302 # No or missing previous revision; mark the page as new
1305 }
1310 }
1312 /**
1313 * @return string Complete article text, or null if error
1314 */
1319 // Whole-page edit; let the text through unmolested.
1326 }
1331 }
1335 # Inserting a new section
1341 # Replacing an existing section; roll out the big guns
1344 }
1346 }
1350 }
1352 /**
1353 * @deprecated use Article::doEdit()
1354 */
1355 function insertNewArticle( $text, $summary, $isminor, $watchthis, $suppressRC=false, $comment=false, $bot=false ) {
1361 # If this is a comment, add the summary as headline
1364 }
1374 }
1380 }
1381 }
1383 }
1385 /**
1386 * @deprecated use Article::doEdit()
1387 */
1388 function updateArticle( $text, $summary, $minor, $watchthis, $forceBot = false, $sectionanchor = '' ) {
1396 }
1404 }
1410 }
1411 }
1418 }
1420 /**
1421 * Article::doEdit()
1422 *
1423 * Change an existing article or create a new article. Updates RC and all necessary caches,
1424 * optionally via the deferred update array.
1425 *
1426 * $wgUser must be set before calling this function.
1427 *
1428 * @param string $text New text
1429 * @param string $summary Edit summary
1430 * @param integer $flags bitfield:
1431 * EDIT_NEW
1432 * Article is known or assumed to be non-existent, create a new one
1433 * EDIT_UPDATE
1434 * Article is known or assumed to be pre-existing, update it
1435 * EDIT_MINOR
1436 * Mark this edit minor, if the user is allowed to do so
1437 * EDIT_SUPPRESS_RC
1438 * Do not log the change in recentchanges
1439 * EDIT_FORCE_BOT
1440 * Mark the edit a "bot" edit regardless of user rights
1441 * EDIT_DEFER_UPDATES
1442 * Defer some of the updates until the end of index.php
1443 * EDIT_AUTOSUMMARY
1444 * Fill in blank summaries with generated text where possible
1445 *
1446 * If neither EDIT_NEW nor EDIT_UPDATE is specified, the status of the article will be detected.
1447 * If EDIT_UPDATE is specified and the article doesn't exist, the function will an
1448 * edit-gone-missing error. If EDIT_NEW is specified and the article does exist, an
1449 * edit-already-exists error will be returned. These two conditions are also possible with
1450 * auto-detection due to MediaWiki's performance-optimised locking strategy.
1451 *
1452 * @param $baseRevId, the revision ID this edit was based off, if any
1453 *
1454 * @return Status object. Possible errors:
1455 * edit-hook-aborted: The ArticleSave hook aborted the edit but didn't set the fatal flag of $status
1456 * edit-gone-missing: In update mode, but the article didn't exist
1457 * edit-conflict: In update mode, the article changed unexpectedly
1458 * edit-no-change: Warning that the text was the same as before
1459 * edit-already-exists: In creation mode, but the article already exists
1460 *
1461 * Extensions may define additional errors.
1462 *
1463 * $return->value will contain an associative array with members as follows:
1464 * new: Boolean indicating if the function attempted to create a new article
1465 * revision: The revision object for the inserted revision, or null
1466 *
1467 * Compatibility note: this function previously returned a boolean value indicating success/failure
1468 */
1472 # Low-level sanity check
1475 }
1481 }
1484 # Load $this->mTitle->getArticleID() and $this->mLatest if it's not already
1493 }
1494 }
1499 {
1504 }
1506 }
1508 # Silently ignore EDIT_MINOR if not allowed
1515 # Provide autosummaries if one is not provided and autosummaries are enabled.
1518 }
1528 # Update article, but only if changed.
1531 # Make sure the revision is either completely inserted or not inserted at all
1534 }
1546 # Article gone missing
1551 }
1561 ) );
1566 # Update page
1567 #
1568 # Note that we use $this->mLatest instead of fetching a value from the master DB
1569 # during the course of this function. This makes sure that EditPage can detect
1570 # edit conflicts reliably, either by $ok here, or by $article->getTimestamp()
1571 # before this function is called. A previous function used a separate query, this
1572 # creates a window where concurrent edits can cause an ignored edit conflict.
1576 /* Belated edit conflict! Run away!! */
1578 # Delete the invalid revision if the DB is not transactional
1581 }
1587 # Update recentchanges
1593 # Mark as patrolled if the user can do so
1596 }
1597 }
1600 }
1604 // Keep the same revision ID, but do some updates on it
1606 // Update page_touched, this is usually implicit in the page update
1607 // Other cache updates are done in onArticleEdit()
1609 }
1613 }
1614 // Now that ignore_user_abort is restored, we can respond to fatal errors
1618 }
1620 # Invalidate cache of this article and all pages using this article
1621 # as a template. Partly deferred.
1623 # Update links tables, site stats, etc.
1626 # Create new article
1629 # Set statistics members
1630 # We work out if it's countable after PST to avoid counter drift
1631 # when articles are created with {{subst:}}
1637 # Add the page record; stake our claim on this title!
1638 # This will return false if the article already exists
1646 }
1648 # Save the revision text...
1656 ) );
1661 # Update the page record with revision data
1669 # Mark as patrolled if the user can
1670 if( ($GLOBALS['wgUseRCPatrol'] || $GLOBALS['wgUseNPPatrol']) && $user->isAllowed( 'autopatrol' ) ) {
1672 }
1673 }
1677 # Update links, etc.
1680 # Clear caches
1685 }
1687 # Do updates right now unless deferral was requested
1690 }
1692 // Return the new revision (or null) to the caller
1700 }
1702 /**
1703 * @deprecated wrapper for doRedirect
1704 */
1707 }
1709 /**
1710 * Output a redirect back to the article.
1711 * This is typically used after an edit.
1712 *
1713 * @param boolean $noRedir Add redirect=no
1714 * @param string $sectionAnchor section to redirect to, including "#"
1715 * @param string $extraQuery, extra query params
1716 */
1725 }
1727 }
1729 /**
1730 * Mark this particular edit/page as patrolled
1731 */
1736 # If we haven't been given an rc_id value, we can't do anything
1742 }
1744 #It would be nice to see where the user had actually come from, but for now just guess
1754 }
1757 // The hook itself has handled any output
1759 }
1766 }
1771 }
1773 # Inform the user
1777 }
1779 /**
1780 * User-interface handler for the "watch" action
1781 */
1790 }
1794 }
1801 }
1804 }
1806 /**
1807 * Add this page to $wgUser's watchlist
1808 * @return bool true on successful watch operation
1809 */
1814 }
1820 }
1823 }
1825 /**
1826 * User interface handler for the "unwatch" action.
1827 */
1835 }
1839 }
1846 }
1849 }
1851 /**
1852 * Stop watching a page
1853 * @return bool true on successful unwatch
1854 */
1859 }
1865 }
1868 }
1870 /**
1871 * action=protect handler
1872 */
1876 }
1878 /**
1879 * action=unprotect handler (alias)
1880 */
1883 }
1885 /**
1886 * Update the article's restriction field, and leave a log entry.
1887 *
1888 * @param array $limit set of restriction keys
1889 * @param string $reason
1890 * @return bool true on success
1891 */
1892 function updateRestrictions( $limit = array(), $reason = '', $cascade = 0, $expiry = array() ) {
1896 if( array() != $this->mTitle->getUserPermissionsErrors( 'protect', $wgUser ) || wfReadOnly() || $id == 0 ) {
1898 }
1902 }
1904 // Take this opportunity to purge out expired restrictions
1907 # FIXME: Same limitations as described in ProtectionForm.php (line 37);
1908 # we expect a single selection, but the schema allows otherwise.
1915 }
1923 # If nothing's changed, do nothing
1929 # Prepare a null revision to be added to the history
1935 }
1936 $comment = $wgContLang->ucfirst( wfMsgForContent( $comment_type, $this->mTitle->getPrefixedText() ) );
1938 # Only restrictions with the 'protect' right can cascade...
1939 # Otherwise, people who cannot normally protect can "protect" pages via transclusion
1941 # FIXME: can $restriction be an array or what? (same as fixme above)
1945 }
1946 }
1950 }
1967 }
1969 }
1970 }
1977 # Update restrictions table
1989 }
1990 }
1992 # Insert a null revision
1997 # Update page record
2006 );
2011 # Update the protection log
2018 }
2024 }
2026 /**
2027 * Take an array of page restrictions and flatten it to a string
2028 * suitable for insertion into the page_restrictions field.
2029 * @param array $limit
2030 * @return string
2031 * @private
2032 */
2036 }
2042 }
2043 }
2045 }
2047 /**
2048 * Auto-generates a deletion reason
2049 * @param bool &$hasHistory Whether the page has a history
2050 */
2054 // Get the last revision
2059 // Get the article's contents
2062 // If the page is blank, use the text from the previous revision,
2063 // which can only be blank if there's a move/import/protect dummy revision involved
2069 }
2070 }
2072 // Find out if there was only one contributor
2073 // Only scan the last 20 revisions
2078 );
2080 // This page has no revisions, which is very weird
2084 else
2088 // Try to find a second contributor
2093 }
2094 }
2097 // Generate the summary with a '$1' placeholder
2099 // The current revision is blank and the one before is also
2100 // blank. It's just not our lucky day
2105 else
2107 }
2109 // Replace newlines with spaces to prevent uglyness
2111 // Calculate the maximum amount of chars to get
2112 // Max content length = max comment length - length of the comment (excl. $1) - '...'
2115 // Remove possible unfinished links
2117 // Now replace the '$1' placeholder
2120 }
2123 /*
2124 * UI entry point for page deletion
2125 */
2138 // Entry from drop down menu + additional comment
2142 }
2143 # Flag to hide all contents of the archived revisions
2146 # This code desperately needs to be totally rewritten
2148 # Read-only check...
2152 }
2154 # Check permissions
2160 }
2164 # Better double-check that it hasn't been deleted yet!
2171 }
2173 # Hack for big sites
2180 }
2188 }
2190 }
2192 // Generate deletion reason
2196 // If the page has a history, insert a warning
2199 $wgOut->addHTML( '<strong>' . wfMsg( 'historywarning' ) . ' ' . $skin->historyLink() . '</strong>' );
2204 }
2205 }
2208 }
2210 /**
2211 * @return bool whether or not the page surpasses $wgDeleteRevisionsLimit revisions
2212 */
2218 }
2220 }
2222 /**
2223 * @return int approximate revision count
2224 */
2227 // For an exact count...
2228 //return $dbr->selectField( 'revision', 'COUNT(*)',
2229 // array( 'rev_page' => $this->getId() ), __METHOD__ );
2232 }
2234 /**
2235 * Get the last N authors
2236 * @param int $num Number of revisions to get
2237 * @param string $revLatest The latest rev_id, selected from the master (optional)
2238 * @return array Array of authors, duplicates not removed
2239 */
2243 // First try the slave
2244 // If that doesn't have the latest revision, try the master
2253 'rev_page = page_id'
2257 ) )
2258 );
2262 }
2269 }
2275 }
2278 }
2280 /**
2281 * Output deletion confirmation dialog
2282 * @param $reason string Prefilled reason
2283 */
2290 $wgOut->setSubtitle( wfMsg( 'delete-backlink', $wgUser->getSkin()->makeKnownLinkObj( $this->mTitle ) ) );
2296 $suppress .= Xml::checkLabel( wfMsg( 'revdelete-suppress' ), 'wpSuppress', 'wpSuppress', false, array( 'tabindex' => '2' ) );
2300 }
2306 Xml::tags( 'legend', null, wfMsgExt( 'delete-legend', array( 'parsemag', 'escapenoentities' ) ) ) .
2311 "</td>
2316 "</td>
2317 </tr>
2321 "</td>
2325 "</td>
2326 </tr>
2327 <tr>
2328 <td></td>
2330 Xml::checkLabel( wfMsg( 'watchthis' ), 'wpWatch', 'wpWatch', $checkWatch, array( 'tabindex' => '3' ) ) .
2331 "</td>
2332 </tr>
2333 $suppress
2334 <tr>
2335 <td></td>
2337 Xml::submitButton( wfMsg( 'deletepage' ), array( 'name' => 'wpConfirmB', 'id' => 'wpConfirmB', 'tabindex' => '4' ) ) .
2338 "</td>
2347 $link = $skin->makeLink ( 'MediaWiki:Deletereason-dropdown', wfMsgHtml( 'delete-edit-reasonlist' ) );
2349 }
2353 }
2356 /**
2357 * Show relevant lines from the deletion log
2358 */
2362 }
2365 /**
2366 * Perform a deletion and output success or failure messages
2367 */
2391 else
2393 }
2394 }
2395 }
2397 /**
2398 * Back-end article deletion
2399 * Deletes the article with database consistency, writes logs, purges caches
2400 * Returns success
2401 */
2415 }
2420 // Bitfields to further suppress the content
2423 // This should be 15...
2430 }
2433 // For now, shunt the revision data into the archive table.
2434 // Text is *not* removed from the text table; bulk storage
2435 // is left intact to avoid breaking block-compression or
2436 // immutable storage schemes.
2437 //
2438 // For backwards compatibility, note that some older archive
2439 // table entries will have ar_text and ar_flags fields still.
2440 //
2441 // In the future, we may keep revisions and mark them with
2442 // the rev_deleted field, which is reserved for this purpose.
2461 'page_id = rev_page'
2462 ), __METHOD__
2463 );
2465 # Delete restrictions for it
2468 # Now that it's safely backed up, delete it
2474 }
2476 # If using cascading deletes, we can skip some explicit deletes
2483 # Delete outgoing links
2491 }
2493 # If using cleanup triggers, we can skip some manual deletes
2495 # Clean up recentchanges entries...
2498 __METHOD__ );
2499 }
2501 # Clear caches
2504 # Fix category table counts
2509 }
2512 # Clear the cached article id so the interface doesn't act like we exist
2516 # Log the deletion, if the page was suppressed, log it at Oversight instead
2520 # Make sure logging got through
2526 }
2528 /**
2529 * Roll back the most recent consecutive set of edits to a page
2530 * from the same user; fails if there are no eligible edits to
2531 * roll back to, e.g. user is the sole contributor. This function
2532 * performs permissions checks on $wgUser, then calls commitRollback()
2533 * to do the dirty work
2534 *
2535 * @param string $fromP - Name of the user whose edits to rollback.
2536 * @param string $summary - Custom summary. Set to default summary if empty.
2537 * @param string $token - Rollback token.
2538 * @param bool $bot - If true, mark all reverted edits as bot.
2539 *
2540 * @param array $resultDetails contains result-specific array of additional values
2541 * 'alreadyrolled' : 'current' (rev)
2542 * success : 'summary' (str), 'current' (rev), 'target' (rev)
2543 *
2544 * @return array of errors, each error formatted as
2545 * array(messagekey, param1, param2, ...).
2546 * On success, the array is empty. This array can also be passed to
2547 * OutputPage::showPermissionsErrorPage().
2548 */
2553 # Check permissions
2561 }
2562 # If there were errors, bail out now
2567 }
2569 /**
2570 * Backend implementation of doRollback(), please refer there for parameter
2571 * and return value documentation
2572 *
2573 * NOTE: This function does NOT check ANY permissions, it just commits the
2574 * rollback to the DB Therefore, you should only call this function direct-
2575 * ly if you want to use custom permissions checks. If you don't, use
2576 * doRollback() instead.
2577 */
2584 }
2586 # Get the last editor
2589 # Something wrong... no page?
2591 }
2600 ));
2601 }
2603 # Get the last edit not by this guy
2613 );
2615 # No one else ever edited this page
2617 } else if( $s->rev_deleted & REVISION::DELETED_TEXT || $s->rev_deleted & REVISION::DELETED_USER ) {
2618 # Only admins can see this text
2620 }
2624 # Mark all reverted edits as bot
2626 }
2628 # Mark all reverted edits as patrolled
2630 }
2638 ), __METHOD__
2639 );
2640 }
2642 # Generate the edit summary if necessary
2646 }
2648 # Allow the custom summary to use the same args as the default message
2653 );
2656 # Save
2664 # Actually store the edit
2670 }
2679 );
2681 }
2683 /**
2684 * User interface for rollback operations
2685 */
2695 $details
2696 );
2701 }
2705 }
2706 if( isset( $result[0][0] ) && ( $result[0][0] == 'alreadyrolled' || $result[0][0] == 'cantrollback' ) ) {
2716 }
2717 }
2719 }
2720 # Display permissions errors before read-only message -- there's no
2721 # point in misleading the user into thinking the inability to rollback
2722 # is only temporary.
2724 # array_diff is completely broken for arrays of arrays, sigh. Re-
2725 # move any 'readonlytext' error manually.
2730 }
2731 }
2734 }
2738 }
2749 $wgOut->addHtml( wfMsgExt( 'rollback-success', array( 'parse', 'replaceafter' ), $old, $new ) );
2755 }
2756 }
2759 /**
2760 * Do standard deferred updates after page view
2761 * @private
2762 */
2767 # Don't update page view counters on views from bot users (bug 14044)
2773 }
2774 }
2776 # Update newtalk / watchlist notification status
2778 }
2780 /**
2781 * Prepare text which is about to be saved.
2782 * Returns a stdclass with source, pst and output members
2783 */
2785 if ( $this->mPreparedEdit && $this->mPreparedEdit->newText == $text && $this->mPreparedEdit->revid == $revid) {
2786 // Already prepared
2788 }
2801 }
2803 /**
2804 * Do standard deferred updates after page edit.
2805 * Update links tables, site stats, search index and message cache.
2806 * Purges pages that include this page if the text was changed here.
2807 * Every 100th edit, prune the recent changes table.
2808 *
2809 * @private
2810 * @param $text New text of the article
2811 * @param $summary Edit summary
2812 * @param $minoredit Minor edit
2813 * @param $timestamp_of_pagechange Timestamp associated with the page change
2814 * @param $newid rev_id value of the new revision
2815 * @param $changed Whether or not the content actually changed
2816 */
2817 function editUpdates( $text, $summary, $minoredit, $timestamp_of_pagechange, $newid, $changed = true ) {
2822 # Parse the text
2823 # Be careful not to double-PST: $text is usually already PST-ed once
2830 }
2832 # Save it to the parser cache
2836 }
2838 # Update the links tables
2847 // Flush old entries from the `recentchanges` table; we do this on
2848 // random requests so as to avoid an increase in writes for no good reason
2855 }
2856 }
2865 }
2872 # If this is another user's talk page, update newtalk
2873 # Don't do this if $changed = false otherwise some idiot can null-edit a
2874 # load of user talk pages and piss people off, nor if it's a minor edit
2875 # by a properly-flagged bot.
2876 if( $this->mTitle->getNamespace() == NS_USER_TALK && $shortTitle != $wgUser->getTitleKey() && $changed
2883 // An anonymous user
2889 }
2890 }
2891 }
2895 }
2898 }
2900 /**
2901 * Perform article updates on a special page creation.
2902 *
2903 * @param Revision $rev
2904 *
2905 * @todo This is a shitty interface function. Kill it and replace the
2906 * other shitty functions like editUpdates and such so it's not needed
2907 * anymore.
2908 */
2914 }
2916 /**
2917 * Generate the navigation links when browsing through an article revisions
2918 * It shows the information as:
2919 * Revision as of \<date\>; view current revision
2920 * \<- Previous version | Next Version -\>
2921 *
2922 * @private
2923 * @param string $oldid Revision ID of this article revision
2924 */
2930 }
2945 ? $sk->makeKnownLinkObj( $this->mTitle, wfMsg( 'previousrevision' ), 'direction=prev&oldid='.$oldid )
2952 : $sk->makeKnownLinkObj( $this->mTitle, wfMsg( 'nextrevision' ), 'direction=next&oldid='.$oldid );
2961 // We don't handle top deleted edits too well
2964 // If revision was hidden from sysops
2971 // Bolden oversighted content
2974 }
2976 }
2977 # Show user links if allowed to see them. Normally they
2978 # are hidden regardless, but since we can already see the text here...
2983 ? 'revision-info-current'
2986 $r = "\n\t\t\t\t<div id=\"mw-{$infomsg}\">" . wfMsg( $infomsg, $td, $userlinks ) . "</div>\n" .
2991 }
2993 /**
2994 * This function is called right before saving the wikitext,
2995 * so we can do things like signatures and links-in-context.
2996 *
2997 * @param string $text
2998 */
3001 return $wgParser->preSaveTransform( $text, $this->mTitle, $wgUser, ParserOptions::newFromUser( $wgUser ) );
3002 }
3004 /* Caching functions */
3006 /**
3007 * checkLastModified returns true if it has taken care of all
3008 * output to the client that is necessary for this request.
3009 * (that is, it has sent a cached version of the page)
3010 */
3016 }
3028 }
3031 }
3033 }
3035 /**
3036 * Check if the page can be cached
3037 * @return bool
3038 */
3041 // Get all query values
3045 // Normal page view in query form
3048 }
3049 }
3050 // Check for non-standard user language; this covers uselang,
3051 // and extensions for auto-detecting user language.
3062 // Extension may have reason to disable file caching on some pages.
3065 }
3067 }
3069 /**
3070 * Loads page_touched and returns a value indicating if it should be used
3071 *
3072 */
3076 }
3078 }
3080 /**
3081 * Get the page_touched field
3082 */
3084 # Ensure that page data has been loaded
3087 }
3089 }
3091 /**
3092 * Get the page_latest field
3093 */
3097 }
3099 }
3101 /**
3102 * Edit an article without doing all that other stuff
3103 * The article must already exist; link tables etc
3104 * are not updated, caches are not flushed.
3105 *
3106 * @param string $text text submitted
3107 * @param string $comment comment submitted
3108 * @param bool $minor whereas it's a minor modification
3109 */
3119 ) );
3126 }
3128 /**
3129 * Used to increment the view counter
3130 *
3131 * @static
3132 * @param integer $id article id
3133 */
3146 }
3148 # Not important enough to warrant an error page in case of failure
3155 # Most of the time (or on SQL errors), skip row count check
3158 }
3178 }
3182 }
3187 }
3189 }
3191 /**#@+
3192 * The onArticle*() functions are supposed to be a kind of hooks
3193 * which should be called whenever any of the specified actions
3194 * are done.
3195 *
3196 * This is a good place to put code to clear caches, for instance.
3197 *
3198 * This is called on page move and undelete, as well as edit
3199 * @static
3200 * @param $title_obj a title object
3201 */
3204 # Update existence markers on article/talk tabs...
3209 }
3216 }
3220 # Update existence markers on article/talk tabs...
3225 }
3232 # File cache
3236 }
3238 # Messages
3241 }
3242 # Images
3246 }
3247 # User talk pages
3251 }
3252 }
3254 /**
3255 * Purge caches on page update etc
3256 */
3260 // Invalidate caches of articles which include this page
3264 // Invalidate the caches of all pages which redirect here
3267 # Purge squid for this page only
3270 # Clear file cache for this page only
3274 }
3275 }
3277 /**#@-*/
3279 /**
3280 * Overriden by ImagePage class, only present here to avoid a fatal error
3281 * Called for ?action=revert
3282 */
3286 }
3288 /**
3289 * Info about this page
3290 * Called for ?action=info when $wgAllowPageInfo is on.
3291 *
3292 * @public
3293 */
3300 }
3311 // This doesn't quite make sense; the user is asking for
3312 // information about the _page_, not the message... -- RC
3316 ? 'noarticletext'
3319 }
3330 __METHOD__,
3336 $wgOut->addHTML( "<ul><li>" . wfMsg("numwatchers", $wgLang->formatNum( $numwatchers ) ) . '</li>' );
3337 $wgOut->addHTML( "<li>" . wfMsg('numedits', $wgLang->formatNum( $pageInfo['edits'] ) ) . '</li>');
3339 $wgOut->addHTML( '<li>' . wfMsg("numtalkedits", $wgLang->formatNum( $talkInfo['edits'] ) ) . '</li>');
3340 }
3341 $wgOut->addHTML( '<li>' . wfMsg("numauthors", $wgLang->formatNum( $pageInfo['authors'] ) ) . '</li>' );
3343 $wgOut->addHTML( '<li>' . wfMsg('numtalkauthors', $wgLang->formatNum( $talkInfo['authors'] ) ) . '</li>' );
3344 }
3347 }
3348 }
3350 /**
3351 * Return the total number of edits and number of unique editors
3352 * on a given page. If page does not exist, returns false.
3353 *
3354 * @param Title $title
3355 * @return array
3356 * @private
3357 */
3362 }
3372 __METHOD__,
3379 __METHOD__,
3383 }
3385 /**
3386 * Return a list of templates used by this article.
3387 * Uses the templatelinks table
3388 *
3389 * @return array Array of Title objects
3390 */
3396 }
3402 __METHOD__ );
3406 }
3407 }
3410 }
3412 /**
3413 * Returns a list of hidden categories this page is a member of.
3414 * Uses the page_props and categorylinks tables.
3415 *
3416 * @return array Array of Title objects
3417 */
3423 }
3430 __METHOD__ );
3434 }
3435 }
3438 }
3440 /**
3441 * Return an applicable autosummary if one exists for the given edit.
3442 * @param string $oldtext The previous text of the page.
3443 * @param string $newtext The submitted text of the page.
3444 * @param bitmask $flags A bitmask of flags submitted for the edit.
3445 * @return string An appropriate autosummary, or an empty string.
3446 */
3448 # Decide what kind of autosummary is needed.
3450 # Redirect autosummaries
3454 }
3456 # New page autosummaries
3458 # If they're making a new article, give its text, truncated, in the summary.
3465 }
3467 # Blanking autosummaries
3471 # Removing more than 90% of the article
3476 '...'
3477 );
3479 }
3481 # If we reach this point, there's no applicable autosummary for our case, so our
3482 # autosummary is empty.
3484 }
3486 /**
3487 * Add the primary page-view wikitext to the output buffer
3488 * Saves the text into the parser cache if possible.
3489 * Updates templatelinks if it is out of date.
3490 *
3491 * @param string $text
3492 * @param bool $cache
3493 */
3507 }
3508 // Make sure file cache is not used on uncacheable content.
3509 // Output that has magic words in it can still use the parser cache
3510 // (if enabled), though it will generally expire sooner.
3513 }
3516 // templatelinks table may have become out of sync,
3517 // especially if using variable-based transclusions.
3518 // For paranoia, check if things have changed and if
3519 // so apply updates to the database. This will ensure
3520 // that cascaded protections apply as soon as the changes
3521 // are visible.
3523 # Get templates from templatelinks
3532 __METHOD__ );
3539 }
3540 }
3542 # Get templates from parser output.
3548 }
3550 # Get the diff
3554 # Whee, link updates time.
3557 }
3558 }
3561 }
3563 /**
3564 * Update all the appropriate counts in the category table, given that
3565 * we've added the categories $added and deleted the categories $deleted.
3566 *
3567 * @param $added array The names of categories that were added
3568 * @param $deleted array The names of categories that were deleted
3569 * @return null
3570 */
3575 # First make sure the rows exist. If one of the "deleted" ones didn't
3576 # exist, we might legitimately not create it, but it's simpler to just
3577 # create it and then give it a negative value, since the value is bogus
3578 # anyway.
3579 #
3580 # Sometimes I wish we had INSERT ... ON DUPLICATE KEY UPDATE.
3583 # Okay, nothing to do
3585 }
3589 }
3600 }
3607 __METHOD__
3608 );
3609 }
3615 __METHOD__
3616 );
3617 }
3618 }
3619 }