| blob | 92bca9ef58ace8550c1c3332a3bff131107133c5 |
1 <?php
2 /**
3 * Contains the EditPage class
4 * @file
5 */
7 /**
8 * The edit page/HTML interface (split from Article)
9 * The actual database and text munging is still in Article,
10 * but it should get easier to call those from alternate
11 * interfaces.
12 *
13 * EditPage cares about two distinct titles:
14 * $this->mContextTitle is the page that forms submit to, links point to,
15 * redirects go to, etc. $this->mTitle (as well as $mArticle) is the
16 * page in the database that is actually being edited. These are
17 * usually the same, but they are now allowed to be different.
18 *
19 * Surgeon General's Warning: prolonged exposure to this class is known to cause
20 * headaches, which may be fatal.
21 */
24 /**
25 * Status: Article successfully updated
26 */
29 /**
30 * Status: Article successfully created
31 */
34 /**
35 * Status: Article update aborted by a hook function
36 */
39 /**
40 * Status: The filter function set in $wgFilterCallback returned true (= block it)
41 */
44 /**
45 * Status: A hook function returned an error
46 */
49 /**
50 * Status: User is blocked from editting this page
51 */
54 /**
55 * Status: Content too big (> $wgMaxArticleSize)
56 */
59 /**
60 * Status: User cannot edit? (not used)
61 */
64 /**
65 * Status: this anonymous user is not allowed to edit this page
66 */
69 /**
70 * Status: this logged in user is not allowed to edit this page
71 */
74 /**
75 * Status: wiki is in readonly mode (wfReadOnly() == true)
76 */
79 /**
80 * Status: rate limiter for action 'edit' was tripped
81 */
84 /**
85 * Status: article was deleted while editting and param wpRecreate == false or form
86 * was not posted
87 */
90 /**
91 * Status: user tried to create this page, but is not allowed to do that
92 * ( Title->usercan('create') == false )
93 */
96 /**
97 * Status: user tried to create a blank page
98 */
101 /**
102 * Status: (non-resolvable) edit conflict
103 */
106 /**
107 * Status: no edit summary given and the user has forceeditsummary set and the user is not
108 * editting in his own userspace or talkspace and wpIgnoreBlankSummary == false
109 */
112 /**
113 * Status: user tried to create a new section without content
114 */
117 /**
118 * Status: article is too big (> $wgMaxArticleSize), after merging in the new section
119 */
122 /**
123 * not used
124 */
127 /**
128 * Status: WikiPage::doEdit() was unsuccessfull
129 */
132 /**
133 * Status: summary contained spam according to one of the regexes in $wgSummarySpamRegex
134 */
137 /**
138 * Status: anonymous user is not allowed to upload (User::isAllowed('upload') == false)
139 */
142 /**
143 * Status: logged in user is not allowed to upload (User::isAllowed('upload') == false)
144 */
147 /**
148 * HTML id and name for the beginning of the edit form.
149 */
152 /**
153 * @var Article
154 */
157 /**
158 * @var Title
159 */
184 #var $mPreviewTemplates;
186 /**
187 * @var ParserOutput
188 */
191 /**
192 * Has a summary been preset using GET parameter &summary= ?
193 * @var Bool
194 */
200 # Form values
207 # Placeholders for text injection by hooks (must be HTML)
208 # extensions should take care to _append_ to the present value
219 /* $didSave should be set to true whenever an article was succesfully altered. */
225 /**
226 * @param $article Article
227 */
231 }
233 /**
234 * @return Article
235 */
238 }
240 /**
241 * @since 1.19
242 * @return Title
243 */
246 }
248 /**
249 * Set the context Title object
250 *
251 * @param $title Title object or null
252 */
255 }
257 /**
258 * Get the context title object.
259 * If not set, $wgTitle will be returned. This behavior might changed in
260 * the future to return $this->mTitle instead.
261 *
262 * @return Title object
263 */
270 }
271 }
275 }
277 /**
278 * This is the function that gets called for "action=edit". It
279 * sets up various member variables, then passes execution to
280 * another function, usually showEditForm()
281 *
282 * The edit form is self-submitting, so that when things like
283 * preview and edit conflicts occur, we get the same form back
284 * with the extra stuff added. Only when the final submission
285 * is made and all is well do we actually save and redirect to
286 * the newly-edited page.
287 */
290 // Allow extensions to modify/prevent this form or submission
293 }
298 // If they used redlink=1 and the page exists, redirect to the main article
303 }
312 }
315 // Force preview
318 }
332 }
333 }
338 // Auto-block user's IP if the account was "hard" blocked
345 }
350 // css / js subpages of user pages get a special treatment
357 # Show applicable editing introductions
360 }
362 # Attempt submission here. This will check for edit conflicts,
363 # and redundantly check for locked database, blocked IPs, etc.
364 # that edit() already checked just in case someone tries to sneak
365 # in the back door with a hand-edited submission URL.
372 }
373 }
375 # First time through: get contents, set time for conflict
376 # checking, etc.
383 }
386 else
388 }
393 }
395 /**
396 * @return array
397 */
401 # Can this title be created?
405 }
406 # Ignore some permissions errors when a user is just previewing/viewing diffs
411 {
413 }
414 }
417 }
419 /**
420 * Display a permissions error page, like OutputPage::showPermissionsErrorPage(),
421 * but with the following differences:
422 * - If redlink=1, the user will be redirected to the page
423 * - If there is content to display or the error occurs while either saving,
424 * previewing or showing the difference, it will be a
425 * "View source for ..." page displaying the source code after the error message.
426 *
427 * @since 1.19
428 * @param $permErrors Array of permissions errors, as returned by
429 * Title::getUserPermissionsErrors().
430 */
435 // The edit page was reached via a red link.
436 // Redirect to the article page and let them click the edit tab if
437 // they really want a permission error.
440 }
444 # Use the normal message if there's nothing to display
449 }
451 $wgOut->setPageTitle( wfMessage( 'viewsource-title', $this->getContextTitle()->getPrefixedText() ) );
456 # If the user made changes, preserve them when showing the markup
457 # (This happens when a user is blocked during edit, for instance)
463 }
472 }
473 }
475 /**
476 * Show a read-only error
477 * Parameters are the same as OutputPage:readOnlyPage()
478 * Redirect to the article page if redlink=1
479 * @deprecated in 1.19; use displayPermissionsError() instead
480 */
481 function readOnlyPage( $source = null, $protected = false, $reasons = array(), $action = null ) {
486 // The edit page was reached via a red link.
487 // Redirect to the article page and let them click the edit tab if
488 // they really want a permission error.
492 }
493 }
495 /**
496 * Should we show a preview when the edit form is first shown?
497 *
498 * @return bool
499 */
503 // Explicit override from request
506 // Explicit override from request
509 // Nothing *to* preview for new sections
511 } elseif ( ( $wgRequest->getVal( 'preload' ) !== null || $this->mTitle->exists() ) && $wgUser->getOption( 'previewonfirst' ) ) {
512 // Standard preference behaviour
517 {
518 // Categories are special
522 }
523 }
525 /**
526 * Checks whether the user entered a skin name in uppercase,
527 * e.g. "User:Example/Monobook.css" instead of "monobook.css"
528 *
529 * @return bool
530 */
537 );
542 }
543 }
545 /**
546 * Does this EditPage class support section editing?
547 * This is used by EditPage subclasses to indicate their ui cannot handle section edits
548 *
549 * @return bool
550 */
553 }
555 /**
556 * This function collects the form data and uses it to populate various member variables.
557 * @param $request WebRequest
558 */
564 # Section edit can come from either the form or a link
568 # These fields need to be checked for encoding.
569 # Also remove trailing whitespace, but don't remove _initial_
570 # whitespace from the text boxes. This may be significant formatting.
573 // Skip this if wpTextbox2 has input, it indicates that we came
574 // from a conflict page with raw page text, not a custom form
575 // modified by subclasses
581 }
583 # Truncate for whole multibyte characters. +5 bytes for ellipsis
586 # If the summary consists of a heading, e.g. '==Foobar==', extract the title from the
587 # header syntax, e.g. 'Foobar'. This is mainly an issue when we are using wpSummary for
588 # section titles.
591 # Treat sectiontitle the same way as summary.
592 # Note that wpSectionTitle is not yet a part of the actual edit form, as wpSummary is
593 # currently doing double duty as both edit summary and section title. Right now this
594 # is just to allow API edits to work around this limitation, but this should be
595 # incorporated into the actual edit form when EditPage is rewritten (Bugs 18654, 26312).
605 // wpTextbox1 field is missing, possibly due to being "too big"
606 // according to some filter rules such as Suhosin's setting for
607 // suhosin.request.max_value_length (d'oh)
610 // edittime should be one of our last fields; if it's missing,
611 // the submission probably broke somewhere in the middle.
613 }
615 # If the form is incomplete, force to preview.
620 /* Fallback for live preview */
624 // Remember whether a save was requested, so we can indicate
625 // if we forced preview due to session failure.
629 # Some browsers will not report any submit button
630 # if the user hits enter in the comment box.
631 # The unmarked state will be assumed to be a save,
632 # if the form seems otherwise complete.
635 # Failed token check, but only requested "Show Changes".
638 # Page might be a hack attempt posted from
639 # an external site. Preview instead of saving.
642 }
643 }
647 }
651 }
658 # Don't force edit summaries when a user is editing their own user or talk page
661 {
664 $this->allowBlankSummary = $request->getBool( 'wpIgnoreBlankSummary' ) || !$wgUser->getOption( 'forceeditsummary' );
665 }
669 # Not a posted form? Start with nothing.
681 $this->watchthis = $request->getBool( 'watchthis', false ); // Watch may be overriden by request parameters
684 // When creating a new section, we can preload a section title by passing it as the
685 // preloadtitle parameter in the URL (Bug 13100)
688 // Once wpSummary isn't being use for setting section titles, we should delete this.
690 }
695 }
696 }
700 }
701 }
710 // Custom edit intro for new sections
713 // Allow extensions to modify form data
717 }
719 /**
720 * Subpage overridable method for extracting the page content data from the
721 * posted form to be placed in $this->textbox1, if using customized input
722 * this method should be overrided and return the page text that will be used
723 * for saving, preview parsing and so on...
724 *
725 * @param $request WebRequest
726 */
729 }
731 /**
732 * Initialise form fields in the object
733 * Called on the first invocation, e.g. when a user clicks an edit link
734 * @return bool -- if the requested section is valid
735 */
740 // activate checkboxes if user wants them to be always active
741 # Sort out the "watch" checkbox
743 # Watch all edits
746 # Watch creations
749 # Already watched
751 }
754 }
757 }
760 }
762 /**
763 * Fetch initial editing page content.
764 *
765 * @param $def_text string
766 * @return mixed string on success, $def_text for invalid sections
767 * @private
768 */
776 // For message page not locally set, use the i18n message.
777 // For other non-existent articles, use preload text if any.
780 # If this is a system message, get the default text.
782 }
784 # If requested, preload some text.
786 // Custom preload text for new sections
789 }
790 // For existing pages, get text based on "undo" or section parameters.
793 // Get section edit text (returns $def_text for invalid sections)
801 # If they got undoafter and undo round the wrong way, switch them
803 }
808 # Sanity check, make sure it's the right page,
809 # the revisions exist and they were not deleted.
810 # Otherwise, $text will be left as-is.
819 # Warn the user that something went wrong
822 # Inform the user of our success and set an automatic edit summary
825 # If we just undid one rev, use an autosummary
833 }
835 }
837 }
839 // Failed basic sanity checks.
840 // Older revisions may have been removed since the link
841 // was created, or we may simply have got bogus input.
843 }
848 }
852 }
853 }
854 }
858 }
860 /**
861 * Get the content of the wanted revision, without section extraction.
862 *
863 * The result of this function can be used to compare user's input with
864 * section replaced in its context (using WikiPage::replaceSection())
865 * to the original text of the edit.
866 *
867 * This difers from Article::getContent() that when a missing revision is
868 * encountered the result will be an empty string and not the
869 * 'missing-article' message.
870 *
871 * @since 1.19
872 * @return string
873 */
877 }
881 }
883 }
885 /**
886 * Get the actual text of the page. This is basically similar to
887 * WikiPage::getRawText() except that when the page doesn't exist an empty
888 * string is returned instead of false.
889 *
890 * @since 1.19
891 * @return string
892 */
899 }
900 }
902 /**
903 * Use this method before edit() to preload some text into the edit box
904 *
905 * @param $text string
906 */
909 }
911 /**
912 * Get the contents to be preloaded into the box, either set by
913 * an earlier setPreloadText() or by loading the given page.
914 *
915 * @param $preload String: representing the title to preload from.
916 * @return String
917 */
923 }
927 }
930 # Check for existence to avoid getting MediaWiki:Noarticletext
933 }
938 # Same as before
941 }
943 }
947 }
949 /**
950 * Make sure the form isn't faking a user's credentials.
951 *
952 * @param $request WebRequest
953 * @return bool
954 * @private
955 */
962 }
964 /**
965 * Attempt submission
966 * @return bool false if output is done, true if the rest of the form should be displayed
967 */
972 # Allow bots to exempt some edits from bot flagging
975 // FIXME: once the interface for internalAttemptSave() is made nicer, this should use the message in $status
977 if ( $status->value == self::AS_SUCCESS_UPDATE || $status->value == self::AS_SUCCESS_NEW_ARTICLE ) {
979 }
1006 // Give extensions a chance to modify URL query on update
1007 wfRunHooks( 'ArticleUpdateBeforeRedirect', array( $this->mArticle, &$sectionanchor, &$extraQuery ) );
1014 }
1015 }
1048 }
1050 }
1052 /**
1053 * Attempt submission (no UI)
1054 *
1055 * @param $result
1056 * @param $bot bool
1057 *
1058 * @return Status object, possibly with a message, but always with one of the AS_* constants in $status->value,
1059 *
1060 * FIXME: This interface is TERRIBLE, but hard to get rid of due to various error display idiosyncrasies. There are
1061 * also lots of cases where error metadata is set in the object and retrieved later instead of being returned, e.g.
1062 * AS_CONTENT_TOO_BIG and AS_BLOCKED_PAGE_FOR_USER. All that stuff needs to be cleaned up some time.
1063 */
1080 }
1082 # Check image redirect
1093 }
1095 # Check for spam
1099 }
1111 }
1112 if ( $wgFilterCallback && is_callable( $wgFilterCallback ) && $wgFilterCallback( $this->mTitle, $this->textbox1, $this->section, $this->hookError, $this->summary ) ) {
1113 # Error messages or other handling should be performed by the filter function
1118 }
1119 if ( !wfRunHooks( 'EditFilter', array( $this, $this->textbox1, $this->section, &$this->hookError, $this->summary ) ) ) {
1120 # Error messages etc. could be handled within the hook...
1127 # ...or the hook could be expecting us to produce an error
1133 }
1136 // Auto-block user's IP if the account was "hard" blocked
1138 # Check block state against master, thus 'false'.
1143 }
1147 // Error will be displayed by showEditForm()
1153 }
1167 }
1168 }
1176 }
1183 }
1185 # If the article has been deleted while editing, don't save it without
1186 # confirmation
1192 }
1196 # If article is new, insert it.
1201 // Late check for create permission, just in case *PARANOIA*
1208 }
1210 # Don't save a new article if it's blank.
1215 }
1217 // Run post-section-merge edit filter
1218 if ( !wfRunHooks( 'EditFilterMerged', array( $this, $this->textbox1, &$this->hookError, $this->summary ) ) ) {
1219 # Error messages etc. could be handled within the hook...
1225 # ...or the hook could be expecting us to produce an error
1230 }
1236 // Insert the section title above the content.
1237 $text = wfMsgForContent( 'newsectionheaderdefaultlevel', $this->sectiontitle ) . "\n\n" . $text;
1239 // Jump to the new section
1240 $result['sectionanchor'] = $wgParser->guessLegacySectionNameFromWikiText( $this->sectiontitle );
1242 // If no edit summary was specified, create one automatically from the section
1243 // title and have it link to the new section. Otherwise, respect the summary as
1244 // passed.
1248 }
1250 // Insert the section title above the content.
1253 // Jump to the new section
1256 // Create a link to the new section from the edit summary.
1259 }
1260 }
1266 # Article exists. Check for edit conflict.
1278 // Probably a duplicate submission of a new comment.
1279 // This can happen when squid resends a request after
1280 // a timeout but the first one actually went through.
1283 // New comment; suppress conflict.
1286 }
1287 } elseif ( $this->section == '' && $this->userWasLastToEdit( $wgUser->getId(), $this->edittime ) ) {
1288 # Suppress edit conflict with self, except for section edits where merging is required.
1291 }
1292 }
1294 // If sectiontitle is set, use it, otherwise use the summary as the section title (for
1295 // backwards compatibility with old forms/bots).
1300 }
1303 wfDebug( __METHOD__ . ": conflict! getting section '$this->section' for time '$this->edittime' (article time '{$timestamp}')\n" );
1304 $text = $this->mArticle->replaceSection( $this->section, $this->textbox1, $sectionTitle, $this->edittime );
1308 }
1314 # Attempt merge
1316 // Successful merge! Maybe we should tell the user the good news?
1323 }
1324 }
1330 }
1332 // Run post-section-merge edit filter
1333 if ( !wfRunHooks( 'EditFilterMerged', array( $this, $text, &$this->hookError, $this->summary ) ) ) {
1334 # Error messages etc. could be handled within the hook...
1340 # ...or the hook could be expecting us to produce an error
1345 }
1347 # Handle the user preference to force summaries here, but not for null edits
1351 {
1358 }
1359 }
1361 # And a similar thing for new sections
1369 }
1370 }
1372 # All's well
1383 }
1386 // If no edit summary was specified, create one automatically from the section
1387 // title and have it link to the new section. Otherwise, respect the summary as
1388 // passed.
1392 }
1395 # This is a new section, so create a link to the new section
1396 # in the revision summary.
1399 }
1401 # Try to get a section anchor from the section source, redirect to edited section if header found
1402 # XXX: might be better to integrate this into Article::replaceSection
1403 # for duplicate heading checking and maybe parsing
1405 # we can't deal with anchors, includes, html etc in the header for now,
1406 # headline would need to be parsed to improve this
1409 }
1410 }
1414 // Save errors may fall down to the edit form, but we've now
1415 // merged the section into full text. Clear the section field
1416 // so that later submission of conflict forms won't try to
1417 // replace that into a duplicated mess.
1422 }
1424 // Check for length errors again now that the section is merged in
1431 }
1447 $doEditStatus->value = self::AS_END; // Destroys data doEdit() put in $status->value but who cares
1450 }
1451 }
1453 /**
1454 * Commit the change of watch status
1455 */
1465 }
1467 }
1468 }
1470 /**
1471 * Check if no edits were made by other users since
1472 * the time a user started editing the page. Limit to
1473 * 50 revisions for the sake of performance.
1474 *
1475 * @param $id int
1476 * @param $edittime string
1477 *
1478 * @return bool
1479 */
1488 ),
1489 __METHOD__,
1494 }
1495 }
1497 }
1499 /**
1500 * @private
1501 * @todo document
1502 *
1503 * @parma $editText string
1504 *
1505 * @return bool
1506 */
1512 // This is the revision the editor started from
1517 }
1520 // The current state, we want to merge updates into it
1525 }
1536 }
1537 }
1539 /**
1540 * @return Revision
1541 */
1550 }
1551 }
1553 /**
1554 * Check given input text against $wgSpamRegex, and return the text of the first match.
1555 *
1556 * @param $text string
1557 *
1558 * @return string|bool matching string or false
1559 */
1562 // For back compatibility, $wgSpamRegex may be a single string or an array of regexes.
1565 }
1567 /**
1568 * Check given input text against $wgSpamRegex, and return the text of the first match.
1569 *
1570 * @parma $text string
1571 *
1572 * @return string|bool matching string or false
1573 */
1578 }
1580 /**
1581 * @param $text string
1582 * @param $regexes array
1583 * @return bool|string
1584 */
1590 }
1591 }
1593 }
1602 }
1603 // Bug #19334: textarea jumps when editing articles in IE8
1608 # Enabled article-related sidebar, toplinks, etc.
1617 $msg = $contextTitle->exists() || ( $contextTitle->getNamespace() == NS_MEDIAWIKI && $contextTitle->getDefaultMessageText() !== false ) ?
1619 }
1620 # Use the title defined by DISPLAYTITLE magic word when present
1621 $displayTitle = isset( $this->mParserOutput ) ? $this->mParserOutput->getDisplayTitle() : false;
1624 }
1626 }
1628 /**
1629 * Show all applicable editing introductions
1630 */
1635 }
1640 # Show a warning if editing an interface message
1643 # Show a hint to shared repo
1647 # there must be a description url to show a hint to shared repo
1652 ) );
1656 ) );
1657 }
1658 }
1659 }
1660 }
1662 # Show a warning message when someone creates/edits a user (talk) page but the user does not exist
1663 # Show log extract when the user is currently blocked
1684 )
1685 )
1686 );
1687 }
1688 }
1689 # Try to add a custom edit intro, or use the standard one if this is not possible.
1694 $wgOut->wrapWikiMsg( "<div class=\"mw-newarticletextanon\">\n$1\n</div>", 'newarticletextanon' );
1695 }
1696 }
1697 # Give a notice if the user is editing a deleted/moved page...
1704 );
1705 }
1706 }
1708 /**
1709 * Attempt to show a custom editing introduction, if supplied
1710 *
1711 * @return bool
1712 */
1718 // Added using template syntax, to take <noinclude>'s into account.
1723 }
1726 }
1727 }
1729 /**
1730 * Send the edit form and related headers to $wgOut
1731 * @param $formCallback Callback that takes an OutputPage parameter; will be called
1732 * during form output near the top, for captchas and the like.
1733 */
1739 # need to parse the preview early so that we know which templates are used,
1740 # otherwise users with "show preview after edit box" will get a blank list
1741 # we parse this near the beginning so that setHeaders can do the title
1742 # setting work instead of leaving it in getPreviewText
1746 }
1755 }
1761 }
1768 // Hide the toolbar and edit area, user can click preview to get it back
1769 // Add an confirmation checkbox and explanation.
1774 }
1775 }
1777 $wgOut->addHTML( Html::openElement( 'form', array( 'id' => self::EDITFORM_ID, 'name' => self::EDITFORM_ID,
1783 }
1787 // Put these up at the top to ensure they aren't lost on early form submission
1794 // It is better to not parse the comment at all than to have templates expanded in the middle
1795 // TODO: can the checkLabel be moved outside of the div so that wrapWikiMsg could be used?
1797 ? 'confirmrecreate-noreason'
1804 ) .
1805 '</div>'
1806 );
1807 }
1809 # When the summary is hidden, also hide them on preview/show changes
1812 }
1814 # If a blank edit summary was previously provided, and the appropriate
1815 # user preference is active, pass a hidden tag as wpIgnoreBlankSummary. This will stop the
1816 # user being bounced back more than once in the event that a summary
1817 # is not required.
1818 #####
1819 # For a bit more sophisticated detection of blank summaries, hash the
1820 # automatic one and pass that in the hidden field wpAutoSummary.
1823 }
1826 // If a summary has been preset using &summary= we dont want to prompt for
1827 // a different summary. Only prompt for a summary if the summary is blanked.
1828 // (Bug 17416)
1830 }
1840 }
1846 }
1849 // In an edit conflict bypass the overrideable content form method
1850 // and fallback to the raw wpTextbox1 since editconflicts can't be
1851 // resolved between page source edits and custom ui edits using the
1852 // custom edit ui.
1859 }
1885 }
1891 }
1894 }
1896 /**
1897 * Extract the section title from current section text, if any.
1898 *
1899 * @param string $text
1900 * @return Mixed|string or false
1901 */
1909 }
1910 }
1917 }
1919 # Optional notices on a per-namespace and per-page basis
1924 }
1933 }
1934 }
1936 # Even if there are no subpages in namespace, we still don't want / in MW ns.
1941 }
1942 }
1949 // We use $this->section to much before this and getVal('wgSection') directly in other places
1950 // at this point we can't reset $this->section to '' to fallback to non-section editing.
1951 // Someone is welcome to try refactoring though
1954 }
1961 }
1962 }
1963 }
1967 }
1971 }
1974 $wgOut->wrapWikiMsg( "<div id='mw-missingcommentheader'>\n$1\n</div>", 'missingcommentheader' );
1975 }
1979 }
1983 }
1988 // Let sysop know that this will make private content public if saved
1991 $wgOut->wrapWikiMsg( "<div class='mw-warning plainlinks'>\n$1\n</div>\n", 'rev-deleted-text-permission' );
1993 $wgOut->wrapWikiMsg( "<div class='mw-warning plainlinks'>\n$1\n</div>\n", 'rev-deleted-text-view' );
1994 }
1999 }
2001 // Something went wrong
2006 }
2007 }
2008 }
2011 $wgOut->wrapWikiMsg( "<div id=\"mw-read-only-warning\">\n$1\n</div>", array( 'readonlywarning', wfReadOnlyReason() ) );
2017 }
2020 # Check the skin exists
2022 $wgOut->wrapWikiMsg( "<div class='error' id='mw-userinvalidcssjstitle'>\n$1\n</div>", array( 'userinvalidcssjstitle', $this->mTitle->getSkinFromCssJsSubpage() ) );
2023 }
2026 $wgOut->wrapWikiMsg( "<div id='mw-usercssyoucanpreview'>\n$1\n</div>", array( 'usercssyoucanpreview' ) );
2028 $wgOut->wrapWikiMsg( "<div id='mw-userjsyoucanpreview'>\n$1\n</div>", array( 'userjsyoucanpreview' ) );
2029 }
2030 }
2031 }
2034 # Is the title semi-protected?
2038 # Then it must be protected based on static groups (regular)
2040 }
2043 }
2045 # Is this page under cascading protection from some source pages?
2050 # Explain, and list the titles responsible
2053 }
2054 }
2057 }
2064 }
2068 }
2072 array( 'longpageerror', $wgLang->formatNum( $this->kblength ), $wgLang->formatNum( $wgMaxArticleSize ) ) );
2076 array( 'longpage-hint', $wgLang->formatSize( strlen( $this->textbox1 ) ), strlen( $this->textbox1 ) )
2077 );
2078 }
2079 }
2080 }
2082 /**
2083 * Standard summary input and label (wgSummary), abstracted so EditPage
2084 * subclasses may reorganize the form.
2085 * Note that you do not need to worry about the label's for=, it will be
2086 * inferred by the id given to the input. You can remove them both by
2087 * passing array( 'id' => false ) to $userInputAttrs.
2088 *
2089 * @param $summary string The value of the summary input
2090 * @param $labelText string The html to place inside the label
2091 * @param $inputAttrs array of attrs to use on the input
2092 * @param $spanLabelAttrs array of attrs to use on the span inside the label
2093 *
2094 * @return array An array in the format array( $label, $input )
2095 */
2096 function getSummaryInput( $summary = "", $labelText = null, $inputAttrs = null, $spanLabelAttrs = null ) {
2097 // Note: the maxlength is overriden in JS to 250 and to make it use UTF-8 bytes, not characters.
2109 );
2113 $label = Xml::tags( 'label', $inputAttrs['id'] ? array( 'for' => $inputAttrs['id'] ) : null, $labelText );
2115 }
2120 }
2122 /**
2123 * @param $isSubjectPreview Boolean: true if this is the section subject/title
2124 * up top, or false if this is the comment summary
2125 * down below the textarea
2126 * @param $summary String: The text of the summary to display
2127 * @return String
2128 */
2131 # Add a class if 'missingsummary' is triggered to allow styling of the summary line
2136 }
2140 }
2141 }
2144 list( $label, $input ) = $this->getSummaryInput( $summary, $labelText, array( 'class' => $summaryClass ), array() );
2146 }
2148 /**
2149 * @param $isSubjectPreview Boolean: true if this is the section subject/title
2150 * up top, or false if this is the comment summary
2151 * down below the textarea
2152 * @param $summary String: the text of the summary to display
2153 * @return String
2154 */
2166 $summary = wfMsgExt( $message, 'parseinline' ) . Linker::commentBlock( $summary, $this->mTitle, $isSubjectPreview );
2168 }
2179 HTML
2180 );
2183 }
2187 /**
2188 * To make it harder for someone to slip a user a page
2189 * which submits an edit form to the wiki without their
2190 * knowledge, a random token is associated with the login
2191 * session. If it's not passed back with the submission,
2192 * we won't save the page, or render user JavaScript and
2193 * CSS previews.
2194 *
2195 * For anon editors, who may not have a session, we just
2196 * include the constant suffix to prevent editing from
2197 * broken text-mangling proxies.
2198 */
2200 }
2202 /**
2203 * Subpage overridable method for printing the form for page content editing
2204 * By default this simply outputs wpTextbox1
2205 * Subclasses can override this to provide a custom UI for editing;
2206 * be it a form, or simply wpTextbox1 with a modified content that will be
2207 * reverse modified when extracted from the post data.
2208 * Note that this is basically the inverse for importContentFormData
2209 */
2212 }
2214 /**
2215 * Method to output wpTextbox1
2216 * The $textoverride method can be used by subclasses overriding showContentForm
2217 * to pass back to this method.
2218 *
2219 * @param $customAttribs array of html attributes to use in the textarea
2220 * @param $textoverride String: optional text to override $this->textarea1 with
2221 */
2228 # Is the title semi-protected?
2232 # Then it must be protected based on static groups (regular)
2234 }
2235 # Is the title cascade-protected?
2238 }
2239 }
2245 }
2250 }
2252 }
2253 }
2255 $this->showTextbox( $textoverride !== null ? $textoverride : $this->textbox1, 'wpTextbox1', $attribs );
2256 }
2260 }
2267 // Ensure there's a newline at the end, otherwise adding lines
2268 // is awkward.
2269 // But don't add a newline if the ext is empty, or Firefox in XHTML
2270 // mode will show an extra newline. A bit annoying.
2272 }
2279 'style' => '' // avoid php notices when appending preferences (appending allows customAttribs['style'] to still work
2280 );
2287 }
2304 }
2310 }
2311 }
2313 /**
2314 * Append preview output to $wgOut.
2315 * Includes category rendering if this is a category page.
2316 *
2317 * @param $text String: the HTML to be output for the preview.
2318 */
2323 }
2324 # This hook seems slightly odd here, but makes things more
2325 # consistent for extensions.
2330 }
2331 }
2333 /**
2334 * Get a diff between the current contents of the edit box and the
2335 * version of the page we're editing from.
2336 *
2337 * If this is a section edit, we'll replace the section as for final
2338 * save and then make a comparison.
2339 */
2344 # if message does not exist, show diff against the preloaded default
2349 }
2352 }
2371 }
2374 }
2376 /**
2377 * Give a chance for site and per-namespace customizations of
2378 * terms of service summary link that might exist separately
2379 * from the copyright notice.
2380 *
2381 * This will display between the save button and the edit tools,
2382 * so should remain short!
2383 */
2392 }
2393 }
2400 }
2411 }
2412 // Allow for site and per-namespace customization of contribution/copyright notice.
2417 }
2426 }
2437 }
2444 }
2446 /**
2447 * Show an edit conflict. textbox1 is already shown in showEditForm().
2448 * If you want to use another entry point to this function, be careful.
2449 */
2462 }
2463 }
2465 /**
2466 * @return string
2467 */
2472 }
2478 $cancelParams
2479 );
2480 }
2482 /**
2483 * Returns the URL to use in the form's action attribute.
2484 * This is used by EditPage subclasses when simply customizing the action
2485 * variable in the constructor is not enough. This can be used when the
2486 * EditPage lives inside of a Special page rather than a custom page action.
2487 *
2488 * @param $title Title object for which is being edited (where we go to for &action= links)
2489 * @return string
2490 */
2493 }
2495 /**
2496 * Check if a page was deleted while the user was editing it, before submit.
2497 * Note that we rely on the logging table, which hasn't been always there,
2498 * but that doesn't matter, because this only applies to brand new
2499 * deletes.
2500 */
2504 }
2514 }
2515 }
2516 }
2519 }
2540 __METHOD__,
2542 );
2543 // Quick paranoid permission checks...
2549 }
2551 }
2553 /**
2554 * Get the rendered text for previewing.
2555 * @return string
2556 */
2563 // Could be an offsite preview attempt. This is very unsafe if
2564 // HTML is enabled, as it could be an attack.
2567 // Do not put big scary notice, if previewing the empty
2568 // string, which happens when you initially edit
2569 // a category page, due to automatic preview-on-open.
2572 }
2575 }
2582 }
2587 ' [[#' . self::EDITFORM_ID . '|' . $wgLang->getArrow() . ' ' . wfMsg( 'continue-editing' ) . ']]';
2588 }
2596 # don't parse non-wikitext pages, show message about preview
2604 }
2606 # Used messages to make sure grep find them:
2607 # Messages: usercsspreview, userjspreview, sitecsspreview, sitejspreview
2611 $previewtext = "<div id='mw-{$level}csspreview'>\n" . wfMsg( "{$level}csspreview" ) . "\n</div>";
2614 $previewtext = "<div id='mw-{$level}jspreview'>\n" . wfMsg( "{$level}jspreview" ) . "\n</div>";
2618 }
2623 }
2625 $previewHTML .= "<pre class=\"$class\" dir=\"ltr\">\n" . htmlspecialchars( $this->textbox1 ) . "\n</pre>\n";
2629 # If we're adding a comment, we need to show the
2630 # summary as the headline
2632 $toparse = wfMsgForContent( 'newsectionheaderdefaultlevel', $this->summary ) . "\n\n" . $toparse;
2633 }
2647 }
2654 }
2655 }
2658 $conflict = '<h2 id="mw-previewconflict">' . htmlspecialchars( wfMsg( 'previewconflict' ) ) . "</h2>\n";
2661 }
2674 }
2676 /**
2677 * @return Array
2678 */
2684 }
2688 }
2689 }
2693 }
2694 }
2696 /**
2697 * Shows a bulletin board style toolbar for common editing functions.
2698 * It can be disabled in the user preferences.
2699 * The necessary JavaScript code can be found in skins/common/edit.js.
2700 *
2701 * @return string
2702 */
2709 /**
2710 * $toolarray is an array of arrays each of which includes the
2711 * filename of the button image (without path), the opening
2712 * tag, the closing tag, optionally a sample text that is
2713 * inserted between the two when no selection is highlighted
2714 * and. The tip text is shown when the user moves the mouse
2715 * over the button.
2716 *
2717 * Also here: accesskeys (key), which are not used yet until
2718 * someone can figure out a way to make them work in
2719 * IE. However, we should make sure these keys are not defined
2720 * on the edit page.
2721 */
2731 ),
2740 ),
2749 ),
2758 ),
2767 ),
2803 ),
2812 ),
2821 )
2822 );
2828 }
2832 // Note that we use the tip both for the ALT tag and the TITLE tag of the image.
2833 // Older browsers show a "speedtip" type message only for ALT.
2834 // Ideally these should be different, realistically they
2835 // probably don't need to be.
2841 );
2844 }
2846 // This used to be called on DOMReady from mediawiki.action.edit, which
2847 // ended up causing race conditions with the setup code above.
2853 $wgOut->addScript( Html::inlineScript( ResourceLoader::makeLoaderConditionalScript( $script ) ) );
2860 }
2862 /**
2863 * Returns an array of html code of the following checkboxes:
2864 * minor and watch
2865 *
2866 * @param $tabindex int Current tabindex
2867 * @param $checked Array of checkbox => bool, where bool indicates the checked
2868 * status of the checkbox
2869 *
2870 * @return array
2871 */
2877 // don't show the minor edit checkbox if it's a new page or section
2886 );
2890 Xml::expandAttributes( array( 'title' => Linker::titleAttrib( 'minoredit', 'withaccess' ) ) ) .
2892 }
2893 }
2902 );
2908 }
2911 }
2913 /**
2914 * Returns an array of html code of the following buttons:
2915 * save, diff, preview and live
2916 *
2917 * @param $tabindex int Current tabindex
2918 *
2919 * @return array
2920 */
2932 );
2944 );
2956 );
2961 }
2963 /**
2964 * Output preview text only. This can be sucked into the edit page
2965 * via JavaScript, and saves the server time rendering the skin as
2966 * well as theoretically being more robust on the client (doesn't
2967 * disturb the edit box's undo history, won't eat your text on
2968 * failure, etc).
2969 *
2970 * @todo This doesn't include category or interlanguage links.
2971 * Would need to enhance it a bit, <s>maybe wrap them in XML
2972 * or something...</s> that might also require more skin
2973 * initialization, so check whether that's a problem.
2974 */
2982 #$categories = $skin->getCategoryLinks();
2988 #. Xml::element( 'category', null, $categories )
2989 );
2991 }
2993 /**
2994 * Call the stock "user is blocked" page
2995 *
2996 * @deprecated in 1.19; throw an exception directly instead
2997 */
3003 }
3005 /**
3006 * Produce the stock "please login to edit pages" page
3007 *
3008 * @deprecated in 1.19; throw an exception directly instead
3009 */
3013 }
3015 /**
3016 * Show an error page saying to the user that he has insufficient permissions
3017 * to create a new page
3018 *
3019 * @deprecated in 1.19; throw an exception directly instead
3020 */
3025 }
3027 /**
3028 * Creates a basic error page which informs the user that
3029 * they have attempted to edit a nonexistent section.
3030 */
3041 }
3043 /**
3044 * Produce the stock "your edit contains spam" page
3045 *
3046 * @param $match string Text which triggered one or more filters
3047 * @deprecated since 1.17 Use method spamPageWithContent() instead
3048 */
3060 }
3064 }
3066 /**
3067 * Show "your edit contains spam" page with your diff and text
3068 *
3069 * @param $match string|Array|bool Text (or array of texts) which triggered one or more filters
3070 */
3077 }
3084 }
3094 }
3096 /**
3097 * Format an anchor fragment as it would appear for a given section name
3098 * @param $text String
3099 * @return String
3100 * @private
3101 */
3105 }
3107 /**
3108 * Check if the browser is on a blacklist of user-agents known to
3109 * mangle UTF-8 data on form submission. Returns true if Unicode
3110 * should make it through, false if it's known to be a problem.
3111 * @return bool
3112 * @private
3113 */
3117 // No User-Agent header sent? Trust it by default...
3119 }
3124 }
3125 }
3127 }
3129 /**
3130 * Filter an input field through a Unicode de-armoring process if it
3131 * came from an old browser with known broken Unicode editing issues.
3132 *
3133 * @param $request WebRequest
3134 * @param $field String
3135 * @return String
3136 * @private
3137 */
3143 }
3145 /**
3146 * @param $request WebRequest
3147 * @param $text string
3148 * @return string
3149 */
3155 }
3157 /**
3158 * Filter an output field through a Unicode armoring process if it is
3159 * going to an old browser with known broken Unicode editing issues.
3160 *
3161 * @param $text String
3162 * @return String
3163 * @private
3164 */
3169 ? $codedText
3171 }
3173 /**
3174 * A number of web browsers are known to corrupt non-ASCII characters
3175 * in a UTF-8 text editing environment. To protect against this,
3176 * detected browsers will be served an armored version of the text,
3177 * with non-ASCII chars converted to numeric HTML character references.
3178 *
3179 * Preexisting such character references will have a 0 added to them
3180 * to ensure that round-trips do not alter the original data.
3181 *
3182 * @param $invalue String
3183 * @return String
3184 * @private
3185 */
3187 // Armor existing references for reversability.
3204 }
3214 }
3215 }
3217 }
3219 /**
3220 * Reverse the previously applied transliteration of non-ASCII characters
3221 * back to UTF-8. Used to protect data from corruption by broken web browsers
3222 * as listed in $wgBrowserBlackList.
3223 *
3224 * @param $invalue String
3225 * @return String
3226 * @private
3227 */
3239 // Do some sanity checks. These aren't needed for reversability,
3240 // but should help keep the breakage down if the editor
3241 // breaks one of the entities whilst editing.
3247 }
3250 }
3251 }
3252 // reverse the transform that we made for reversability reasons.
3254 }
3255 }