2007-01-20 12:50:56 +00:00
|
|
|
<?php
|
2012-08-20 14:55:28 +00:00
|
|
|
|
2010-08-22 14:31:05 +00:00
|
|
|
/**
|
2012-08-20 14:55:28 +00:00
|
|
|
* Output of the PHP parser.
|
2010-08-22 14:31:05 +00:00
|
|
|
*
|
2012-04-30 09:22:16 +00:00
|
|
|
* 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
|
|
|
|
|
*
|
2010-08-22 14:31:05 +00:00
|
|
|
* @file
|
|
|
|
|
* @ingroup Parser
|
|
|
|
|
*/
|
2010-12-28 09:54:25 +00:00
|
|
|
class ParserOutput extends CacheTime {
|
2014-08-11 20:24:54 +00:00
|
|
|
public $mText, # The output text
|
2014-05-16 00:48:01 +00:00
|
|
|
$mLanguageLinks, # List of the full text of language links, in the order they appear
|
|
|
|
|
$mCategories, # Map of category names to sort keys
|
Implement page status indicators
Page status indicators are icons (or short text snippets) usually
displayed in the top-right corner of the page, outside of the main
content. Basically, <indicator name="foo">[[File:Foo.svg|20px]]</indicator>
may be used on a page to place the icon in the indicator area. They
are also known as top icons, page icons, heading icons or title icons.
I found the discussion on bug 23796 highly illuminating. I suggest
that everyone read it before suggesting different design choices.
I spent some time with a thesaurus pondering the name. "Emblems" and
"badges" were also considered, but the former has a much more limited
meaning and the latter is already taken by Wikidata, with a similar
but subtly different feature set. I am not aware of any naming
conflicts ;) besides new talk page message "indicator" (used by core
and Echo in some documents) and OOjs UI indicators (tiny icons like
the arrow on a dropdown form element), which shouldn't be confusing.
Potential use cases include:
* "Lock" indicators for page protection levels
* Featured/good article indicators
* Redirect shortcuts display ("WP:VPT")
* Links to help/manual for special pages
* Coordinates?… or globe icon for inline pop-up maps
Design features:
* Skin-customizable. Skins can fully control where and how indicators
are shown, or may just do <?php echo $this->getIndicators(); ?> to
output the default structure. By default they are not shown at all.
* Extension-customizable. Extensions can call ParserOutput::addIndicator()
to insert an indicator from one of the numerous parser hooks.
* Wiki-customizable. In addition to just using the parser functions,
on-wiki styles and scripts can use the provided classes and ids
(.mw-indicator, #mw-indicator-<name>) to customize their display.
Design limitations:
* Every indicator must have a unique identifier (name). It's not
possible to create arrays, or to have several indicators with the
same name. In case of duplicates, the latest occurrence of the
parser function wins.
* Indicators are displayed ordered by their names (and not occurrence
order). This ensures consistency across pages and provides a simple
means of ordering or grouping them.
* Indicators are not stored, tracked or accessible outside of
ParserOutput (in particular they're not in the page_props table).
They are intended to merely reflect the content or metadata that is
already present on the page, and not be data themselves. If you ever
think you need to list pages with a given status indicator, instead
figure out what it means and use the appropriate tracking category,
special page report, already existing page_prop, or other means.
Corresponding patch in Vector: I90a8ae15ac8275d084ea5f47b6b2684d5e6c7412.
I'll implement support in the other three skins included in the tarball
and document it on mediawiki.org after this is merged.
Bug: 23796
Change-Id: I2389ff9a5332a2b1d033eb75f0946e5241cfaaf4
2014-09-24 10:44:16 +00:00
|
|
|
$mIndicators = array(), # Page status indicators, usually displayed in top-right corner
|
2014-05-16 00:48:01 +00:00
|
|
|
$mTitleText, # title text of the chosen language variant
|
|
|
|
|
$mLinks = array(), # 2-D map of NS/DBK to ID for the links in the document. ID=zero for broken.
|
|
|
|
|
$mTemplates = array(), # 2-D map of NS/DBK to ID for the template references. ID=zero for broken.
|
|
|
|
|
$mTemplateIds = array(), # 2-D map of NS/DBK to rev ID for the template references. ID=zero for broken.
|
|
|
|
|
$mImages = array(), # DB keys of the images used, in the array key only
|
|
|
|
|
$mFileSearchOptions = array(), # DB keys of the images used mapped to sha1 and MW timestamp
|
|
|
|
|
$mExternalLinks = array(), # External link URLs, in the key only
|
|
|
|
|
$mInterwikiLinks = array(), # 2-D map of prefix/DBK (in keys only) for the inline interwiki links in the document.
|
|
|
|
|
$mNewSection = false, # Show a new section link?
|
|
|
|
|
$mHideNewSection = false, # Hide the new section link?
|
|
|
|
|
$mNoGallery = false, # No gallery on category page? (__NOGALLERY__)
|
|
|
|
|
$mHeadItems = array(), # Items to put in the <head> section
|
|
|
|
|
$mModules = array(), # Modules to be loaded by the resource loader
|
|
|
|
|
$mModuleScripts = array(), # Modules of which only the JS will be loaded by the resource loader
|
|
|
|
|
$mModuleStyles = array(), # Modules of which only the CSSS will be loaded by the resource loader
|
|
|
|
|
$mModuleMessages = array(), # Modules of which only the messages will be loaded by the resource loader
|
|
|
|
|
$mJsConfigVars = array(), # JavaScript config variable for mw.config combined with this page
|
|
|
|
|
$mOutputHooks = array(), # Hook tags as per $wgParserOutputHooks
|
|
|
|
|
$mWarnings = array(), # Warning text to be returned to the user. Wikitext formatted, in the key only
|
|
|
|
|
$mSections = array(), # Table of contents
|
|
|
|
|
$mEditSectionTokens = false, # prefix/suffix markers if edit sections were output as tokens
|
|
|
|
|
$mProperties = array(), # Name/value pairs to be cached in the DB
|
|
|
|
|
$mTOCHTML = '', # HTML of the TOC
|
|
|
|
|
$mTimestamp, # Timestamp of the revision
|
|
|
|
|
$mTOCEnabled = true; # Whether TOC should be shown, can't override __NOTOC__
|
2014-09-08 15:00:14 +00:00
|
|
|
private $mIndexPolicy = ''; # 'index' or 'noindex'? Any other value will result in no change.
|
|
|
|
|
private $mAccessedOptions = array(); # List of ParserOptions (stored in the keys)
|
2015-01-09 19:16:00 +00:00
|
|
|
private $mSecondaryDataUpdates = array(); # List of DataUpdate, used to save info from the page somewhere else.
|
|
|
|
|
private $mCustomDataUpdateCount = 0; # Number of custom updaters in $mSecondaryDataUpdates.
|
2014-09-08 15:00:14 +00:00
|
|
|
private $mExtensionData = array(); # extra data used by extensions
|
|
|
|
|
private $mLimitReportData = array(); # Parser limit report data
|
|
|
|
|
private $mParseStartTime = array(); # Timestamps for getTimeSinceStart()
|
|
|
|
|
private $mPreventClickjacking = false; # Whether to emit X-Frame-Options: DENY
|
2008-02-20 08:53:12 +00:00
|
|
|
|
2014-05-10 23:03:45 +00:00
|
|
|
const EDITSECTION_REGEX =
|
|
|
|
|
'#<(?:mw:)?editsection page="(.*?)" section="(.*?)"(?:/>|>(.*?)(</(?:mw:)?editsection>))#';
|
2011-02-08 01:31:21 +00:00
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function __construct( $text = '', $languageLinks = array(), $categoryLinks = array(),
|
2013-12-01 20:39:00 +00:00
|
|
|
$containsOldMagic = false, $titletext = ''
|
|
|
|
|
) {
|
2007-01-20 12:50:56 +00:00
|
|
|
$this->mText = $text;
|
|
|
|
|
$this->mLanguageLinks = $languageLinks;
|
|
|
|
|
$this->mCategories = $categoryLinks;
|
|
|
|
|
$this->mContainsOldMagic = $containsOldMagic;
|
|
|
|
|
$this->mTitleText = $titletext;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getText() {
|
2013-08-22 22:22:03 +00:00
|
|
|
$text = $this->mText;
|
2011-01-03 20:17:20 +00:00
|
|
|
if ( $this->mEditSectionTokens ) {
|
2014-07-04 20:19:48 +00:00
|
|
|
$text = preg_replace_callback(
|
|
|
|
|
ParserOutput::EDITSECTION_REGEX,
|
|
|
|
|
function ( $m ) {
|
|
|
|
|
global $wgOut, $wgLang;
|
|
|
|
|
$editsectionPage = Title::newFromText( htmlspecialchars_decode( $m[1] ) );
|
|
|
|
|
$editsectionSection = htmlspecialchars_decode( $m[2] );
|
|
|
|
|
$editsectionContent = isset( $m[4] ) ? $m[3] : null;
|
|
|
|
|
|
|
|
|
|
if ( !is_object( $editsectionPage ) ) {
|
|
|
|
|
throw new MWException( "Bad parser output text." );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$skin = $wgOut->getSkin();
|
|
|
|
|
return call_user_func_array(
|
|
|
|
|
array( $skin, 'doEditSectionLink' ),
|
|
|
|
|
array( $editsectionPage, $editsectionSection,
|
|
|
|
|
$editsectionContent, $wgLang->getCode() )
|
|
|
|
|
);
|
|
|
|
|
},
|
|
|
|
|
$text
|
|
|
|
|
);
|
2013-08-22 22:22:03 +00:00
|
|
|
} else {
|
|
|
|
|
$text = preg_replace( ParserOutput::EDITSECTION_REGEX, '', $text );
|
2011-01-03 20:17:20 +00:00
|
|
|
}
|
2013-08-22 22:22:03 +00:00
|
|
|
|
|
|
|
|
// If you have an old cached version of this class - sorry, you can't disable the TOC
|
|
|
|
|
if ( isset( $this->mTOCEnabled ) && $this->mTOCEnabled ) {
|
|
|
|
|
$text = str_replace( array( Parser::TOC_START, Parser::TOC_END ), '', $text );
|
|
|
|
|
} else {
|
|
|
|
|
$text = preg_replace(
|
2013-11-19 18:03:54 +00:00
|
|
|
'#' . preg_quote( Parser::TOC_START ) . '.*?' . preg_quote( Parser::TOC_END ) . '#s',
|
2013-08-22 22:22:03 +00:00
|
|
|
'',
|
|
|
|
|
$text
|
|
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
return $text;
|
2011-01-03 20:17:20 +00:00
|
|
|
}
|
2011-08-01 15:40:02 +00:00
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function &getLanguageLinks() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mLanguageLinks;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getInterwikiLinks() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mInterwikiLinks;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getCategoryLinks() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return array_keys( $this->mCategories );
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function &getCategories() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mCategories;
|
|
|
|
|
}
|
|
|
|
|
|
Implement page status indicators
Page status indicators are icons (or short text snippets) usually
displayed in the top-right corner of the page, outside of the main
content. Basically, <indicator name="foo">[[File:Foo.svg|20px]]</indicator>
may be used on a page to place the icon in the indicator area. They
are also known as top icons, page icons, heading icons or title icons.
I found the discussion on bug 23796 highly illuminating. I suggest
that everyone read it before suggesting different design choices.
I spent some time with a thesaurus pondering the name. "Emblems" and
"badges" were also considered, but the former has a much more limited
meaning and the latter is already taken by Wikidata, with a similar
but subtly different feature set. I am not aware of any naming
conflicts ;) besides new talk page message "indicator" (used by core
and Echo in some documents) and OOjs UI indicators (tiny icons like
the arrow on a dropdown form element), which shouldn't be confusing.
Potential use cases include:
* "Lock" indicators for page protection levels
* Featured/good article indicators
* Redirect shortcuts display ("WP:VPT")
* Links to help/manual for special pages
* Coordinates?… or globe icon for inline pop-up maps
Design features:
* Skin-customizable. Skins can fully control where and how indicators
are shown, or may just do <?php echo $this->getIndicators(); ?> to
output the default structure. By default they are not shown at all.
* Extension-customizable. Extensions can call ParserOutput::addIndicator()
to insert an indicator from one of the numerous parser hooks.
* Wiki-customizable. In addition to just using the parser functions,
on-wiki styles and scripts can use the provided classes and ids
(.mw-indicator, #mw-indicator-<name>) to customize their display.
Design limitations:
* Every indicator must have a unique identifier (name). It's not
possible to create arrays, or to have several indicators with the
same name. In case of duplicates, the latest occurrence of the
parser function wins.
* Indicators are displayed ordered by their names (and not occurrence
order). This ensures consistency across pages and provides a simple
means of ordering or grouping them.
* Indicators are not stored, tracked or accessible outside of
ParserOutput (in particular they're not in the page_props table).
They are intended to merely reflect the content or metadata that is
already present on the page, and not be data themselves. If you ever
think you need to list pages with a given status indicator, instead
figure out what it means and use the appropriate tracking category,
special page report, already existing page_prop, or other means.
Corresponding patch in Vector: I90a8ae15ac8275d084ea5f47b6b2684d5e6c7412.
I'll implement support in the other three skins included in the tarball
and document it on mediawiki.org after this is merged.
Bug: 23796
Change-Id: I2389ff9a5332a2b1d033eb75f0946e5241cfaaf4
2014-09-24 10:44:16 +00:00
|
|
|
/**
|
|
|
|
|
* @since 1.25
|
|
|
|
|
*/
|
|
|
|
|
public function getIndicators() {
|
|
|
|
|
return $this->mIndicators;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getTitleText() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mTitleText;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getSections() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mSections;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getEditSectionTokens() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mEditSectionTokens;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function &getLinks() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mLinks;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function &getTemplates() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mTemplates;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function &getTemplateIds() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mTemplateIds;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function &getImages() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mImages;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function &getFileSearchOptions() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mFileSearchOptions;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function &getExternalLinks() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mExternalLinks;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getNoGallery() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mNoGallery;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getHeadItems() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mHeadItems;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getModules() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mModules;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getModuleScripts() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mModuleScripts;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getModuleStyles() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mModuleStyles;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getModuleMessages() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mModuleMessages;
|
|
|
|
|
}
|
|
|
|
|
|
2014-01-19 15:39:46 +00:00
|
|
|
/** @since 1.23 */
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getJsConfigVars() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mJsConfigVars;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getOutputHooks() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return (array)$this->mOutputHooks;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getWarnings() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return array_keys( $this->mWarnings );
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getIndexPolicy() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mIndexPolicy;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getTOCHTML() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mTOCHTML;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getTimestamp() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mTimestamp;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getLimitReportData() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mLimitReportData;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getTOCEnabled() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mTOCEnabled;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function setText( $text ) {
|
2014-05-10 23:03:45 +00:00
|
|
|
return wfSetVar( $this->mText, $text );
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function setLanguageLinks( $ll ) {
|
2014-05-10 23:03:45 +00:00
|
|
|
return wfSetVar( $this->mLanguageLinks, $ll );
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function setCategoryLinks( $cl ) {
|
2014-05-10 23:03:45 +00:00
|
|
|
return wfSetVar( $this->mCategories, $cl );
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function setTitleText( $t ) {
|
2014-05-10 23:03:45 +00:00
|
|
|
return wfSetVar( $this->mTitleText, $t );
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function setSections( $toc ) {
|
2014-05-10 23:03:45 +00:00
|
|
|
return wfSetVar( $this->mSections, $toc );
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function setEditSectionTokens( $t ) {
|
2014-05-10 23:03:45 +00:00
|
|
|
return wfSetVar( $this->mEditSectionTokens, $t );
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function setIndexPolicy( $policy ) {
|
2014-05-10 23:03:45 +00:00
|
|
|
return wfSetVar( $this->mIndexPolicy, $policy );
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function setTOCHTML( $tochtml ) {
|
2014-05-10 23:03:45 +00:00
|
|
|
return wfSetVar( $this->mTOCHTML, $tochtml );
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function setTimestamp( $timestamp ) {
|
2014-05-10 23:03:45 +00:00
|
|
|
return wfSetVar( $this->mTimestamp, $timestamp );
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function setTOCEnabled( $flag ) {
|
2014-05-10 23:03:45 +00:00
|
|
|
return wfSetVar( $this->mTOCEnabled, $flag );
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function addCategory( $c, $sort ) {
|
2014-05-10 23:03:45 +00:00
|
|
|
$this->mCategories[$c] = $sort;
|
|
|
|
|
}
|
|
|
|
|
|
Implement page status indicators
Page status indicators are icons (or short text snippets) usually
displayed in the top-right corner of the page, outside of the main
content. Basically, <indicator name="foo">[[File:Foo.svg|20px]]</indicator>
may be used on a page to place the icon in the indicator area. They
are also known as top icons, page icons, heading icons or title icons.
I found the discussion on bug 23796 highly illuminating. I suggest
that everyone read it before suggesting different design choices.
I spent some time with a thesaurus pondering the name. "Emblems" and
"badges" were also considered, but the former has a much more limited
meaning and the latter is already taken by Wikidata, with a similar
but subtly different feature set. I am not aware of any naming
conflicts ;) besides new talk page message "indicator" (used by core
and Echo in some documents) and OOjs UI indicators (tiny icons like
the arrow on a dropdown form element), which shouldn't be confusing.
Potential use cases include:
* "Lock" indicators for page protection levels
* Featured/good article indicators
* Redirect shortcuts display ("WP:VPT")
* Links to help/manual for special pages
* Coordinates?… or globe icon for inline pop-up maps
Design features:
* Skin-customizable. Skins can fully control where and how indicators
are shown, or may just do <?php echo $this->getIndicators(); ?> to
output the default structure. By default they are not shown at all.
* Extension-customizable. Extensions can call ParserOutput::addIndicator()
to insert an indicator from one of the numerous parser hooks.
* Wiki-customizable. In addition to just using the parser functions,
on-wiki styles and scripts can use the provided classes and ids
(.mw-indicator, #mw-indicator-<name>) to customize their display.
Design limitations:
* Every indicator must have a unique identifier (name). It's not
possible to create arrays, or to have several indicators with the
same name. In case of duplicates, the latest occurrence of the
parser function wins.
* Indicators are displayed ordered by their names (and not occurrence
order). This ensures consistency across pages and provides a simple
means of ordering or grouping them.
* Indicators are not stored, tracked or accessible outside of
ParserOutput (in particular they're not in the page_props table).
They are intended to merely reflect the content or metadata that is
already present on the page, and not be data themselves. If you ever
think you need to list pages with a given status indicator, instead
figure out what it means and use the appropriate tracking category,
special page report, already existing page_prop, or other means.
Corresponding patch in Vector: I90a8ae15ac8275d084ea5f47b6b2684d5e6c7412.
I'll implement support in the other three skins included in the tarball
and document it on mediawiki.org after this is merged.
Bug: 23796
Change-Id: I2389ff9a5332a2b1d033eb75f0946e5241cfaaf4
2014-09-24 10:44:16 +00:00
|
|
|
/**
|
|
|
|
|
* @since 1.25
|
|
|
|
|
*/
|
|
|
|
|
public function setIndicator( $id, $content ) {
|
|
|
|
|
$this->mIndicators[$id] = $content;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function addLanguageLink( $t ) {
|
2014-05-10 23:03:45 +00:00
|
|
|
$this->mLanguageLinks[] = $t;
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function addWarning( $s ) {
|
2014-05-10 23:03:45 +00:00
|
|
|
$this->mWarnings[$s] = 1;
|
|
|
|
|
}
|
2007-01-20 12:50:56 +00:00
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function addOutputHook( $hook, $data = false ) {
|
Basic integrated audio/video support, with Ogg implementation.
* JavaScript video player based loosely on Greg Maxwell's player
* Image page text snippet customisation
* Abstraction of transform parameters in the parser. Introduced Linker::makeImageLink2().
* Made canRender(), mustRender() depend on file, not just on handler. Moved width=0, height=0 checking to ImageHandler::canRender(), since audio streams have width=height=0 but should be rendered.
Also:
* Automatic upgrade for oldimage rows on image page view, allows media handler selection based on oi_*_mime
* oi_*_mime unconditionally referenced, REQUIRES SCHEMA UPGRADE
* Don't destroy file info for missing files on upgrade
* Simple, centralised extension message file handling
* Made MessageCache::loadAllMessages non-static, optimised for repeated-call case due to abuse in User.php
* Support for lightweight parser output hooks, with callback whitelist for security
* Moved Linker::formatSize() to Language, to join the new formatTimePeriod() and formatBitrate()
* Introduced MagicWordArray, regex capture trick requires that magic word IDs DO NOT CONTAIN HYPHENS.
2007-08-15 10:50:09 +00:00
|
|
|
$this->mOutputHooks[] = array( $hook, $data );
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function setNewSection( $value ) {
|
2007-01-20 12:50:56 +00:00
|
|
|
$this->mNewSection = (bool)$value;
|
|
|
|
|
}
|
2014-08-11 20:24:54 +00:00
|
|
|
public function hideNewSection( $value ) {
|
2009-02-19 22:14:59 +00:00
|
|
|
$this->mHideNewSection = (bool)$value;
|
|
|
|
|
}
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getHideNewSection() {
|
2009-02-19 22:14:59 +00:00
|
|
|
return (bool)$this->mHideNewSection;
|
|
|
|
|
}
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getNewSection() {
|
2007-01-20 12:50:56 +00:00
|
|
|
return (bool)$this->mNewSection;
|
|
|
|
|
}
|
|
|
|
|
|
2012-09-29 10:36:33 +00:00
|
|
|
/**
|
|
|
|
|
* Checks, if a url is pointing to the own server
|
|
|
|
|
*
|
2014-04-21 23:38:39 +00:00
|
|
|
* @param string $internal The server to check against
|
|
|
|
|
* @param string $url The url to check
|
2012-09-29 10:36:33 +00:00
|
|
|
* @return bool
|
|
|
|
|
*/
|
2014-08-11 20:24:54 +00:00
|
|
|
public static function isLinkInternal( $internal, $url ) {
|
2012-09-29 10:36:33 +00:00
|
|
|
return (bool)preg_match( '/^' .
|
|
|
|
|
# If server is proto relative, check also for http/https links
|
|
|
|
|
( substr( $internal, 0, 2 ) === '//' ? '(?:https?:)?' : '' ) .
|
|
|
|
|
preg_quote( $internal, '/' ) .
|
|
|
|
|
# check for query/path/anchor or end of link in each case
|
|
|
|
|
'(?:[\?\/\#]|$)/i',
|
|
|
|
|
$url
|
|
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function addExternalLink( $url ) {
|
2009-07-11 08:04:31 +00:00
|
|
|
# We don't register links pointing to our own server, unless... :-)
|
|
|
|
|
global $wgServer, $wgRegisterInternalExternals;
|
2012-09-29 10:36:33 +00:00
|
|
|
|
|
|
|
|
$registerExternalLink = true;
|
2013-04-20 15:38:24 +00:00
|
|
|
if ( !$wgRegisterInternalExternals ) {
|
2012-09-29 10:36:33 +00:00
|
|
|
$registerExternalLink = !self::isLinkInternal( $wgServer, $url );
|
|
|
|
|
}
|
2013-04-20 15:38:24 +00:00
|
|
|
if ( $registerExternalLink ) {
|
2011-08-01 15:40:02 +00:00
|
|
|
$this->mExternalLinks[$url] = 1;
|
2012-09-29 10:36:33 +00:00
|
|
|
}
|
2009-07-11 08:04:31 +00:00
|
|
|
}
|
|
|
|
|
|
2010-04-16 01:40:05 +00:00
|
|
|
/**
|
|
|
|
|
* Record a local or interwiki inline link for saving in future link tables.
|
|
|
|
|
*
|
2014-04-21 23:38:39 +00:00
|
|
|
* @param Title $title
|
|
|
|
|
* @param int|null $id Optional known page_id so we can skip the lookup
|
2010-04-16 01:40:05 +00:00
|
|
|
*/
|
2014-08-11 20:24:54 +00:00
|
|
|
public function addLink( Title $title, $id = null ) {
|
2009-07-18 22:49:31 +00:00
|
|
|
if ( $title->isExternal() ) {
|
|
|
|
|
// Don't record interwikis in pagelinks
|
2010-04-16 01:40:05 +00:00
|
|
|
$this->addInterwikiLink( $title );
|
2009-07-18 22:49:31 +00:00
|
|
|
return;
|
|
|
|
|
}
|
2007-01-20 12:50:56 +00:00
|
|
|
$ns = $title->getNamespace();
|
|
|
|
|
$dbk = $title->getDBkey();
|
2009-01-01 00:05:08 +00:00
|
|
|
if ( $ns == NS_MEDIA ) {
|
|
|
|
|
// Normalize this pseudo-alias if it makes it down here...
|
|
|
|
|
$ns = NS_FILE;
|
2013-04-20 15:38:24 +00:00
|
|
|
} elseif ( $ns == NS_SPECIAL ) {
|
2009-01-01 00:05:08 +00:00
|
|
|
// We don't record Special: links currently
|
|
|
|
|
// It might actually be wise to, but we'd need to do some normalization.
|
|
|
|
|
return;
|
2013-04-20 15:38:24 +00:00
|
|
|
} elseif ( $dbk === '' ) {
|
2009-01-11 03:42:13 +00:00
|
|
|
// Don't record self links - [[#Foo]]
|
|
|
|
|
return;
|
2009-01-01 00:05:08 +00:00
|
|
|
}
|
2007-01-20 12:50:56 +00:00
|
|
|
if ( !isset( $this->mLinks[$ns] ) ) {
|
|
|
|
|
$this->mLinks[$ns] = array();
|
|
|
|
|
}
|
|
|
|
|
if ( is_null( $id ) ) {
|
|
|
|
|
$id = $title->getArticleID();
|
|
|
|
|
}
|
|
|
|
|
$this->mLinks[$ns][$dbk] = $id;
|
|
|
|
|
}
|
2008-04-14 07:45:50 +00:00
|
|
|
|
2011-03-23 17:35:40 +00:00
|
|
|
/**
|
2011-04-04 01:22:08 +00:00
|
|
|
* Register a file dependency for this output
|
2013-03-11 17:15:01 +00:00
|
|
|
* @param string $name Title dbKey
|
|
|
|
|
* @param string $timestamp MW timestamp of file creation (or false if non-existing)
|
2014-04-21 23:38:39 +00:00
|
|
|
* @param string $sha1 Base 36 SHA-1 of file (or false if non-existing)
|
2012-01-12 19:41:18 +00:00
|
|
|
* @return void
|
2011-03-23 17:35:40 +00:00
|
|
|
*/
|
2014-08-11 20:24:54 +00:00
|
|
|
public function addImage( $name, $timestamp = null, $sha1 = null ) {
|
2007-05-31 16:01:26 +00:00
|
|
|
$this->mImages[$name] = 1;
|
2011-04-04 01:22:08 +00:00
|
|
|
if ( $timestamp !== null && $sha1 !== null ) {
|
2011-09-14 19:05:43 +00:00
|
|
|
$this->mFileSearchOptions[$name] = array( 'time' => $timestamp, 'sha1' => $sha1 );
|
2011-04-04 01:22:08 +00:00
|
|
|
}
|
2007-05-31 16:01:26 +00:00
|
|
|
}
|
2007-01-20 12:50:56 +00:00
|
|
|
|
2011-02-19 01:02:56 +00:00
|
|
|
/**
|
2011-04-04 01:22:08 +00:00
|
|
|
* Register a template dependency for this output
|
2014-04-21 23:38:39 +00:00
|
|
|
* @param Title $title
|
|
|
|
|
* @param int $page_id
|
|
|
|
|
* @param int $rev_id
|
2012-01-12 19:41:18 +00:00
|
|
|
* @return void
|
2011-02-19 01:02:56 +00:00
|
|
|
*/
|
2014-08-11 20:24:54 +00:00
|
|
|
public function addTemplate( $title, $page_id, $rev_id ) {
|
2007-01-20 12:50:56 +00:00
|
|
|
$ns = $title->getNamespace();
|
|
|
|
|
$dbk = $title->getDBkey();
|
|
|
|
|
if ( !isset( $this->mTemplates[$ns] ) ) {
|
|
|
|
|
$this->mTemplates[$ns] = array();
|
|
|
|
|
}
|
2007-05-31 16:01:26 +00:00
|
|
|
$this->mTemplates[$ns][$dbk] = $page_id;
|
|
|
|
|
if ( !isset( $this->mTemplateIds[$ns] ) ) {
|
|
|
|
|
$this->mTemplateIds[$ns] = array();
|
|
|
|
|
}
|
|
|
|
|
$this->mTemplateIds[$ns][$dbk] = $rev_id; // For versioning
|
2007-01-20 12:50:56 +00:00
|
|
|
}
|
2011-08-01 15:40:02 +00:00
|
|
|
|
2010-04-16 01:40:05 +00:00
|
|
|
/**
|
2014-04-21 23:38:39 +00:00
|
|
|
* @param Title $title Title object, must be an interwiki link
|
2014-07-24 17:43:25 +00:00
|
|
|
* @throws MWException If given invalid input
|
2010-04-16 01:40:05 +00:00
|
|
|
*/
|
2014-08-11 20:24:54 +00:00
|
|
|
public function addInterwikiLink( $title ) {
|
2014-01-02 10:59:10 +00:00
|
|
|
if ( !$title->isExternal() ) {
|
2010-04-16 01:40:05 +00:00
|
|
|
throw new MWException( 'Non-interwiki link passed, internal parser error.' );
|
|
|
|
|
}
|
2014-01-02 10:59:10 +00:00
|
|
|
$prefix = $title->getInterwiki();
|
2013-02-03 19:42:08 +00:00
|
|
|
if ( !isset( $this->mInterwikiLinks[$prefix] ) ) {
|
2010-04-16 01:40:05 +00:00
|
|
|
$this->mInterwikiLinks[$prefix] = array();
|
|
|
|
|
}
|
|
|
|
|
$this->mInterwikiLinks[$prefix][$title->getDBkey()] = 1;
|
|
|
|
|
}
|
2007-01-20 12:50:56 +00:00
|
|
|
|
2007-04-03 21:58:18 +00:00
|
|
|
/**
|
2012-07-10 12:48:06 +00:00
|
|
|
* Add some text to the "<head>".
|
2008-04-14 07:45:50 +00:00
|
|
|
* If $tag is set, the section with that tag will only be included once
|
2007-04-03 21:58:18 +00:00
|
|
|
* in a given page.
|
2014-04-21 23:38:39 +00:00
|
|
|
* @param string $section
|
|
|
|
|
* @param string|bool $tag
|
2007-04-03 21:58:18 +00:00
|
|
|
*/
|
2014-08-11 20:24:54 +00:00
|
|
|
public function addHeadItem( $section, $tag = false ) {
|
2007-04-03 21:58:18 +00:00
|
|
|
if ( $tag !== false ) {
|
|
|
|
|
$this->mHeadItems[$tag] = $section;
|
|
|
|
|
} else {
|
|
|
|
|
$this->mHeadItems[] = $section;
|
|
|
|
|
}
|
|
|
|
|
}
|
2011-08-01 15:40:02 +00:00
|
|
|
|
2011-08-02 15:40:03 +00:00
|
|
|
public function addModules( $modules ) {
|
2013-08-31 16:36:02 +00:00
|
|
|
$this->mModules = array_merge( $this->mModules, (array)$modules );
|
2010-09-04 04:00:09 +00:00
|
|
|
}
|
2008-04-14 07:45:50 +00:00
|
|
|
|
2011-08-02 15:40:03 +00:00
|
|
|
public function addModuleScripts( $modules ) {
|
|
|
|
|
$this->mModuleScripts = array_merge( $this->mModuleScripts, (array)$modules );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public function addModuleStyles( $modules ) {
|
|
|
|
|
$this->mModuleStyles = array_merge( $this->mModuleStyles, (array)$modules );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public function addModuleMessages( $modules ) {
|
|
|
|
|
$this->mModuleMessages = array_merge( $this->mModuleMessages, (array)$modules );
|
|
|
|
|
}
|
|
|
|
|
|
2014-01-19 15:39:46 +00:00
|
|
|
/**
|
|
|
|
|
* Add one or more variables to be set in mw.config in JavaScript.
|
|
|
|
|
*
|
2014-04-21 23:38:39 +00:00
|
|
|
* @param string|array $keys Key or array of key/value pairs.
|
|
|
|
|
* @param mixed $value [optional] Value of the configuration variable.
|
2014-01-19 15:39:46 +00:00
|
|
|
* @since 1.23
|
|
|
|
|
*/
|
|
|
|
|
public function addJsConfigVars( $keys, $value = null ) {
|
|
|
|
|
if ( is_array( $keys ) ) {
|
|
|
|
|
foreach ( $keys as $key => $value ) {
|
|
|
|
|
$this->mJsConfigVars[$key] = $value;
|
|
|
|
|
}
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$this->mJsConfigVars[$keys] = $value;
|
|
|
|
|
}
|
|
|
|
|
|
2011-08-02 15:40:03 +00:00
|
|
|
/**
|
|
|
|
|
* Copy items from the OutputPage object into this one
|
|
|
|
|
*
|
2014-04-21 23:38:39 +00:00
|
|
|
* @param OutputPage $out
|
2011-08-02 15:40:03 +00:00
|
|
|
*/
|
2011-08-02 16:31:22 +00:00
|
|
|
public function addOutputPageMetadata( OutputPage $out ) {
|
2011-08-02 15:40:03 +00:00
|
|
|
$this->addModules( $out->getModules() );
|
|
|
|
|
$this->addModuleScripts( $out->getModuleScripts() );
|
|
|
|
|
$this->addModuleStyles( $out->getModuleStyles() );
|
|
|
|
|
$this->addModuleMessages( $out->getModuleMessages() );
|
2014-01-19 15:39:46 +00:00
|
|
|
$this->addJsConfigVars( $out->getJsConfigVars() );
|
2011-08-02 15:40:03 +00:00
|
|
|
|
|
|
|
|
$this->mHeadItems = array_merge( $this->mHeadItems, $out->getHeadItemsArray() );
|
2014-07-10 19:16:29 +00:00
|
|
|
$this->mPreventClickjacking = $this->mPreventClickjacking || $out->getPreventClickjacking();
|
2011-08-02 15:40:03 +00:00
|
|
|
}
|
|
|
|
|
|
2014-09-23 14:36:40 +00:00
|
|
|
/**
|
|
|
|
|
* Add a tracking category, getting the title from a system message,
|
|
|
|
|
* or print a debug message if the title is invalid.
|
|
|
|
|
*
|
|
|
|
|
* Please add any message that you use with this function to
|
|
|
|
|
* $wgTrackingCategories. That way they will be listed on
|
|
|
|
|
* Special:TrackingCategories.
|
|
|
|
|
*
|
|
|
|
|
* @param string $msg Message key
|
|
|
|
|
* @param Title $title title of the page which is being tracked
|
|
|
|
|
* @return bool Whether the addition was successful
|
|
|
|
|
* @since 1.25
|
|
|
|
|
*/
|
|
|
|
|
public function addTrackingCategory( $msg, $title ) {
|
|
|
|
|
if ( $title->getNamespace() === NS_SPECIAL ) {
|
|
|
|
|
wfDebug( __METHOD__ . ": Not adding tracking category $msg to special page!\n" );
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// Important to parse with correct title (bug 31469)
|
|
|
|
|
$cat = wfMessage( $msg )
|
|
|
|
|
->title( $title )
|
|
|
|
|
->inContentLanguage()
|
|
|
|
|
->text();
|
|
|
|
|
|
|
|
|
|
# Allow tracking categories to be disabled by setting them to "-"
|
|
|
|
|
if ( $cat === '-' ) {
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$containerCategory = Title::makeTitleSafe( NS_CATEGORY, $cat );
|
|
|
|
|
if ( $containerCategory ) {
|
|
|
|
|
$this->addCategory( $containerCategory->getDBkey(), $this->getProperty( 'defaultsort' ) ?: '' );
|
|
|
|
|
return true;
|
|
|
|
|
} else {
|
|
|
|
|
wfDebug( __METHOD__ . ": [[MediaWiki:$msg]] is not a valid title!\n" );
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2007-06-25 15:51:09 +00:00
|
|
|
/**
|
|
|
|
|
* Override the title to be used for display
|
|
|
|
|
* -- this is assumed to have been validated
|
|
|
|
|
* (check equal normalisation, etc.)
|
|
|
|
|
*
|
2014-07-24 17:43:25 +00:00
|
|
|
* @param string $text Desired title text
|
2007-06-25 15:51:09 +00:00
|
|
|
*/
|
|
|
|
|
public function setDisplayTitle( $text ) {
|
2010-01-15 19:14:23 +00:00
|
|
|
$this->setTitleText( $text );
|
2010-07-10 11:30:11 +00:00
|
|
|
$this->setProperty( 'displaytitle', $text );
|
2007-06-25 15:51:09 +00:00
|
|
|
}
|
2008-12-31 16:49:38 +00:00
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Get the title to be used for display
|
|
|
|
|
*
|
2014-04-21 23:38:39 +00:00
|
|
|
* @return string
|
2008-12-31 16:49:38 +00:00
|
|
|
*/
|
|
|
|
|
public function getDisplayTitle() {
|
2010-12-28 09:54:25 +00:00
|
|
|
$t = $this->getTitleText();
|
2013-04-20 15:38:24 +00:00
|
|
|
if ( $t === '' ) {
|
2010-01-15 19:14:23 +00:00
|
|
|
return false;
|
|
|
|
|
}
|
2010-02-16 03:37:19 +00:00
|
|
|
return $t;
|
2007-06-25 15:51:09 +00:00
|
|
|
}
|
2008-04-14 07:45:50 +00:00
|
|
|
|
2007-11-15 02:54:28 +00:00
|
|
|
/**
|
|
|
|
|
* Fairly generic flag setter thingy.
|
2014-08-14 18:22:52 +00:00
|
|
|
* @param string $flag
|
2007-11-15 02:54:28 +00:00
|
|
|
*/
|
|
|
|
|
public function setFlag( $flag ) {
|
|
|
|
|
$this->mFlags[$flag] = true;
|
|
|
|
|
}
|
2008-04-14 07:45:50 +00:00
|
|
|
|
2007-11-15 02:54:28 +00:00
|
|
|
public function getFlag( $flag ) {
|
|
|
|
|
return isset( $this->mFlags[$flag] );
|
|
|
|
|
}
|
2008-02-20 08:53:12 +00:00
|
|
|
|
|
|
|
|
/**
|
2012-10-22 00:58:05 +00:00
|
|
|
* Set a property to be stored in the page_props database table.
|
|
|
|
|
*
|
|
|
|
|
* page_props is a key value store indexed by the page ID. This allows
|
|
|
|
|
* the parser to set a property on a page which can then be quickly
|
|
|
|
|
* retrieved given the page ID or via a DB join when given the page
|
|
|
|
|
* title.
|
|
|
|
|
*
|
2014-03-31 11:00:28 +00:00
|
|
|
* Since 1.23, page_props are also indexed by numeric value, to allow
|
|
|
|
|
* for efficient "top k" queries of pages wrt a given property.
|
|
|
|
|
*
|
2012-10-22 00:58:05 +00:00
|
|
|
* setProperty() is thus used to propagate properties from the parsed
|
|
|
|
|
* page to request contexts other than a page view of the currently parsed
|
|
|
|
|
* article.
|
|
|
|
|
*
|
|
|
|
|
* Some applications examples:
|
|
|
|
|
*
|
|
|
|
|
* * To implement hidden categories, hiding pages from category listings
|
|
|
|
|
* by storing a property.
|
|
|
|
|
*
|
|
|
|
|
* * Overriding the displayed article title.
|
|
|
|
|
* @see ParserOutput::setDisplayTitle()
|
|
|
|
|
*
|
|
|
|
|
* * To implement image tagging, for example displaying an icon on an
|
|
|
|
|
* image thumbnail to indicate that it is listed for deletion on
|
|
|
|
|
* Wikimedia Commons.
|
|
|
|
|
* This is not actually implemented, yet but would be pretty cool.
|
|
|
|
|
*
|
2014-07-24 09:30:25 +00:00
|
|
|
* @note Do not use setProperty() to set a property which is only used
|
2013-01-22 11:59:23 +00:00
|
|
|
* in a context where the ParserOutput object itself is already available,
|
|
|
|
|
* for example a normal page view. There is no need to save such a property
|
2014-03-18 20:20:09 +00:00
|
|
|
* in the database since the text is already parsed. You can just hook
|
2012-10-22 00:58:05 +00:00
|
|
|
* OutputPageParserOutput and get your data out of the ParserOutput object.
|
|
|
|
|
*
|
2013-01-22 11:59:23 +00:00
|
|
|
* If you are writing an extension where you want to set a property in the
|
|
|
|
|
* parser which is used by an OutputPageParserOutput hook, you have to
|
|
|
|
|
* associate the extension data directly with the ParserOutput object.
|
|
|
|
|
* Since MediaWiki 1.21, you can use setExtensionData() to do this:
|
|
|
|
|
*
|
|
|
|
|
* @par Example:
|
|
|
|
|
* @code
|
|
|
|
|
* $parser->getOutput()->setExtensionData( 'my_ext_foo', '...' );
|
|
|
|
|
* @endcode
|
|
|
|
|
*
|
|
|
|
|
* And then later, in OutputPageParserOutput or similar:
|
|
|
|
|
*
|
|
|
|
|
* @par Example:
|
|
|
|
|
* @code
|
|
|
|
|
* $output->getExtensionData( 'my_ext_foo' );
|
|
|
|
|
* @endcode
|
|
|
|
|
*
|
|
|
|
|
* In MediaWiki 1.20 and older, you have to use a custom member variable
|
|
|
|
|
* within the ParserOutput object:
|
2012-10-22 00:58:05 +00:00
|
|
|
*
|
|
|
|
|
* @par Example:
|
|
|
|
|
* @code
|
|
|
|
|
* $parser->getOutput()->my_ext_foo = '...';
|
|
|
|
|
* @endcode
|
|
|
|
|
*
|
2008-02-20 08:53:12 +00:00
|
|
|
*/
|
|
|
|
|
public function setProperty( $name, $value ) {
|
|
|
|
|
$this->mProperties[$name] = $value;
|
|
|
|
|
}
|
|
|
|
|
|
2014-04-16 14:13:46 +00:00
|
|
|
/**
|
|
|
|
|
* @param string $name The property name to look up.
|
|
|
|
|
*
|
2014-07-24 17:43:25 +00:00
|
|
|
* @return mixed|bool The value previously set using setProperty(). False if null or no value
|
2014-04-16 14:13:46 +00:00
|
|
|
* was set for the given property name.
|
|
|
|
|
*
|
|
|
|
|
* @note You need to use getProperties() to check for boolean and null properties.
|
|
|
|
|
*/
|
2013-01-26 21:11:09 +00:00
|
|
|
public function getProperty( $name ) {
|
2008-02-20 08:53:12 +00:00
|
|
|
return isset( $this->mProperties[$name] ) ? $this->mProperties[$name] : false;
|
|
|
|
|
}
|
|
|
|
|
|
2014-04-16 09:31:29 +00:00
|
|
|
public function unsetProperty( $name ) {
|
|
|
|
|
unset( $this->mProperties[$name] );
|
|
|
|
|
}
|
|
|
|
|
|
2008-02-20 08:53:12 +00:00
|
|
|
public function getProperties() {
|
|
|
|
|
if ( !isset( $this->mProperties ) ) {
|
|
|
|
|
$this->mProperties = array();
|
|
|
|
|
}
|
|
|
|
|
return $this->mProperties;
|
|
|
|
|
}
|
2011-08-01 15:40:02 +00:00
|
|
|
|
2010-12-26 19:21:45 +00:00
|
|
|
/**
|
2011-08-01 15:40:02 +00:00
|
|
|
* Returns the options from its ParserOptions which have been taken
|
2010-12-26 19:21:45 +00:00
|
|
|
* into account to produce this output or false if not available.
|
2014-04-21 23:38:39 +00:00
|
|
|
* @return array
|
2010-12-26 19:21:45 +00:00
|
|
|
*/
|
2013-01-26 21:11:09 +00:00
|
|
|
public function getUsedOptions() {
|
2010-12-26 19:21:45 +00:00
|
|
|
if ( !isset( $this->mAccessedOptions ) ) {
|
2011-08-01 15:50:49 +00:00
|
|
|
return array();
|
2010-12-26 19:21:45 +00:00
|
|
|
}
|
|
|
|
|
return array_keys( $this->mAccessedOptions );
|
2013-01-26 21:11:09 +00:00
|
|
|
}
|
2011-08-01 15:40:02 +00:00
|
|
|
|
2013-01-26 21:11:09 +00:00
|
|
|
/**
|
2013-12-02 13:20:26 +00:00
|
|
|
* Tags a parser option for use in the cache key for this parser output.
|
|
|
|
|
* Registered as a watcher at ParserOptions::registerWatcher() by Parser::clearState().
|
|
|
|
|
*
|
|
|
|
|
* @see ParserCache::getKey
|
|
|
|
|
* @see ParserCache::save
|
|
|
|
|
* @see ParserOptions::addExtraKey
|
|
|
|
|
* @see ParserOptions::optionsHash
|
2014-04-21 23:38:39 +00:00
|
|
|
* @param string $option
|
2013-01-26 21:11:09 +00:00
|
|
|
*/
|
2013-12-02 13:20:26 +00:00
|
|
|
public function recordOption( $option ) {
|
2013-01-26 21:11:09 +00:00
|
|
|
$this->mAccessedOptions[$option] = true;
|
|
|
|
|
}
|
2012-04-05 15:21:07 +00:00
|
|
|
|
2012-05-08 15:09:30 +00:00
|
|
|
/**
|
2014-03-18 20:20:09 +00:00
|
|
|
* Adds an update job to the output. Any update jobs added to the output will
|
|
|
|
|
* eventually be executed in order to store any secondary information extracted
|
|
|
|
|
* from the page's content. This is triggered by calling getSecondaryDataUpdates()
|
|
|
|
|
* and is used for forward links updates on edit and backlink updates by jobs.
|
2012-05-10 19:22:11 +00:00
|
|
|
*
|
2015-01-09 19:16:00 +00:00
|
|
|
* @note: custom DataUpdates do not survive serialization of the ParserOutput!
|
|
|
|
|
* This is especially relevant when using a cached ParserOutput for updating
|
|
|
|
|
* the database, as WikiPage does if $wgAjaxStashEdit is enabled. For this
|
|
|
|
|
* reason, ApiStashEdit will skip any ParserOutput that has custom DataUpdates.
|
|
|
|
|
*
|
2012-08-20 14:55:28 +00:00
|
|
|
* @since 1.20
|
|
|
|
|
*
|
|
|
|
|
* @param DataUpdate $update
|
2012-05-08 15:09:30 +00:00
|
|
|
*/
|
|
|
|
|
public function addSecondaryDataUpdate( DataUpdate $update ) {
|
|
|
|
|
$this->mSecondaryDataUpdates[] = $update;
|
2015-01-09 19:16:00 +00:00
|
|
|
$this->mCustomDataUpdateCount = count( $this->mSecondaryDataUpdates );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Whether this ParserOutput contains custom DataUpdate objects that may not survive
|
|
|
|
|
* serialization of the ParserOutput.
|
|
|
|
|
*
|
|
|
|
|
* @see __sleep()
|
|
|
|
|
*
|
|
|
|
|
* @return bool
|
|
|
|
|
*/
|
|
|
|
|
public function hasCustomDataUpdates() {
|
|
|
|
|
return ( $this->mCustomDataUpdateCount > 0 );
|
2012-05-08 15:09:30 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Returns any DataUpdate jobs to be executed in order to store secondary information
|
|
|
|
|
* extracted from the page's content, including a LinksUpdate object for all links stored in
|
|
|
|
|
* this ParserOutput object.
|
2012-05-10 19:22:11 +00:00
|
|
|
*
|
2014-05-10 23:03:45 +00:00
|
|
|
* @note Avoid using this method directly, use ContentHandler::getSecondaryDataUpdates()
|
|
|
|
|
* instead! The content handler may provide additional update objects.
|
2012-06-07 12:57:43 +00:00
|
|
|
*
|
2012-08-20 14:55:28 +00:00
|
|
|
* @since 1.20
|
|
|
|
|
*
|
2014-04-21 23:38:39 +00:00
|
|
|
* @param Title $title The title of the page we're updating. If not given, a title object will
|
|
|
|
|
* be created based on $this->getTitleText()
|
|
|
|
|
* @param bool $recursive Queue jobs for recursive updates?
|
2012-05-08 15:09:30 +00:00
|
|
|
*
|
2015-01-09 15:51:15 +00:00
|
|
|
* @throws MWException if called on a ParserOutput instance that was restored from serialization.
|
|
|
|
|
* DataUpdates are generally not serializable, so after serialization, they are undefined.
|
|
|
|
|
*
|
2014-04-21 23:38:39 +00:00
|
|
|
* @return array An array of instances of DataUpdate
|
2012-05-08 15:09:30 +00:00
|
|
|
*/
|
|
|
|
|
public function getSecondaryDataUpdates( Title $title = null, $recursive = true ) {
|
2012-08-20 14:55:28 +00:00
|
|
|
if ( is_null( $title ) ) {
|
2012-05-08 15:09:30 +00:00
|
|
|
$title = Title::newFromText( $this->getTitleText() );
|
|
|
|
|
}
|
|
|
|
|
|
2015-01-09 19:16:00 +00:00
|
|
|
if ( count( $this->mSecondaryDataUpdates ) !== $this->mCustomDataUpdateCount ) {
|
|
|
|
|
// NOTE: This happens when mSecondaryDataUpdates are lost during serialization
|
2015-01-09 15:51:15 +00:00
|
|
|
// (see __sleep below). After (un)serialization, getSecondaryDataUpdates()
|
2015-01-09 19:16:00 +00:00
|
|
|
// has no defined behavior in that case, and should throw an exception.
|
2015-01-09 15:51:15 +00:00
|
|
|
throw new MWException( 'getSecondaryDataUpdates() must not be called on ParserOutput restored from serialization.' );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// NOTE: ApiStashEdit knows about this "magic" update object. If this goes away,
|
|
|
|
|
// ApiStashEdit::buildStashValue needs to be adjusted.
|
2012-05-08 15:09:30 +00:00
|
|
|
$linksUpdate = new LinksUpdate( $title, $this, $recursive );
|
|
|
|
|
|
2013-01-25 15:46:24 +00:00
|
|
|
return array_merge( $this->mSecondaryDataUpdates, array( $linksUpdate ) );
|
2013-01-26 21:11:09 +00:00
|
|
|
}
|
2012-08-20 14:55:28 +00:00
|
|
|
|
2013-01-22 11:59:23 +00:00
|
|
|
/**
|
|
|
|
|
* Attaches arbitrary data to this ParserObject. This can be used to store some information in
|
|
|
|
|
* the ParserOutput object for later use during page output. The data will be cached along with
|
|
|
|
|
* the ParserOutput object, but unlike data set using setProperty(), it is not recorded in the
|
|
|
|
|
* database.
|
|
|
|
|
*
|
|
|
|
|
* This method is provided to overcome the unsafe practice of attaching extra information to a
|
|
|
|
|
* ParserObject by directly assigning member variables.
|
|
|
|
|
*
|
|
|
|
|
* To use setExtensionData() to pass extension information from a hook inside the parser to a
|
|
|
|
|
* hook in the page output, use this in the parser hook:
|
|
|
|
|
*
|
|
|
|
|
* @par Example:
|
|
|
|
|
* @code
|
|
|
|
|
* $parser->getOutput()->setExtensionData( 'my_ext_foo', '...' );
|
|
|
|
|
* @endcode
|
|
|
|
|
*
|
|
|
|
|
* And then later, in OutputPageParserOutput or similar:
|
|
|
|
|
*
|
|
|
|
|
* @par Example:
|
|
|
|
|
* @code
|
|
|
|
|
* $output->getExtensionData( 'my_ext_foo' );
|
|
|
|
|
* @endcode
|
|
|
|
|
*
|
|
|
|
|
* In MediaWiki 1.20 and older, you have to use a custom member variable
|
|
|
|
|
* within the ParserOutput object:
|
|
|
|
|
*
|
|
|
|
|
* @par Example:
|
|
|
|
|
* @code
|
|
|
|
|
* $parser->getOutput()->my_ext_foo = '...';
|
|
|
|
|
* @endcode
|
|
|
|
|
*
|
|
|
|
|
* @since 1.21
|
|
|
|
|
*
|
|
|
|
|
* @param string $key The key for accessing the data. Extensions should take care to avoid
|
2014-04-21 23:38:39 +00:00
|
|
|
* conflicts in naming keys. It is suggested to use the extension's name as a prefix.
|
2013-01-22 11:59:23 +00:00
|
|
|
*
|
|
|
|
|
* @param mixed $value The value to set. Setting a value to null is equivalent to removing
|
2014-04-21 23:38:39 +00:00
|
|
|
* the value.
|
2013-01-22 11:59:23 +00:00
|
|
|
*/
|
|
|
|
|
public function setExtensionData( $key, $value ) {
|
|
|
|
|
if ( $value === null ) {
|
|
|
|
|
unset( $this->mExtensionData[$key] );
|
|
|
|
|
} else {
|
|
|
|
|
$this->mExtensionData[$key] = $value;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Gets extensions data previously attached to this ParserOutput using setExtensionData().
|
|
|
|
|
* Typically, such data would be set while parsing the page, e.g. by a parser function.
|
|
|
|
|
*
|
|
|
|
|
* @since 1.21
|
|
|
|
|
*
|
|
|
|
|
* @param string $key The key to look up.
|
|
|
|
|
*
|
2014-04-16 14:13:46 +00:00
|
|
|
* @return mixed|null The value previously set for the given key using setExtensionData()
|
2013-01-22 11:59:23 +00:00
|
|
|
* or null if no value was set for this key.
|
|
|
|
|
*/
|
|
|
|
|
public function getExtensionData( $key ) {
|
|
|
|
|
if ( isset( $this->mExtensionData[$key] ) ) {
|
|
|
|
|
return $this->mExtensionData[$key];
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return null;
|
|
|
|
|
}
|
|
|
|
|
|
2013-03-14 12:43:06 +00:00
|
|
|
private static function getTimes( $clock = null ) {
|
|
|
|
|
$ret = array();
|
|
|
|
|
if ( !$clock || $clock === 'wall' ) {
|
|
|
|
|
$ret['wall'] = microtime( true );
|
|
|
|
|
}
|
2014-09-04 23:56:20 +00:00
|
|
|
if ( !$clock || $clock === 'cpu' ) {
|
|
|
|
|
$ru = wfGetRusage();
|
|
|
|
|
if ( $ru ) {
|
|
|
|
|
$ret['cpu'] = $ru['ru_utime.tv_sec'] + $ru['ru_utime.tv_usec'] / 1e6;
|
|
|
|
|
$ret['cpu'] += $ru['ru_stime.tv_sec'] + $ru['ru_stime.tv_usec'] / 1e6;
|
|
|
|
|
}
|
2013-03-14 12:43:06 +00:00
|
|
|
}
|
|
|
|
|
return $ret;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Resets the parse start timestamps for future calls to getTimeSinceStart()
|
|
|
|
|
* @since 1.22
|
|
|
|
|
*/
|
2014-08-11 20:24:54 +00:00
|
|
|
public function resetParseStartTime() {
|
2013-03-14 12:43:06 +00:00
|
|
|
$this->mParseStartTime = self::getTimes();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Returns the time since resetParseStartTime() was last called
|
|
|
|
|
*
|
|
|
|
|
* Clocks available are:
|
|
|
|
|
* - wall: Wall clock time
|
|
|
|
|
* - cpu: CPU time (requires getrusage)
|
|
|
|
|
*
|
|
|
|
|
* @since 1.22
|
|
|
|
|
* @param string $clock
|
|
|
|
|
* @return float|null
|
|
|
|
|
*/
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getTimeSinceStart( $clock ) {
|
2013-03-14 12:43:06 +00:00
|
|
|
if ( !isset( $this->mParseStartTime[$clock] ) ) {
|
|
|
|
|
return null;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$end = self::getTimes( $clock );
|
|
|
|
|
return $end[$clock] - $this->mParseStartTime[$clock];
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Sets parser limit report data for a key
|
|
|
|
|
*
|
|
|
|
|
* The key is used as the prefix for various messages used for formatting:
|
|
|
|
|
* - $key: The label for the field in the limit report
|
|
|
|
|
* - $key-value-text: Message used to format the value in the "NewPP limit
|
|
|
|
|
* report" HTML comment. If missing, uses $key-format.
|
|
|
|
|
* - $key-value-html: Message used to format the value in the preview
|
|
|
|
|
* limit report table. If missing, uses $key-format.
|
|
|
|
|
* - $key-value: Message used to format the value. If missing, uses "$1".
|
|
|
|
|
*
|
|
|
|
|
* Note that all values are interpreted as wikitext, and so should be
|
|
|
|
|
* encoded with htmlspecialchars() as necessary, but should avoid complex
|
|
|
|
|
* HTML for sanity of display in the "NewPP limit report" comment.
|
|
|
|
|
*
|
|
|
|
|
* @since 1.22
|
|
|
|
|
* @param string $key Message key
|
|
|
|
|
* @param mixed $value Appropriate for Message::params()
|
|
|
|
|
*/
|
2014-08-11 20:24:54 +00:00
|
|
|
public function setLimitReportData( $key, $value ) {
|
2013-03-14 12:43:06 +00:00
|
|
|
$this->mLimitReportData[$key] = $value;
|
|
|
|
|
}
|
2014-03-18 20:20:09 +00:00
|
|
|
|
2014-07-10 19:16:29 +00:00
|
|
|
/**
|
|
|
|
|
* Get or set the prevent-clickjacking flag
|
|
|
|
|
*
|
|
|
|
|
* @since 1.24
|
2014-08-04 10:00:15 +00:00
|
|
|
* @param bool|null $flag New flag value, or null to leave it unchanged
|
|
|
|
|
* @return bool Old flag value
|
2014-07-10 19:16:29 +00:00
|
|
|
*/
|
|
|
|
|
public function preventClickjacking( $flag = null ) {
|
|
|
|
|
return wfSetVar( $this->mPreventClickjacking, $flag );
|
|
|
|
|
}
|
|
|
|
|
|
2014-03-18 20:20:09 +00:00
|
|
|
/**
|
2014-12-16 00:41:45 +00:00
|
|
|
* Save space for serialization by removing useless values
|
2014-08-23 20:34:25 +00:00
|
|
|
* @return array
|
2014-03-18 20:20:09 +00:00
|
|
|
*/
|
2014-08-11 20:24:54 +00:00
|
|
|
public function __sleep() {
|
2014-03-18 20:20:09 +00:00
|
|
|
return array_diff(
|
|
|
|
|
array_keys( get_object_vars( $this ) ),
|
|
|
|
|
array( 'mSecondaryDataUpdates', 'mParseStartTime' )
|
|
|
|
|
);
|
|
|
|
|
}
|
2007-01-20 12:50:56 +00:00
|
|
|
}
|
