X-Git-Url: https://scripts.mit.edu/gitweb/autoinstallsdev/mediawiki.git/blobdiff_plain/f75295fdeb4bb0dc64fff481a386e0f48081a492..83d871ca0d985c6d586b323bf96161afb510ebf6:/includes/api/ApiExpandTemplates.php diff --git a/includes/api/ApiExpandTemplates.php b/includes/api/ApiExpandTemplates.php index afb11402..7c86e09d 100644 --- a/includes/api/ApiExpandTemplates.php +++ b/includes/api/ApiExpandTemplates.php @@ -1,11 +1,10 @@ @gmail.com + * Created on Oct 05, 2007 + * + * Copyright © 2007 Yuri Astrakhan "@gmail.com" * * 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 @@ -19,15 +18,12 @@ * * 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., - * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. * http://www.gnu.org/copyleft/gpl.html + * + * @file */ -if (!defined('MEDIAWIKI')) { - // Eclipse helper - will be ignored in production - require_once ("ApiBase.php"); -} - /** * API module that functions as a shortcut to the wikitext preprocessor. Expands * any templates in a provided string, and returns the result of this expansion @@ -37,77 +33,201 @@ if (!defined('MEDIAWIKI')) { */ class ApiExpandTemplates extends ApiBase { - public function __construct($main, $action) { - parent :: __construct($main, $action); - } - public function execute() { - // Cache may vary on $wgUser because ParserOptions gets data from it + // Cache may vary on the user because ParserOptions gets data from it $this->getMain()->setCacheMode( 'anon-public-user-private' ); // Get parameters $params = $this->extractRequestParams(); + $this->requireMaxOneParameter( $params, 'prop', 'generatexml' ); + + $title = $params['title']; + if ( $title === null ) { + $titleProvided = false; + // A title is needed for parsing, so arbitrarily choose one + $title = 'API'; + } else { + $titleProvided = true; + } + + if ( $params['prop'] === null ) { + $this->addDeprecation( + 'apiwarn-deprecation-expandtemplates-prop', 'action=expandtemplates&!prop' + ); + $prop = []; + } else { + $prop = array_flip( $params['prop'] ); + } + + $titleObj = Title::newFromText( $title ); + if ( !$titleObj || $titleObj->isExternal() ) { + $this->dieWithError( [ 'apierror-invalidtitle', wfEscapeWikiText( $params['title'] ) ] ); + } - //Create title for parser - $title_obj = Title :: newFromText( $params['title'] ); - if(!$title_obj) - $title_obj = Title :: newFromText( "API" ); // default + // Get title and revision ID for parser + $revid = $params['revid']; + if ( $revid !== null ) { + $rev = Revision::newFromId( $revid ); + if ( !$rev ) { + $this->dieWithError( [ 'apierror-nosuchrevid', $revid ] ); + } + $pTitleObj = $titleObj; + $titleObj = $rev->getTitle(); + if ( $titleProvided ) { + if ( !$titleObj->equals( $pTitleObj ) ) { + $this->addWarning( [ 'apierror-revwrongpage', $rev->getId(), + wfEscapeWikiText( $pTitleObj->getPrefixedText() ) ] ); + } + } else { + // Consider the title derived from the revid as having + // been provided. + $titleProvided = true; + } + } $result = $this->getResult(); // Parse text global $wgParser; - $options = new ParserOptions(); - if ( $params['generatexml'] ) - { - $wgParser->startExternalParse( $title_obj, $options, OT_PREPROCESS ); + $options = ParserOptions::newFromContext( $this->getContext() ); + + if ( $params['includecomments'] ) { + $options->setRemoveComments( false ); + } + + $reset = null; + $suppressCache = false; + Hooks::run( 'ApiMakeParserOptions', + [ $options, $titleObj, $params, $this, &$reset, &$suppressCache ] ); + + $retval = []; + + if ( isset( $prop['parsetree'] ) || $params['generatexml'] ) { + $wgParser->startExternalParse( $titleObj, $options, Parser::OT_PREPROCESS ); $dom = $wgParser->preprocessToDom( $params['text'] ); - if ( is_callable( array( $dom, 'saveXML' ) ) ) { + if ( is_callable( [ $dom, 'saveXML' ] ) ) { $xml = $dom->saveXML(); } else { $xml = $dom->__toString(); } - $xml_result = array(); - $result->setContent( $xml_result, $xml ); - $result->addValue( null, 'parsetree', $xml_result); + if ( isset( $prop['parsetree'] ) ) { + unset( $prop['parsetree'] ); + $retval['parsetree'] = $xml; + } else { + // the old way + $result->addValue( null, 'parsetree', $xml ); + $result->addValue( null, ApiResult::META_BC_SUBELEMENTS, [ 'parsetree' ] ); + } } - $retval = $wgParser->preprocess( $params['text'], $title_obj, $options ); - // Return result - $retval_array = array(); - $result->setContent( $retval_array, $retval ); - $result->addValue( null, $this->getModuleName(), $retval_array ); + // if they didn't want any output except (probably) the parse tree, + // then don't bother actually fully expanding it + if ( $prop || $params['prop'] === null ) { + $wgParser->startExternalParse( $titleObj, $options, Parser::OT_PREPROCESS ); + $frame = $wgParser->getPreprocessor()->newFrame(); + $wikitext = $wgParser->preprocess( $params['text'], $titleObj, $options, $revid, $frame ); + if ( $params['prop'] === null ) { + // the old way + ApiResult::setContentValue( $retval, 'wikitext', $wikitext ); + } else { + $p_output = $wgParser->getOutput(); + if ( isset( $prop['categories'] ) ) { + $categories = $p_output->getCategories(); + if ( $categories ) { + $categories_result = []; + foreach ( $categories as $category => $sortkey ) { + $entry = []; + $entry['sortkey'] = $sortkey; + ApiResult::setContentValue( $entry, 'category', (string)$category ); + $categories_result[] = $entry; + } + ApiResult::setIndexedTagName( $categories_result, 'category' ); + $retval['categories'] = $categories_result; + } + } + if ( isset( $prop['properties'] ) ) { + $properties = $p_output->getProperties(); + if ( $properties ) { + ApiResult::setArrayType( $properties, 'BCkvp', 'name' ); + ApiResult::setIndexedTagName( $properties, 'property' ); + $retval['properties'] = $properties; + } + } + if ( isset( $prop['volatile'] ) ) { + $retval['volatile'] = $frame->isVolatile(); + } + if ( isset( $prop['ttl'] ) && $frame->getTTL() !== null ) { + $retval['ttl'] = $frame->getTTL(); + } + if ( isset( $prop['wikitext'] ) ) { + $retval['wikitext'] = $wikitext; + } + if ( isset( $prop['modules'] ) ) { + $retval['modules'] = array_values( array_unique( $p_output->getModules() ) ); + $retval['modulescripts'] = array_values( array_unique( $p_output->getModuleScripts() ) ); + $retval['modulestyles'] = array_values( array_unique( $p_output->getModuleStyles() ) ); + } + if ( isset( $prop['jsconfigvars'] ) ) { + $retval['jsconfigvars'] = + ApiResult::addMetadataToResultVars( $p_output->getJsConfigVars() ); + } + if ( isset( $prop['encodedjsconfigvars'] ) ) { + $retval['encodedjsconfigvars'] = FormatJson::encode( + $p_output->getJsConfigVars(), false, FormatJson::ALL_OK + ); + $retval[ApiResult::META_SUBELEMENTS][] = 'encodedjsconfigvars'; + } + if ( isset( $prop['modules'] ) && + !isset( $prop['jsconfigvars'] ) && !isset( $prop['encodedjsconfigvars'] ) ) { + $this->addWarning( 'apiwarn-moduleswithoutvars' ); + } + } + } + ApiResult::setSubelementsList( $retval, [ 'wikitext', 'parsetree' ] ); + $result->addValue( null, $this->getModuleName(), $retval ); } public function getAllowedParams() { - return array ( - 'title' => array( - ApiBase :: PARAM_DFLT => 'API', - ), - 'text' => null, - 'generatexml' => false, - ); - } - - public function getParamDescription() { - return array ( - 'text' => 'Wikitext to convert', - 'title' => 'Title of page', - 'generatexml' => 'Generate XML parse tree', - ); - } - - public function getDescription() { - return 'This module expand all templates in wikitext'; + return [ + 'title' => null, + 'text' => [ + ApiBase::PARAM_TYPE => 'text', + ApiBase::PARAM_REQUIRED => true, + ], + 'revid' => [ + ApiBase::PARAM_TYPE => 'integer', + ], + 'prop' => [ + ApiBase::PARAM_TYPE => [ + 'wikitext', + 'categories', + 'properties', + 'volatile', + 'ttl', + 'modules', + 'jsconfigvars', + 'encodedjsconfigvars', + 'parsetree', + ], + ApiBase::PARAM_ISMULTI => true, + ApiBase::PARAM_HELP_MSG_PER_VALUE => [], + ], + 'includecomments' => false, + 'generatexml' => [ + ApiBase::PARAM_TYPE => 'boolean', + ApiBase::PARAM_DEPRECATED => true, + ], + ]; } - protected function getExamples() { - return array ( - 'api.php?action=expandtemplates&text={{Project:Sandbox}}' - ); + protected function getExamplesMessages() { + return [ + 'action=expandtemplates&text={{Project:Sandbox}}' + => 'apihelp-expandtemplates-example-simple', + ]; } - public function getVersion() { - return __CLASS__ . ': $Id: ApiExpandTemplates.php 69986 2010-07-27 03:57:39Z tstarling $'; + public function getHelpUrls() { + return 'https://www.mediawiki.org/wiki/Special:MyLanguage/API:Parsing_wikitext#expandtemplates'; } }