| blob | ebf3c640365b3262f27c771a414790524c73c1f6 |
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
642 # Honour customised robot policies for this namespace
645 # Default to encourage indexing and following links
647 }
650 # If we got diff and oldid in the query, we want to see a
651 # diff page instead of the article.
657 // DifferenceEngine directly fetched the revision:
661 // Needed to get the page's current revision
664 # Run view updates for current revision only
666 }
669 }
678 # tell wgOut that output is taken care of
683 }
684 }
686 # Should the parser cache be used?
694 }
698 // This is an internally redirected page view.
699 // We'll need a backlink to the source page for navigation.
706 // Set the fragment if one was specified in the redirect
710 }
712 }
714 // This is an externally redirected view, from some other wiki.
715 // If it was reported from a trusted site, supply a backlink.
723 }
724 }
730 // Ensure that UI elements requiring revision ID have
731 // the correct version information.
734 }
735 }
739 # Failed to load, replace text with error message
746 }
747 }
749 # Another whitelist check in case oldid is altering the title
754 }
756 # We're looking at an old revision
761 // FIXME: This would be a nice place to load the 'no such page' text.
771 // and we are allowed to see...
772 }
773 }
774 }
776 }
777 }
780 # wrap user css and user js in pre and don't parse
781 # XXX: use $this->mTitle->usCssJsSubpage() when php is fixed/ a workaround is found
785 ) {
789 # Display redirect
792 # Don't overwrite the subtitle if this was an old revision
795 }
804 # Display content and save to parser cache
807 # Display content, don't attempt to save to parser cache
808 # Don't show section-edit links on old revisions... this way lies madness.
811 }
812 # Display content and don't save to parser cache
813 # With timing hack -- TS 2006-07-26
818 # Timing hack
822 }
826 }
828 }
829 }
830 /* title may have been set from the cache */
834 }
836 # check if we're displaying a [[User talk:x.x.x.x]] anonymous talk page
840 }
842 # If we have been passed an &rcid= parameter, we want to give the user a
843 # chance to mark this new article as patrolled.
850 ) .
851 '</div>'
852 );
853 }
855 # Trackbacks
861 }
871 );
883 }
890 }
892 }
900 }
905 }
910 }
916 }
923 }
925 /**
926 * Handle action=purge
927 */
934 }
947 }
948 }
950 /**
951 * Perform the actions of a page purging
952 */
955 // Invalidate the cache
959 // Commit the transaction before the purge is sent
963 // Send purge
966 }
968 }
970 /**
971 * Insert a new empty page record for this article.
972 * This *must* be followed up by creating a revision
973 * and running $this->updateToLatest( $rev_id );
974 * or else the record will be left in a funky state.
975 * Best if all done inside a transaction.
976 *
977 * @param Database $dbw
978 * @return int The newly created page_id key
979 * @private
980 */
1004 }
1006 /**
1007 * Update the page record to point to a newly saved revision.
1008 *
1009 * @param Database $dbw
1010 * @param Revision $revision For ID number, and text used to set
1011 length and redirect status fields
1012 * @param int $lastRevision If given, will not overwrite the page field
1013 * when different from the currently set value.
1014 * Giving 0 indicates the new page flag should
1015 * be set on.
1016 * @param bool $lastRevIsRedirect If given, will optimize adding and
1017 * removing rows in redirect table.
1018 * @return bool true on success, false on failure
1019 * @private
1020 */
1021 function updateRevisionOn( &$dbw, $revision, $lastRevision = null, $lastRevIsRedirect = null ) {
1029 # An extra check against threads stepping on each other
1031 }
1040 ),
1042 __METHOD__ );
1047 // FIXME: Should the result from updateRedirectOn() be returned instead?
1049 }
1053 }
1055 /**
1056 * Add row to the redirect table if this is a redirect, remove otherwise.
1057 *
1058 * @param Database $dbw
1059 * @param $redirectTitle a title object pointing to the redirect target,
1060 * or NULL if this is not a redirect
1061 * @param bool $lastRevIsRedirect If given, will optimize adding and
1062 * removing rows in redirect table.
1063 * @return bool true on success, false on failure
1064 * @private
1065 */
1068 // Always update redirects (target link might have changed)
1069 // Update/Insert if we don't know if the last revision was a redirect or not
1070 // Delete if changing from redirect to non-redirect
1078 // This title is a redirect, Add/Update row in the redirect table
1083 );
1087 // This is not a redirect, remove row from redirect table
1090 }
1094 }
1097 }
1099 /**
1100 * If the given revision is newer than the currently set page_latest,
1101 * update the page record. Otherwise, do nothing.
1102 *
1103 * @param Database $dbw
1104 * @param Revision $revision
1105 */
1115 __METHOD__ );
1120 }
1124 # No or missing previous revision; mark the page as new
1127 }
1132 }
1134 /**
1135 * @return string Complete article text, or null if error
1136 */
1141 // Whole-page edit; let the text through unmolested.
1148 }
1153 }
1157 # Inserting a new section
1163 # Replacing an existing section; roll out the big guns
1166 }
1168 }
1172 }
1174 /**
1175 * @deprecated use Article::doEdit()
1176 */
1177 function insertNewArticle( $text, $summary, $isminor, $watchthis, $suppressRC=false, $comment=false ) {
1182 # If this is a comment, add the summary as headline
1185 }
1195 }
1201 }
1202 }
1204 }
1206 /**
1207 * @deprecated use Article::doEdit()
1208 */
1209 function updateArticle( $text, $summary, $minor, $watchthis, $forceBot = false, $sectionanchor = '' ) {
1222 }
1228 }
1229 }
1232 }
1234 }
1236 /**
1237 * Article::doEdit()
1238 *
1239 * Change an existing article or create a new article. Updates RC and all necessary caches,
1240 * optionally via the deferred update array.
1241 *
1242 * $wgUser must be set before calling this function.
1243 *
1244 * @param string $text New text
1245 * @param string $summary Edit summary
1246 * @param integer $flags bitfield:
1247 * EDIT_NEW
1248 * Article is known or assumed to be non-existent, create a new one
1249 * EDIT_UPDATE
1250 * Article is known or assumed to be pre-existing, update it
1251 * EDIT_MINOR
1252 * Mark this edit minor, if the user is allowed to do so
1253 * EDIT_SUPPRESS_RC
1254 * Do not log the change in recentchanges
1255 * EDIT_FORCE_BOT
1256 * Mark the edit a "bot" edit regardless of user rights
1257 * EDIT_DEFER_UPDATES
1258 * Defer some of the updates until the end of index.php
1259 * EDIT_AUTOSUMMARY
1260 * Fill in blank summaries with generated text where possible
1261 *
1262 * If neither EDIT_NEW nor EDIT_UPDATE is specified, the status of the article will be detected.
1263 * If EDIT_UPDATE is specified and the article doesn't exist, the function will return false. If
1264 * EDIT_NEW is specified and the article does exist, a duplicate key error will cause an exception
1265 * to be thrown from the Database. These two conditions are also possible with auto-detection due
1266 * to MediaWiki's performance-optimised locking strategy.
1267 *
1268 * @return bool success
1269 */
1282 }
1283 }
1288 {
1292 }
1294 # Silently ignore EDIT_MINOR if not allowed
1301 # Provide autosummaries if one is not provided.
1312 # Update article, but only if changed.
1314 # Make sure the revision is either completely inserted or not inserted at all
1317 }
1331 # Article gone missing
1335 }
1342 ) );
1347 # Update page
1351 /* Belated edit conflict! Run away!! */
1355 # Update recentchanges
1361 # Mark as patrolled if the user can do so
1365 }
1366 }
1369 }
1371 // Keep the same revision ID, but do some updates on it
1373 // Update page_touched, this is usually implicit in the page update
1374 // Other cache updates are done in onArticleEdit()
1376 }
1380 }
1383 # Invalidate cache of this article and all pages using this article
1384 # as a template. Partly deferred.
1387 # Update links tables, site stats, etc.
1390 }
1392 # Create new article
1394 # Set statistics members
1395 # We work out if it's countable after PST to avoid counter drift
1396 # when articles are created with {{subst:}}
1402 # Add the page record; stake our claim on this title!
1403 # This will fail with a database query exception if the article already exists
1406 # Save the revision text...
1412 ) );
1417 # Update the page record with revision data
1423 # Mark as patrolled if the user can
1427 }
1428 }
1432 # Update links, etc.
1435 # Clear caches
1441 }
1445 }
1454 }
1456 /**
1457 * @deprecated wrapper for doRedirect
1458 */
1461 }
1463 /**
1464 * Output a redirect back to the article.
1465 * This is typically used after an edit.
1466 *
1467 * @param boolean $noRedir Add redirect=no
1468 * @param string $sectionAnchor section to redirect to, including "#"
1469 */
1476 }
1478 }
1480 /**
1481 * Mark this particular edit as patrolled
1482 */
1487 # Check RC patrol config. option
1491 }
1493 # Check permissions
1497 }
1499 # If we haven't been given an rc_id value, we can't do anything
1504 }
1506 # Handle the 'MarkPatrolled' hook
1509 }
1512 # If it's left up to us, check that the user is allowed to patrol this edit
1513 # If the user has the "autopatrol" right, then we'll assume there are no
1514 # other conditions stopping them doing so
1517 # Graceful error handling, as we've done before here...
1518 # (If the recent change doesn't exist, then it doesn't matter whether
1519 # the user is allowed to patrol it or not; nothing is going to happen
1521 # The user made this edit, and can't patrol it
1522 # Tell them so, and then back off
1527 }
1528 }
1530 # Mark the edit as patrolled
1535 # Inform the user
1539 }
1541 /**
1542 * User-interface handler for the "watch" action
1543 */
1552 }
1556 }
1565 }
1568 }
1570 /**
1571 * Add this page to $wgUser's watchlist
1572 * @return bool true on successful watch operation
1573 */
1578 }
1584 }
1587 }
1589 /**
1590 * User interface handler for the "unwatch" action.
1591 */
1599 }
1603 }
1612 }
1615 }
1617 /**
1618 * Stop watching a page
1619 * @return bool true on successful unwatch
1620 */
1625 }
1631 }
1634 }
1636 /**
1637 * action=protect handler
1638 */
1642 }
1644 /**
1645 * action=unprotect handler (alias)
1646 */
1649 }
1651 /**
1652 * Update the article's restriction field, and leave a log entry.
1653 *
1654 * @param array $limit set of restriction keys
1655 * @param string $reason
1656 * @return bool true on success
1657 */
1664 }
1668 }
1670 // Take this opportunity to purge out expired restrictions
1673 # FIXME: Same limitations as described in ProtectionForm.php (line 37);
1674 # we expect a single selection, but the schema allows otherwise.
1687 # If nothing's changed, do nothing
1698 $expiry_description = ' (' . wfMsgForContent( 'protect-expiring', $wgContLang->timeanddate( $expiry ) ).')';
1699 }
1701 # Prepare a null revision to be added to the history
1702 $comment = $wgContLang->ucfirst( wfMsgForContent( $protect ? 'protectedarticle' : 'unprotectedarticle', $this->mTitle->getPrefixedText() ) );
1705 # Check if the group level required to edit also can protect pages
1706 # Otherwise, people who cannot normally protect can "protect" pages via transclusion
1707 $cascade = ( $cascade && isset($wgGroupPermissions[$restrictions]['protect']) && $wgGroupPermissions[$restrictions]['protect'] );
1708 }
1713 }
1727 # Update restrictions table
1737 }
1738 }
1740 # Update page record
1749 );
1752 # Update the protection log
1756 $log->addEntry( 'protect', $this->mTitle, trim( $reason . " [$updated]$cascade_description$expiry_description" ) );
1759 }
1765 }
1767 /**
1768 * Take an array of page restrictions and flatten it to a string
1769 * suitable for insertion into the page_restrictions field.
1770 * @param array $limit
1771 * @return string
1772 * @private
1773 */
1777 }
1783 }
1784 }
1786 }
1788 /*
1789 * UI entry point for page deletion
1790 */
1797 # This code desperately needs to be totally rewritten
1799 # Check permissions
1804 }
1808 }
1813 }
1817 # Better double-check that it hasn't been deleted yet!
1824 }
1832 }
1834 }
1836 # determine whether this page has earlier revisions
1837 # and insert a warning if it does
1843 $wgOut->addHTML( '<strong>' . wfMsg( 'historywarning' ) . ' ' . $skin->historyLink() . '</strong>' );
1844 }
1846 # If a single user is responsible for all revisions, find out who they are
1848 // Query bailed out, too many revisions to find out if they're all the same
1856 }
1857 }
1858 }
1859 # Fetch article text
1863 # if this is a mini-text, we can paste part of it into the deletion reason
1866 #if this is empty, an earlier revision may contain "useful" text
1873 }
1874 }
1878 # this should not happen, since it is not possible to store an empty, new
1879 # page. Let's insert a standard text in case it does, though
1882 }
1885 # comment field=255, let's grep the first 150 to have some user
1886 # space left
1890 # let's strip out newlines
1898 }
1901 }
1902 }
1903 }
1906 }
1908 /**
1909 * Get the last N authors
1910 * @param int $num Number of revisions to get
1911 * @param string $revLatest The latest rev_id, selected from the master (optional)
1912 * @return array Array of authors, duplicates not removed
1913 */
1917 // First try the slave
1918 // If that doesn't have the latest revision, try the master
1927 'rev_page = page_id'
1931 ) )
1932 );
1936 }
1943 }
1949 }
1952 }
1954 /**
1955 * Output deletion confirmation dialog
1956 */
1972 $watch = Xml::checkLabel( wfMsg( 'watchthis' ), 'wpWatch', 'wpWatch', $wgUser->getBoolOption( 'watchdeletion' ) || $this->mTitle->userIsWatching(), array( 'tabindex' => '2' ) );
1976 <table border='0'>
1977 <tr>
1978 <td align='right'>
1980 </td>
1981 <td align='left'>
1982 <input type='text' size='60' name='wpReason' id='wpReason' value=\"" . htmlspecialchars( $reason ) . "\" tabindex=\"1\" />
1983 </td>
1984 </tr>
1985 <tr>
1986 <td> </td>
1988 </tr>
1989 <tr>
1990 <td> </td>
1991 <td>
1993 </td>
1994 </tr>
1995 </table>
2002 }
2005 /**
2006 * Show relevant lines from the deletion log
2007 */
2016 }
2019 /**
2020 * Perform a deletion and output success or failure messages
2021 */
2041 }
2042 }
2043 }
2045 /**
2046 * Back-end article deletion
2047 * Deletes the article with database consistency, writes logs, purges caches
2048 * Returns success
2049 */
2063 }
2068 // For now, shunt the revision data into the archive table.
2069 // Text is *not* removed from the text table; bulk storage
2070 // is left intact to avoid breaking block-compression or
2071 // immutable storage schemes.
2072 //
2073 // For backwards compatibility, note that some older archive
2074 // table entries will have ar_text and ar_flags fields still.
2075 //
2076 // In the future, we may keep revisions and mark them with
2077 // the rev_deleted field, which is reserved for this purpose.
2094 'page_id = rev_page'
2095 ), __METHOD__
2096 );
2098 # Delete restrictions for it
2101 # Now that it's safely backed up, delete it
2104 # If using cascading deletes, we can skip some explicit deletes
2112 # Delete outgoing links
2120 }
2122 # If using cleanup triggers, we can skip some manual deletes
2125 # Clean up recentchanges entries...
2127 }
2129 # Clear caches
2132 # Log the deletion
2136 # Clear the cached article id so the interface doesn't act like we exist
2140 }
2142 /**
2143 * Revert a modification
2144 */
2152 }
2156 }
2161 }
2168 }
2171 # Enhanced rollback, marks edits rc_bot=1
2174 # Replace all this user's current edits with the next one down
2176 # Get the last editor
2179 # Something wrong... no page?
2182 }
2195 }
2197 }
2199 # Get the last edit not by this guy
2211 );
2213 # Something wrong
2217 }
2221 # Mark all reverted edits as bot
2223 }
2225 # Mark all reverted edits as patrolled
2227 }
2235 ), __METHOD__
2236 );
2237 }
2239 # Get the edit summary
2244 # Save it!
2249 $this->updateArticle( $target->getText(), $newComment, 1, $this->mTitle->userIsWatching(), $bot );
2252 }
2255 /**
2256 * Do standard deferred updates after page view
2257 * @private
2258 */
2268 }
2269 }
2271 # Update newtalk / watchlist notification status
2274 }
2276 /**
2277 * Do standard deferred updates after page edit.
2278 * Update links tables, site stats, search index and message cache.
2279 * Every 1000th edit, prune the recent changes table.
2280 *
2281 * @private
2282 * @param $text New text of the article
2283 * @param $summary Edit summary
2284 * @param $minoredit Minor edit
2285 * @param $timestamp_of_pagechange Timestamp associated with the page change
2286 * @param $newid rev_id value of the new revision
2287 * @param $changed Whether or not the content actually changed
2288 */
2289 function editUpdates( $text, $summary, $minoredit, $timestamp_of_pagechange, $newid, $changed = true ) {
2294 # Parse the text
2299 # Save it to the parser cache
2303 # Update the links tables
2310 # Periodically flush old entries from the recentchanges table.
2318 }
2319 }
2328 }
2335 # If this is another user's talk page, update newtalk
2336 # Don't do this if $changed = false otherwise some idiot can null-edit a
2337 # load of user talk pages and piss people off, nor if it's a minor edit
2338 # by a properly-flagged bot.
2339 if( $this->mTitle->getNamespace() == NS_USER_TALK && $shortTitle != $wgUser->getTitleKey() && $changed
2344 // An anonymous user
2347 }
2350 }
2351 }
2352 }
2356 }
2359 }
2361 /**
2362 * Perform article updates on a special page creation.
2363 *
2364 * @param Revision $rev
2365 *
2366 * @todo This is a shitty interface function. Kill it and replace the
2367 * other shitty functions like editUpdates and such so it's not needed
2368 * anymore.
2369 */
2375 }
2377 /**
2378 * Generate the navigation links when browsing through an article revisions
2379 * It shows the information as:
2380 * Revision as of \<date\>; view current revision
2381 * \<- Previous version | Next Version -\>
2382 *
2383 * @private
2384 * @param string $oldid Revision ID of this article revision
2385 */
2391 }
2406 ? $sk->makeKnownLinkObj( $this->mTitle, wfMsg( 'previousrevision' ), 'direction=prev&oldid='.$oldid )
2413 : $sk->makeKnownLinkObj( $this->mTitle, wfMsg( 'nextrevision' ), 'direction=next&oldid='.$oldid );
2421 $r = "\n\t\t\t\t<div id=\"mw-revision-info\">" . wfMsg( 'revision-info', $td, $userlinks ) . "</div>\n" .
2422 "\n\t\t\t\t<div id=\"mw-revision-nav\">" . wfMsg( 'revision-nav', $prevdiff, $prevlink, $lnk, $curdiff, $nextlink, $nextdiff ) . "</div>\n\t\t\t";
2424 }
2426 /**
2427 * This function is called right before saving the wikitext,
2428 * so we can do things like signatures and links-in-context.
2429 *
2430 * @param string $text
2431 */
2434 return $wgParser->preSaveTransform( $text, $this->mTitle, $wgUser, ParserOptions::newFromUser( $wgUser ) );
2435 }
2437 /* Caching functions */
2439 /**
2440 * checkLastModified returns true if it has taken care of all
2441 * output to the client that is necessary for this request.
2442 * (that is, it has sent a cached version of the page)
2443 */
2449 }
2461 }
2464 }
2465 }
2467 /**
2468 * Check if the page can be cached
2469 * @return bool
2470 */
2480 //check for non-standard user language; this covers uselang,
2481 //and extensions for auto-detecting user language.
2501 //extension may have reason to disable file caching on some pages.
2503 }
2506 }
2508 /**
2509 * Loads page_touched and returns a value indicating if it should be used
2510 *
2511 */
2515 }
2517 }
2519 /**
2520 * Get the page_touched field
2521 */
2523 # Ensure that page data has been loaded
2526 }
2528 }
2530 /**
2531 * Get the page_latest field
2532 */
2536 }
2538 }
2540 /**
2541 * Edit an article without doing all that other stuff
2542 * The article must already exist; link tables etc
2543 * are not updated, caches are not flushed.
2544 *
2545 * @param string $text text submitted
2546 * @param string $comment comment submitted
2547 * @param bool $minor whereas it's a minor modification
2548 */
2559 ) );
2565 }
2567 /**
2568 * Used to increment the view counter
2569 *
2570 * @static
2571 * @param integer $id article id
2572 */
2585 }
2587 # Not important enough to warrant an error page in case of failure
2594 # Most of the time (or on SQL errors), skip row count check
2597 }
2617 }
2621 }
2626 }
2628 }
2630 /**#@+
2631 * The onArticle*() functions are supposed to be a kind of hooks
2632 * which should be called whenever any of the specified actions
2633 * are done.
2634 *
2635 * This is a good place to put code to clear caches, for instance.
2636 *
2637 * This is called on page move and undelete, as well as edit
2638 * @static
2639 * @param $title_obj a title object
2640 */
2643 # The talk page isn't in the regular link tables, so we need to update manually:
2648 }
2654 }
2662 # File cache
2666 }
2670 }
2671 }
2673 /**
2674 * Purge caches on page update etc
2675 */
2679 // Invalidate caches of articles which include this page
2683 # Purge squid for this page only
2686 # Clear file cache
2690 }
2691 }
2693 /**#@-*/
2695 /**
2696 * Info about this page
2697 * Called for ?action=info when $wgAllowPageInfo is on.
2698 *
2699 * @public
2700 */
2707 }
2714 # first, see if the page exists at all.
2721 }
2731 __METHOD__,
2737 $wgOut->addHTML( "<ul><li>" . wfMsg("numwatchers", $wgLang->formatNum( $numwatchers ) ) . '</li>' );
2738 $wgOut->addHTML( "<li>" . wfMsg('numedits', $wgLang->formatNum( $pageInfo['edits'] ) ) . '</li>');
2740 $wgOut->addHTML( '<li>' . wfMsg("numtalkedits", $wgLang->formatNum( $talkInfo['edits'] ) ) . '</li>');
2741 }
2742 $wgOut->addHTML( '<li>' . wfMsg("numauthors", $wgLang->formatNum( $pageInfo['authors'] ) ) . '</li>' );
2744 $wgOut->addHTML( '<li>' . wfMsg('numtalkauthors', $wgLang->formatNum( $talkInfo['authors'] ) ) . '</li>' );
2745 }
2748 }
2749 }
2751 /**
2752 * Return the total number of edits and number of unique editors
2753 * on a given page. If page does not exist, returns false.
2754 *
2755 * @param Title $title
2756 * @return array
2757 * @private
2758 */
2763 }
2773 __METHOD__,
2780 __METHOD__,
2784 }
2786 /**
2787 * Return a list of templates used by this article.
2788 * Uses the templatelinks table
2789 *
2790 * @return array Array of Title objects
2791 */
2797 }
2808 }
2809 }
2810 }
2813 }
2815 /**
2816 * Return an auto-generated summary if the text provided is a redirect.
2817 *
2818 * @param string $text The wikitext to check
2819 * @return string '' or an appropriate summary
2820 */
2825 else
2827 }
2829 /**
2830 * Return an auto-generated summary if the new text is much shorter than
2831 * the old text.
2832 *
2833 * @param string $oldtext The previous text of the page
2834 * @param string $text The submitted text of the page
2835 * @return string An appropriate autosummary, or an empty string.
2836 */
2841 #Removing more than 90% of the article
2843 $truncatedtext = $wgContLang->truncate($text, max(0, 200 - strlen(wfMsgForContent('autosumm-replace'))), '...');
2847 }
2848 }
2850 /**
2851 * Return an applicable autosummary if one exists for the given edit.
2852 * @param string $oldtext The previous text of the page.
2853 * @param string $newtext The submitted text of the page.
2854 * @param bitmask $flags A bitmask of flags submitted for the edit.
2855 * @return string An appropriate autosummary, or an empty string.
2856 */
2859 # This code is UGLY UGLY UGLY.
2860 # Somebody PLEASE come up with a more elegant way to do it.
2862 #Redirect autosummaries
2868 #Blanking autosummaries
2875 #New page autosummaries
2877 #If they're making a new article, give its text, truncated, in the summary.
2884 }
2890 }
2892 /**
2893 * Add the primary page-view wikitext to the output buffer
2894 * Saves the text into the parser cache if possible.
2895 * Updates templatelinks if it is out of date.
2896 *
2897 * @param string $text
2898 * @param bool $cache
2899 */
2911 }
2914 // templatelinks table may have become out of sync,
2915 // especially if using variable-based transclusions.
2916 // For paranoia, check if things have changed and if
2917 // so apply updates to the database. This will ensure
2918 // that cascaded protections apply as soon as the changes
2919 // are visible.
2921 # Get templates from templatelinks
2938 }
2939 }
2940 }
2942 # Get templates from parser output.
2948 }
2950 # Get the diff
2954 # Whee, link updates time.
2963 }
2964 }
2967 }
2969 }
2971 ?>