| blob | 33ffc7630c03e5cbf92120ce7742875f0762006d |
1 <?php
2 /**
3 * File for articles
4 * @package MediaWiki
5 */
7 /**
8 * Need the CacheManager to be loaded
9 */
16 /**
17 * Class representing a MediaWiki article and history.
18 *
19 * See design.txt for an overview.
20 * Note: edit user interface and cache support functions have been
21 * moved to separate EditPage and CacheManager classes.
22 *
23 * @package MediaWiki
24 */
26 /**#@+
27 * @access private
28 */
41 /**#@-*/
43 /**
44 * Constructor and clear the article
45 * @param Title &$title
46 * @param integer $oldId Revision ID, null to fetch from request, zero for current
47 */
52 }
54 /**
55 * Tell the page view functions that this view was redirected
56 * from another page on the wiki.
57 * @param Title $from
58 */
61 }
63 /**
64 * @return mixed false, Title of in-wiki target, or string with URL
65 */
70 # process if title object is valid and not special:userlogout
74 // Offsite wikis need an HTTP redirect.
75 //
76 // This can be hard to reverse and may produce loops,
77 // so they may be disabled in the site configuration.
81 }
84 // Gotta hand redirects to special pages differently:
85 // Fill the HTTP response "Location" header and ignore
86 // the rest of the page we're on.
87 //
88 // This can be hard to reverse, so they may be disabled.
91 // rolleyes
94 }
95 }
97 }
98 }
100 // No or invalid redirect
102 }
104 /**
105 * get the title object of the article
106 */
109 }
111 /**
112 * Clear the object
113 * @access private
114 */
130 }
132 /**
133 * Note that getContent/loadContent do not follow redirects anymore.
134 * If you need to fetch redirectable content easily, try
135 * the shortcut in Article::followContent()
136 *
137 * @fixme There are still side-effects in this!
138 * In general, you should use the Revision class, not Article,
139 * to fetch text for purposes other than page views.
140 *
141 * @return Return the text of this revision
142 */
146 # Get variables from query string :P
158 # If requested, preload some text.
161 # We used to put MediaWiki:Newarticletext here if
162 # $text was empty at this point.
163 # This is now shown above the edit box instead.
165 }
173 }
178 # check if we're displaying a [[User talk:x.x.x.x]] anonymous talk page
182 ) {
192 }
194 # strip NOWIKI etc. to avoid confusion (true-parameter causes HTML
195 # comments to be stripped as well)
199 }
200 }
203 }
204 }
205 }
207 /**
208 * Get the contents of a page from its title and remove includeonly tags
209 *
210 * @param string The title of the page
211 * @return string The contents of the page
212 */
222 // TODO FIXME: AAAAAAAAAAA, this shouldn't be implementing
223 // its own mini-parser! -ævar
228 }
229 }
230 }
232 /**
233 * This function returns the text of a section, specified by a number ($section).
234 * A section is text under a heading like == Heading == or <h1>Heading</h1>, or
235 * the first section before any such heading (section 0).
236 *
237 * If a section contains subsections, these are also returned.
238 *
239 * @param string $text text to look in
240 * @param integer $section section number
241 * @return string text of the requested section
242 */
245 # strip NOWIKI etc. to avoid confusion (true-parameter causes HTML
246 # comments to be stripped as well)
253 # now that we can be sure that no pseudo-sections are in the source,
254 # split it up by section
259 PREG_SPLIT_DELIM_CAPTURE);
267 # translate wiki heading into level
270 }
283 }
286 }
289 }
292 }
293 }
294 # reinsert stripped tags
300 }
302 /**
303 * @return int The oldid of the article that is to be shown, 0 for the
304 * current revision
305 */
309 }
311 }
313 /**
314 * Sets $this->mRedirectUrl to a correct URL if the query parameters are incorrect
315 *
316 * @return int The old id for the request
317 */
330 }
336 # TODO
337 }
338 }
340 }
343 }
345 }
347 /**
348 * Load the revision (including text) into this object
349 */
353 # Query variables :P
358 # Pre-fill content with error message so that if something
359 # fails we'll have something telling us what we intended.
365 }
368 /**
369 * Fetch a page record with the given conditions
370 * @param Database $dbr
371 * @param array $conditions
372 * @access private
373 */
394 }
396 /**
397 * @param Database $dbr
398 * @param Title $title
399 */
404 }
406 /**
407 * @param Database $dbr
408 * @param int $id
409 */
412 }
414 /**
415 * Set the general counter, title etc data loaded from
416 * some source.
417 *
418 * @param object $data
419 * @access private
420 */
425 }
442 }
444 }
447 }
449 /**
450 * Get text of an article from database
451 * Does *NOT* follow redirects.
452 * @param int $oldid 0 for whatever the latest revision is
453 * @return string
454 */
458 }
463 # Pre-fill content with error message so that if something
464 # fails we'll have something telling us what we intended.
468 }
476 }
481 }
488 wfDebug( "$fname failed to find page data for title " . $this->mTitle->getPrefixedText() . "\n" );
490 }
492 }
497 }
498 }
500 // FIXME: Horrible, horrible! This content-loading interface just plain sucks.
501 // We should instead work with the Revision object when we need it...
503 //$this->mContent = $revision->getText();
517 }
519 /**
520 * Read/write accessor to select FOR UPDATE
521 *
522 * @param mixed $x
523 */
526 }
528 /**
529 * Get the database which should be used for reads
530 *
531 * @return Database
532 */
536 }
538 /**
539 * Get options for all SELECT statements
540 *
541 * @param array $options an optional options array which'll be appended to
542 * the default
543 * @return array Options
544 */
551 }
552 }
554 }
556 /**
557 * @return int Page ID
558 */
564 }
565 }
567 /**
568 * @return bool Whether or not the page exists in the database
569 */
572 }
574 /**
575 * @return int The view count for the page
576 */
586 }
587 }
589 }
591 /**
592 * Determine whether a page would be suitable for being counted as an
593 * article in the site_stats table based on the title & its content
594 *
595 * @param string $text Text to analyze
596 * @return bool
597 */
602 return
606 }
608 /**
609 * Tests if the article text represents a redirect
610 *
611 * @param string $text
612 * @return bool
613 */
620 }
622 }
624 /**
625 * Returns true if the currently-referenced revision is the current edit
626 * to this page (and it exists).
627 * @return bool
628 */
633 }
635 /**
636 * Loads everything except the text
637 * This isn't necessary for all uses, so it's only done if needed.
638 * @access private
639 */
644 # New or non-existent articles have no user information
656 }
657 }
660 // Check if the field has been filled by ParserCache::get()
663 }
665 }
670 }
675 }
680 }
685 }
690 }
695 # XXX: this is expensive; cache this info somewhere.
711 GROUP BY rev_user, rev_user_text, user_real_name
721 }
725 }
727 /**
728 * This is the default action of the script: just view the page of
729 * the given title.
730 */
740 # Get variables from query string
743 # getOldID may want us to redirect somewhere else
748 }
756 # If we got diff and oldid in the query, we want to see a
757 # diff page instead of the article.
764 // DifferenceEngine directly fetched the revision:
769 # Run view updates for current revision only
771 }
774 }
783 # tell wgOut that output is taken care of
788 }
789 }
790 # Should the parser cache be used?
798 }
802 // This is an internally redirected page view.
803 // We'll need a backlink to the source page for navigation.
810 }
812 // This is an externally redirected view, from some other wiki.
813 // If it was reported from a trusted site, supply a backlink.
821 }
822 }
828 }
829 }
833 # Failed to load, replace text with error message
840 }
841 }
843 # Another whitelist check in case oldid is altering the title
848 }
850 # We're looking at an old revision
855 // FIXME: This would be a nice place to load the 'no such page' text.
865 // and we are allowed to see...
866 }
867 }
868 }
870 }
871 }
873 /**
874 * @fixme: this hook doesn't work most of the time, as it doesn't
875 * trigger when the parser cache is used.
876 */
879 # wrap user css and user js in pre and don't parse
880 # XXX: use $this->mTitle->usCssJsSubpage() when php is fixed/ a workaround is found
884 ) {
888 # Display redirect
893 }
904 # Display content and save to parser cache
907 # Display content, don't attempt to save to parser cache
909 # Don't show section-edit links on old revisions... this way lies madness.
912 }
913 # Display content and don't save to parser cache
918 }
919 }
920 }
921 /* title may have been set from the cache */
925 }
927 # If we have been passed an &rcid= parameter, we want to give the user a
928 # chance to mark this new article as patrolled.
933 $sk->makeKnownLinkObj( $this->mTitle, wfMsg('markaspatrolledtext'), "action=markpatrolled&rcid=$rcid" )
934 ) .
935 '</div>'
936 );
937 }
939 # Trackbacks
945 }
955 );
967 }
974 }
976 }
984 }
989 }
994 }
1000 }
1007 }
1009 /**
1010 * Handle action=purge
1011 */
1018 }
1031 }
1032 }
1034 /**
1035 * Perform the actions of a page purging
1036 */
1039 // Invalidate the cache
1043 // Commit the transaction before the purge is sent
1047 // Send purge
1050 }
1052 }
1054 /**
1055 * Insert a new empty page record for this article.
1056 * This *must* be followed up by creating a revision
1057 * and running $this->updateToLatest( $rev_id );
1058 * or else the record will be left in a funky state.
1059 * Best if all done inside a transaction.
1060 *
1061 * @param Database $dbw
1062 * @param string $restrictions
1063 * @return int The newly created page_id key
1064 * @access private
1065 */
1090 }
1092 /**
1093 * Update the page record to point to a newly saved revision.
1094 *
1095 * @param Database $dbw
1096 * @param Revision $revision For ID number, and text used to set
1097 length and redirect status fields
1098 * @param int $lastRevision If given, will not overwrite the page field
1099 * when different from the currently set value.
1100 * Giving 0 indicates the new page flag should
1101 * be set on.
1102 * @return bool true on success, false on failure
1103 * @access private
1104 */
1111 # An extra check against threads stepping on each other
1113 }
1123 ),
1129 }
1131 /**
1132 * If the given revision is newer than the currently set page_latest,
1133 * update the page record. Otherwise, do nothing.
1134 *
1135 * @param Database $dbw
1136 * @param Revision $revision
1137 */
1153 }
1156 # No or missing previous revision; mark the page as new
1158 }
1163 }
1165 /**
1166 * Insert a new article into the database
1167 * @access private
1168 */
1169 function insertNewArticle( $text, $summary, $isminor, $watchthis, $suppressRC=false, $comment=false ) {
1180 }
1188 # If this is a comment, add the summary as headline
1191 }
1194 /* Silently ignore minoredit if not allowed */
1200 # Add the page record; stake our claim on this title!
1203 # Save the revision text...
1209 ) );
1214 # Update the page record with revision data
1222 # Mark as patrolled if the user can and has the option set
1225 }
1226 }
1233 }
1234 }
1236 # The talk page isn't in the regular link tables, so we need to update manually:
1244 # standard deferred updates
1257 }
1259 function getTextOfLastEditWithSectionReplacedOrAdded($section, $text, $summary = '', $edittime = NULL) {
1261 }
1263 /**
1264 * @return string Complete article text, or null if error
1265 */
1276 }
1281 }
1289 # strip NOWIKI etc. to avoid confusion (true-parameter causes HTML
1290 # comments to be stripped as well)
1297 # now that we can be sure that no pseudo-sections are in the source,
1298 # split it up
1299 # Unfortunately we can't simply do a preg_replace because that might
1300 # replace the wrong section, so we have to use the section counter instead
1305 # section 0 is top (intro) section
1308 # headline of old section - we need to go through this section
1309 # to determine if there are any subsections that now need to
1310 # be erased, as the mother section has been replaced with
1311 # the text of all subsections.
1316 # determine headline level for wikimarkup headings
1319 }
1332 }
1334 // erase old subsections
1337 }
1340 }
1343 }
1345 }
1347 # reinsert the stuff that we stripped out earlier
1350 }
1352 }
1355 }
1357 /**
1358 * Change an existing article. Puts the previous version back into the old table, updates RC
1359 * and all necessary caches, mostly via the deferred update array.
1360 *
1361 * It is possible to call this function from a command-line script, but note that you should
1362 * first set $wgUser, and clean up $wgDeferredUpdates after each edit.
1363 */
1364 function updateArticle( $text, $summary, $minor, $watchthis, $forceBot = false, $sectionanchor = '' ) {
1378 }
1387 # Update article, but only if changed.
1389 # It's important that we either rollback or complete, otherwise an attacker could
1390 # overwrite cur entries by sending precisely timed user aborts. Random bored users
1391 # could conceivably have the same effect, especially if cur is locked for long periods.
1394 }
1416 ) );
1422 # Update page
1426 /* Belated edit conflict! Run away!! */
1430 # Update recentchanges and purge cache and whatnot
1437 # Mark as patrolled if the user can do so and has it set in their options
1440 }
1444 // Update caches outside the main transaction
1446 }
1448 // Keep the same revision ID, but do some updates on it
1450 }
1454 }
1463 }
1470 }
1471 }
1472 # standard deferred updates
1477 # Invalidate caches of all articles using this article as a template
1479 # Template namespace
1480 # Purge all articles linking here
1486 }
1487 }
1489 # Squid updates
1494 }
1496 # File cache
1500 }
1502 $this->showArticle( $text, wfMsg( 'updated' ), $sectionanchor, $isminor, $now, $summary, $lastRevision );
1503 }
1510 }
1512 /**
1513 * After we've either updated or inserted the article, update
1514 * the link tables and redirect to the new page.
1515 */
1522 # Output the redirect
1525 else
1530 }
1532 /**
1533 * Mark this particular edit as patrolled
1534 */
1539 # Check RC patrol config. option
1543 }
1545 # Check permissions
1549 }
1559 }
1562 }
1565 }
1566 }
1568 /**
1569 * User-interface handler for the "watch" action
1570 */
1579 }
1583 }
1592 }
1595 }
1597 /**
1598 * Add this page to $wgUser's watchlist
1599 * @return bool true on successful watch operation
1600 */
1605 }
1612 }
1615 }
1617 /**
1618 * User interface handler for the "unwatch" action.
1619 */
1627 }
1631 }
1640 }
1643 }
1645 /**
1646 * Stop watching a page
1647 * @return bool true on successful unwatch
1648 */
1653 }
1660 }
1663 }
1665 /**
1666 * action=protect handler
1667 */
1672 }
1674 /**
1675 * action=unprotect handler (alias)
1676 */
1679 }
1681 /**
1682 * Update the article's restriction field, and leave a log entry.
1683 *
1684 * @param array $limit set of restriction keys
1685 * @param string $reason
1686 * @return bool true on success
1687 */
1693 }
1697 }
1702 }
1718 );
1728 }
1729 }
1731 }
1733 /**
1734 * Take an array of page restrictions and flatten it to a string
1735 * suitable for insertion into the page_restrictions field.
1736 * @param array $limit
1737 * @return string
1738 * @access private
1739 */
1743 }
1748 }
1749 }
1751 }
1753 /*
1754 * UI entry point for page deletion
1755 */
1763 # This code desperately needs to be totally rewritten
1765 # Check permissions
1770 }
1774 }
1779 }
1783 # Better double-check that it hasn't been deleted yet!
1790 }
1795 }
1797 # determine whether this page has earlier revisions
1798 # and insert a warning if it does
1806 }
1808 # If a single user is responsible for all revisions, find out who they are
1810 // Query bailed out, too many revisions to find out if they're all the same
1818 }
1819 }
1820 }
1821 # Fetch article text
1825 # if this is a mini-text, we can paste part of it into the deletion reason
1828 #if this is empty, an earlier revision may contain "useful" text
1835 }
1836 }
1840 # this should not happen, since it is not possible to store an empty, new
1841 # page. Let's insert a standard text in case it does, though
1844 }
1847 # comment field=255, let's grep the first 150 to have some user
1848 # space left
1852 # let's strip out newlines
1860 }
1863 }
1864 }
1865 }
1868 }
1870 /**
1871 * Get the last N authors
1872 * @param int $num Number of revisions to get
1873 * @param string $revLatest The latest rev_id, selected from the master (optional)
1874 * @return array Array of authors, duplicates not removed
1875 */
1880 // First try the slave
1881 // If that doesn't have the latest revision, try the master
1890 'rev_page = page_id'
1894 ) )
1895 );
1899 }
1906 }
1912 }
1915 }
1917 /**
1918 * Output deletion confirmation dialog
1919 */
1938 <table border='0'>
1939 <tr>
1940 <td align='right'>
1942 </td>
1943 <td align='left'>
1944 <input type='text' size='60' name='wpReason' id='wpReason' value=\"" . htmlspecialchars( $reason ) . "\" />
1945 </td>
1946 </tr>
1947 <tr>
1948 <td> </td>
1949 <td>
1951 </td>
1952 </tr>
1953 </table>
1958 }
1961 /**
1962 * Perform a deletion and output success or failure messages
1963 */
1984 }
1985 }
1986 }
1988 /**
1989 * Back-end article deletion
1990 * Deletes the article with database consistency, writes logs, purges caches
1991 * Returns success
1992 */
2007 }
2014 # Squid purging
2019 );
2024 }
2026 # Client and file cache invalidation
2030 // For now, shunt the revision data into the archive table.
2031 // Text is *not* removed from the text table; bulk storage
2032 // is left intact to avoid breaking block-compression or
2033 // immutable storage schemes.
2034 //
2035 // For backwards compatibility, note that some older archive
2036 // table entries will have ar_text and ar_flags fields still.
2037 //
2038 // In the future, we may keep revisions and mark them with
2039 // the rev_deleted field, which is reserved for this purpose.
2053 'page_id = rev_page'
2055 );
2057 # Now that it's safely backed up, delete it
2064 # Clean up recentchanges entries...
2067 # Finally, clean up the link tables
2072 # Delete outgoing links
2079 # Log the deletion
2083 # Clear the cached article id so the interface doesn't act like we exist
2087 }
2089 /**
2090 * Revert a modification
2091 */
2100 }
2104 }
2109 }
2116 }
2119 # Enhanced rollback, marks edits rc_bot=1
2122 # Replace all this user's current edits with the next one down
2126 # Get the last editor, lock table exclusively
2130 # Something wrong... no page?
2134 }
2147 }
2149 }
2151 # Get the last edit not by this guy
2163 );
2165 # Something wrong
2170 }
2174 # Mark all reverted edits as bot
2176 }
2178 # Mark all reverted edits as patrolled
2180 }
2189 );
2190 }
2192 # Get the edit summary
2197 # Save it!
2202 $this->updateArticle( $target->getText(), $newComment, 1, $this->mTitle->userIsWatching(), $bot );
2207 }
2210 /**
2211 * Do standard deferred updates after page view
2212 * @access private
2213 */
2223 }
2224 }
2226 # Update newtalk / watchlist notification status
2229 }
2231 /**
2232 * Do standard deferred updates after page edit.
2233 * Every 1000th edit, prune the recent changes table.
2234 * @access private
2235 * @param string $text
2236 */
2243 # Parse the text
2248 # Save it to the parser cache
2252 # Update the links tables
2259 # Periodically flush old entries from the recentchanges table.
2267 }
2268 }
2277 }
2284 # If this is another user's talk page, update newtalk
2290 // An anonymous user
2293 }
2296 }
2297 }
2298 }
2302 }
2305 }
2307 /**
2308 * Generate the navigation links when browsing through an article revisions
2309 * It shows the information as:
2310 * Revision as of <date>; view current revision
2311 * <- Previous version | Next Version ->
2312 *
2313 * @access private
2314 * @param string $oldid Revision ID of this article revision
2315 */
2327 ? $sk->makeKnownLinkObj( $this->mTitle, wfMsg( 'previousrevision' ), 'direction=prev&oldid='.$oldid )
2331 : $sk->makeKnownLinkObj( $this->mTitle, wfMsg( 'nextrevision' ), 'direction=next&oldid='.$oldid );
2334 }
2336 /**
2337 * This function is called right before saving the wikitext,
2338 * so we can do things like signatures and links-in-context.
2339 *
2340 * @param string $text
2341 */
2344 return $wgParser->preSaveTransform( $text, $this->mTitle, $wgUser, ParserOptions::newFromUser( $wgUser ) );
2345 }
2347 /* Caching functions */
2349 /**
2350 * checkLastModified returns true if it has taken care of all
2351 * output to the client that is necessary for this request.
2352 * (that is, it has sent a cached version of the page)
2353 */
2359 }
2371 }
2374 }
2375 }
2377 /**
2378 * Check if the page can be cached
2379 * @return bool
2380 */
2397 }
2399 /**
2400 * Loads page_touched and returns a value indicating if it should be used
2401 *
2402 */
2407 }
2409 }
2411 /**
2412 * Get the page_touched field
2413 */
2415 # Ensure that page data has been loaded
2418 }
2420 }
2422 /**
2423 * Get the page_latest field
2424 */
2428 }
2430 }
2432 /**
2433 * Edit an article without doing all that other stuff
2434 * The article must already exist; link tables etc
2435 * are not updated, caches are not flushed.
2436 *
2437 * @param string $text text submitted
2438 * @param string $comment comment submitted
2439 * @param bool $minor whereas it's a minor modification
2440 */
2452 ) );
2458 }
2460 /**
2461 * Used to increment the view counter
2462 *
2463 * @static
2464 * @param integer $id article id
2465 */
2478 }
2480 # Not important enough to warrant an error page in case of failure
2487 # Most of the time (or on SQL errors), skip row count check
2490 }
2511 }
2513 }
2515 /**#@+
2516 * The onArticle*() functions are supposed to be a kind of hooks
2517 * which should be called whenever any of the specified actions
2518 * are done.
2519 *
2520 * This is a good place to put code to clear caches, for instance.
2521 *
2522 * This is called on page move and undelete, as well as edit
2523 * @static
2524 * @param $title_obj a title object
2525 */
2533 # Purge squid
2538 }
2541 }
2542 }
2551 }
2552 }
2554 /**
2555 * Purge caches on page update etc
2556 */
2562 // Template namespace? Purge all articles linking here.
2563 // FIXME: When a templatelinks table arrives, use it for all includes.
2570 }
2571 }
2572 }
2574 # Squid updates
2579 }
2581 # File cache
2585 }
2586 }
2588 /**#@-*/
2590 /**
2591 * Info about this page
2592 * Called for ?action=info when $wgAllowPageInfo is on.
2593 *
2594 * @access public
2595 */
2603 }
2610 # first, see if the page exists at all.
2617 }
2633 $wgOut->addHTML( "<ul><li>" . wfMsg("numwatchers", $wgLang->formatNum( $numwatchers ) ) . '</li>' );
2634 $wgOut->addHTML( "<li>" . wfMsg('numedits', $wgLang->formatNum( $pageInfo['edits'] ) ) . '</li>');
2636 $wgOut->addHTML( '<li>' . wfMsg("numtalkedits", $wgLang->formatNum( $talkInfo['edits'] ) ) . '</li>');
2637 }
2638 $wgOut->addHTML( '<li>' . wfMsg("numauthors", $wgLang->formatNum( $pageInfo['authors'] ) ) . '</li>' );
2640 $wgOut->addHTML( '<li>' . wfMsg('numtalkauthors', $wgLang->formatNum( $talkInfo['authors'] ) ) . '</li>' );
2641 }
2644 }
2645 }
2647 /**
2648 * Return the total number of edits and number of unique editors
2649 * on a given page. If page does not exist, returns false.
2650 *
2651 * @param Title $title
2652 * @return array
2653 * @access private
2654 */
2659 }
2681 }
2683 /**
2684 * Return a list of templates used by this article.
2685 * Uses the templatelinks table
2686 *
2687 * @return array Array of Title objects
2688 */
2694 }
2705 }
2706 }
2707 }
2710 }
2711 }
2713 ?>