diff options
Diffstat (limited to 'includes/specials/SpecialExpandTemplates.php')
| -rw-r--r-- | includes/specials/SpecialExpandTemplates.php | 286 |
1 files changed, 286 insertions, 0 deletions
diff --git a/includes/specials/SpecialExpandTemplates.php b/includes/specials/SpecialExpandTemplates.php new file mode 100644 index 00000000..62f957fc --- /dev/null +++ b/includes/specials/SpecialExpandTemplates.php @@ -0,0 +1,286 @@ +<?php +/** + * Implements Special:ExpandTemplates + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. + * http://www.gnu.org/copyleft/gpl.html + * + * @file + * @ingroup SpecialPage + */ + +/** + * A special page that expands submitted templates, parser functions, + * and variables, allowing easier debugging of these. + * + * @ingroup SpecialPage + */ +class SpecialExpandTemplates extends SpecialPage { + + /** @var bool Whether or not to show the XML parse tree */ + protected $generateXML; + + /** @var bool Whether or not to show the raw HTML code */ + protected $generateRawHtml; + + /** @var bool Whether or not to remove comments in the expanded wikitext */ + protected $removeComments; + + /** @var bool Whether or not to remove <nowiki> tags in the expanded wikitext */ + protected $removeNowiki; + + /** @var int Maximum size in bytes to include. 50MB allows fixing those huge pages */ + const MAX_INCLUDE_SIZE = 50000000; + + function __construct() { + parent::__construct( 'ExpandTemplates' ); + } + + /** + * Show the special page + * @param string|null $subpage + */ + function execute( $subpage ) { + global $wgParser; + + $this->setHeaders(); + + $request = $this->getRequest(); + $titleStr = $request->getText( 'wpContextTitle' ); + $title = Title::newFromText( $titleStr ); + + if ( !$title ) { + $title = $this->getPageTitle(); + } + $input = $request->getText( 'wpInput' ); + $this->generateXML = $request->getBool( 'wpGenerateXml' ); + $this->generateRawHtml = $request->getBool( 'wpGenerateRawHtml' ); + + if ( strlen( $input ) ) { + $this->removeComments = $request->getBool( 'wpRemoveComments', false ); + $this->removeNowiki = $request->getBool( 'wpRemoveNowiki', false ); + $options = ParserOptions::newFromContext( $this->getContext() ); + $options->setRemoveComments( $this->removeComments ); + $options->setTidy( true ); + $options->setMaxIncludeSize( self::MAX_INCLUDE_SIZE ); + + if ( $this->generateXML ) { + $wgParser->startExternalParse( $title, $options, OT_PREPROCESS ); + $dom = $wgParser->preprocessToDom( $input ); + + if ( method_exists( $dom, 'saveXML' ) ) { + $xml = $dom->saveXML(); + } else { + $xml = $dom->__toString(); + } + } + + $output = $wgParser->preprocess( $input, $title, $options ); + } else { + $this->removeComments = $request->getBool( 'wpRemoveComments', true ); + $this->removeNowiki = $request->getBool( 'wpRemoveNowiki', false ); + $output = false; + } + + $out = $this->getOutput(); + $out->addWikiMsg( 'expand_templates_intro' ); + $out->addHTML( $this->makeForm( $titleStr, $input ) ); + + if ( $output !== false ) { + if ( $this->generateXML && strlen( $output ) > 0 ) { + $out->addHTML( $this->makeOutput( $xml, 'expand_templates_xml_output' ) ); + } + + $tmp = $this->makeOutput( $output ); + + if ( $this->removeNowiki ) { + $tmp = preg_replace( + array( '_<nowiki>_', '_</nowiki>_', '_<nowiki */>_' ), + '', + $tmp + ); + } + + $config = $this->getConfig(); + if ( ( $config->get( 'UseTidy' ) && $options->getTidy() ) || $config->get( 'AlwaysUseTidy' ) ) { + $tmp = MWTidy::tidy( $tmp ); + } + + $out->addHTML( $tmp ); + + $pout = $this->generateHtml( $title, $output ); + $rawhtml = $pout->getText(); + if ( $this->generateRawHtml && strlen( $rawhtml ) > 0 ) { + $out->addHTML( $this->makeOutput( $rawhtml, 'expand_templates_html_output' ) ); + } + + $this->showHtmlPreview( $title, $pout, $out ); + } + } + + /** + * Generate a form allowing users to enter information + * + * @param string $title Value for context title field + * @param string $input Value for input textbox + * @return string + */ + private function makeForm( $title, $input ) { + $self = $this->getPageTitle(); + $request = $this->getRequest(); + $user = $this->getUser(); + + $form = Xml::openElement( + 'form', + array( 'method' => 'post', 'action' => $self->getLocalUrl() ) + ); + $form .= "<fieldset><legend>" . $this->msg( 'expandtemplates' )->escaped() . "</legend>\n"; + + $form .= '<p>' . Xml::inputLabel( + $this->msg( 'expand_templates_title' )->plain(), + 'wpContextTitle', + 'contexttitle', + 60, + $title, + array( 'autofocus' => true ) + ) . '</p>'; + $form .= '<p>' . Xml::label( + $this->msg( 'expand_templates_input' )->text(), + 'input' + ) . '</p>'; + $form .= Xml::textarea( + 'wpInput', + $input, + 10, + 10, + array( 'id' => 'input' ) + ); + + $form .= '<p>' . Xml::checkLabel( + $this->msg( 'expand_templates_remove_comments' )->text(), + 'wpRemoveComments', + 'removecomments', + $this->removeComments + ) . '</p>'; + $form .= '<p>' . Xml::checkLabel( + $this->msg( 'expand_templates_remove_nowiki' )->text(), + 'wpRemoveNowiki', + 'removenowiki', + $this->removeNowiki + ) . '</p>'; + $form .= '<p>' . Xml::checkLabel( + $this->msg( 'expand_templates_generate_xml' )->text(), + 'wpGenerateXml', + 'generate_xml', + $this->generateXML + ) . '</p>'; + $form .= '<p>' . Xml::checkLabel( + $this->msg( 'expand_templates_generate_rawhtml' )->text(), + 'wpGenerateRawHtml', + 'generate_rawhtml', + $this->generateRawHtml + ) . '</p>'; + $form .= '<p>' . Xml::submitButton( + $this->msg( 'expand_templates_ok' )->text(), + array( 'accesskey' => 's' ) + ) . '</p>'; + $form .= "</fieldset>\n"; + $form .= Html::hidden( 'wpEditToken', $user->getEditToken( '', $request ) ); + $form .= Xml::closeElement( 'form' ); + + return $form; + } + + /** + * Generate a nice little box with a heading for output + * + * @param string $output Wiki text output + * @param string $heading + * @return string + */ + private function makeOutput( $output, $heading = 'expand_templates_output' ) { + $out = "<h2>" . $this->msg( $heading )->escaped() . "</h2>\n"; + $out .= Xml::textarea( + 'output', + $output, + 10, + 10, + array( 'id' => 'output', 'readonly' => 'readonly' ) + ); + + return $out; + } + + /** + * Renders the supplied wikitext as html + * + * @param Title $title + * @param string $text + * @return ParserOutput + */ + private function generateHtml( Title $title, $text ) { + global $wgParser; + + $popts = ParserOptions::newFromContext( $this->getContext() ); + $popts->setTargetLanguage( $title->getPageLanguage() ); + return $wgParser->parse( $text, $title, $popts ); + } + + /** + * Wraps the provided html code in a div and outputs it to the page + * + * @param Title $title + * @param ParserOutput $pout + * @param OutputPage $out + */ + private function showHtmlPreview( Title $title, ParserOutput $pout, OutputPage $out ) { + $lang = $title->getPageViewLanguage(); + $out->addHTML( "<h2>" . $this->msg( 'expand_templates_preview' )->escaped() . "</h2>\n" ); + + if ( $this->getConfig()->get( 'RawHtml' ) ) { + $request = $this->getRequest(); + $user = $this->getUser(); + + // To prevent cross-site scripting attacks, don't show the preview if raw HTML is + // allowed and a valid edit token is not provided (bug 71111). However, MediaWiki + // does not currently provide logged-out users with CSRF protection; in that case, + // do not show the preview unless anonymous editing is allowed. + if ( $user->isAnon() && !$user->isAllowed( 'edit' ) ) { + $error = array( 'expand_templates_preview_fail_html_anon' ); + } elseif ( !$user->matchEditToken( $request->getVal( 'wpEditToken' ), '', $request ) ) { + $error = array( 'expand_templates_preview_fail_html' ); + } else { + $error = false; + } + + if ( $error ) { + $out->wrapWikiMsg( "<div class='previewnote'>\n$1\n</div>", $error ); + return; + } + } + + $out->addHTML( Html::openElement( 'div', array( + 'class' => 'mw-content-' . $lang->getDir(), + 'dir' => $lang->getDir(), + 'lang' => $lang->getHtmlCode(), + ) ) ); + $out->addParserOutputContent( $pout ); + $out->addHTML( Html::closeElement( 'div' ) ); + } + + protected function getGroupName() { + return 'wiki'; + } +} |