| blob | 79bc6e51143de03e9cc520da4545d305bb96cb0e |
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 */
126 }
128 /**
129 * Note that getContent/loadContent do not follow redirects anymore.
130 * If you need to fetch redirectable content easily, try
131 * the shortcut in Article::followContent()
132 * FIXME
133 * @todo There are still side-effects in this!
134 * In general, you should use the Revision class, not Article,
135 * to fetch text for purposes other than page views.
136 *
137 * @return Return the text of this revision
138 */
152 }
159 }
160 }
162 /**
163 * This function returns the text of a section, specified by a number ($section).
164 * A section is text under a heading like == Heading == or \<h1\>Heading\</h1\>, or
165 * the first section before any such heading (section 0).
166 *
167 * If a section contains subsections, these are also returned.
168 *
169 * @param $text String: text to look in
170 * @param $section Integer: section number
171 * @return string text of the requested section
172 * @deprecated
173 */
177 }
179 /**
180 * @return int The oldid of the article that is to be shown, 0 for the
181 * current revision
182 */
186 }
188 }
190 /**
191 * Sets $this->mRedirectUrl to a correct URL if the query parameters are incorrect
192 *
193 * @return int The old id for the request
194 */
207 }
213 # TODO
214 }
215 }
216 # unused:
217 # $lastid = $oldid;
218 }
222 }
224 }
226 /**
227 * Load the revision (including text) into this object
228 */
232 # Query variables :P
235 # Pre-fill content with error message so that if something
236 # fails we'll have something telling us what we intended.
239 }
242 /**
243 * Fetch a page record with the given conditions
244 * @param Database $dbr
245 * @param array $conditions
246 * @private
247 */
268 }
270 /**
271 * @param Database $dbr
272 * @param Title $title
273 */
278 }
280 /**
281 * @param Database $dbr
282 * @param int $id
283 */
286 }
288 /**
289 * Set the general counter, title etc data loaded from
290 * some source.
291 *
292 * @param object $data
293 * @private
294 */
299 }
307 # Old-fashioned restrictions.
317 }
319 }
322 }
324 /**
325 * Get text of an article from database
326 * Does *NOT* follow redirects.
327 * @param int $oldid 0 for whatever the latest revision is
328 * @return string
329 */
333 }
337 # Pre-fill content with error message so that if something
338 # fails we'll have something telling us what we intended.
342 }
350 }
355 }
362 wfDebug( __METHOD__." failed to find page data for title " . $this->mTitle->getPrefixedText() . "\n" );
364 }
366 }
371 }
372 }
374 // FIXME: Horrible, horrible! This content-loading interface just plain sucks.
375 // We should instead work with the Revision object when we need it...
377 //$this->mContent = $revision->getText();
391 }
393 /**
394 * Read/write accessor to select FOR UPDATE
395 *
396 * @param $x Mixed: FIXME
397 */
400 }
402 /**
403 * Get the database which should be used for reads
404 *
405 * @return Database
406 */
409 }
411 /**
412 * Get options for all SELECT statements
413 *
414 * @param $options Array: an optional options array which'll be appended to
415 * the default
416 * @return Array: options
417 */
424 }
425 }
427 }
429 /**
430 * @return int Page ID
431 */
437 }
438 }
440 /**
441 * @return bool Whether or not the page exists in the database
442 */
445 }
447 /**
448 * @return int The view count for the page
449 */
459 }
460 }
462 }
464 /**
465 * Determine whether a page would be suitable for being counted as an
466 * article in the site_stats table based on the title & its content
467 *
468 * @param $text String: text to analyze
469 * @return bool
470 */
475 return
479 }
481 /**
482 * Tests if the article text represents a redirect
483 *
484 * @param $text String: FIXME
485 * @return bool
486 */
493 }
495 }
497 /**
498 * Returns true if the currently-referenced revision is the current edit
499 * to this page (and it exists).
500 * @return bool
501 */
503 # If no oldid, this is the current version.
510 }
512 /**
513 * Loads everything except the text
514 * This isn't necessary for all uses, so it's only done if needed.
515 * @private
516 */
521 # New or non-existent articles have no user information
533 }
534 }
537 // Check if the field has been filled by ParserCache::get()
540 }
542 }
547 }
552 }
557 }
562 }
567 }
569 /**
570 * @todo Document, fixme $offset never used.
571 * @param $limit Integer: default 0.
572 * @param $offset Integer: default 0.
573 */
575 # XXX: this is expensive; cache this info somewhere.
588 GROUP BY rev_user, rev_user_text, user_real_name
598 }
602 }
604 /**
605 * This is the default action of the script: just view the page of
606 * the given title.
607 */
619 # Get variables from query string
622 # getOldID may want us to redirect somewhere else
627 }
636 # Discourage indexing of printable versions, but encourage following
640 # Honour customised robot policies for this namespace
643 # Default to encourage indexing and following links
645 }
648 # If we got diff and oldid in the query, we want to see a
649 # diff page instead of the article.
655 // DifferenceEngine directly fetched the revision:
659 // Needed to get the page's current revision
662 # Run view updates for current revision only
664 }
667 }
676 # tell wgOut that output is taken care of
681 }
682 }
684 # Should the parser cache be used?
692 }
696 // This is an internally redirected page view.
697 // We'll need a backlink to the source page for navigation.
704 // Set the fragment if one was specified in the redirect
708 }
710 }
712 // This is an externally redirected view, from some other wiki.
713 // If it was reported from a trusted site, supply a backlink.
721 }
722 }
728 // Ensure that UI elements requiring revision ID have
729 // the correct version information.
732 }
733 }
737 # Failed to load, replace text with error message
744 }
745 }
747 # Another whitelist check in case oldid is altering the title
752 }
754 # We're looking at an old revision
759 // FIXME: This would be a nice place to load the 'no such page' text.
769 // and we are allowed to see...
770 }
771 }
772 }
774 }
775 }
778 # wrap user css and user js in pre and don't parse
779 # XXX: use $this->mTitle->usCssJsSubpage() when php is fixed/ a workaround is found
783 ) {
787 # Display redirect
790 # Don't overwrite the subtitle if this was an old revision
793 }
802 # Display content and save to parser cache
805 # Display content, don't attempt to save to parser cache
806 # Don't show section-edit links on old revisions... this way lies madness.
809 }
810 # Display content and don't save to parser cache
811 # With timing hack -- TS 2006-07-26
816 # Timing hack
820 }
824 }
826 }
827 }
828 /* title may have been set from the cache */
832 }
834 # check if we're displaying a [[User talk:x.x.x.x]] anonymous talk page
838 }
840 # If we have been passed an &rcid= parameter, we want to give the user a
841 # chance to mark this new article as patrolled.
848 ) .
849 '</div>'
850 );
851 }
853 # Trackbacks
859 }
869 );
881 }
888 }
890 }
898 }
903 }
908 }
914 }
921 }
923 /**
924 * Handle action=purge
925 */
932 }
945 }
946 }
948 /**
949 * Perform the actions of a page purging
950 */
953 // Invalidate the cache
957 // Commit the transaction before the purge is sent
961 // Send purge
964 }
966 }
968 /**
969 * Insert a new empty page record for this article.
970 * This *must* be followed up by creating a revision
971 * and running $this->updateToLatest( $rev_id );
972 * or else the record will be left in a funky state.
973 * Best if all done inside a transaction.
974 *
975 * @param Database $dbw
976 * @return int The newly created page_id key
977 * @private
978 */
1002 }
1004 /**
1005 * Update the page record to point to a newly saved revision.
1006 *
1007 * @param Database $dbw
1008 * @param Revision $revision For ID number, and text used to set
1009 length and redirect status fields
1010 * @param int $lastRevision If given, will not overwrite the page field
1011 * when different from the currently set value.
1012 * Giving 0 indicates the new page flag should
1013 * be set on.
1014 * @param bool $lastRevIsRedirect If given, will optimize adding and
1015 * removing rows in redirect table.
1016 * @return bool true on success, false on failure
1017 * @private
1018 */
1019 function updateRevisionOn( &$dbw, $revision, $lastRevision = null, $lastRevIsRedirect = null ) {
1027 # An extra check against threads stepping on each other
1029 }
1038 ),
1040 __METHOD__ );
1045 // FIXME: Should the result from updateRedirectOn() be returned instead?
1047 }
1051 }
1053 /**
1054 * Add row to the redirect table if this is a redirect, remove otherwise.
1055 *
1056 * @param Database $dbw
1057 * @param $redirectTitle a title object pointing to the redirect target,
1058 * or NULL if this is not a redirect
1059 * @param bool $lastRevIsRedirect If given, will optimize adding and
1060 * removing rows in redirect table.
1061 * @return bool true on success, false on failure
1062 * @private
1063 */
1066 // Always update redirects (target link might have changed)
1067 // Update/Insert if we don't know if the last revision was a redirect or not
1068 // Delete if changing from redirect to non-redirect
1076 // This title is a redirect, Add/Update row in the redirect table
1081 );
1085 // This is not a redirect, remove row from redirect table
1088 }
1092 }
1095 }
1097 /**
1098 * If the given revision is newer than the currently set page_latest,
1099 * update the page record. Otherwise, do nothing.
1100 *
1101 * @param Database $dbw
1102 * @param Revision $revision
1103 */
1113 __METHOD__ );
1118 }
1122 # No or missing previous revision; mark the page as new
1125 }
1130 }
1132 /**
1133 * @return string Complete article text, or null if error
1134 */
1139 // Whole-page edit; let the text through unmolested.
1146 }
1151 }
1155 # Inserting a new section
1161 # Replacing an existing section; roll out the big guns
1164 }
1166 }
1170 }
1172 /**
1173 * @deprecated use Article::doEdit()
1174 */
1175 function insertNewArticle( $text, $summary, $isminor, $watchthis, $suppressRC=false, $comment=false ) {
1180 # If this is a comment, add the summary as headline
1183 }
1193 }
1199 }
1200 }
1202 }
1204 /**
1205 * @deprecated use Article::doEdit()
1206 */
1207 function updateArticle( $text, $summary, $minor, $watchthis, $forceBot = false, $sectionanchor = '' ) {
1220 }
1226 }
1227 }
1230 }
1232 }
1234 /**
1235 * Article::doEdit()
1236 *
1237 * Change an existing article or create a new article. Updates RC and all necessary caches,
1238 * optionally via the deferred update array.
1239 *
1240 * $wgUser must be set before calling this function.
1241 *
1242 * @param string $text New text
1243 * @param string $summary Edit summary
1244 * @param integer $flags bitfield:
1245 * EDIT_NEW
1246 * Article is known or assumed to be non-existent, create a new one
1247 * EDIT_UPDATE
1248 * Article is known or assumed to be pre-existing, update it
1249 * EDIT_MINOR
1250 * Mark this edit minor, if the user is allowed to do so
1251 * EDIT_SUPPRESS_RC
1252 * Do not log the change in recentchanges
1253 * EDIT_FORCE_BOT
1254 * Mark the edit a "bot" edit regardless of user rights
1255 * EDIT_DEFER_UPDATES
1256 * Defer some of the updates until the end of index.php
1257 * EDIT_AUTOSUMMARY
1258 * Fill in blank summaries with generated text where possible
1259 *
1260 * If neither EDIT_NEW nor EDIT_UPDATE is specified, the status of the article will be detected.
1261 * If EDIT_UPDATE is specified and the article doesn't exist, the function will return false. If
1262 * EDIT_NEW is specified and the article does exist, a duplicate key error will cause an exception
1263 * to be thrown from the Database. These two conditions are also possible with auto-detection due
1264 * to MediaWiki's performance-optimised locking strategy.
1265 *
1266 * @return bool success
1267 */
1280 }
1281 }
1286 {
1290 }
1292 # Silently ignore EDIT_MINOR if not allowed
1299 # Provide autosummaries if one is not provided.
1310 # Update article, but only if changed.
1312 # Make sure the revision is either completely inserted or not inserted at all
1315 }
1329 # Article gone missing
1333 }
1340 ) );
1345 # Update page
1349 /* Belated edit conflict! Run away!! */
1353 # Update recentchanges
1359 # Mark as patrolled if the user can do so
1363 }
1364 }
1367 }
1369 // Keep the same revision ID, but do some updates on it
1371 // Update page_touched, this is usually implicit in the page update
1372 // Other cache updates are done in onArticleEdit()
1374 }
1378 }
1381 # Invalidate cache of this article and all pages using this article
1382 # as a template. Partly deferred.
1385 # Update links tables, site stats, etc.
1388 }
1390 # Create new article
1392 # Set statistics members
1393 # We work out if it's countable after PST to avoid counter drift
1394 # when articles are created with {{subst:}}
1400 # Add the page record; stake our claim on this title!
1401 # This will fail with a database query exception if the article already exists
1404 # Save the revision text...
1410 ) );
1415 # Update the page record with revision data
1421 # Mark as patrolled if the user can
1425 }
1426 }
1430 # Update links, etc.
1433 # Clear caches
1439 }
1443 }
1452 }
1454 /**
1455 * @deprecated wrapper for doRedirect
1456 */
1459 }
1461 /**
1462 * Output a redirect back to the article.
1463 * This is typically used after an edit.
1464 *
1465 * @param boolean $noRedir Add redirect=no
1466 * @param string $sectionAnchor section to redirect to, including "#"
1467 */
1474 }
1476 }
1478 /**
1479 * Mark this particular edit as patrolled
1480 */
1485 # Check RC patrol config. option
1489 }
1491 # Check permissions
1495 }
1497 # If we haven't been given an rc_id value, we can't do anything
1502 }
1504 # Handle the 'MarkPatrolled' hook
1507 }
1510 # If it's left up to us, check that the user is allowed to patrol this edit
1511 # If the user has the "autopatrol" right, then we'll assume there are no
1512 # other conditions stopping them doing so
1515 # Graceful error handling, as we've done before here...
1516 # (If the recent change doesn't exist, then it doesn't matter whether
1517 # the user is allowed to patrol it or not; nothing is going to happen
1519 # The user made this edit, and can't patrol it
1520 # Tell them so, and then back off
1525 }
1526 }
1528 # Mark the edit as patrolled
1533 # Inform the user
1537 }
1539 /**
1540 * User-interface handler for the "watch" action
1541 */
1550 }
1554 }
1563 }
1566 }
1568 /**
1569 * Add this page to $wgUser's watchlist
1570 * @return bool true on successful watch operation
1571 */
1576 }
1582 }
1585 }
1587 /**
1588 * User interface handler for the "unwatch" action.
1589 */
1597 }
1601 }
1610 }
1613 }
1615 /**
1616 * Stop watching a page
1617 * @return bool true on successful unwatch
1618 */
1623 }
1629 }
1632 }
1634 /**
1635 * action=protect handler
1636 */
1640 }
1642 /**
1643 * action=unprotect handler (alias)
1644 */
1647 }
1649 /**
1650 * Update the article's restriction field, and leave a log entry.
1651 *
1652 * @param array $limit set of restriction keys
1653 * @param string $reason
1654 * @return bool true on success
1655 */
1662 }
1666 }
1668 // Take this opportunity to purge out expired restrictions
1671 # FIXME: Same limitations as described in ProtectionForm.php (line 37);
1672 # we expect a single selection, but the schema allows otherwise.
1685 # If nothing's changed, do nothing
1696 $expiry_description = ' (' . wfMsgForContent( 'protect-expiring', $wgContLang->timeanddate( $expiry ) ).')';
1697 }
1699 # Prepare a null revision to be added to the history
1700 $comment = $wgContLang->ucfirst( wfMsgForContent( $protect ? 'protectedarticle' : 'unprotectedarticle', $this->mTitle->getPrefixedText() ) );
1703 # Check if the group level required to edit also can protect pages
1704 # Otherwise, people who cannot normally protect can "protect" pages via transclusion
1705 $cascade = ( $cascade && isset($wgGroupPermissions[$restrictions]['protect']) && $wgGroupPermissions[$restrictions]['protect'] );
1706 }
1711 }
1725 # Update restrictions table
1735 }
1736 }
1738 # Update page record
1747 );
1750 # Update the protection log
1754 $log->addEntry( 'protect', $this->mTitle, trim( $reason . " [$updated]$cascade_description$expiry_description" ) );
1757 }
1763 }
1765 /**
1766 * Take an array of page restrictions and flatten it to a string
1767 * suitable for insertion into the page_restrictions field.
1768 * @param array $limit
1769 * @return string
1770 * @private
1771 */
1775 }
1781 }
1782 }
1784 }
1786 /*
1787 * UI entry point for page deletion
1788 */
1795 # This code desperately needs to be totally rewritten
1797 # Check permissions
1802 }
1806 }
1811 }
1815 # Better double-check that it hasn't been deleted yet!
1822 }
1830 }
1832 }
1834 # determine whether this page has earlier revisions
1835 # and insert a warning if it does
1841 $wgOut->addHTML( '<strong>' . wfMsg( 'historywarning' ) . ' ' . $skin->historyLink() . '</strong>' );
1842 }
1844 # If a single user is responsible for all revisions, find out who they are
1846 // Query bailed out, too many revisions to find out if they're all the same
1854 }
1855 }
1856 }
1857 # Fetch article text
1861 # if this is a mini-text, we can paste part of it into the deletion reason
1864 #if this is empty, an earlier revision may contain "useful" text
1871 }
1872 }
1876 # this should not happen, since it is not possible to store an empty, new
1877 # page. Let's insert a standard text in case it does, though
1880 }
1883 # comment field=255, let's grep the first 150 to have some user
1884 # space left
1888 # let's strip out newlines
1896 }
1899 }
1900 }
1901 }
1904 }
1906 /**
1907 * Get the last N authors
1908 * @param int $num Number of revisions to get
1909 * @param string $revLatest The latest rev_id, selected from the master (optional)
1910 * @return array Array of authors, duplicates not removed
1911 */
1915 // First try the slave
1916 // If that doesn't have the latest revision, try the master
1925 'rev_page = page_id'
1929 ) )
1930 );
1934 }
1941 }
1947 }
1950 }
1952 /**
1953 * Output deletion confirmation dialog
1954 */
1970 $watch = Xml::checkLabel( wfMsg( 'watchthis' ), 'wpWatch', 'wpWatch', $wgUser->getBoolOption( 'watchdeletion' ) || $this->mTitle->userIsWatching(), array( 'tabindex' => '2' ) );
1974 <table border='0'>
1975 <tr>
1976 <td align='right'>
1978 </td>
1979 <td align='left'>
1980 <input type='text' size='60' name='wpReason' id='wpReason' value=\"" . htmlspecialchars( $reason ) . "\" tabindex=\"1\" />
1981 </td>
1982 </tr>
1983 <tr>
1984 <td> </td>
1986 </tr>
1987 <tr>
1988 <td> </td>
1989 <td>
1991 </td>
1992 </tr>
1993 </table>
2000 }
2003 /**
2004 * Fetch deletion log
2005 */
2007 # Show relevant lines from the deletion log:
2015 }
2018 /**
2019 * Perform a deletion and output success or failure messages
2020 */
2040 }
2041 }
2042 }
2044 /**
2045 * Back-end article deletion
2046 * Deletes the article with database consistency, writes logs, purges caches
2047 * Returns success
2048 */
2062 }
2067 // For now, shunt the revision data into the archive table.
2068 // Text is *not* removed from the text table; bulk storage
2069 // is left intact to avoid breaking block-compression or
2070 // immutable storage schemes.
2071 //
2072 // For backwards compatibility, note that some older archive
2073 // table entries will have ar_text and ar_flags fields still.
2074 //
2075 // In the future, we may keep revisions and mark them with
2076 // the rev_deleted field, which is reserved for this purpose.
2093 'page_id = rev_page'
2094 ), __METHOD__
2095 );
2097 # Delete restrictions for it
2100 # Now that it's safely backed up, delete it
2103 # If using cascading deletes, we can skip some explicit deletes
2111 # Delete outgoing links
2119 }
2121 # If using cleanup triggers, we can skip some manual deletes
2124 # Clean up recentchanges entries...
2126 }
2128 # Clear caches
2131 # Log the deletion
2135 # Clear the cached article id so the interface doesn't act like we exist
2139 }
2141 /**
2142 * Revert a modification
2143 */
2151 }
2155 }
2160 }
2167 }
2170 # Enhanced rollback, marks edits rc_bot=1
2173 # Replace all this user's current edits with the next one down
2175 # Get the last editor
2178 # Something wrong... no page?
2181 }
2194 }
2196 }
2198 # Get the last edit not by this guy
2210 );
2212 # Something wrong
2216 }
2220 # Mark all reverted edits as bot
2222 }
2224 # Mark all reverted edits as patrolled
2226 }
2234 ), __METHOD__
2235 );
2236 }
2238 # Get the edit summary
2243 # Save it!
2248 $this->updateArticle( $target->getText(), $newComment, 1, $this->mTitle->userIsWatching(), $bot );
2251 }
2254 /**
2255 * Do standard deferred updates after page view
2256 * @private
2257 */
2267 }
2268 }
2270 # Update newtalk / watchlist notification status
2273 }
2275 /**
2276 * Do standard deferred updates after page edit.
2277 * Update links tables, site stats, search index and message cache.
2278 * Every 1000th edit, prune the recent changes table.
2279 *
2280 * @private
2281 * @param $text New text of the article
2282 * @param $summary Edit summary
2283 * @param $minoredit Minor edit
2284 * @param $timestamp_of_pagechange Timestamp associated with the page change
2285 * @param $newid rev_id value of the new revision
2286 * @param $changed Whether or not the content actually changed
2287 */
2288 function editUpdates( $text, $summary, $minoredit, $timestamp_of_pagechange, $newid, $changed = true ) {
2293 # Parse the text
2298 # Save it to the parser cache
2302 # Update the links tables
2309 # Periodically flush old entries from the recentchanges table.
2317 }
2318 }
2327 }
2334 # If this is another user's talk page, update newtalk
2335 # Don't do this if $changed = false otherwise some idiot can null-edit a
2336 # load of user talk pages and piss people off, nor if it's a minor edit
2337 # by a properly-flagged bot.
2338 if( $this->mTitle->getNamespace() == NS_USER_TALK && $shortTitle != $wgUser->getTitleKey() && $changed
2343 // An anonymous user
2346 }
2349 }
2350 }
2351 }
2355 }
2358 }
2360 /**
2361 * Perform article updates on a special page creation.
2362 *
2363 * @param Revision $rev
2364 *
2365 * @todo This is a shitty interface function. Kill it and replace the
2366 * other shitty functions like editUpdates and such so it's not needed
2367 * anymore.
2368 */
2374 }
2376 /**
2377 * Generate the navigation links when browsing through an article revisions
2378 * It shows the information as:
2379 * Revision as of \<date\>; view current revision
2380 * \<- Previous version | Next Version -\>
2381 *
2382 * @private
2383 * @param string $oldid Revision ID of this article revision
2384 */
2390 }
2405 ? $sk->makeKnownLinkObj( $this->mTitle, wfMsg( 'previousrevision' ), 'direction=prev&oldid='.$oldid )
2412 : $sk->makeKnownLinkObj( $this->mTitle, wfMsg( 'nextrevision' ), 'direction=next&oldid='.$oldid );
2420 $r = "\n\t\t\t\t<div id=\"mw-revision-info\">" . wfMsg( 'revision-info', $td, $userlinks ) . "</div>\n" .
2421 "\n\t\t\t\t<div id=\"mw-revision-nav\">" . wfMsg( 'revision-nav', $prevdiff, $prevlink, $lnk, $curdiff, $nextlink, $nextdiff ) . "</div>\n\t\t\t";
2423 }
2425 /**
2426 * This function is called right before saving the wikitext,
2427 * so we can do things like signatures and links-in-context.
2428 *
2429 * @param string $text
2430 */
2433 return $wgParser->preSaveTransform( $text, $this->mTitle, $wgUser, ParserOptions::newFromUser( $wgUser ) );
2434 }
2436 /* Caching functions */
2438 /**
2439 * checkLastModified returns true if it has taken care of all
2440 * output to the client that is necessary for this request.
2441 * (that is, it has sent a cached version of the page)
2442 */
2448 }
2460 }
2463 }
2464 }
2466 /**
2467 * Check if the page can be cached
2468 * @return bool
2469 */
2479 //check for non-standard user language; this covers uselang,
2480 //and extensions for auto-detecting user language.
2500 //extension may have reason to disable file caching on some pages.
2502 }
2505 }
2507 /**
2508 * Loads page_touched and returns a value indicating if it should be used
2509 *
2510 */
2514 }
2516 }
2518 /**
2519 * Get the page_touched field
2520 */
2522 # Ensure that page data has been loaded
2525 }
2527 }
2529 /**
2530 * Get the page_latest field
2531 */
2535 }
2537 }
2539 /**
2540 * Edit an article without doing all that other stuff
2541 * The article must already exist; link tables etc
2542 * are not updated, caches are not flushed.
2543 *
2544 * @param string $text text submitted
2545 * @param string $comment comment submitted
2546 * @param bool $minor whereas it's a minor modification
2547 */
2558 ) );
2564 }
2566 /**
2567 * Used to increment the view counter
2568 *
2569 * @static
2570 * @param integer $id article id
2571 */
2584 }
2586 # Not important enough to warrant an error page in case of failure
2593 # Most of the time (or on SQL errors), skip row count check
2596 }
2616 }
2620 }
2625 }
2627 }
2629 /**#@+
2630 * The onArticle*() functions are supposed to be a kind of hooks
2631 * which should be called whenever any of the specified actions
2632 * are done.
2633 *
2634 * This is a good place to put code to clear caches, for instance.
2635 *
2636 * This is called on page move and undelete, as well as edit
2637 * @static
2638 * @param $title_obj a title object
2639 */
2642 # The talk page isn't in the regular link tables, so we need to update manually:
2647 }
2653 }
2661 # File cache
2665 }
2669 }
2670 }
2672 /**
2673 * Purge caches on page update etc
2674 */
2678 // Invalidate caches of articles which include this page
2682 # Purge squid for this page only
2685 # Clear file cache
2689 }
2690 }
2692 /**#@-*/
2694 /**
2695 * Info about this page
2696 * Called for ?action=info when $wgAllowPageInfo is on.
2697 *
2698 * @public
2699 */
2706 }
2713 # first, see if the page exists at all.
2720 }
2730 __METHOD__,
2736 $wgOut->addHTML( "<ul><li>" . wfMsg("numwatchers", $wgLang->formatNum( $numwatchers ) ) . '</li>' );
2737 $wgOut->addHTML( "<li>" . wfMsg('numedits', $wgLang->formatNum( $pageInfo['edits'] ) ) . '</li>');
2739 $wgOut->addHTML( '<li>' . wfMsg("numtalkedits", $wgLang->formatNum( $talkInfo['edits'] ) ) . '</li>');
2740 }
2741 $wgOut->addHTML( '<li>' . wfMsg("numauthors", $wgLang->formatNum( $pageInfo['authors'] ) ) . '</li>' );
2743 $wgOut->addHTML( '<li>' . wfMsg('numtalkauthors', $wgLang->formatNum( $talkInfo['authors'] ) ) . '</li>' );
2744 }
2747 }
2748 }
2750 /**
2751 * Return the total number of edits and number of unique editors
2752 * on a given page. If page does not exist, returns false.
2753 *
2754 * @param Title $title
2755 * @return array
2756 * @private
2757 */
2762 }
2772 __METHOD__,
2779 __METHOD__,
2783 }
2785 /**
2786 * Return a list of templates used by this article.
2787 * Uses the templatelinks table
2788 *
2789 * @return array Array of Title objects
2790 */
2796 }
2807 }
2808 }
2809 }
2812 }
2814 /**
2815 * Return an auto-generated summary if the text provided is a redirect.
2816 *
2817 * @param string $text The wikitext to check
2818 * @return string '' or an appropriate summary
2819 */
2824 else
2826 }
2828 /**
2829 * Return an auto-generated summary if the new text is much shorter than
2830 * the old text.
2831 *
2832 * @param string $oldtext The previous text of the page
2833 * @param string $text The submitted text of the page
2834 * @return string An appropriate autosummary, or an empty string.
2835 */
2840 #Removing more than 90% of the article
2842 $truncatedtext = $wgContLang->truncate($text, max(0, 200 - strlen(wfMsgForContent('autosumm-replace'))), '...');
2846 }
2847 }
2849 /**
2850 * Return an applicable autosummary if one exists for the given edit.
2851 * @param string $oldtext The previous text of the page.
2852 * @param string $newtext The submitted text of the page.
2853 * @param bitmask $flags A bitmask of flags submitted for the edit.
2854 * @return string An appropriate autosummary, or an empty string.
2855 */
2858 # This code is UGLY UGLY UGLY.
2859 # Somebody PLEASE come up with a more elegant way to do it.
2861 #Redirect autosummaries
2867 #Blanking autosummaries
2874 #New page autosummaries
2876 #If they're making a new article, give its text, truncated, in the summary.
2883 }
2889 }
2891 /**
2892 * Add the primary page-view wikitext to the output buffer
2893 * Saves the text into the parser cache if possible.
2894 * Updates templatelinks if it is out of date.
2895 *
2896 * @param string $text
2897 * @param bool $cache
2898 */
2910 }
2913 // templatelinks table may have become out of sync,
2914 // especially if using variable-based transclusions.
2915 // For paranoia, check if things have changed and if
2916 // so apply updates to the database. This will ensure
2917 // that cascaded protections apply as soon as the changes
2918 // are visible.
2920 # Get templates from templatelinks
2937 }
2938 }
2939 }
2941 # Get templates from parser output.
2947 }
2949 # Get the diff
2953 # Whee, link updates time.
2962 }
2963 }
2966 }
2968 }
2970 ?>