2007-01-20 12:50:56 +00:00
|
|
|
<?php
|
2012-08-20 14:55:28 +00:00
|
|
|
|
2020-09-23 15:30:40 +00:00
|
|
|
use MediaWiki\Logger\LoggerFactory;
|
2020-11-05 17:04:37 +00:00
|
|
|
use Wikimedia\Reflection\GhostFieldAccessTrait;
|
2020-09-23 15:30:40 +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
|
|
|
|
|
*/
|
2017-11-24 19:22:25 +00:00
|
|
|
|
2010-12-28 09:54:25 +00:00
|
|
|
class ParserOutput extends CacheTime {
|
2020-11-05 17:04:37 +00:00
|
|
|
use GhostFieldAccessTrait;
|
|
|
|
|
|
2017-11-22 20:07:51 +00:00
|
|
|
/**
|
2017-12-22 18:32:49 +00:00
|
|
|
* Feature flags to indicate to extensions that MediaWiki core supports and
|
2017-11-22 20:07:51 +00:00
|
|
|
* uses getText() stateless transforms.
|
2019-06-20 14:33:00 +00:00
|
|
|
*
|
|
|
|
|
* @since 1.31
|
2017-11-22 20:07:51 +00:00
|
|
|
*/
|
2020-05-15 22:40:17 +00:00
|
|
|
public const SUPPORTS_STATELESS_TRANSFORMS = 1;
|
2019-06-20 14:33:00 +00:00
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @since 1.31
|
|
|
|
|
*/
|
2020-05-15 22:40:17 +00:00
|
|
|
public const SUPPORTS_UNWRAP_TRANSFORM = 1;
|
2017-11-22 20:07:51 +00:00
|
|
|
|
2015-09-27 13:12:36 +00:00
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var string|null The output text
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mText = null;
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array List of the full text of language links,
|
2015-09-27 13:12:36 +00:00
|
|
|
* in the order they appear.
|
|
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mLanguageLinks;
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array Map of category names to sort keys
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mCategories;
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array Page status indicators, usually displayed in top-right corner.
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mIndicators = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var string Title text of the chosen language variant, as HTML.
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mTitleText;
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var int[][] 2-D map of NS/DBK to ID for the links in the document.
|
2015-09-27 13:12:36 +00:00
|
|
|
* ID=zero for broken.
|
2019-10-11 14:06:45 +00:00
|
|
|
* @phan-var array<int,array<string,int>>
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mLinks = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
preferences: Signature validation (lint errors, user links, nested subst)
Three new checks are now applied to user signatures in preferences:
* Disallow invalid HTML and lint errors (T140606)
Since 15e0e9bb4b we can rely on Parsoid to check the signature for
lint errors. (The old PHP Parser doesn't have this capability.)
Most importantly, this will disallow unclosed HTML tags. Unclosed
formatting tags like `<i>` (and also wikitext markup like `''`)
could affect the entire page with the bad markup.
New configuration variable $wgSignatureAllowedLintErrors is added
to allow ignoring some errors. The default value ignores the
'obsolete-tag' error (caused by HTML tags like `<font>` and `<tt>`.)
* Require a link to user page, talk page or contributions (T237700)
Various tools don't work correctly when such a link is missing. For
example, Echo notifications are not sent, DiscussionTools will not
allow replying to these comments, English Wikipedia's SineBot treats
these comments as unsigned.
Such requirement has been present for a long time in many Wikimedia
wikis' policies, but it was not enforced by software.
* Disallow "nested" substitution in signature (T230652)
Clever abuse of "subst" markup and tildes allows users to save edits
containing wikitext in which substitution occurs again when the page
is next saved. Disallow this in signatures, at least.
New configuration variable $wgSignatureValidation is added to control
what we do about the result of the validation described above. The
options are:
* 'warning':
Only displays a warning near the field on Special:Preferences if
the current signature is invalid. Signatures can still be changed
regardless of validity and will be used when signing comments.
* 'new':
In addition to the above, if a user tries to change their signature,
the new one must be valid. Existing invalid signatures are still
used when signing comments.
* 'disallow':
In addition to the above, existing invalid signatures are no longer
used when signing comments.
Bug: T140606
Bug: T237700
Bug: T230652
Change-Id: I07c575c2d9d2afe7a89c4847d16ac044417297bf
2019-11-09 00:15:51 +00:00
|
|
|
/**
|
|
|
|
|
* @var array Keys are DBKs for the links to special pages in the document.
|
|
|
|
|
* @since 1.35
|
|
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mLinksSpecial = [];
|
preferences: Signature validation (lint errors, user links, nested subst)
Three new checks are now applied to user signatures in preferences:
* Disallow invalid HTML and lint errors (T140606)
Since 15e0e9bb4b we can rely on Parsoid to check the signature for
lint errors. (The old PHP Parser doesn't have this capability.)
Most importantly, this will disallow unclosed HTML tags. Unclosed
formatting tags like `<i>` (and also wikitext markup like `''`)
could affect the entire page with the bad markup.
New configuration variable $wgSignatureAllowedLintErrors is added
to allow ignoring some errors. The default value ignores the
'obsolete-tag' error (caused by HTML tags like `<font>` and `<tt>`.)
* Require a link to user page, talk page or contributions (T237700)
Various tools don't work correctly when such a link is missing. For
example, Echo notifications are not sent, DiscussionTools will not
allow replying to these comments, English Wikipedia's SineBot treats
these comments as unsigned.
Such requirement has been present for a long time in many Wikimedia
wikis' policies, but it was not enforced by software.
* Disallow "nested" substitution in signature (T230652)
Clever abuse of "subst" markup and tildes allows users to save edits
containing wikitext in which substitution occurs again when the page
is next saved. Disallow this in signatures, at least.
New configuration variable $wgSignatureValidation is added to control
what we do about the result of the validation described above. The
options are:
* 'warning':
Only displays a warning near the field on Special:Preferences if
the current signature is invalid. Signatures can still be changed
regardless of validity and will be used when signing comments.
* 'new':
In addition to the above, if a user tries to change their signature,
the new one must be valid. Existing invalid signatures are still
used when signing comments.
* 'disallow':
In addition to the above, existing invalid signatures are no longer
used when signing comments.
Bug: T140606
Bug: T237700
Bug: T230652
Change-Id: I07c575c2d9d2afe7a89c4847d16ac044417297bf
2019-11-09 00:15:51 +00:00
|
|
|
|
2015-09-27 13:12:36 +00:00
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array 2-D map of NS/DBK to ID for the template references.
|
2015-09-27 13:12:36 +00:00
|
|
|
* ID=zero for broken.
|
|
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mTemplates = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array 2-D map of NS/DBK to rev ID for the template references.
|
2015-09-27 13:12:36 +00:00
|
|
|
* ID=zero for broken.
|
|
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mTemplateIds = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array DB keys of the images used, in the array key only
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mImages = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array DB keys of the images used mapped to sha1 and MW timestamp.
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mFileSearchOptions = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array External link URLs, in the key only.
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mExternalLinks = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array 2-D map of prefix/DBK (in keys only)
|
2015-09-27 13:12:36 +00:00
|
|
|
* for the inline interwiki links in the document.
|
|
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mInterwikiLinks = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var bool Show a new section link?
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mNewSection = false;
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var bool Hide the new section link?
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mHideNewSection = false;
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var bool No gallery on category page? (__NOGALLERY__).
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mNoGallery = false;
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array Items to put in the <head> section
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mHeadItems = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array Modules to be loaded by ResourceLoader
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mModules = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-10-01 00:22:03 +00:00
|
|
|
* @var array Modules of which only the CSSS will be loaded by ResourceLoader.
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mModuleStyles = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array JavaScript config variable for mw.config combined with this page.
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mJsConfigVars = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array Hook tags as per $wgParserOutputHooks.
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mOutputHooks = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array Warning text to be returned to the user.
|
2015-09-27 13:12:36 +00:00
|
|
|
* Wikitext formatted, in the key only.
|
|
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mWarnings = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array Table of contents
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mSections = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array Name/value pairs to be cached in the DB.
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mProperties = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var string HTML of the TOC.
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mTOCHTML = '';
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var string Timestamp of the revision.
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mTimestamp;
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var bool Whether OOUI should be enabled.
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2020-10-01 00:22:03 +00:00
|
|
|
public $mEnableOOUI = false;
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var string 'index' or 'noindex'? Any other value will result in no change.
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
|
|
|
|
private $mIndexPolicy = '';
|
|
|
|
|
|
2020-10-01 00:22:03 +00:00
|
|
|
/**
|
|
|
|
|
* @var true[] List of ParserOptions (stored in the keys).
|
|
|
|
|
*/
|
|
|
|
|
private $mAccessedOptions = [];
|
|
|
|
|
|
2015-09-27 13:12:36 +00:00
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array extra data used by extensions.
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2016-02-17 09:09:32 +00:00
|
|
|
private $mExtensionData = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
2016-11-08 21:03:21 +00:00
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array Parser limit report data.
|
2016-11-08 21:03:21 +00:00
|
|
|
*/
|
2016-02-17 09:09:32 +00:00
|
|
|
private $mLimitReportData = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
2016-11-10 20:29:27 +00:00
|
|
|
/** @var array Parser limit report data for JSON */
|
|
|
|
|
private $mLimitReportJSData = [];
|
|
|
|
|
|
2015-09-27 13:12:36 +00:00
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array Timestamps for getTimeSinceStart().
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2016-02-17 09:09:32 +00:00
|
|
|
private $mParseStartTime = [];
|
2015-09-27 13:12:36 +00:00
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var bool Whether to emit X-Frame-Options: DENY.
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
|
|
|
|
private $mPreventClickjacking = false;
|
|
|
|
|
|
2020-02-03 09:50:14 +00:00
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array Extra script-src for CSP
|
2020-02-03 09:50:14 +00:00
|
|
|
*/
|
|
|
|
|
private $mExtraScriptSrcs = [];
|
|
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array Extra default-src for CSP [Everything but script and style]
|
2020-02-03 09:50:14 +00:00
|
|
|
*/
|
|
|
|
|
private $mExtraDefaultSrcs = [];
|
|
|
|
|
|
|
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array Extra style-src for CSP
|
2020-02-03 09:50:14 +00:00
|
|
|
*/
|
|
|
|
|
private $mExtraStyleSrcs = [];
|
|
|
|
|
|
2015-09-27 13:12:36 +00:00
|
|
|
/**
|
2020-04-07 21:38:17 +00:00
|
|
|
* @var array Generic flags.
|
2015-09-27 13:12:36 +00:00
|
|
|
*/
|
2016-02-17 09:09:32 +00:00
|
|
|
private $mFlags = [];
|
2008-02-20 08:53:12 +00:00
|
|
|
|
2019-06-27 04:30:35 +00:00
|
|
|
/** @var string[] */
|
2019-10-16 01:24:50 +00:00
|
|
|
private const SPECULATIVE_FIELDS = [
|
2019-06-27 04:30:35 +00:00
|
|
|
'speculativePageIdUsed',
|
2019-07-31 02:16:07 +00:00
|
|
|
'mSpeculativeRevId',
|
2019-06-27 04:30:35 +00:00
|
|
|
'revisionTimestampUsed'
|
|
|
|
|
];
|
2019-07-26 06:39:16 +00:00
|
|
|
|
2017-08-20 11:20:59 +00:00
|
|
|
/** @var int|null Assumed rev ID for {{REVISIONID}} if no revision is set */
|
2019-07-31 02:16:07 +00:00
|
|
|
private $mSpeculativeRevId;
|
2019-06-27 04:30:35 +00:00
|
|
|
/** @var int|null Assumed page ID for {{PAGEID}} if no revision is set */
|
|
|
|
|
private $speculativePageIdUsed;
|
2019-04-19 01:36:40 +00:00
|
|
|
/** @var int|null Assumed rev timestamp for {{REVISIONTIMESTAMP}} if no revision is set */
|
|
|
|
|
private $revisionTimestampUsed;
|
|
|
|
|
|
2019-07-04 10:01:31 +00:00
|
|
|
/** @var string|null SHA-1 base 36 hash of any self-transclusion */
|
|
|
|
|
private $revisionUsedSha1Base36;
|
|
|
|
|
|
2018-08-28 16:48:10 +00:00
|
|
|
/** string CSS classes to use for the wrapping div, stored in the array keys.
|
|
|
|
|
* If no class is given, no wrapper is added.
|
|
|
|
|
*/
|
|
|
|
|
private $mWrapperDivClasses = [];
|
|
|
|
|
|
2017-08-20 11:20:59 +00:00
|
|
|
/** @var int Upper bound of expiry based on parse duration */
|
2016-08-30 19:35:08 +00:00
|
|
|
private $mMaxAdaptiveExpiry = INF;
|
|
|
|
|
|
2020-05-15 22:40:17 +00:00
|
|
|
private const EDITSECTION_REGEX =
|
2016-10-18 19:17:30 +00:00
|
|
|
'#<(?:mw:)?editsection page="(.*?)" section="(.*?)"(?:/>|>(.*?)(</(?:mw:)?editsection>))#s';
|
2011-02-08 01:31:21 +00:00
|
|
|
|
2016-08-30 19:35:08 +00:00
|
|
|
// finalizeAdaptiveCacheExpiry() uses TTL = MAX( m * PARSE_TIME + b, MIN_AR_TTL)
|
|
|
|
|
// Current values imply that m=3933.333333 and b=-333.333333
|
|
|
|
|
// See https://www.nngroup.com/articles/website-response-times/
|
2020-05-15 22:40:17 +00:00
|
|
|
private const PARSE_FAST_SEC = 0.100; // perceived "fast" page parse
|
|
|
|
|
private const PARSE_SLOW_SEC = 1.0; // perceived "slow" page parse
|
|
|
|
|
private const FAST_AR_TTL = 60; // adaptive TTL for "fast" pages
|
|
|
|
|
private const SLOW_AR_TTL = 3600; // adaptive TTL for "slow" pages
|
|
|
|
|
private const MIN_AR_TTL = 15; // min adaptive TTL (for sanity, pool counter, and edit stashing)
|
2016-08-30 19:35:08 +00:00
|
|
|
|
2018-08-13 20:33:31 +00:00
|
|
|
/**
|
|
|
|
|
* @param string|null $text HTML. Use null to indicate that this ParserOutput contains only
|
|
|
|
|
* meta-data, and the HTML output is undetermined, as opposed to empty. Passing null
|
|
|
|
|
* here causes hasText() to return false.
|
|
|
|
|
* @param array $languageLinks
|
|
|
|
|
* @param array $categoryLinks
|
|
|
|
|
* @param bool $unused
|
|
|
|
|
* @param string $titletext
|
|
|
|
|
*/
|
2016-02-17 09:09:32 +00:00
|
|
|
public function __construct( $text = '', $languageLinks = [], $categoryLinks = [],
|
2015-02-15 22:41:49 +00:00
|
|
|
$unused = false, $titletext = ''
|
2013-12-01 20:39:00 +00:00
|
|
|
) {
|
2007-01-20 12:50:56 +00:00
|
|
|
$this->mText = $text;
|
|
|
|
|
$this->mLanguageLinks = $languageLinks;
|
|
|
|
|
$this->mCategories = $categoryLinks;
|
|
|
|
|
$this->mTitleText = $titletext;
|
|
|
|
|
}
|
|
|
|
|
|
2018-08-13 20:33:31 +00:00
|
|
|
/**
|
|
|
|
|
* Returns true if text was passed to the constructor, or set using setText(). Returns false
|
|
|
|
|
* if null was passed to the $text parameter of the constructor to indicate that this
|
|
|
|
|
* ParserOutput only contains meta-data, and the HTML output is undetermined.
|
|
|
|
|
*
|
|
|
|
|
* @since 1.32
|
|
|
|
|
*
|
|
|
|
|
* @return bool Whether this ParserOutput contains rendered text. If this returns false, the
|
|
|
|
|
* ParserOutput contains meta-data only.
|
|
|
|
|
*/
|
|
|
|
|
public function hasText() {
|
|
|
|
|
return ( $this->mText !== null );
|
|
|
|
|
}
|
|
|
|
|
|
2016-01-25 03:44:36 +00:00
|
|
|
/**
|
|
|
|
|
* Get the cacheable text with <mw:editsection> markers still in it. The
|
|
|
|
|
* return value is suitable for writing back via setText() but is not valid
|
|
|
|
|
* for display to the user.
|
|
|
|
|
*
|
2017-09-09 20:47:04 +00:00
|
|
|
* @return string
|
2016-01-25 03:44:36 +00:00
|
|
|
* @since 1.27
|
|
|
|
|
*/
|
|
|
|
|
public function getRawText() {
|
2018-08-13 20:33:31 +00:00
|
|
|
if ( $this->mText === null ) {
|
|
|
|
|
throw new LogicException( 'This ParserOutput contains no text!' );
|
|
|
|
|
}
|
|
|
|
|
|
2016-01-25 03:44:36 +00:00
|
|
|
return $this->mText;
|
|
|
|
|
}
|
|
|
|
|
|
2017-11-22 18:12:23 +00:00
|
|
|
/**
|
|
|
|
|
* Get the output HTML
|
|
|
|
|
*
|
|
|
|
|
* @param array $options (since 1.31) Transformations to apply to the HTML
|
|
|
|
|
* - allowTOC: (bool) Show the TOC, assuming there were enough headings
|
|
|
|
|
* to generate one and `__NOTOC__` wasn't used. Default is true,
|
|
|
|
|
* but might be statefully overridden.
|
|
|
|
|
* - enableSectionEditLinks: (bool) Include section edit links, assuming
|
2017-12-22 18:32:49 +00:00
|
|
|
* section edit link tokens are present in the HTML. Default is true,
|
2017-11-22 18:12:23 +00:00
|
|
|
* but might be statefully overridden.
|
2019-10-08 18:23:54 +00:00
|
|
|
* - skin: (Skin) Skin object used for transforming section edit links.
|
2018-08-28 16:48:10 +00:00
|
|
|
* - unwrap: (bool) Return text without a wrapper div. Default is false,
|
|
|
|
|
* meaning a wrapper div will be added if getWrapperDivClass() returns
|
|
|
|
|
* a non-empty string.
|
|
|
|
|
* - wrapperDivClass: (string) Wrap the output in a div and apply the given
|
|
|
|
|
* CSS class to that div. This overrides the output of getWrapperDivClass().
|
|
|
|
|
* Setting this to an empty string has the same effect as 'unwrap' => true.
|
2017-11-24 19:22:25 +00:00
|
|
|
* - deduplicateStyles: (bool) When true, which is the default, `<style>`
|
|
|
|
|
* tags with the `data-mw-deduplicate` attribute set are deduplicated by
|
|
|
|
|
* value of the attribute: all but the first will be replaced by `<link
|
|
|
|
|
* rel="mw-deduplicated-inline-style" href="mw-data:..."/>` tags, where
|
|
|
|
|
* the scheme-specific-part of the href is the (percent-encoded) value
|
|
|
|
|
* of the `data-mw-deduplicate` attribute.
|
2017-11-22 18:12:23 +00:00
|
|
|
* @return string HTML
|
2018-08-31 15:55:44 +00:00
|
|
|
* @return-taint escaped
|
2017-11-22 18:12:23 +00:00
|
|
|
*/
|
|
|
|
|
public function getText( $options = [] ) {
|
|
|
|
|
$options += [
|
2017-11-22 23:12:40 +00:00
|
|
|
'allowTOC' => true,
|
|
|
|
|
'enableSectionEditLinks' => true,
|
2019-10-08 18:23:54 +00:00
|
|
|
'skin' => null,
|
2017-12-22 18:32:49 +00:00
|
|
|
'unwrap' => false,
|
2017-11-24 19:22:25 +00:00
|
|
|
'deduplicateStyles' => true,
|
2018-08-28 16:48:10 +00:00
|
|
|
'wrapperDivClass' => $this->getWrapperDivClass(),
|
2017-11-22 18:12:23 +00:00
|
|
|
];
|
2018-08-13 20:33:31 +00:00
|
|
|
$text = $this->getRawText();
|
2017-11-22 18:12:23 +00:00
|
|
|
|
Hooks::run() call site migration
Migrate all callers of Hooks::run() to use the new
HookContainer/HookRunner system.
General principles:
* Use DI if it is already used. We're not changing the way state is
managed in this patch.
* HookContainer is always injected, not HookRunner. HookContainer
is a service, it's a more generic interface, it is the only
thing that provides isRegistered() which is needed in some cases,
and a HookRunner can be efficiently constructed from it
(confirmed by benchmark). Because HookContainer is needed
for object construction, it is also needed by all factories.
* "Ask your friendly local base class". Big hierarchies like
SpecialPage and ApiBase have getHookContainer() and getHookRunner()
methods in the base class, and classes that extend that base class
are not expected to know or care where the base class gets its
HookContainer from.
* ProtectedHookAccessorTrait provides protected getHookContainer() and
getHookRunner() methods, getting them from the global service
container. The point of this is to ease migration to DI by ensuring
that call sites ask their local friendly base class rather than
getting a HookRunner from the service container directly.
* Private $this->hookRunner. In some smaller classes where accessor
methods did not seem warranted, there is a private HookRunner property
which is accessed directly. Very rarely (two cases), there is a
protected property, for consistency with code that conventionally
assumes protected=private, but in cases where the class might actually
be overridden, a protected accessor is preferred over a protected
property.
* The last resort: Hooks::runner(). Mostly for static, file-scope and
global code. In a few cases it was used for objects with broken
construction schemes, out of horror or laziness.
Constructors with new required arguments:
* AuthManager
* BadFileLookup
* BlockManager
* ClassicInterwikiLookup
* ContentHandlerFactory
* ContentSecurityPolicy
* DefaultOptionsManager
* DerivedPageDataUpdater
* FullSearchResultWidget
* HtmlCacheUpdater
* LanguageFactory
* LanguageNameUtils
* LinkRenderer
* LinkRendererFactory
* LocalisationCache
* MagicWordFactory
* MessageCache
* NamespaceInfo
* PageEditStash
* PageHandlerFactory
* PageUpdater
* ParserFactory
* PermissionManager
* RevisionStore
* RevisionStoreFactory
* SearchEngineConfig
* SearchEngineFactory
* SearchFormWidget
* SearchNearMatcher
* SessionBackend
* SpecialPageFactory
* UserNameUtils
* UserOptionsManager
* WatchedItemQueryService
* WatchedItemStore
Constructors with new optional arguments:
* DefaultPreferencesFactory
* Language
* LinkHolderArray
* MovePage
* Parser
* ParserCache
* PasswordReset
* Router
setHookContainer() now required after construction:
* AuthenticationProvider
* ResourceLoaderModule
* SearchEngine
Change-Id: Id442b0dbe43aba84bd5cf801d86dedc768b082c7
2020-03-19 02:42:09 +00:00
|
|
|
Hooks::runner()->onParserOutputPostCacheTransform( $this, $text, $options );
|
2017-11-22 18:12:23 +00:00
|
|
|
|
2018-08-28 16:48:10 +00:00
|
|
|
if ( $options['wrapperDivClass'] !== '' && !$options['unwrap'] ) {
|
|
|
|
|
$text = Html::rawElement( 'div', [ 'class' => $options['wrapperDivClass'] ], $text );
|
2017-12-22 18:32:49 +00:00
|
|
|
}
|
|
|
|
|
|
2017-11-22 18:12:23 +00:00
|
|
|
if ( $options['enableSectionEditLinks'] ) {
|
2019-10-08 18:23:54 +00:00
|
|
|
// TODO: Passing the skin should be required
|
|
|
|
|
$skin = $options['skin'] ?: RequestContext::getMain()->getSkin();
|
|
|
|
|
|
2014-07-04 20:19:48 +00:00
|
|
|
$text = preg_replace_callback(
|
2017-07-23 01:24:09 +00:00
|
|
|
self::EDITSECTION_REGEX,
|
2019-10-08 18:23:54 +00:00
|
|
|
function ( $m ) use ( $skin ) {
|
2014-07-04 20:19:48 +00:00
|
|
|
$editsectionPage = Title::newFromText( htmlspecialchars_decode( $m[1] ) );
|
|
|
|
|
$editsectionSection = htmlspecialchars_decode( $m[2] );
|
2017-09-13 11:49:02 +00:00
|
|
|
$editsectionContent = isset( $m[4] ) ? Sanitizer::decodeCharReferences( $m[3] ) : null;
|
2014-07-04 20:19:48 +00:00
|
|
|
|
|
|
|
|
if ( !is_object( $editsectionPage ) ) {
|
2020-09-23 15:30:40 +00:00
|
|
|
LoggerFactory::getInstance( 'Parser' )
|
|
|
|
|
->error(
|
|
|
|
|
'ParserOutput::getText(): bad title in editsection placeholder',
|
|
|
|
|
[
|
|
|
|
|
'placeholder' => $m[0],
|
|
|
|
|
'editsectionPage' => $m[1],
|
|
|
|
|
'titletext' => $this->getTitleText(),
|
|
|
|
|
'phab' => 'T261347'
|
|
|
|
|
]
|
|
|
|
|
);
|
|
|
|
|
return '';
|
2014-07-04 20:19:48 +00:00
|
|
|
}
|
|
|
|
|
|
2019-10-08 18:23:54 +00:00
|
|
|
return $skin->doEditSectionLink(
|
2018-10-15 01:39:29 +00:00
|
|
|
$editsectionPage,
|
2018-06-08 02:58:35 +00:00
|
|
|
$editsectionSection,
|
|
|
|
|
$editsectionContent,
|
2019-10-08 18:23:54 +00:00
|
|
|
$skin->getLanguage()
|
2014-07-04 20:19:48 +00:00
|
|
|
);
|
|
|
|
|
},
|
|
|
|
|
$text
|
|
|
|
|
);
|
2013-08-22 22:22:03 +00:00
|
|
|
} else {
|
2017-07-23 01:24:09 +00:00
|
|
|
$text = preg_replace( self::EDITSECTION_REGEX, '', $text );
|
2011-01-03 20:17:20 +00:00
|
|
|
}
|
2013-08-22 22:22:03 +00:00
|
|
|
|
2017-11-22 18:12:23 +00:00
|
|
|
if ( $options['allowTOC'] ) {
|
2016-02-17 09:09:32 +00:00
|
|
|
$text = str_replace( [ Parser::TOC_START, Parser::TOC_END ], '', $text );
|
2013-08-22 22:22:03 +00:00
|
|
|
} else {
|
|
|
|
|
$text = preg_replace(
|
2015-06-25 17:43:56 +00:00
|
|
|
'#' . preg_quote( Parser::TOC_START, '#' ) . '.*?' . preg_quote( Parser::TOC_END, '#' ) . '#s',
|
2013-08-22 22:22:03 +00:00
|
|
|
'',
|
|
|
|
|
$text
|
|
|
|
|
);
|
|
|
|
|
}
|
2017-11-22 18:12:23 +00:00
|
|
|
|
2017-11-24 19:22:25 +00:00
|
|
|
if ( $options['deduplicateStyles'] ) {
|
|
|
|
|
$seen = [];
|
|
|
|
|
$text = preg_replace_callback(
|
|
|
|
|
'#<style\s+([^>]*data-mw-deduplicate\s*=[^>]*)>.*?</style>#s',
|
|
|
|
|
function ( $m ) use ( &$seen ) {
|
|
|
|
|
$attr = Sanitizer::decodeTagAttributes( $m[1] );
|
|
|
|
|
if ( !isset( $attr['data-mw-deduplicate'] ) ) {
|
|
|
|
|
return $m[0];
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$key = $attr['data-mw-deduplicate'];
|
|
|
|
|
if ( !isset( $seen[$key] ) ) {
|
|
|
|
|
$seen[$key] = true;
|
|
|
|
|
return $m[0];
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// We were going to use an empty <style> here, but there
|
|
|
|
|
// was concern that would be too much overhead for browsers.
|
|
|
|
|
// So let's hope a <link> with a non-standard rel and href isn't
|
|
|
|
|
// going to be misinterpreted or mangled by any subsequent processing.
|
|
|
|
|
return Html::element( 'link', [
|
|
|
|
|
'rel' => 'mw-deduplicated-inline-style',
|
|
|
|
|
'href' => "mw-data:" . wfUrlencode( $key ),
|
|
|
|
|
] );
|
|
|
|
|
},
|
|
|
|
|
$text
|
|
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
|
2018-08-07 16:52:40 +00:00
|
|
|
// Hydrate slot section header placeholders generated by RevisionRenderer.
|
|
|
|
|
$text = preg_replace_callback(
|
|
|
|
|
'#<mw:slotheader>(.*?)</mw:slotheader>#',
|
|
|
|
|
function ( $m ) {
|
|
|
|
|
$role = htmlspecialchars_decode( $m[1] );
|
|
|
|
|
// TODO: map to message, using the interface language. Set lang="xyz" accordingly.
|
|
|
|
|
$headerText = $role;
|
|
|
|
|
return $headerText;
|
|
|
|
|
},
|
|
|
|
|
$text
|
|
|
|
|
);
|
2013-08-22 22:22:03 +00:00
|
|
|
return $text;
|
2011-01-03 20:17:20 +00:00
|
|
|
}
|
2011-08-01 15:40:02 +00:00
|
|
|
|
2020-09-23 21:31:14 +00:00
|
|
|
/**
|
|
|
|
|
* Adds a comment notice about cache state to the text of the page
|
|
|
|
|
* @param string $msg
|
|
|
|
|
* @internal used by ParserCache
|
|
|
|
|
*/
|
|
|
|
|
public function addCacheMessage( string $msg ) {
|
|
|
|
|
$this->mText .= "\n<!-- $msg\n -->\n";
|
|
|
|
|
}
|
|
|
|
|
|
2018-08-28 16:48:10 +00:00
|
|
|
/**
|
|
|
|
|
* Add a CSS class to use for the wrapping div. If no class is given, no wrapper is added.
|
|
|
|
|
*
|
|
|
|
|
* @param string $class
|
|
|
|
|
*/
|
|
|
|
|
public function addWrapperDivClass( $class ) {
|
|
|
|
|
$this->mWrapperDivClasses[$class] = true;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Clears the CSS class to use for the wrapping div, effectively disabling the wrapper div
|
|
|
|
|
* until addWrapperDivClass() is called.
|
|
|
|
|
*/
|
|
|
|
|
public function clearWrapperDivClass() {
|
|
|
|
|
$this->mWrapperDivClasses = [];
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Returns the class (or classes) to be used with the wrapper div for this otuput.
|
|
|
|
|
* If there is no wrapper class given, no wrapper div should be added.
|
|
|
|
|
* The wrapper div is added automatically by getText().
|
|
|
|
|
*
|
|
|
|
|
* @return string
|
|
|
|
|
*/
|
|
|
|
|
public function getWrapperDivClass() {
|
|
|
|
|
return implode( ' ', array_keys( $this->mWrapperDivClasses ) );
|
|
|
|
|
}
|
|
|
|
|
|
2016-06-19 05:30:21 +00:00
|
|
|
/**
|
2017-08-20 11:20:59 +00:00
|
|
|
* @param int $id
|
2016-06-19 05:30:21 +00:00
|
|
|
* @since 1.28
|
|
|
|
|
*/
|
|
|
|
|
public function setSpeculativeRevIdUsed( $id ) {
|
2019-07-31 02:16:07 +00:00
|
|
|
$this->mSpeculativeRevId = $id;
|
2016-06-19 05:30:21 +00:00
|
|
|
}
|
|
|
|
|
|
2017-09-09 20:47:04 +00:00
|
|
|
/**
|
|
|
|
|
* @return int|null
|
|
|
|
|
* @since 1.28
|
|
|
|
|
*/
|
2016-06-19 05:30:21 +00:00
|
|
|
public function getSpeculativeRevIdUsed() {
|
2019-07-31 02:16:07 +00:00
|
|
|
return $this->mSpeculativeRevId;
|
2019-06-27 04:30:35 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @param int $id
|
|
|
|
|
* @since 1.34
|
|
|
|
|
*/
|
|
|
|
|
public function setSpeculativePageIdUsed( $id ) {
|
|
|
|
|
$this->speculativePageIdUsed = $id;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @return int|null
|
|
|
|
|
* @since 1.34
|
|
|
|
|
*/
|
|
|
|
|
public function getSpeculativePageIdUsed() {
|
|
|
|
|
return $this->speculativePageIdUsed;
|
2016-06-19 05:30:21 +00:00
|
|
|
}
|
|
|
|
|
|
2019-04-19 01:36:40 +00:00
|
|
|
/**
|
|
|
|
|
* @param string $timestamp TS_MW timestamp
|
|
|
|
|
* @since 1.34
|
|
|
|
|
*/
|
|
|
|
|
public function setRevisionTimestampUsed( $timestamp ) {
|
|
|
|
|
$this->revisionTimestampUsed = $timestamp;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @return string|null TS_MW timestamp or null if not used
|
|
|
|
|
* @since 1.34
|
|
|
|
|
*/
|
|
|
|
|
public function getRevisionTimestampUsed() {
|
|
|
|
|
return $this->revisionTimestampUsed;
|
|
|
|
|
}
|
|
|
|
|
|
2019-07-04 10:01:31 +00:00
|
|
|
/**
|
|
|
|
|
* @param string $hash Lowercase SHA-1 base 36 hash
|
|
|
|
|
* @since 1.34
|
|
|
|
|
*/
|
|
|
|
|
public function setRevisionUsedSha1Base36( $hash ) {
|
|
|
|
|
if ( $hash === null ) {
|
|
|
|
|
return; // e.g. RevisionRecord::getSha1() returned null
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if (
|
|
|
|
|
$this->revisionUsedSha1Base36 !== null &&
|
|
|
|
|
$this->revisionUsedSha1Base36 !== $hash
|
|
|
|
|
) {
|
|
|
|
|
$this->revisionUsedSha1Base36 = ''; // mismatched
|
|
|
|
|
} else {
|
|
|
|
|
$this->revisionUsedSha1Base36 = $hash;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @return string|null Lowercase SHA-1 base 36 hash, null if unused, or "" on inconsistency
|
|
|
|
|
* @since 1.34
|
|
|
|
|
*/
|
|
|
|
|
public function getRevisionUsedSha1Base36() {
|
|
|
|
|
return $this->revisionUsedSha1Base36;
|
|
|
|
|
}
|
|
|
|
|
|
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
|
|
|
/**
|
2017-09-09 20:47:04 +00:00
|
|
|
* @return array
|
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 &getLinks() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mLinks;
|
|
|
|
|
}
|
|
|
|
|
|
preferences: Signature validation (lint errors, user links, nested subst)
Three new checks are now applied to user signatures in preferences:
* Disallow invalid HTML and lint errors (T140606)
Since 15e0e9bb4b we can rely on Parsoid to check the signature for
lint errors. (The old PHP Parser doesn't have this capability.)
Most importantly, this will disallow unclosed HTML tags. Unclosed
formatting tags like `<i>` (and also wikitext markup like `''`)
could affect the entire page with the bad markup.
New configuration variable $wgSignatureAllowedLintErrors is added
to allow ignoring some errors. The default value ignores the
'obsolete-tag' error (caused by HTML tags like `<font>` and `<tt>`.)
* Require a link to user page, talk page or contributions (T237700)
Various tools don't work correctly when such a link is missing. For
example, Echo notifications are not sent, DiscussionTools will not
allow replying to these comments, English Wikipedia's SineBot treats
these comments as unsigned.
Such requirement has been present for a long time in many Wikimedia
wikis' policies, but it was not enforced by software.
* Disallow "nested" substitution in signature (T230652)
Clever abuse of "subst" markup and tildes allows users to save edits
containing wikitext in which substitution occurs again when the page
is next saved. Disallow this in signatures, at least.
New configuration variable $wgSignatureValidation is added to control
what we do about the result of the validation described above. The
options are:
* 'warning':
Only displays a warning near the field on Special:Preferences if
the current signature is invalid. Signatures can still be changed
regardless of validity and will be used when signing comments.
* 'new':
In addition to the above, if a user tries to change their signature,
the new one must be valid. Existing invalid signatures are still
used when signing comments.
* 'disallow':
In addition to the above, existing invalid signatures are no longer
used when signing comments.
Bug: T140606
Bug: T237700
Bug: T230652
Change-Id: I07c575c2d9d2afe7a89c4847d16ac044417297bf
2019-11-09 00:15:51 +00:00
|
|
|
/**
|
|
|
|
|
* @return array Keys are DBKs for the links to special pages in the document
|
|
|
|
|
* @since 1.35
|
|
|
|
|
*/
|
|
|
|
|
public function &getLinksSpecial() {
|
|
|
|
|
return $this->mLinksSpecial;
|
|
|
|
|
}
|
|
|
|
|
|
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;
|
|
|
|
|
}
|
|
|
|
|
|
2018-08-07 16:52:40 +00:00
|
|
|
public function setNoGallery( $value ) {
|
|
|
|
|
$this->mNoGallery = (bool)$value;
|
|
|
|
|
}
|
2019-05-11 01:17:43 +00:00
|
|
|
|
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 getModuleStyles() {
|
2014-05-10 23:03:45 +00:00
|
|
|
return $this->mModuleStyles;
|
|
|
|
|
}
|
|
|
|
|
|
2017-09-09 20:47:04 +00:00
|
|
|
/**
|
|
|
|
|
* @return array
|
|
|
|
|
* @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;
|
|
|
|
|
}
|
|
|
|
|
|
2016-04-27 22:43:38 +00:00
|
|
|
/**
|
|
|
|
|
* @return string|null TS_MW timestamp of the revision content
|
|
|
|
|
*/
|
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;
|
|
|
|
|
}
|
|
|
|
|
|
2016-11-10 20:29:27 +00:00
|
|
|
public function getLimitReportJSData() {
|
|
|
|
|
return $this->mLimitReportJSData;
|
|
|
|
|
}
|
|
|
|
|
|
2015-07-25 15:32:08 +00:00
|
|
|
public function getEnableOOUI() {
|
|
|
|
|
return $this->mEnableOOUI;
|
|
|
|
|
}
|
|
|
|
|
|
2020-02-03 09:50:14 +00:00
|
|
|
/**
|
|
|
|
|
* Get extra Content-Security-Policy 'default-src' directives
|
|
|
|
|
* @since 1.35
|
|
|
|
|
* @return array
|
|
|
|
|
*/
|
|
|
|
|
public function getExtraCSPDefaultSrcs() {
|
|
|
|
|
return $this->mExtraDefaultSrcs;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Get extra Content-Security-Policy 'script-src' directives
|
|
|
|
|
* @since 1.35
|
|
|
|
|
* @return array
|
|
|
|
|
*/
|
|
|
|
|
public function getExtraCSPScriptSrcs() {
|
|
|
|
|
return $this->mExtraScriptSrcs;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Get extra Content-Security-Policy 'style-src' directives
|
|
|
|
|
* @since 1.35
|
|
|
|
|
* @return array
|
|
|
|
|
*/
|
|
|
|
|
public function getExtraCSPStyleSrcs() {
|
|
|
|
|
return $this->mExtraStyleSrcs;
|
|
|
|
|
}
|
|
|
|
|
|
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 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 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
|
|
|
/**
|
2017-09-09 20:47:04 +00:00
|
|
|
* @param string $id
|
|
|
|
|
* @param string $content
|
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;
|
|
|
|
|
}
|
|
|
|
|
|
2015-07-25 15:32:08 +00:00
|
|
|
/**
|
|
|
|
|
* Enables OOUI, if true, in any OutputPage instance this ParserOutput
|
|
|
|
|
* object is added to.
|
|
|
|
|
*
|
|
|
|
|
* @since 1.26
|
|
|
|
|
* @param bool $enable If OOUI should be enabled or not
|
|
|
|
|
*/
|
|
|
|
|
public function setEnableOOUI( $enable = false ) {
|
|
|
|
|
$this->mEnableOOUI = $enable;
|
|
|
|
|
}
|
|
|
|
|
|
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 ) {
|
2016-02-17 09:09:32 +00:00
|
|
|
$this->mOutputHooks[] = [ $hook, $data ];
|
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
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function setNewSection( $value ) {
|
2007-01-20 12:50:56 +00:00
|
|
|
$this->mNewSection = (bool)$value;
|
|
|
|
|
}
|
2019-05-11 01:17:43 +00:00
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function hideNewSection( $value ) {
|
2009-02-19 22:14:59 +00:00
|
|
|
$this->mHideNewSection = (bool)$value;
|
|
|
|
|
}
|
2019-05-11 01:17:43 +00:00
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function getHideNewSection() {
|
2009-02-19 22:14:59 +00:00
|
|
|
return (bool)$this->mHideNewSection;
|
|
|
|
|
}
|
2019-05-11 01:17:43 +00:00
|
|
|
|
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
|
|
|
|
2016-03-11 01:08:06 +00:00
|
|
|
# Replace unnecessary URL escape codes with the referenced character
|
|
|
|
|
# This prevents spammers from hiding links from the filters
|
2017-12-15 10:58:11 +00:00
|
|
|
$url = Parser::normalizeLinkUrl( $url );
|
2016-03-11 01:08:06 +00:00
|
|
|
|
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();
|
2020-07-22 17:29:48 +00:00
|
|
|
if ( $ns === NS_MEDIA ) {
|
2009-01-01 00:05:08 +00:00
|
|
|
// Normalize this pseudo-alias if it makes it down here...
|
|
|
|
|
$ns = NS_FILE;
|
2020-07-22 17:29:48 +00:00
|
|
|
} elseif ( $ns === NS_SPECIAL ) {
|
preferences: Signature validation (lint errors, user links, nested subst)
Three new checks are now applied to user signatures in preferences:
* Disallow invalid HTML and lint errors (T140606)
Since 15e0e9bb4b we can rely on Parsoid to check the signature for
lint errors. (The old PHP Parser doesn't have this capability.)
Most importantly, this will disallow unclosed HTML tags. Unclosed
formatting tags like `<i>` (and also wikitext markup like `''`)
could affect the entire page with the bad markup.
New configuration variable $wgSignatureAllowedLintErrors is added
to allow ignoring some errors. The default value ignores the
'obsolete-tag' error (caused by HTML tags like `<font>` and `<tt>`.)
* Require a link to user page, talk page or contributions (T237700)
Various tools don't work correctly when such a link is missing. For
example, Echo notifications are not sent, DiscussionTools will not
allow replying to these comments, English Wikipedia's SineBot treats
these comments as unsigned.
Such requirement has been present for a long time in many Wikimedia
wikis' policies, but it was not enforced by software.
* Disallow "nested" substitution in signature (T230652)
Clever abuse of "subst" markup and tildes allows users to save edits
containing wikitext in which substitution occurs again when the page
is next saved. Disallow this in signatures, at least.
New configuration variable $wgSignatureValidation is added to control
what we do about the result of the validation described above. The
options are:
* 'warning':
Only displays a warning near the field on Special:Preferences if
the current signature is invalid. Signatures can still be changed
regardless of validity and will be used when signing comments.
* 'new':
In addition to the above, if a user tries to change their signature,
the new one must be valid. Existing invalid signatures are still
used when signing comments.
* 'disallow':
In addition to the above, existing invalid signatures are no longer
used when signing comments.
Bug: T140606
Bug: T237700
Bug: T230652
Change-Id: I07c575c2d9d2afe7a89c4847d16ac044417297bf
2019-11-09 00:15:51 +00:00
|
|
|
// We don't want to record Special: links in the database, so put them in a separate place.
|
2009-01-01 00:05:08 +00:00
|
|
|
// It might actually be wise to, but we'd need to do some normalization.
|
preferences: Signature validation (lint errors, user links, nested subst)
Three new checks are now applied to user signatures in preferences:
* Disallow invalid HTML and lint errors (T140606)
Since 15e0e9bb4b we can rely on Parsoid to check the signature for
lint errors. (The old PHP Parser doesn't have this capability.)
Most importantly, this will disallow unclosed HTML tags. Unclosed
formatting tags like `<i>` (and also wikitext markup like `''`)
could affect the entire page with the bad markup.
New configuration variable $wgSignatureAllowedLintErrors is added
to allow ignoring some errors. The default value ignores the
'obsolete-tag' error (caused by HTML tags like `<font>` and `<tt>`.)
* Require a link to user page, talk page or contributions (T237700)
Various tools don't work correctly when such a link is missing. For
example, Echo notifications are not sent, DiscussionTools will not
allow replying to these comments, English Wikipedia's SineBot treats
these comments as unsigned.
Such requirement has been present for a long time in many Wikimedia
wikis' policies, but it was not enforced by software.
* Disallow "nested" substitution in signature (T230652)
Clever abuse of "subst" markup and tildes allows users to save edits
containing wikitext in which substitution occurs again when the page
is next saved. Disallow this in signatures, at least.
New configuration variable $wgSignatureValidation is added to control
what we do about the result of the validation described above. The
options are:
* 'warning':
Only displays a warning near the field on Special:Preferences if
the current signature is invalid. Signatures can still be changed
regardless of validity and will be used when signing comments.
* 'new':
In addition to the above, if a user tries to change their signature,
the new one must be valid. Existing invalid signatures are still
used when signing comments.
* 'disallow':
In addition to the above, existing invalid signatures are no longer
used when signing comments.
Bug: T140606
Bug: T237700
Bug: T230652
Change-Id: I07c575c2d9d2afe7a89c4847d16ac044417297bf
2019-11-09 00:15:51 +00:00
|
|
|
$this->mLinksSpecial[$dbk] = 1;
|
2009-01-01 00:05:08 +00:00
|
|
|
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] ) ) {
|
2016-02-17 09:09:32 +00:00
|
|
|
$this->mLinks[$ns] = [];
|
2007-01-20 12:50:56 +00:00
|
|
|
}
|
2020-01-09 23:48:34 +00:00
|
|
|
if ( $id === null ) {
|
2007-01-20 12:50:56 +00:00
|
|
|
$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
|
2018-04-18 12:31:13 +00:00
|
|
|
* @param string|false|null $timestamp MW timestamp of file creation (or false if non-existing)
|
|
|
|
|
* @param string|false|null $sha1 Base 36 SHA-1 of file (or false if non-existing)
|
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 ) {
|
2016-02-17 09:09:32 +00:00
|
|
|
$this->mFileSearchOptions[$name] = [ '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
|
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] ) ) {
|
2016-02-17 09:09:32 +00:00
|
|
|
$this->mTemplates[$ns] = [];
|
2007-01-20 12:50:56 +00:00
|
|
|
}
|
2007-05-31 16:01:26 +00:00
|
|
|
$this->mTemplates[$ns][$dbk] = $page_id;
|
|
|
|
|
if ( !isset( $this->mTemplateIds[$ns] ) ) {
|
2016-02-17 09:09:32 +00:00
|
|
|
$this->mTemplateIds[$ns] = [];
|
2007-05-31 16:01:26 +00:00
|
|
|
}
|
|
|
|
|
$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] ) ) {
|
2016-02-17 09:09:32 +00:00
|
|
|
$this->mInterwikiLinks[$prefix] = [];
|
2010-04-16 01:40:05 +00:00
|
|
|
}
|
|
|
|
|
$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
|
|
|
|
2018-03-02 01:21:32 +00:00
|
|
|
/**
|
|
|
|
|
* @see OutputPage::addModules
|
2019-11-11 21:10:35 +00:00
|
|
|
* @param string|array $modules
|
2018-03-02 01:21:32 +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
|
|
|
|
2018-03-02 01:21:32 +00:00
|
|
|
/**
|
|
|
|
|
* @see OutputPage::addModuleStyles
|
2019-11-11 21:10:35 +00:00
|
|
|
* @param string|array $modules
|
2018-03-02 01:21:32 +00:00
|
|
|
*/
|
2011-08-02 15:40:03 +00:00
|
|
|
public function addModuleStyles( $modules ) {
|
|
|
|
|
$this->mModuleStyles = array_merge( $this->mModuleStyles, (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.
|
2018-06-26 21:14:43 +00:00
|
|
|
* @param mixed|null $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->addModuleStyles( $out->getModuleStyles() );
|
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.
|
|
|
|
|
*
|
2014-12-17 19:18:49 +00:00
|
|
|
* Any message used with this function should be registered so it will
|
|
|
|
|
* show up on Special:TrackingCategories. Core messages should be added
|
|
|
|
|
* to SpecialTrackingCategories::$coreTrackingCategories, and extensions
|
|
|
|
|
* should add to "TrackingCategories" in their extension.json.
|
2014-09-23 14:36:40 +00:00
|
|
|
*
|
2016-11-29 23:04:07 +00:00
|
|
|
* @todo Migrate some code to TrackingCategories
|
|
|
|
|
*
|
2014-09-23 14:36:40 +00:00
|
|
|
* @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 ) {
|
2017-04-29 20:22:46 +00:00
|
|
|
if ( $title->isSpecialPage() ) {
|
2020-06-01 05:00:39 +00:00
|
|
|
wfDebug( __METHOD__ . ": Not adding tracking category $msg to special page!" );
|
2014-09-23 14:36:40 +00:00
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
|
2017-02-20 22:44:19 +00:00
|
|
|
// Important to parse with correct title (T33469)
|
2014-09-23 14:36:40 +00:00
|
|
|
$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 {
|
2020-06-01 05:00:39 +00:00
|
|
|
wfDebug( __METHOD__ . ": [[MediaWiki:$msg]] is not a valid title!" );
|
2014-09-23 14:36:40 +00:00
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2007-06-25 15:51:09 +00:00
|
|
|
/**
|
|
|
|
|
* Override the title to be used for display
|
2015-10-16 18:03:33 +00:00
|
|
|
*
|
|
|
|
|
* @note this is assumed to have been validated
|
2007-06-25 15:51:09 +00:00
|
|
|
* (check equal normalisation, etc.)
|
|
|
|
|
*
|
2015-10-16 18:03:33 +00:00
|
|
|
* @note this is expected to be safe HTML,
|
|
|
|
|
* ready to be served to the client.
|
|
|
|
|
*
|
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
|
|
|
|
|
|
|
|
/**
|
2015-10-16 18:03:33 +00:00
|
|
|
* Get the title to be used for display.
|
|
|
|
|
*
|
|
|
|
|
* As per the contract of setDisplayTitle(), this is safe HTML,
|
|
|
|
|
* ready to be served to the client.
|
2008-12-31 16:49:38 +00:00
|
|
|
*
|
2015-10-16 18:03:33 +00:00
|
|
|
* @return string HTML
|
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
|
|
|
/**
|
2019-05-29 17:55:57 +00:00
|
|
|
* Attach a flag to the output so that it can be checked later to handle special cases
|
|
|
|
|
*
|
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
|
|
|
|
2019-05-29 17:55:57 +00:00
|
|
|
/**
|
|
|
|
|
* @param string $flag
|
|
|
|
|
* @return bool Whether the given flag was set to signify a special case
|
|
|
|
|
*/
|
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
|
|
|
|
2019-05-29 17:55:57 +00:00
|
|
|
/**
|
|
|
|
|
* @return string[] List of flags signifying special cases
|
|
|
|
|
* @since 1.34
|
|
|
|
|
*/
|
|
|
|
|
public function getAllFlags() {
|
|
|
|
|
return array_keys( $this->mFlags );
|
|
|
|
|
}
|
|
|
|
|
|
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.
|
|
|
|
|
*
|
2018-05-19 20:46:54 +00:00
|
|
|
* * Overriding the displayed article title (ParserOutput::setDisplayTitle()).
|
2012-10-22 00:58:05 +00:00
|
|
|
*
|
|
|
|
|
* * 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
|
2020-10-14 14:54:56 +00:00
|
|
|
*
|
2020-11-03 10:58:00 +00:00
|
|
|
* @note Only scalar values like numbers and strings are supported
|
|
|
|
|
* as a value. Attempt to use an object or array will
|
|
|
|
|
* not work properly with LinksUpdate.
|
2020-10-14 14:54:56 +00:00
|
|
|
*
|
2017-09-09 20:47:04 +00:00
|
|
|
* @param string $name
|
2020-11-03 10:58:00 +00:00
|
|
|
* @param int|float|string|bool|null $value
|
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 ) {
|
2017-10-06 22:17:58 +00:00
|
|
|
return $this->mProperties[$name] ?? false;
|
2008-02-20 08:53:12 +00:00
|
|
|
}
|
|
|
|
|
|
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 ) ) {
|
2016-02-17 09:09:32 +00:00
|
|
|
$this->mProperties = [];
|
2008-02-20 08:53:12 +00:00
|
|
|
}
|
|
|
|
|
return $this->mProperties;
|
|
|
|
|
}
|
2011-08-01 15:40:02 +00:00
|
|
|
|
2020-10-01 00:22:03 +00:00
|
|
|
/**
|
|
|
|
|
* Returns the options from its ParserOptions which have been taken
|
|
|
|
|
* into account to produce this output.
|
|
|
|
|
* @return string[]
|
|
|
|
|
*/
|
2020-09-23 21:31:14 +00:00
|
|
|
public function getUsedOptions() : array {
|
|
|
|
|
// TODO: Merge mAccessedOptions with CacheTime::mUsedOptions
|
2020-10-01 00:22:03 +00:00
|
|
|
if ( !isset( $this->mAccessedOptions ) ) {
|
|
|
|
|
return [];
|
|
|
|
|
}
|
|
|
|
|
return array_keys( $this->mAccessedOptions );
|
|
|
|
|
}
|
|
|
|
|
|
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().
|
2015-08-26 16:17:05 +00:00
|
|
|
* The information gathered here is available via getUsedOptions(),
|
|
|
|
|
* and is used by ParserCache::save().
|
2013-12-02 13:20:26 +00:00
|
|
|
*
|
2020-09-23 21:31:14 +00:00
|
|
|
* @see ParserCache::getMetadata
|
2013-12-02 13:20:26 +00:00
|
|
|
* @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
|
|
|
|
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
|
|
|
|
|
*
|
2020-10-14 14:54:56 +00:00
|
|
|
* @note Only scalar values, e.g. numbers, strings, arrays are supported
|
|
|
|
|
* as a value. Attempt to set a class instance as a extension data will
|
|
|
|
|
* break ParserCache for the page.
|
|
|
|
|
*
|
2013-01-22 11:59:23 +00:00
|
|
|
* @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 ) {
|
2018-10-20 21:55:44 +00:00
|
|
|
return $this->mExtensionData[$key] ?? null;
|
2013-01-22 11:59:23 +00:00
|
|
|
}
|
|
|
|
|
|
2013-03-14 12:43:06 +00:00
|
|
|
private static function getTimes( $clock = null ) {
|
2016-02-17 09:09:32 +00:00
|
|
|
$ret = [];
|
2013-03-14 12:43:06 +00:00
|
|
|
if ( !$clock || $clock === 'wall' ) {
|
|
|
|
|
$ret['wall'] = microtime( true );
|
|
|
|
|
}
|
2014-09-04 23:56:20 +00:00
|
|
|
if ( !$clock || $clock === 'cpu' ) {
|
2019-10-22 10:32:06 +00:00
|
|
|
$ru = getrusage( 0 /* RUSAGE_SELF */ );
|
|
|
|
|
$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
|
|
|
|
|
*
|
2016-11-08 21:03:21 +00:00
|
|
|
* 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.
|
2013-03-14 12:43:06 +00:00
|
|
|
*
|
|
|
|
|
* @since 1.22
|
2016-11-08 21:03:21 +00:00
|
|
|
* @param string $key Message key
|
|
|
|
|
* @param mixed $value Appropriate for Message::params()
|
2013-03-14 12:43:06 +00:00
|
|
|
*/
|
2014-08-11 20:24:54 +00:00
|
|
|
public function setLimitReportData( $key, $value ) {
|
2016-11-08 21:03:21 +00:00
|
|
|
$this->mLimitReportData[$key] = $value;
|
2016-11-10 20:29:27 +00:00
|
|
|
|
|
|
|
|
if ( is_array( $value ) ) {
|
|
|
|
|
if ( array_keys( $value ) === [ 0, 1 ]
|
|
|
|
|
&& is_numeric( $value[0] )
|
|
|
|
|
&& is_numeric( $value[1] )
|
|
|
|
|
) {
|
|
|
|
|
$data = [ 'value' => $value[0], 'limit' => $value[1] ];
|
|
|
|
|
} else {
|
|
|
|
|
$data = $value;
|
|
|
|
|
}
|
|
|
|
|
} else {
|
|
|
|
|
$data = $value;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if ( strpos( $key, '-' ) ) {
|
|
|
|
|
list( $ns, $name ) = explode( '-', $key, 2 );
|
|
|
|
|
$this->mLimitReportJSData[$ns][$name] = $data;
|
|
|
|
|
} else {
|
|
|
|
|
$this->mLimitReportJSData[$key] = $data;
|
|
|
|
|
}
|
2013-03-14 12:43:06 +00:00
|
|
|
}
|
2014-03-18 20:20:09 +00:00
|
|
|
|
2015-02-12 23:03:24 +00:00
|
|
|
/**
|
|
|
|
|
* Check whether the cache TTL was lowered due to dynamic content
|
|
|
|
|
*
|
|
|
|
|
* When content is determined by more than hard state (e.g. page edits),
|
|
|
|
|
* such as template/file transclusions based on the current timestamp or
|
|
|
|
|
* extension tags that generate lists based on queries, this return true.
|
|
|
|
|
*
|
|
|
|
|
* @return bool
|
|
|
|
|
* @since 1.25
|
|
|
|
|
*/
|
|
|
|
|
public function hasDynamicContent() {
|
|
|
|
|
global $wgParserCacheExpireTime;
|
|
|
|
|
|
|
|
|
|
return $this->getCacheExpiry() < $wgParserCacheExpireTime;
|
|
|
|
|
}
|
|
|
|
|
|
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
|
|
|
/**
|
2016-08-30 19:35:08 +00:00
|
|
|
* Lower the runtime adaptive TTL to at most this value
|
|
|
|
|
*
|
2017-08-20 11:20:59 +00:00
|
|
|
* @param int $ttl
|
2016-08-30 19:35:08 +00:00
|
|
|
* @since 1.28
|
|
|
|
|
*/
|
|
|
|
|
public function updateRuntimeAdaptiveExpiry( $ttl ) {
|
|
|
|
|
$this->mMaxAdaptiveExpiry = min( $ttl, $this->mMaxAdaptiveExpiry );
|
|
|
|
|
$this->updateCacheExpiry( $ttl );
|
|
|
|
|
}
|
|
|
|
|
|
2020-02-03 09:50:14 +00:00
|
|
|
/**
|
|
|
|
|
* Add an extra value to Content-Security-Policy default-src directive
|
|
|
|
|
*
|
|
|
|
|
* Call this if you are including a resource (e.g. image) from a third party domain.
|
|
|
|
|
* This is used for all source types except style and script.
|
|
|
|
|
*
|
|
|
|
|
* @since 1.35
|
|
|
|
|
* @param string $src CSP source e.g. example.com
|
|
|
|
|
*/
|
|
|
|
|
public function addExtraCSPDefaultSrc( $src ) {
|
|
|
|
|
$this->mExtraDefaultSrcs[] = $src;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Add an extra value to Content-Security-Policy style-src directive
|
|
|
|
|
*
|
|
|
|
|
* @since 1.35
|
|
|
|
|
* @param string $src CSP source e.g. example.com
|
|
|
|
|
*/
|
|
|
|
|
public function addExtraCSPStyleSrc( $src ) {
|
|
|
|
|
$this->mExtraStyleSrcs[] = $src;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Add an extra value to Content-Security-Policy script-src directive
|
|
|
|
|
*
|
|
|
|
|
* Call this if you are loading third-party Javascript
|
|
|
|
|
*
|
|
|
|
|
* @since 1.35
|
|
|
|
|
* @param string $src CSP source e.g. example.com
|
|
|
|
|
*/
|
|
|
|
|
public function addExtraCSPScriptSrc( $src ) {
|
|
|
|
|
$this->mExtraScriptSrcs[] = $src;
|
|
|
|
|
}
|
|
|
|
|
|
2016-08-30 19:35:08 +00:00
|
|
|
/**
|
|
|
|
|
* Call this when parsing is done to lower the TTL based on low parse times
|
|
|
|
|
*
|
|
|
|
|
* @since 1.28
|
2014-03-18 20:20:09 +00:00
|
|
|
*/
|
2016-08-30 19:35:08 +00:00
|
|
|
public function finalizeAdaptiveCacheExpiry() {
|
|
|
|
|
if ( is_infinite( $this->mMaxAdaptiveExpiry ) ) {
|
|
|
|
|
return; // not set
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$runtime = $this->getTimeSinceStart( 'wall' );
|
|
|
|
|
if ( is_float( $runtime ) ) {
|
|
|
|
|
$slope = ( self::SLOW_AR_TTL - self::FAST_AR_TTL )
|
|
|
|
|
/ ( self::PARSE_SLOW_SEC - self::PARSE_FAST_SEC );
|
|
|
|
|
// SLOW_AR_TTL = PARSE_SLOW_SEC * $slope + $point
|
|
|
|
|
$point = self::SLOW_AR_TTL - self::PARSE_SLOW_SEC * $slope;
|
|
|
|
|
|
|
|
|
|
$adaptiveTTL = min(
|
|
|
|
|
max( $slope * $runtime + $point, self::MIN_AR_TTL ),
|
|
|
|
|
$this->mMaxAdaptiveExpiry
|
|
|
|
|
);
|
|
|
|
|
$this->updateCacheExpiry( $adaptiveTTL );
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2014-08-11 20:24:54 +00:00
|
|
|
public function __sleep() {
|
2019-08-01 00:08:38 +00:00
|
|
|
return array_filter( array_keys( get_object_vars( $this ) ),
|
|
|
|
|
function ( $field ) {
|
|
|
|
|
if ( $field === 'mParseStartTime' ) {
|
|
|
|
|
return false;
|
|
|
|
|
} elseif ( strpos( $field, "\0" ) !== false ) {
|
|
|
|
|
// Unserializing unknown private fields in HHVM causes
|
|
|
|
|
// member variables with nulls in their names (T229366)
|
|
|
|
|
return false;
|
|
|
|
|
} else {
|
|
|
|
|
return true;
|
|
|
|
|
}
|
|
|
|
|
}
|
2014-03-18 20:20:09 +00:00
|
|
|
);
|
|
|
|
|
}
|
2018-08-07 16:52:40 +00:00
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Merges internal metadata such as flags, accessed options, and profiling info
|
|
|
|
|
* from $source into this ParserOutput. This should be used whenever the state of $source
|
|
|
|
|
* has any impact on the state of this ParserOutput.
|
|
|
|
|
*
|
|
|
|
|
* @param ParserOutput $source
|
|
|
|
|
*/
|
|
|
|
|
public function mergeInternalMetaDataFrom( ParserOutput $source ) {
|
|
|
|
|
$this->mOutputHooks = self::mergeList( $this->mOutputHooks, $source->getOutputHooks() );
|
|
|
|
|
$this->mWarnings = self::mergeMap( $this->mWarnings, $source->mWarnings ); // don't use getter
|
|
|
|
|
$this->mTimestamp = $this->useMaxValue( $this->mTimestamp, $source->getTimestamp() );
|
|
|
|
|
|
2019-10-16 01:24:50 +00:00
|
|
|
foreach ( self::SPECULATIVE_FIELDS as $field ) {
|
2019-06-27 04:30:35 +00:00
|
|
|
if ( $this->$field && $source->$field && $this->$field !== $source->$field ) {
|
|
|
|
|
wfLogWarning( __METHOD__ . ": inconsistent '$field' properties!" );
|
|
|
|
|
}
|
|
|
|
|
$this->$field = $this->useMaxValue( $this->$field, $source->$field );
|
2018-08-07 16:52:40 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$this->mParseStartTime = $this->useEachMinValue(
|
|
|
|
|
$this->mParseStartTime,
|
|
|
|
|
$source->mParseStartTime
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
$this->mFlags = self::mergeMap( $this->mFlags, $source->mFlags );
|
|
|
|
|
$this->mAccessedOptions = self::mergeMap( $this->mAccessedOptions, $source->mAccessedOptions );
|
|
|
|
|
|
|
|
|
|
// TODO: maintain per-slot limit reports!
|
|
|
|
|
if ( empty( $this->mLimitReportData ) ) {
|
|
|
|
|
$this->mLimitReportData = $source->mLimitReportData;
|
|
|
|
|
}
|
|
|
|
|
if ( empty( $this->mLimitReportJSData ) ) {
|
|
|
|
|
$this->mLimitReportJSData = $source->mLimitReportJSData;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Merges HTML metadata such as head items, JS config vars, and HTTP cache control info
|
|
|
|
|
* from $source into this ParserOutput. This should be used whenever the HTML in $source
|
|
|
|
|
* has been somehow mered into the HTML of this ParserOutput.
|
|
|
|
|
*
|
|
|
|
|
* @param ParserOutput $source
|
|
|
|
|
*/
|
|
|
|
|
public function mergeHtmlMetaDataFrom( ParserOutput $source ) {
|
|
|
|
|
// HTML and HTTP
|
|
|
|
|
$this->mHeadItems = self::mergeMixedList( $this->mHeadItems, $source->getHeadItems() );
|
|
|
|
|
$this->mModules = self::mergeList( $this->mModules, $source->getModules() );
|
|
|
|
|
$this->mModuleStyles = self::mergeList( $this->mModuleStyles, $source->getModuleStyles() );
|
|
|
|
|
$this->mJsConfigVars = self::mergeMap( $this->mJsConfigVars, $source->getJsConfigVars() );
|
|
|
|
|
$this->mMaxAdaptiveExpiry = min( $this->mMaxAdaptiveExpiry, $source->mMaxAdaptiveExpiry );
|
2020-02-03 09:50:14 +00:00
|
|
|
$this->mExtraStyleSrcs = self::mergeList(
|
|
|
|
|
$this->mExtraStyleSrcs,
|
|
|
|
|
$source->getExtraCSPStyleSrcs()
|
|
|
|
|
);
|
|
|
|
|
$this->mExtraScriptSrcs = self::mergeList(
|
|
|
|
|
$this->mExtraScriptSrcs,
|
|
|
|
|
$source->getExtraCSPScriptSrcs()
|
|
|
|
|
);
|
|
|
|
|
$this->mExtraDefaultSrcs = self::mergeList(
|
|
|
|
|
$this->mExtraDefaultSrcs,
|
|
|
|
|
$source->getExtraCSPDefaultSrcs()
|
|
|
|
|
);
|
2018-08-07 16:52:40 +00:00
|
|
|
|
|
|
|
|
// "noindex" always wins!
|
|
|
|
|
if ( $this->mIndexPolicy === 'noindex' || $source->mIndexPolicy === 'noindex' ) {
|
|
|
|
|
$this->mIndexPolicy = 'noindex';
|
|
|
|
|
} elseif ( $this->mIndexPolicy !== 'index' ) {
|
|
|
|
|
$this->mIndexPolicy = $source->mIndexPolicy;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// Skin control
|
|
|
|
|
$this->mNewSection = $this->mNewSection || $source->getNewSection();
|
|
|
|
|
$this->mHideNewSection = $this->mHideNewSection || $source->getHideNewSection();
|
|
|
|
|
$this->mNoGallery = $this->mNoGallery || $source->getNoGallery();
|
|
|
|
|
$this->mEnableOOUI = $this->mEnableOOUI || $source->getEnableOOUI();
|
|
|
|
|
$this->mPreventClickjacking = $this->mPreventClickjacking || $source->preventClickjacking();
|
|
|
|
|
|
|
|
|
|
// TODO: we'll have to be smarter about this!
|
|
|
|
|
$this->mSections = array_merge( $this->mSections, $source->getSections() );
|
2017-05-01 17:18:38 +00:00
|
|
|
$this->mTOCHTML .= $source->mTOCHTML;
|
2018-08-07 16:52:40 +00:00
|
|
|
|
|
|
|
|
// XXX: we don't want to concatenate title text, so first write wins.
|
|
|
|
|
// We should use the first *modified* title text, but we don't have the original to check.
|
|
|
|
|
if ( $this->mTitleText === null || $this->mTitleText === '' ) {
|
|
|
|
|
$this->mTitleText = $source->mTitleText;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// class names are stored in array keys
|
|
|
|
|
$this->mWrapperDivClasses = self::mergeMap(
|
|
|
|
|
$this->mWrapperDivClasses,
|
|
|
|
|
$source->mWrapperDivClasses
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
// NOTE: last write wins, same as within one ParserOutput
|
|
|
|
|
$this->mIndicators = self::mergeMap( $this->mIndicators, $source->getIndicators() );
|
|
|
|
|
|
|
|
|
|
// NOTE: include extension data in "tracking meta data" as well as "html meta data"!
|
|
|
|
|
// TODO: add a $mergeStrategy parameter to setExtensionData to allow different
|
|
|
|
|
// kinds of extension data to be merged in different ways.
|
|
|
|
|
$this->mExtensionData = self::mergeMap(
|
|
|
|
|
$this->mExtensionData,
|
|
|
|
|
$source->mExtensionData
|
|
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Merges dependency tracking metadata such as backlinks, images used, and extension data
|
|
|
|
|
* from $source into this ParserOutput. This allows dependency tracking to be done for the
|
|
|
|
|
* combined output of multiple content slots.
|
|
|
|
|
*
|
|
|
|
|
* @param ParserOutput $source
|
|
|
|
|
*/
|
|
|
|
|
public function mergeTrackingMetaDataFrom( ParserOutput $source ) {
|
|
|
|
|
$this->mLanguageLinks = self::mergeList( $this->mLanguageLinks, $source->getLanguageLinks() );
|
|
|
|
|
$this->mCategories = self::mergeMap( $this->mCategories, $source->getCategories() );
|
|
|
|
|
$this->mLinks = self::merge2D( $this->mLinks, $source->getLinks() );
|
|
|
|
|
$this->mTemplates = self::merge2D( $this->mTemplates, $source->getTemplates() );
|
|
|
|
|
$this->mTemplateIds = self::merge2D( $this->mTemplateIds, $source->getTemplateIds() );
|
|
|
|
|
$this->mImages = self::mergeMap( $this->mImages, $source->getImages() );
|
|
|
|
|
$this->mFileSearchOptions = self::mergeMap(
|
|
|
|
|
$this->mFileSearchOptions,
|
|
|
|
|
$source->getFileSearchOptions()
|
|
|
|
|
);
|
|
|
|
|
$this->mExternalLinks = self::mergeMap( $this->mExternalLinks, $source->getExternalLinks() );
|
|
|
|
|
$this->mInterwikiLinks = self::merge2D(
|
|
|
|
|
$this->mInterwikiLinks,
|
|
|
|
|
$source->getInterwikiLinks()
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
// TODO: add a $mergeStrategy parameter to setProperty to allow different
|
|
|
|
|
// kinds of properties to be merged in different ways.
|
|
|
|
|
$this->mProperties = self::mergeMap( $this->mProperties, $source->getProperties() );
|
|
|
|
|
|
|
|
|
|
// NOTE: include extension data in "tracking meta data" as well as "html meta data"!
|
|
|
|
|
// TODO: add a $mergeStrategy parameter to setExtensionData to allow different
|
|
|
|
|
// kinds of extension data to be merged in different ways.
|
|
|
|
|
$this->mExtensionData = self::mergeMap(
|
|
|
|
|
$this->mExtensionData,
|
|
|
|
|
$source->mExtensionData
|
|
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static function mergeMixedList( array $a, array $b ) {
|
|
|
|
|
return array_unique( array_merge( $a, $b ), SORT_REGULAR );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static function mergeList( array $a, array $b ) {
|
|
|
|
|
return array_values( array_unique( array_merge( $a, $b ), SORT_REGULAR ) );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static function mergeMap( array $a, array $b ) {
|
|
|
|
|
return array_replace( $a, $b );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static function merge2D( array $a, array $b ) {
|
|
|
|
|
$values = [];
|
|
|
|
|
$keys = array_merge( array_keys( $a ), array_keys( $b ) );
|
|
|
|
|
|
|
|
|
|
foreach ( $keys as $k ) {
|
|
|
|
|
if ( empty( $a[$k] ) ) {
|
|
|
|
|
$values[$k] = $b[$k];
|
|
|
|
|
} elseif ( empty( $b[$k] ) ) {
|
|
|
|
|
$values[$k] = $a[$k];
|
|
|
|
|
} elseif ( is_array( $a[$k] ) && is_array( $b[$k] ) ) {
|
|
|
|
|
$values[$k] = array_replace( $a[$k], $b[$k] );
|
|
|
|
|
} else {
|
|
|
|
|
$values[$k] = $b[$k];
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return $values;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static function useEachMinValue( array $a, array $b ) {
|
|
|
|
|
$values = [];
|
|
|
|
|
$keys = array_merge( array_keys( $a ), array_keys( $b ) );
|
|
|
|
|
|
|
|
|
|
foreach ( $keys as $k ) {
|
|
|
|
|
if ( is_array( $a[$k] ?? null ) && is_array( $b[$k] ?? null ) ) {
|
|
|
|
|
$values[$k] = self::useEachMinValue( $a[$k], $b[$k] );
|
|
|
|
|
} else {
|
|
|
|
|
$values[$k] = self::useMinValue( $a[$k] ?? null, $b[$k] ?? null );
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return $values;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static function useMinValue( $a, $b ) {
|
|
|
|
|
if ( $a === null ) {
|
|
|
|
|
return $b;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if ( $b === null ) {
|
|
|
|
|
return $a;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return min( $a, $b );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static function useMaxValue( $a, $b ) {
|
|
|
|
|
if ( $a === null ) {
|
|
|
|
|
return $b;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if ( $b === null ) {
|
|
|
|
|
return $a;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return max( $a, $b );
|
|
|
|
|
}
|
|
|
|
|
|
2020-09-29 19:18:00 +00:00
|
|
|
/**
|
|
|
|
|
* Returns a JSON serializable structure representing this ParserOutput instance.
|
|
|
|
|
* @see newFromJson()
|
|
|
|
|
* @since 1.36
|
|
|
|
|
*
|
|
|
|
|
* @return array
|
|
|
|
|
*/
|
|
|
|
|
public function jsonSerialize() {
|
|
|
|
|
$data = [
|
|
|
|
|
'_type_' => 'ParserOutput',
|
|
|
|
|
|
|
|
|
|
'Text' => $this->mText,
|
|
|
|
|
'LanguageLinks' => $this->mLanguageLinks,
|
|
|
|
|
'Categories' => $this->mCategories,
|
|
|
|
|
'Indicators' => $this->mIndicators,
|
|
|
|
|
'TitleText' => $this->mTitleText,
|
|
|
|
|
'Links' => $this->mLinks,
|
|
|
|
|
'LinksSpecial' => $this->mLinksSpecial,
|
|
|
|
|
'Templates' => $this->mTemplates,
|
|
|
|
|
'TemplateIds' => $this->mTemplateIds,
|
|
|
|
|
'Images' => $this->mImages,
|
|
|
|
|
'FileSearchOptions' => $this->mFileSearchOptions,
|
|
|
|
|
'ExternalLinks' => $this->mExternalLinks,
|
|
|
|
|
'InterwikiLinks' => $this->mInterwikiLinks,
|
|
|
|
|
'NewSection' => $this->mNewSection,
|
|
|
|
|
'HideNewSection' => $this->mHideNewSection,
|
|
|
|
|
'NoGallery' => $this->mNoGallery,
|
|
|
|
|
'HeadItems' => $this->mHeadItems,
|
|
|
|
|
'Modules' => $this->mModules,
|
|
|
|
|
'ModuleStyles' => $this->mModuleStyles,
|
|
|
|
|
'JsConfigVars' => $this->mJsConfigVars,
|
|
|
|
|
'OutputHooks' => $this->mOutputHooks,
|
|
|
|
|
'Warnings' => $this->mWarnings,
|
|
|
|
|
'Sections' => $this->mSections,
|
2020-11-03 10:58:00 +00:00
|
|
|
'Properties' => self::detectAndEncodeBinary( $this->mProperties ),
|
2020-09-29 19:18:00 +00:00
|
|
|
'TOCHTML' => $this->mTOCHTML,
|
|
|
|
|
'Timestamp' => $this->mTimestamp,
|
|
|
|
|
'EnableOOUI' => $this->mEnableOOUI,
|
|
|
|
|
'IndexPolicy' => $this->mIndexPolicy,
|
|
|
|
|
'AccessedOptions' => $this->mAccessedOptions,
|
|
|
|
|
'ExtensionData' => $this->mExtensionData, // may contain arbitrary structures!
|
|
|
|
|
'LimitReportData' => $this->mLimitReportData,
|
|
|
|
|
'LimitReportJSData' => $this->mLimitReportJSData,
|
|
|
|
|
'ParseStartTime' => $this->mParseStartTime,
|
|
|
|
|
'PreventClickjacking' => $this->mPreventClickjacking,
|
|
|
|
|
'ExtraScriptSrcs' => $this->mExtraScriptSrcs,
|
|
|
|
|
'ExtraDefaultSrcs' => $this->mExtraDefaultSrcs,
|
|
|
|
|
'ExtraStyleSrcs' => $this->mExtraStyleSrcs,
|
|
|
|
|
'Flags' => $this->mFlags,
|
|
|
|
|
'SpeculativeRevId' => $this->mSpeculativeRevId,
|
|
|
|
|
'SpeculativePageIdUsed' => $this->speculativePageIdUsed,
|
|
|
|
|
'RevisionTimestampUsed' => $this->revisionTimestampUsed,
|
|
|
|
|
'RevisionUsedSha1Base36' => $this->revisionUsedSha1Base36,
|
|
|
|
|
'WrapperDivClasses' => $this->mWrapperDivClasses,
|
|
|
|
|
];
|
|
|
|
|
|
|
|
|
|
// Fill in missing fields from parents. Array addition does not override existing fields.
|
|
|
|
|
$data += parent::jsonSerialize();
|
|
|
|
|
|
|
|
|
|
// TODO: make more fields optional!
|
|
|
|
|
|
|
|
|
|
if ( $this->mMaxAdaptiveExpiry !== INF ) {
|
|
|
|
|
// NOTE: JSON can't encode infinity!
|
|
|
|
|
$data['MaxAdaptiveExpiry'] = $this->mMaxAdaptiveExpiry;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return $data;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Construct a ParserOutput instance from a structure returned by jsonSerialize()
|
|
|
|
|
*
|
|
|
|
|
* @see jsonSerialize()
|
|
|
|
|
* @since 1.36
|
|
|
|
|
*
|
|
|
|
|
* @param string|array|object $jsonData
|
|
|
|
|
* @return CacheTime
|
|
|
|
|
* @throws InvalidArgumentException
|
|
|
|
|
*/
|
|
|
|
|
public static function newFromJson( $jsonData ) {
|
|
|
|
|
if ( is_string( $jsonData ) ) {
|
|
|
|
|
$jsonData = FormatJson::decode( $jsonData, true );
|
|
|
|
|
if ( !$jsonData ) {
|
|
|
|
|
// TODO: in PHP 7.3, we can use JsonException
|
|
|
|
|
throw new InvalidArgumentException( 'Bad JSON' );
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if ( is_object( $jsonData ) ) {
|
|
|
|
|
$jsonData = (array)$jsonData;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$output = new ParserOutput();
|
|
|
|
|
$output->initFromJson( $jsonData );
|
|
|
|
|
|
|
|
|
|
return $output;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Initialize member fields from an array returned by jsonSerialize().
|
|
|
|
|
* @param array $jsonData
|
|
|
|
|
*/
|
|
|
|
|
protected function initFromJson( array $jsonData ) {
|
|
|
|
|
parent::initFromJson( $jsonData );
|
2020-11-05 17:04:37 +00:00
|
|
|
$this->mUsedOptions = null;
|
2020-09-29 19:18:00 +00:00
|
|
|
|
|
|
|
|
$this->mText = $jsonData['Text'];
|
|
|
|
|
$this->mLanguageLinks = $jsonData['LanguageLinks'];
|
|
|
|
|
$this->mCategories = $jsonData['Categories'];
|
|
|
|
|
$this->mIndicators = $jsonData['Indicators'];
|
|
|
|
|
$this->mTitleText = $jsonData['TitleText'];
|
|
|
|
|
$this->mLinks = $jsonData['Links'];
|
|
|
|
|
$this->mLinksSpecial = $jsonData['LinksSpecial'];
|
|
|
|
|
$this->mTemplates = $jsonData['Templates'];
|
|
|
|
|
$this->mTemplateIds = $jsonData['TemplateIds'];
|
|
|
|
|
$this->mImages = $jsonData['Images'];
|
|
|
|
|
$this->mFileSearchOptions = $jsonData['FileSearchOptions'];
|
|
|
|
|
$this->mExternalLinks = $jsonData['ExternalLinks'];
|
|
|
|
|
$this->mInterwikiLinks = $jsonData['InterwikiLinks'];
|
|
|
|
|
$this->mNewSection = $jsonData['NewSection'];
|
|
|
|
|
$this->mHideNewSection = $jsonData['HideNewSection'];
|
|
|
|
|
$this->mNoGallery = $jsonData['NoGallery'];
|
|
|
|
|
$this->mHeadItems = $jsonData['HeadItems'];
|
|
|
|
|
$this->mModules = $jsonData['Modules'];
|
|
|
|
|
$this->mModuleStyles = $jsonData['ModuleStyles'];
|
|
|
|
|
$this->mJsConfigVars = $jsonData['JsConfigVars'];
|
|
|
|
|
$this->mOutputHooks = $jsonData['OutputHooks'];
|
|
|
|
|
$this->mWarnings = $jsonData['Warnings'];
|
|
|
|
|
$this->mSections = $jsonData['Sections'];
|
2020-11-03 10:58:00 +00:00
|
|
|
$this->mProperties = self::detectAndDecodeBinary( $jsonData['Properties'] );
|
2020-09-29 19:18:00 +00:00
|
|
|
$this->mTOCHTML = $jsonData['TOCHTML'];
|
|
|
|
|
$this->mTimestamp = $jsonData['Timestamp'];
|
|
|
|
|
$this->mEnableOOUI = $jsonData['EnableOOUI'];
|
|
|
|
|
$this->mIndexPolicy = $jsonData['IndexPolicy'];
|
2020-11-05 17:04:37 +00:00
|
|
|
if ( array_key_exists( 'ParseUsedOptions', $jsonData ) ) {
|
|
|
|
|
// Forward compatibility
|
|
|
|
|
$this->mAccessedOptions = $jsonData['ParseUsedOptions'];
|
|
|
|
|
} else {
|
|
|
|
|
$this->mAccessedOptions = $jsonData['AccessedOptions'];
|
|
|
|
|
}
|
2020-09-29 19:18:00 +00:00
|
|
|
$this->mExtensionData = $jsonData['ExtensionData'];
|
|
|
|
|
$this->mLimitReportData = $jsonData['LimitReportData'];
|
|
|
|
|
$this->mLimitReportJSData = $jsonData['LimitReportJSData'];
|
|
|
|
|
$this->mParseStartTime = $jsonData['ParseStartTime'];
|
|
|
|
|
$this->mPreventClickjacking = $jsonData['PreventClickjacking'];
|
|
|
|
|
$this->mExtraScriptSrcs = $jsonData['ExtraScriptSrcs'];
|
|
|
|
|
$this->mExtraDefaultSrcs = $jsonData['ExtraDefaultSrcs'];
|
|
|
|
|
$this->mExtraStyleSrcs = $jsonData['ExtraStyleSrcs'];
|
|
|
|
|
$this->mFlags = $jsonData['Flags'];
|
|
|
|
|
$this->mSpeculativeRevId = $jsonData['SpeculativeRevId'];
|
|
|
|
|
$this->speculativePageIdUsed = $jsonData['SpeculativePageIdUsed'];
|
|
|
|
|
$this->revisionTimestampUsed = $jsonData['RevisionTimestampUsed'];
|
|
|
|
|
$this->revisionUsedSha1Base36 = $jsonData['RevisionUsedSha1Base36'];
|
|
|
|
|
$this->mWrapperDivClasses = $jsonData['WrapperDivClasses'];
|
|
|
|
|
$this->mMaxAdaptiveExpiry = $jsonData['MaxAdaptiveExpiry'] ?? INF;
|
|
|
|
|
}
|
2020-11-03 10:58:00 +00:00
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Finds any non-utf8 strings in the given array and replaces them with
|
|
|
|
|
* an associative array that wraps a base64 encoded version of the data.
|
|
|
|
|
* Inverse of detectAndDecodeBinary().
|
|
|
|
|
*
|
|
|
|
|
* @param array $properties
|
|
|
|
|
*
|
|
|
|
|
* @return array
|
|
|
|
|
*/
|
|
|
|
|
private static function detectAndEncodeBinary( array $properties ) {
|
|
|
|
|
foreach ( $properties as $key => $value ) {
|
|
|
|
|
if ( is_string( $value ) ) {
|
|
|
|
|
if ( !mb_detect_encoding( $value, 'UTF-8', true ) ) {
|
|
|
|
|
$properties[$key] = [
|
|
|
|
|
'_type_' => 'string',
|
|
|
|
|
'_encoding_' => 'base64',
|
|
|
|
|
'_data_' => base64_encode( $value ),
|
|
|
|
|
];
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return $properties;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Finds any associative arrays that represent encoded binary strings, and
|
|
|
|
|
* replaces them with the decoded binary data.
|
|
|
|
|
*
|
|
|
|
|
* @param array $properties
|
|
|
|
|
*
|
|
|
|
|
* @return array
|
|
|
|
|
*/
|
|
|
|
|
private static function detectAndDecodeBinary( array $properties ) {
|
|
|
|
|
foreach ( $properties as $key => $value ) {
|
|
|
|
|
if ( is_array( $value ) && isset( $value['_encoding_'] ) ) {
|
|
|
|
|
if ( $value['_encoding_'] === 'base64' ) {
|
|
|
|
|
$properties[$key] = base64_decode( $value['_data_'] );
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return $properties;
|
|
|
|
|
}
|
2020-11-05 17:04:37 +00:00
|
|
|
|
|
|
|
|
public function __wakeup() {
|
|
|
|
|
$forwardOptions = $this->getGhostFieldValue( 'mParseUsedOptions' );
|
|
|
|
|
if ( $forwardOptions ) {
|
|
|
|
|
$this->mAccessedOptions = $forwardOptions;
|
|
|
|
|
$this->mUsedOptions = null;
|
|
|
|
|
}
|
|
|
|
|
}
|
2007-01-20 12:50:56 +00:00
|
|
|
}
|
