3 * Contain the EditPage class
8 * Splitting edit page/HTML interface from Article...
9 * The actual database and text munging is still in Article,
10 * but it should get easier to call those from alternate
20 var $isConflict = false;
21 var $isCssJsSubpage = false;
22 var $deletedSinceEdit = false;
29 var $save = false, $preview = false, $diff = false;
30 var $minoredit = false, $watchthis = false, $recreate = false;
31 var $textbox1 = '', $textbox2 = '', $summary = '';
32 var $edittime = '', $section = '', $starttime = '';
33 var $oldid = 0, $editintro = '', $scrolltop = null;
39 function EditPage( $article ) {
40 $this->mArticle
=& $article;
42 $this->mTitle
=& $wgTitle;
46 * This is the function that extracts metadata from the article body on the first view.
47 * To turn the feature on, set $wgUseMetadataEdit = true ; in LocalSettings
48 * and set $wgMetadataWhitelist to the *full* title of the template whitelist
50 function extractMetaDataFromArticle () {
51 global $wgUseMetadataEdit , $wgMetadataWhitelist , $wgLang ;
52 $this->mMetaData
= '' ;
53 if ( !$wgUseMetadataEdit ) return ;
54 if ( $wgMetadataWhitelist == '' ) return ;
56 $t = $this->mArticle
->getContent ( true ) ;
58 # MISSING : <nowiki> filtering
60 # Categories and language links
61 $t = explode ( "\n" , $t ) ;
62 $catlow = strtolower ( $wgLang->getNsText ( NS_CATEGORY
) ) ;
63 $cat = $ll = array() ;
64 foreach ( $t AS $key => $x )
66 $y = trim ( strtolower ( $x ) ) ;
67 while ( substr ( $y , 0 , 2 ) == '[[' )
69 $y = explode ( ']]' , trim ( $x ) ) ;
70 $first = array_shift ( $y ) ;
71 $first = explode ( ':' , $first ) ;
72 $ns = array_shift ( $first ) ;
73 $ns = trim ( str_replace ( '[' , '' , $ns ) ) ;
74 if ( strlen ( $ns ) == 2 OR strtolower ( $ns ) == $catlow )
76 $add = '[[' . $ns . ':' . implode ( ':' , $first ) . ']]' ;
77 if ( strtolower ( $ns ) == $catlow ) $cat[] = $add ;
79 $x = implode ( ']]' , $y ) ;
81 $y = trim ( strtolower ( $x ) ) ;
85 if ( count ( $cat ) ) $s .= implode ( ' ' , $cat ) . "\n" ;
86 if ( count ( $ll ) ) $s .= implode ( ' ' , $ll ) . "\n" ;
87 $t = implode ( "\n" , $t ) ;
90 $sat = array () ; # stand-alone-templates; must be lowercase
91 $wl_title = Title
::newFromText ( $wgMetadataWhitelist ) ;
92 $wl_article = new Article ( $wl_title ) ;
93 $wl = explode ( "\n" , $wl_article->getContent(true) ) ;
98 while ( substr ( $x , 0 , 1 ) == '*' )
101 $x = trim ( substr ( $x , 1 ) ) ;
105 $sat[] = strtolower ( $x ) ;
110 # Templates, but only some
111 $t = explode ( '{{' , $t ) ;
113 foreach ( $t AS $key => $x )
115 $y = explode ( '}}' , $x , 2 ) ;
116 if ( count ( $y ) == 2 )
119 $z = explode ( '|' , $z ) ;
120 $tn = array_shift ( $z ) ;
121 if ( in_array ( strtolower ( $tn ) , $sat ) )
123 $tl[] = '{{' . $y[0] . '}}' ;
125 $y = explode ( '}}' , $y[1] , 2 ) ;
127 else $t[$key] = '{{' . $x ;
129 else if ( $key != 0 ) $t[$key] = '{{' . $x ;
132 if ( count ( $tl ) ) $s .= implode ( ' ' , $tl ) ;
133 $t = implode ( '' , $t ) ;
135 $t = str_replace ( "\n\n\n" , "\n" , $t ) ;
136 $this->mArticle
->mContent
= $t ;
137 $this->mMetaData
= $s ;
145 * This is the function that gets called for "action=edit". It
146 * sets up various member variables, then passes execution to
147 * another function, usually showEditForm()
149 * The edit form is self-submitting, so that when things like
150 * preview and edit conflicts occur, we get the same form back
151 * with the extra stuff added. Only when the final submission
152 * is made and all is well do we actually save and redirect to
153 * the newly-edited page.
156 global $wgOut, $wgUser, $wgRequest, $wgTitle;
158 if ( ! wfRunHooks( 'AlternateEdit', array( &$this ) ) )
161 $fname = 'EditPage::edit';
162 wfProfileIn( $fname );
163 wfDebug( "$fname: enter\n" );
165 // this is not an article
166 $wgOut->setArticleFlag(false);
168 $this->importFormData( $wgRequest );
169 $this->firsttime
= false;
172 $this->livePreview();
173 wfProfileOut( $fname );
177 if ( ! $this->mTitle
->userCanEdit() ) {
178 wfDebug( "$fname: user can't edit\n" );
179 $wgOut->readOnlyPage( $this->mArticle
->getContent( true ), true );
180 wfProfileOut( $fname );
183 wfDebug( "$fname: Checking blocks\n" );
184 if ( !$this->preview
&& !$this->diff
&& $wgUser->isBlockedFrom( $this->mTitle
, !$this->save
) ) {
185 # When previewing, don't check blocked state - will get caught at save time.
186 # Also, check when starting edition is done against slave to improve performance.
187 wfDebug( "$fname: user is blocked\n" );
188 $this->blockedIPpage();
189 wfProfileOut( $fname );
192 if ( !$wgUser->isAllowed('edit') ) {
193 if ( $wgUser->isAnon() ) {
194 wfDebug( "$fname: user must log in\n" );
195 $this->userNotLoggedInPage();
196 wfProfileOut( $fname );
199 wfDebug( "$fname: read-only page\n" );
200 $wgOut->readOnlyPage( $this->mArticle
->getContent( true ), true );
201 wfProfileOut( $fname );
205 if ( wfReadOnly() ) {
206 wfDebug( "$fname: read-only mode is engaged\n" );
207 if( $this->save ||
$this->preview
) {
208 $this->formtype
= 'preview';
209 } else if ( $this->diff
) {
210 $this->formtype
= 'diff';
212 $wgOut->readOnlyPage( $this->mArticle
->getContent( true ) );
213 wfProfileOut( $fname );
218 $this->formtype
= 'save';
219 } else if ( $this->preview
) {
220 $this->formtype
= 'preview';
221 } else if ( $this->diff
) {
222 $this->formtype
= 'diff';
223 } else { # First time through
224 $this->firsttime
= true;
225 if( $this->previewOnOpen() ) {
226 $this->formtype
= 'preview';
228 $this->extractMetaDataFromArticle () ;
229 $this->formtype
= 'initial';
234 wfProfileIn( "$fname-business-end" );
236 $this->isConflict
= false;
237 // css / js subpages of user pages get a special treatment
238 $this->isCssJsSubpage
= $wgTitle->isCssJsSubpage();
240 /* Notice that we can't use isDeleted, because it returns true if article is ever deleted
241 * no matter it's current state
243 $this->deletedSinceEdit
= false;
244 if ( $this->edittime
!= '' ) {
245 /* Note that we rely on logging table, which hasn't been always there,
246 * but that doesn't matter, because this only applies to brand new
247 * deletes. This is done on every preview and save request. Move it further down
248 * to only perform it on saves
250 if ( $this->mTitle
->isDeleted() ) {
251 $this->lastDelete
= $this->getLastDelete();
252 if ( !is_null($this->lastDelete
) ) {
253 $deletetime = $this->lastDelete
->log_timestamp
;
254 if ( ($deletetime - $this->starttime
) > 0 ) {
255 $this->deletedSinceEdit
= true;
261 if(!$this->mTitle
->getArticleID() && ('initial' == $this->formtype ||
$this->firsttime
)) { # new article
264 if( $this->mTitle
->isTalkPage() ) {
265 $wgOut->addWikiText( wfMsg( 'talkpagetext' ) );
268 # Attempt submission here. This will check for edit conflicts,
269 # and redundantly check for locked database, blocked IPs, etc.
270 # that edit() already checked just in case someone tries to sneak
271 # in the back door with a hand-edited submission URL.
273 if ( 'save' == $this->formtype
) {
274 if ( !$this->attemptSave() ) {
275 wfProfileOut( "$fname-business-end" );
276 wfProfileOut( $fname );
281 # First time through: get contents, set time for conflict
283 if ( 'initial' == $this->formtype ||
$this->firsttime
) {
284 $this->initialiseForm();
287 $this->showEditForm();
288 wfProfileOut( "$fname-business-end" );
289 wfProfileOut( $fname );
293 * Return true if this page should be previewed when the edit form
294 * is initially opened.
298 function previewOnOpen() {
300 return $wgUser->getOption( 'previewonfirst' ) ||
301 ( $this->mTitle
->getNamespace() == NS_CATEGORY
&&
302 !$this->mTitle
->exists() );
308 function importFormData( &$request ) {
310 $fname = 'EditPage::importFormData';
311 wfProfileIn( $fname );
313 if( $request->wasPosted() ) {
314 # These fields need to be checked for encoding.
315 # Also remove trailing whitespace, but don't remove _initial_
316 # whitespace from the text boxes. This may be significant formatting.
317 $this->textbox1
= $this->safeUnicodeInput( $request, 'wpTextbox1' );
318 $this->textbox2
= $this->safeUnicodeInput( $request, 'wpTextbox2' );
319 $this->mMetaData
= rtrim( $request->getText( 'metadata' ) );
320 # Truncate for whole multibyte characters. +5 bytes for ellipsis
321 $this->summary
= $wgLang->truncate( $request->getText( 'wpSummary' ), 250 );
323 $this->edittime
= $request->getVal( 'wpEdittime' );
324 $this->starttime
= $request->getVal( 'wpStarttime' );
326 $this->scrolltop
= $request->getIntOrNull( 'wpScrolltop' );
328 if( is_null( $this->edittime
) ) {
329 # If the form is incomplete, force to preview.
330 wfDebug( "$fname: Form data appears to be incomplete\n" );
331 wfDebug( "POST DATA: " . var_export( $_POST, true ) . "\n" );
332 $this->preview
= true;
334 $this->preview
= $request->getCheck( 'wpPreview' );
335 $this->diff
= $request->getCheck( 'wpDiff' );
337 if( !$this->preview
) {
338 if ( $this->tokenOk( $request ) ) {
339 # Some browsers will not report any submit button
340 # if the user hits enter in the comment box.
341 # The unmarked state will be assumed to be a save,
342 # if the form seems otherwise complete.
343 wfDebug( "$fname: Passed token check.\n" );
345 # Page might be a hack attempt posted from
346 # an external site. Preview instead of saving.
347 wfDebug( "$fname: Failed token check; forcing preview\n" );
348 $this->preview
= true;
352 $this->save
= ! ( $this->preview
OR $this->diff
);
353 if( !preg_match( '/^\d{14}$/', $this->edittime
)) {
354 $this->edittime
= null;
357 if( !preg_match( '/^\d{14}$/', $this->starttime
)) {
358 $this->starttime
= null;
361 $this->recreate
= $request->getCheck( 'wpRecreate' );
363 $this->minoredit
= $request->getCheck( 'wpMinoredit' );
364 $this->watchthis
= $request->getCheck( 'wpWatchthis' );
366 # Not a posted form? Start with nothing.
367 wfDebug( "$fname: Not a posted form.\n" );
368 $this->textbox1
= '';
369 $this->textbox2
= '';
370 $this->mMetaData
= '';
372 $this->edittime
= '';
373 $this->starttime
= wfTimestampNow();
374 $this->preview
= false;
377 $this->minoredit
= false;
378 $this->watchthis
= false;
379 $this->recreate
= false;
382 $this->oldid
= $request->getInt( 'oldid' );
384 # Section edit can come from either the form or a link
385 $this->section
= $request->getVal( 'wpSection', $request->getVal( 'section' ) );
387 $this->live
= $request->getCheck( 'live' );
388 $this->editintro
= $request->getText( 'editintro' );
390 wfProfileOut( $fname );
394 * Make sure the form isn't faking a user's credentials.
396 * @param WebRequest $request
400 function tokenOk( &$request ) {
402 if( $wgUser->isAnon() ) {
403 # Anonymous users may not have a session
404 # open. Don't tokenize.
405 $this->mTokenOk
= true;
407 $this->mTokenOk
= $wgUser->matchEditToken( $request->getVal( 'wpEditToken' ) );
409 return $this->mTokenOk
;
412 function showIntro() {
413 global $wgOut, $wgUser;
414 $addstandardintro=true;
415 if($this->editintro
) {
416 $introtitle=Title
::newFromText($this->editintro
);
417 if(isset($introtitle) && $introtitle->userCanRead()) {
418 $rev=Revision
::newFromTitle($introtitle);
420 $wgOut->addWikiText($rev->getText());
421 $addstandardintro=false;
425 if($addstandardintro) {
426 if ( $wgUser->isLoggedIn() )
427 $wgOut->addWikiText( wfMsg( 'newarticletext' ) );
429 $wgOut->addWikiText( wfMsg( 'newarticletextanon' ) );
435 * @return bool false if output is done, true if the rest of the form should be displayed
437 function attemptSave() {
438 global $wgSpamRegex, $wgFilterCallback, $wgUser, $wgOut;
440 $fname = 'EditPage::attemptSave';
441 wfProfileIn( $fname );
442 wfProfileIn( "$fname-checks" );
444 # Reintegrate metadata
445 if ( $this->mMetaData
!= '' ) $this->textbox1
.= "\n" . $this->mMetaData
;
446 $this->mMetaData
= '' ;
449 if ( $wgSpamRegex && preg_match( $wgSpamRegex, $this->textbox1
, $matches ) ) {
450 $this->spamPage ( $matches[0] );
451 wfProfileOut( "$fname-checks" );
452 wfProfileOut( $fname );
455 if ( $wgFilterCallback && $wgFilterCallback( $this->mTitle
, $this->textbox1
, $this->section
) ) {
456 # Error messages or other handling should be performed by the filter function
457 wfProfileOut( $fname );
458 wfProfileOut( "$fname-checks" );
461 if ( !wfRunHooks( 'EditFilter', array( &$this, $this->textbox1
, $this->section
) ) ) {
462 # Error messages or other handling should be performed by the filter function
463 wfProfileOut( $fname );
464 wfProfileOut( "$fname-checks" );
467 if ( $wgUser->isBlockedFrom( $this->mTitle
, false ) ) {
468 # Check block state against master, thus 'false'.
469 $this->blockedIPpage();
470 wfProfileOut( "$fname-checks" );
471 wfProfileOut( $fname );
475 if ( !$wgUser->isAllowed('edit') ) {
476 if ( $wgUser->isAnon() ) {
477 $this->userNotLoggedInPage();
478 wfProfileOut( "$fname-checks" );
479 wfProfileOut( $fname );
483 $wgOut->readOnlyPage();
484 wfProfileOut( "$fname-checks" );
485 wfProfileOut( $fname );
490 if ( wfReadOnly() ) {
491 $wgOut->readOnlyPage();
492 wfProfileOut( "$fname-checks" );
493 wfProfileOut( $fname );
496 if ( $wgUser->pingLimiter() ) {
497 $wgOut->rateLimited();
498 wfProfileOut( "$fname-checks" );
499 wfProfileOut( $fname );
503 # If the article has been deleted while editing, don't save it without
505 if ( $this->deletedSinceEdit
&& !$this->recreate
) {
506 wfProfileOut( "$fname-checks" );
507 wfProfileOut( $fname );
511 wfProfileOut( "$fname-checks" );
513 # If article is new, insert it.
514 $aid = $this->mTitle
->getArticleID( GAID_FOR_UPDATE
);
516 # Don't save a new article if it's blank.
517 if ( ( '' == $this->textbox1
) ) {
518 $wgOut->redirect( $this->mTitle
->getFullURL() );
519 wfProfileOut( $fname );
523 $isComment=($this->section
=='new');
524 $this->mArticle
->insertNewArticle( $this->textbox1
, $this->summary
,
525 $this->minoredit
, $this->watchthis
, false, $isComment);
527 wfProfileOut( $fname );
531 # Article exists. Check for edit conflict.
533 $this->mArticle
->clear(); # Force reload of dates, etc.
534 $this->mArticle
->forUpdate( true ); # Lock the article
536 if( ( $this->section
!= 'new' ) &&
537 ($this->mArticle
->getTimestamp() != $this->edittime
) )
539 $this->isConflict
= true;
541 $userid = $wgUser->getID();
543 if ( $this->isConflict
) {
544 wfDebug( "EditPage::editForm conflict! getting section '$this->section' for time '$this->edittime' (article time '" .
545 $this->mArticle
->getTimestamp() . "'\n" );
546 $text = $this->mArticle
->replaceSection( $this->section
, $this->textbox1
, $this->summary
, $this->edittime
);
549 wfDebug( "EditPage::editForm getting section '$this->section'\n" );
550 $text = $this->mArticle
->replaceSection( $this->section
, $this->textbox1
, $this->summary
);
552 if( is_null( $text ) ) {
553 wfDebug( "EditPage::editForm activating conflict; section replace failed.\n" );
554 $this->isConflict
= true;
555 $text = $this->textbox1
;
558 # Suppress edit conflict with self, except for section edits where merging is required.
559 if ( ( $this->section
== '' ) && ( 0 != $userid ) && ( $this->mArticle
->getUser() == $userid ) ) {
560 wfDebug( "Suppressing edit conflict, same user.\n" );
561 $this->isConflict
= false;
563 # switch from section editing to normal editing in edit conflict
564 if($this->isConflict
) {
566 if( $this->mergeChangesInto( $text ) ){
567 // Successful merge! Maybe we should tell the user the good news?
568 $this->isConflict
= false;
569 wfDebug( "Suppressing edit conflict, successful merge.\n" );
572 $this->textbox1
= $text;
573 wfDebug( "Keeping edit conflict, failed merge.\n" );
578 if ( $this->isConflict
) {
579 wfProfileOut( $fname );
584 wfProfileIn( "$fname-sectionanchor" );
586 if( $this->section
== 'new' ) {
587 if( $this->summary
!= '' ) {
588 $sectionanchor = $this->sectionAnchor( $this->summary
);
590 } elseif( $this->section
!= '' ) {
591 # Try to get a section anchor from the section source, redirect to edited section if header found
592 # XXX: might be better to integrate this into Article::replaceSection
593 # for duplicate heading checking and maybe parsing
594 $hasmatch = preg_match( "/^ *([=]{1,6})(.*?)(\\1) *\\n/i", $this->textbox1
, $matches );
595 # we can't deal with anchors, includes, html etc in the header for now,
596 # headline would need to be parsed to improve this
597 if($hasmatch and strlen($matches[2]) > 0) {
598 $sectionanchor = $this->sectionAnchor( $matches[2] );
601 wfProfileOut( "$fname-sectionanchor" );
603 // Save errors may fall down to the edit form, but we've now
604 // merged the section into full text. Clear the section field
605 // so that later submission of conflict forms won't try to
606 // replace that into a duplicated mess.
607 $this->textbox1
= $text;
610 # update the article here
611 if( $this->mArticle
->updateArticle( $text, $this->summary
, $this->minoredit
,
612 $this->watchthis
, '', $sectionanchor ) ) {
613 wfProfileOut( $fname );
616 $this->isConflict
= true;
618 wfProfileOut( $fname );
623 * Initialise form fields in the object
624 * Called on the first invocation, e.g. when a user clicks an edit link
626 function initialiseForm() {
627 $this->edittime
= $this->mArticle
->getTimestamp();
628 $this->textbox1
= $this->mArticle
->getContent( true );
634 * Send the edit form and related headers to $wgOut
635 * @param $formCallback Optional callable that takes an OutputPage
636 * parameter; will be called during form output
637 * near the top, for captchas and the like.
639 function showEditForm( $formCallback=null ) {
640 global $wgOut, $wgUser, $wgAllowAnonymousMinor, $wgLang, $wgContLang;
642 $fname = 'EditPage::showEditForm';
643 wfProfileIn( $fname );
645 $sk =& $wgUser->getSkin();
647 $wgOut->setRobotpolicy( 'noindex,nofollow' );
649 # Enabled article-related sidebar, toplinks, etc.
650 $wgOut->setArticleRelated( true );
652 if ( $this->isConflict
) {
653 $s = wfMsg( 'editconflict', $this->mTitle
->getPrefixedText() );
654 $wgOut->setPageTitle( $s );
655 $wgOut->addWikiText( wfMsg( 'explainconflict' ) );
657 $this->textbox2
= $this->textbox1
;
658 $this->textbox1
= $this->mArticle
->getContent( true );
659 $this->edittime
= $this->mArticle
->getTimestamp();
662 if( $this->section
!= '' ) {
663 if( $this->section
== 'new' ) {
664 $s = wfMsg('editingcomment', $this->mTitle
->getPrefixedText() );
666 $s = wfMsg('editingsection', $this->mTitle
->getPrefixedText() );
667 if( !$this->preview
&& !$this->diff
) {
668 preg_match( "/^(=+)(.+)\\1/mi",
671 if( !empty( $matches[2] ) ) {
672 $this->summary
= "/* ". trim($matches[2])." */ ";
677 $s = wfMsg( 'editing', $this->mTitle
->getPrefixedText() );
679 $wgOut->setPageTitle( $s );
680 if ( !$this->checkUnicodeCompliantBrowser() ) {
681 $wgOut->addWikiText( wfMsg( 'nonunicodebrowser') );
683 if ( isset( $this->mArticle
)
684 && isset( $this->mArticle
->mRevision
)
685 && !$this->mArticle
->mRevision
->isCurrent() ) {
686 $this->mArticle
->setOldSubtitle( $this->mArticle
->mRevision
->getId() );
687 $wgOut->addWikiText( wfMsg( 'editingold' ) );
692 $wgOut->addWikiText( wfMsg( 'readonlywarning' ) );
693 } else if ( $this->isCssJsSubpage
and 'preview' != $this->formtype
) {
694 $wgOut->addWikiText( wfMsg( 'usercssjsyoucanpreview' ));
696 if( $this->mTitle
->isProtected('edit') ) {
697 $wgOut->addWikiText( wfMsg( 'protectedpagewarning' ) );
700 $kblength = (int)(strlen( $this->textbox1
) / 1024);
701 if( $kblength > 29 ) {
702 $wgOut->addWikiText( wfMsg( 'longpagewarning', $wgLang->formatNum( $kblength ) ) );
705 $rows = $wgUser->getOption( 'rows' );
706 $cols = $wgUser->getOption( 'cols' );
708 $ew = $wgUser->getOption( 'editwidth' );
709 if ( $ew ) $ew = " style=\"width:100%\"";
712 $q = 'action=submit';
713 #if ( "no" == $redirect ) { $q .= "&redirect=no"; }
714 $action = $this->mTitle
->escapeLocalURL( $q );
716 $summary = wfMsg('summary');
717 $subject = wfMsg('subject');
718 $minor = wfMsg('minoredit');
719 $watchthis = wfMsg ('watchthis');
720 $save = wfMsg('savearticle');
721 $prev = wfMsg('showpreview');
722 $diff = wfMsg('showdiff');
724 $cancel = $sk->makeKnownLink( $this->mTitle
->getPrefixedText(),
726 $edithelpurl = $sk->makeInternalOrExternalUrl( wfMsg( 'edithelppage' ));
727 $edithelp = '<a target="helpwindow" href="'.$edithelpurl.'">'.
728 htmlspecialchars( wfMsg( 'edithelp' ) ).'</a> '.
729 htmlspecialchars( wfMsg( 'newwindow' ) );
731 global $wgRightsText;
732 $copywarn = "<div id=\"editpage-copywarn\">\n" .
733 wfMsg( $wgRightsText ?
'copyrightwarning' : 'copyrightwarning2',
734 '[[' . wfMsgForContent( 'copyrightpage' ) . ']]',
735 $wgRightsText ) . "\n</div>";
737 if( $wgUser->getOption('showtoolbar') and !$this->isCssJsSubpage
) {
738 # prepare toolbar for edit buttons
739 $toolbar = $this->getEditToolbar();
744 // activate checkboxes if user wants them to be always active
745 if( !$this->preview
&& !$this->diff
) {
746 if( $wgUser->getOption( 'watchdefault' ) ) $this->watchthis
= true;
747 if( $wgUser->getOption( 'minordefault' ) ) $this->minoredit
= true;
749 // activate checkbox also if user is already watching the page,
750 // require wpWatchthis to be unset so that second condition is not
751 // checked unnecessarily
752 if( !$this->watchthis
&& $this->mTitle
->userIsWatching() ) $this->watchthis
= true;
757 if ( $wgUser->isLoggedIn() ||
$wgAllowAnonymousMinor ) {
759 "<input tabindex='3' type='checkbox' value='1' name='wpMinoredit'".($this->minoredit?
" checked='checked'":"").
760 " accesskey='".wfMsg('accesskey-minoredit')."' id='wpMinoredit' />".
761 "<label for='wpMinoredit' title='".wfMsg('tooltip-minoredit')."'>{$minor}</label>";
766 if ( $wgUser->isLoggedIn() ) {
767 $watchhtml = "<input tabindex='4' type='checkbox' name='wpWatchthis'".
768 ($this->watchthis?
" checked='checked'":"").
769 " accesskey=\"".htmlspecialchars(wfMsg('accesskey-watch'))."\" id='wpWatchthis' />".
770 "<label for='wpWatchthis' title=\"" .
771 htmlspecialchars(wfMsg('tooltip-watch'))."\">{$watchthis}</label>";
774 $checkboxhtml = $minoredithtml . $watchhtml;
776 if ( 'preview' == $this->formtype
&& $wgUser->getOption( 'previewontop' ) ) {
777 $this->showPreview();
779 if ( 'diff' == $this->formtype
) {
780 if ( $wgUser->getOption('previewontop' ) ) {
781 $wgOut->addHTML( $this->getDiff() );
786 # if this is a comment, show a subject line at the top, which is also the edit summary.
787 # Otherwise, show a summary field at the bottom
788 $summarytext = htmlspecialchars( $wgContLang->recodeForEdit( $this->summary
) ); # FIXME
789 if( $this->section
== 'new' ) {
790 $commentsubject="<span id='wpSummaryLabel'><label for='wpSummary'>{$subject}:</label></span> <div class='editOptions'><input tabindex='1' type='text' value=\"$summarytext\" name='wpSummary' id='wpSummary' maxlength='200' size='60' /><br />";
793 $commentsubject = '';
794 $editsummary="<span id='wpSummaryLabel'><label for='wpSummary'>{$summary}:</label></span> <div class='editOptions'><input tabindex='2' type='text' value=\"$summarytext\" name='wpSummary' id='wpSummary' maxlength='200' size='60' /><br />";
797 # Set focus to the edit box on load, except on preview or diff, where it would interfere with the display
798 if( !$this->preview
&& !$this->diff
) {
799 $wgOut->setOnloadHandler( 'document.editform.wpTextbox1.focus()' );
801 $templates = $this->getTemplatesUsed();
803 global $wgLivePreview;
804 if ( $wgLivePreview ) {
805 $liveOnclick = $this->doLivePreviewScript();
810 global $wgUseMetadataEdit ;
811 if ( $wgUseMetadataEdit ) {
812 $metadata = $this->mMetaData
;
813 $metadata = htmlspecialchars( $wgContLang->recodeForEdit( $metadata ) ) ;
814 $helppage = Title
::newFromText( wfMsg( "metadata_page" ) ) ;
815 $top = wfMsg( 'metadata', $helppage->getInternalURL() );
816 $metadata = $top . "<textarea name='metadata' rows='3' cols='{$cols}'{$ew}>{$metadata}</textarea>" ;
818 else $metadata = "" ;
822 if ($this->deletedSinceEdit
) {
823 if ( 'save' != $this->formtype
) {
824 $wgOut->addWikiText( wfMsg('deletedwhileediting'));
826 // Hide the toolbar and edit area, use can click preview to get it back
827 // Add an confirmation checkbox and explanation.
829 $hidden = 'type="hidden" style="display:none;"';
830 $recreate = $wgOut->parse( wfMsg( 'confirmrecreate', $this->lastDelete
->user_name
, $this->lastDelete
->log_comment
));
832 "<br /><input tabindex='1' type='checkbox' value='1' name='wpRecreate' id='wpRecreate' />".
833 "<label for='wpRecreate' title='".wfMsg('tooltip-recreate')."'>". wfMsg('recreate')."</label>";
837 $safemodehtml = $this->checkUnicodeCompliantBrowser()
839 : "<input type='hidden' name=\"safemode\" value='1' />\n";
841 $wgOut->addHTML( <<<END
843 <form id="editform" name="editform" method="post" action="$action"
844 enctype="multipart/form-data">
847 if( is_callable( $formCallback ) ) {
848 call_user_func_array( $formCallback, array( &$wgOut ) );
851 // Put these up at the top to ensure they aren't lost on early form submission
853 <input type='hidden' value=\"" . htmlspecialchars( $this->section
) . "\" name=\"wpSection\" />
854 <input type='hidden' value=\"{$this->starttime}\" name=\"wpStarttime\" />\n
855 <input type='hidden' value=\"{$this->edittime}\" name=\"wpEdittime\" />\n
856 <input type='hidden' value=\"{$this->scrolltop}\" name=\"wpScrolltop\" id=\"wpScrolltop\" />\n" );
858 $wgOut->addHTML( <<<END
861 <textarea tabindex='1' accesskey="," name="wpTextbox1" id="wpTextbox1" rows='{$rows}'
862 cols='{$cols}'{$ew} $hidden>
864 . htmlspecialchars( $this->safeUnicodeOutput( $this->textbox1
) ) .
871 <div class='editButtons'>
872 <input tabindex='5' id='wpSave' type='submit' value=\"{$save}\" name=\"wpSave\" accesskey=\"".wfMsg('accesskey-save')."\"".
873 " title=\"".wfMsg('tooltip-save')."\"/>
874 <input tabindex='6' id='wpPreview' type='submit' $liveOnclick value=\"{$prev}\" name=\"wpPreview\" accesskey=\"".wfMsg('accesskey-preview')."\"".
875 " title=\"".wfMsg('tooltip-preview')."\"/>
876 <input tabindex='7' id='wpDiff' type='submit' value=\"{$diff}\" name=\"wpDiff\" accesskey=\"".wfMsg('accesskey-diff')."\"".
877 " title=\"".wfMsg('tooltip-diff')."\"/> <span class='editHelp'>{$cancel} | {$edithelp}</span></div>
881 wfMsgForContent( 'editpage-template',
883 'METADATA' => $metadata,
884 'SUMMARY' => $editsummary,
885 'CHECKBOXES' => $checkboxhtml . $safemodehtml,
886 'BUTTONS' => $editbuttons,
887 'EDITTOOLS' => $wgOut->parse( wfMsgForContent( 'edittools' ) ),
888 'COPYRIGHTWARNING' => $wgOut->parse( $copywarn ),
889 'TEMPLATES' => "<div class='templatesUsed'>$templates</div>"
894 if ( $wgUser->isLoggedIn() ) {
896 * To make it harder for someone to slip a user a page
897 * which submits an edit form to the wiki without their
898 * knowledge, a random token is associated with the login
899 * session. If it's not passed back with the submission,
900 * we won't save the page, or render user JavaScript and
903 $token = htmlspecialchars( $wgUser->editToken() );
904 $wgOut->addHTML( "\n<input type='hidden' value=\"$token\" name=\"wpEditToken\" />\n" );
908 if ( $this->isConflict
) {
909 require_once( "DifferenceEngine.php" );
910 $wgOut->addWikiText( '==' . wfMsg( "yourdiff" ) . '==' );
912 $de = new DifferenceEngine( $this->mTitle
);
913 $de->setText( $this->textbox2
, $this->textbox1
);
914 $de->showDiff( wfMsg( "yourtext" ), wfMsg( "storedversion" ) );
916 $wgOut->addWikiText( '==' . wfMsg( "yourtext" ) . '==' );
917 $wgOut->addHTML( "<textarea tabindex=6 id='wpTextbox2' name=\"wpTextbox2\" rows='{$rows}' cols='{$cols}' wrap='virtual'>"
918 . htmlspecialchars( $this->safeUnicodeOutput( $this->textbox2
) ) . "\n</textarea>" );
920 $wgOut->addHTML( "</form>\n" );
921 if ( $this->formtype
== 'preview' && !$wgUser->getOption( 'previewontop' ) ) {
922 $this->showPreview();
924 if ( $this->formtype
== 'diff' && !$wgUser->getOption( 'previewontop' ) ) {
925 #$wgOut->addHTML( '<div id="wikiPreview">' . $difftext . '</div>' );
926 $wgOut->addHTML( $this->getDiff() );
929 wfProfileOut( $fname );
933 * Append preview output to $wgOut.
934 * Includes category rendering if this is a category page.
937 function showPreview() {
939 $wgOut->addHTML( '<div id="wikiPreview">' );
940 if($this->mTitle
->getNamespace() == NS_CATEGORY
) {
941 $this->mArticle
->openShowCategory();
943 $previewOutput = $this->getPreviewText();
944 $wgOut->addHTML( $previewOutput );
945 if($this->mTitle
->getNamespace() == NS_CATEGORY
) {
946 $this->mArticle
->closeShowCategory();
948 $wgOut->addHTML( "<br style=\"clear:both;\" />\n" );
949 $wgOut->addHTML( '</div>' );
953 * Prepare a list of templates used by this page. Returns HTML.
955 function getTemplatesUsed() {
958 $fname = 'EditPage::getTemplatesUsed';
959 wfProfileIn( $fname );
961 $sk =& $wgUser->getSkin();
964 $articleTemplates = $this->mArticle
->getUsedTemplates();
965 if ( count( $articleTemplates ) > 0 ) {
966 $templates = '<br />'. wfMsg( 'templatesused' ) . '<ul>';
967 foreach ( $articleTemplates as $tpl ) {
968 if ( $titleObj = Title
::makeTitle( NS_TEMPLATE
, $tpl ) ) {
969 $templates .= '<li>' . $sk->makeLinkObj( $titleObj ) . '</li>';
972 $templates .= '</ul>';
974 wfProfileOut( $fname );
979 * Live Preview lets us fetch rendered preview page content and
980 * add it to the page without refreshing the whole page.
981 * If not supported by the browser it will fall through to the normal form
984 * This function outputs a script tag to support live preview, and
985 * returns an onclick handler which should be added to the attributes
986 * of the preview button
988 function doLivePreviewScript() {
989 global $wgStylePath, $wgJsMimeType, $wgOut;
990 $wgOut->addHTML( '<script type="'.$wgJsMimeType.'" src="' .
991 htmlspecialchars( $wgStylePath . '/common/preview.js' ) .
992 '"></script>' . "\n" );
993 $liveAction = $wgTitle->getLocalUrl( 'action=submit&wpPreview=true&live=true' );
994 return 'onclick="return !livePreview('.
995 'getElementById(\'wikiPreview\'),' .
996 'editform.wpTextbox1.value,' .
997 htmlspecialchars( '"' . $liveAction . '"' ) . ')"';
1000 function getLastDelete() {
1001 $dbr =& wfGetDB( DB_SLAVE
);
1002 $fname = 'EditPage::getLastDelete';
1003 $res = $dbr->select(
1004 array( 'logging', 'user' ),
1014 array( 'log_namespace' => $this->mTitle
->getNamespace(),
1015 'log_title' => $this->mTitle
->getDBkey(),
1016 'log_type' => 'delete',
1017 'log_action' => 'delete',
1018 'user_id=log_user' ),
1020 array( 'LIMIT' => 1, 'ORDER BY' => 'log_timestamp DESC' ) );
1022 if($dbr->numRows($res) == 1) {
1023 while ( $x = $dbr->fetchObject ( $res ) )
1025 $dbr->freeResult ( $res ) ;
1035 function getPreviewText() {
1036 global $wgOut, $wgUser, $wgTitle, $wgParser, $wgAllowDiffPreview, $wgEnableDiffPreviewPreference;
1038 $fname = 'EditPage::getPreviewText';
1039 wfProfileIn( $fname );
1041 if ( $this->mTokenOk
) {
1042 $msg = 'previewnote';
1044 $msg = 'session_fail_preview';
1046 $previewhead = '<h2>' . htmlspecialchars( wfMsg( 'preview' ) ) . "</h2>\n" .
1047 "<div class='previewnote'>" . $wgOut->parse( wfMsg( $msg ) ) . "</div>\n";
1048 if ( $this->isConflict
) {
1049 $previewhead.='<h2>' . htmlspecialchars( wfMsg( 'previewconflict' ) ) . "</h2>\n";
1052 $parserOptions = ParserOptions
::newFromUser( $wgUser );
1053 $parserOptions->setEditSection( false );
1055 # don't parse user css/js, show message about preview
1056 # XXX: stupid php bug won't let us use $wgTitle->isCssJsSubpage() here
1058 if ( $this->isCssJsSubpage
) {
1059 if(preg_match("/\\.css$/", $wgTitle->getText() ) ) {
1060 $previewtext = wfMsg('usercsspreview');
1061 } else if(preg_match("/\\.js$/", $wgTitle->getText() ) ) {
1062 $previewtext = wfMsg('userjspreview');
1064 $parserOutput = $wgParser->parse( $previewtext , $wgTitle, $parserOptions );
1065 $wgOut->addHTML( $parserOutput->mText
);
1066 wfProfileOut( $fname );
1067 return $previewhead;
1069 # if user want to see preview when he edit an article
1070 if( $wgUser->getOption('previewonfirst') and ($this->textbox1
== '')) {
1071 $this->textbox1
= $this->mArticle
->getContent(true);
1074 $toparse = $this->textbox1
;
1076 # If we're adding a comment, we need to show the
1077 # summary as the headline
1078 if($this->section
=="new" && $this->summary
!="") {
1079 $toparse="== {$this->summary} ==\n\n".$toparse;
1082 if ( $this->mMetaData
!= "" ) $toparse .= "\n" . $this->mMetaData
;
1084 $parserOutput = $wgParser->parse( $this->mArticle
->preSaveTransform( $toparse ) ."\n\n",
1085 $wgTitle, $parserOptions );
1087 $previewHTML = $parserOutput->mText
;
1089 $wgOut->addCategoryLinks($parserOutput->getCategoryLinks());
1090 $wgOut->addLanguageLinks($parserOutput->getLanguageLinks());
1092 wfProfileOut( $fname );
1093 return $previewhead . $previewHTML;
1100 function blockedIPpage() {
1101 global $wgOut, $wgUser, $wgContLang;
1103 $wgOut->setPageTitle( wfMsg( 'blockedtitle' ) );
1104 $wgOut->setRobotpolicy( 'noindex,nofollow' );
1105 $wgOut->setArticleRelated( false );
1107 $id = $wgUser->blockedBy();
1108 $reason = $wgUser->blockedFor();
1111 if ( is_numeric( $id ) ) {
1112 $name = User
::whoIs( $id );
1116 $link = '[[' . $wgContLang->getNsText( NS_USER
) .
1117 ":{$name}|{$name}]]";
1119 $wgOut->addWikiText( wfMsg( 'blockedtext', $link, $reason, $ip, $name ) );
1120 $wgOut->returnToMain( false );
1126 function userNotLoggedInPage() {
1129 $wgOut->setPageTitle( wfMsg( 'whitelistedittitle' ) );
1130 $wgOut->setRobotpolicy( 'noindex,nofollow' );
1131 $wgOut->setArticleRelated( false );
1133 $wgOut->addWikiText( wfMsg( 'whitelistedittext' ) );
1134 $wgOut->returnToMain( false );
1140 function spamPage ( $match = false )
1143 $wgOut->setPageTitle( wfMsg( 'spamprotectiontitle' ) );
1144 $wgOut->setRobotpolicy( 'noindex,nofollow' );
1145 $wgOut->setArticleRelated( false );
1147 $wgOut->addWikiText( wfMsg( 'spamprotectiontext' ) );
1149 $wgOut->addWikiText( wfMsg( 'spamprotectionmatch', "<nowiki>{$match}</nowiki>" ) );
1151 $wgOut->returnToMain( false );
1158 function mergeChangesInto( &$editText ){
1159 $fname = 'EditPage::mergeChangesInto';
1160 wfProfileIn( $fname );
1162 $db =& wfGetDB( DB_MASTER
);
1164 // This is the revision the editor started from
1165 $baseRevision = Revision
::loadFromTimestamp(
1166 $db, $this->mArticle
->mTitle
, $this->edittime
);
1167 if( is_null( $baseRevision ) ) {
1168 wfProfileOut( $fname );
1171 $baseText = $baseRevision->getText();
1173 // The current state, we want to merge updates into it
1174 $currentRevision = Revision
::loadFromTitle(
1175 $db, $this->mArticle
->mTitle
);
1176 if( is_null( $currentRevision ) ) {
1177 wfProfileOut( $fname );
1180 $currentText = $currentRevision->getText();
1182 if( wfMerge( $baseText, $editText, $currentText, $result ) ){
1183 $editText = $result;
1184 wfProfileOut( $fname );
1187 wfProfileOut( $fname );
1193 * Check if the browser is on a blacklist of user-agents known to
1194 * mangle UTF-8 data on form submission. Returns true if Unicode
1195 * should make it through, false if it's known to be a problem.
1199 function checkUnicodeCompliantBrowser() {
1200 global $wgBrowserBlackList;
1201 if( empty( $_SERVER["HTTP_USER_AGENT"] ) ) {
1202 // No User-Agent header sent? Trust it by default...
1205 $currentbrowser = $_SERVER["HTTP_USER_AGENT"];
1206 foreach ( $wgBrowserBlackList as $browser ) {
1207 if ( preg_match($browser, $currentbrowser) ) {
1215 * Format an anchor fragment as it would appear for a given section name
1216 * @param string $text
1220 function sectionAnchor( $text ) {
1221 $headline = Sanitizer
::decodeCharReferences( $text );
1223 $headline = preg_replace( '/<.*?' . '>/', '', $headline );
1224 $headline = trim( $headline );
1225 $sectionanchor = '#' . urlencode( str_replace( ' ', '_', $headline ) );
1226 $replacearray = array(
1231 array_keys( $replacearray ),
1232 array_values( $replacearray ),
1237 * Shows a bulletin board style toolbar for common editing functions.
1238 * It can be disabled in the user preferences.
1239 * The necessary JavaScript code can be found in style/wikibits.js.
1241 function getEditToolbar() {
1242 global $wgStylePath, $wgLang, $wgMimeType, $wgJsMimeType;
1245 * toolarray an array of arrays which each include the filename of
1246 * the button image (without path), the opening tag, the closing tag,
1247 * and optionally a sample text that is inserted between the two when no
1248 * selection is highlighted.
1249 * The tip text is shown when the user moves the mouse over the button.
1251 * Already here are accesskeys (key), which are not used yet until someone
1252 * can figure out a way to make them work in IE. However, we should make
1253 * sure these keys are not defined on the edit page.
1256 array( 'image'=>'button_bold.png',
1258 'close' => "\'\'\'",
1259 'sample'=> wfMsg('bold_sample'),
1260 'tip' => wfMsg('bold_tip'),
1263 array( 'image'=>'button_italic.png',
1266 'sample'=> wfMsg('italic_sample'),
1267 'tip' => wfMsg('italic_tip'),
1270 array( 'image'=>'button_link.png',
1273 'sample'=> wfMsg('link_sample'),
1274 'tip' => wfMsg('link_tip'),
1277 array( 'image'=>'button_extlink.png',
1280 'sample'=> wfMsg('extlink_sample'),
1281 'tip' => wfMsg('extlink_tip'),
1284 array( 'image'=>'button_headline.png',
1286 'close' => " ==\\n",
1287 'sample'=> wfMsg('headline_sample'),
1288 'tip' => wfMsg('headline_tip'),
1291 array( 'image'=>'button_image.png',
1292 'open' => '[['.$wgLang->getNsText(NS_IMAGE
).":",
1294 'sample'=> wfMsg('image_sample'),
1295 'tip' => wfMsg('image_tip'),
1298 array( 'image' =>'button_media.png',
1299 'open' => '[['.$wgLang->getNsText(NS_MEDIA
).':',
1301 'sample'=> wfMsg('media_sample'),
1302 'tip' => wfMsg('media_tip'),
1305 array( 'image' =>'button_math.png',
1306 'open' => "\\<math\\>",
1307 'close' => "\\</math\\>",
1308 'sample'=> wfMsg('math_sample'),
1309 'tip' => wfMsg('math_tip'),
1312 array( 'image' =>'button_nowiki.png',
1313 'open' => "\\<nowiki\\>",
1314 'close' => "\\</nowiki\\>",
1315 'sample'=> wfMsg('nowiki_sample'),
1316 'tip' => wfMsg('nowiki_tip'),
1319 array( 'image' =>'button_sig.png',
1323 'tip' => wfMsg('sig_tip'),
1326 array( 'image' =>'button_hr.png',
1327 'open' => "\\n----\\n",
1330 'tip' => wfMsg('hr_tip'),
1334 $toolbar ="<script type='$wgJsMimeType'>\n/*<![CDATA[*/\n";
1336 $toolbar.="document.writeln(\"<div id='toolbar'>\");\n";
1337 foreach($toolarray as $tool) {
1339 $image=$wgStylePath.'/common/images/'.$tool['image'];
1340 $open=$tool['open'];
1341 $close=$tool['close'];
1342 $sample = wfEscapeJsString( $tool['sample'] );
1344 // Note that we use the tip both for the ALT tag and the TITLE tag of the image.
1345 // Older browsers show a "speedtip" type message only for ALT.
1346 // Ideally these should be different, realistically they
1347 // probably don't need to be.
1348 $tip = wfEscapeJsString( $tool['tip'] );
1350 #$key = $tool["key"];
1352 $toolbar.="addButton('$image','$tip','$open','$close','$sample');\n";
1355 $toolbar.="document.writeln(\"</div>\");\n";
1356 $toolbar.="/*]]>*/\n</script>";
1361 * Output preview text only. This can be sucked into the edit page
1362 * via JavaScript, and saves the server time rendering the skin as
1363 * well as theoretically being more robust on the client (doesn't
1364 * disturb the edit box's undo history, won't eat your text on
1367 * @todo This doesn't include category or interlanguage links.
1368 * Would need to enhance it a bit, maybe wrap them in XML
1369 * or something... that might also require more skin
1370 * initialization, so check whether that's a problem.
1372 function livePreview() {
1375 header( 'Content-type: text/xml' );
1376 header( 'Cache-control: no-cache' );
1378 echo $this->getPreviewText( false, false );
1383 * Get a diff between the current contents of the edit box and the
1384 * version of the page we're editing from.
1386 * If this is a section edit, we'll replace the section as for final
1387 * save and then make a comparison.
1389 * @return string HTML
1391 function getDiff() {
1394 require_once( 'DifferenceEngine.php' );
1395 $oldtext = $this->mArticle
->fetchContent();
1396 $newtext = $this->mArticle
->replaceSection(
1397 $this->section
, $this->textbox1
, $this->summary
, $this->edittime
);
1398 $oldtitle = wfMsg( 'currentrev' );
1399 $newtitle = wfMsg( 'yourtext' );
1400 if ( $oldtext !== false ||
$newtext != '' ) {
1401 $de = new DifferenceEngine( $this->mTitle
);
1402 $de->setText( $oldtext, $newtext );
1403 $difftext = $de->getDiff( $oldtitle, $newtitle );
1408 return '<div id="wikiDiff">' . $difftext . '</div>';
1412 * Filter an input field through a Unicode de-armoring process if it
1413 * came from an old browser with known broken Unicode editing issues.
1415 * @param WebRequest $request
1416 * @param string $field
1420 function safeUnicodeInput( $request, $field ) {
1421 $text = rtrim( $request->getText( $field ) );
1422 return $request->getBool( 'safemode' )
1423 ?
$this->unmakesafe( $text )
1428 * Filter an output field through a Unicode armoring process if it is
1429 * going to an old browser with known broken Unicode editing issues.
1431 * @param string $text
1435 function safeUnicodeOutput( $text ) {
1437 $codedText = $wgContLang->recodeForEdit( $text );
1438 return $this->checkUnicodeCompliantBrowser()
1440 : $this->makesafe( $codedText );
1444 * A number of web browsers are known to corrupt non-ASCII characters
1445 * in a UTF-8 text editing environment. To protect against this,
1446 * detected browsers will be served an armored version of the text,
1447 * with non-ASCII chars converted to numeric HTML character references.
1449 * Preexisting such character references will have a 0 added to them
1450 * to ensure that round-trips do not alter the original data.
1452 * @param string $invalue
1456 function makesafe( $invalue ) {
1457 // Armor existing references for reversability.
1458 $invalue = strtr( $invalue, array( "&#x" => "�" ) );
1463 for( $i = 0; $i < strlen( $invalue ); $i++
) {
1464 $bytevalue = ord( $invalue{$i} );
1465 if( $bytevalue <= 0x7F ) { //0xxx xxxx
1466 $result .= chr( $bytevalue );
1468 } elseif( $bytevalue <= 0xBF ) { //10xx xxxx
1469 $working = $working << 6;
1470 $working +
= ($bytevalue & 0x3F);
1472 if( $bytesleft <= 0 ) {
1473 $result .= "&#x" . strtoupper( dechex( $working ) ) . ";";
1475 } elseif( $bytevalue <= 0xDF ) { //110x xxxx
1476 $working = $bytevalue & 0x1F;
1478 } elseif( $bytevalue <= 0xEF ) { //1110 xxxx
1479 $working = $bytevalue & 0x0F;
1481 } else { //1111 0xxx
1482 $working = $bytevalue & 0x07;
1490 * Reverse the previously applied transliteration of non-ASCII characters
1491 * back to UTF-8. Used to protect data from corruption by broken web browsers
1492 * as listed in $wgBrowserBlackList.
1494 * @param string $invalue
1498 function unmakesafe( $invalue ) {
1500 for( $i = 0; $i < strlen( $invalue ); $i++
) {
1501 if( ( substr( $invalue, $i, 3 ) == "&#x" ) && ( $invalue{$i+
3} != '0' ) ) {
1505 $hexstring .= $invalue{$i};
1507 } while( ctype_xdigit( $invalue{$i} ) && ( $i < strlen( $invalue ) ) );
1509 // Do some sanity checks. These aren't needed for reversability,
1510 // but should help keep the breakage down if the editor
1511 // breaks one of the entities whilst editing.
1512 if ((substr($invalue,$i,1)==";") and (strlen($hexstring) <= 6)) {
1513 $codepoint = hexdec($hexstring);
1514 $result .= codepointToUtf8( $codepoint );
1516 $result .= "&#x" . $hexstring . substr( $invalue, $i, 1 );
1519 $result .= substr( $invalue, $i, 1 );
1522 // reverse the transform that we made for reversability reasons.
1523 return strtr( $result, array( "�" => "&#x" ) );