Classes extending OutputTransformStage are typically added to a pipeline of transformations that transform a ParserOutput. More...

Inherited by MediaWiki\OutputTransform\ContentDOMTransformStage, MediaWiki\OutputTransform\ContentHolderTransformStage, MediaWiki\OutputTransform\ContentTextTransformStage, MediaWiki\OutputTransform\Stages\DeduplicateStylesDOM, MediaWiki\OutputTransform\Stages\DeduplicateStylesText, MediaWiki\OutputTransform\Stages\ExecuteFirstStageTransformHooks, MediaWiki\OutputTransform\Stages\ExecuteLastStageTransformHooks, and MediaWiki\OutputTransform\Stages\ParsoidLanguageConverter.

Collaboration diagram for MediaWiki\OutputTransform\OutputTransformStage:

[legend]

Public Member Functions
	__construct (ServiceOptions $options, LoggerInterface $logger,)

	shouldRun (ParserOutput $po, ParserOptions $popts, array $options=[])
	Decides whether or not the stage should be run.

	transform (ParserOutput $po, ParserOptions $popts, array &$options)
	Transforms the input ParserOutput into the returned ParserOutput.

Public Attributes
const	CONSTRUCTOR_OPTIONS = []

Protected Attributes
LoggerInterface	$logger

ServiceOptions	$options

Detailed Description

Classes extending OutputTransformStage are typically added to a pipeline of transformations that transform a ParserOutput.

The argument ParserOutput can explicitly be modified in place; ensuring that cached objects do not suffer from side effects is the caller's (typically the pipeline's) responsibility.

Stability: unstable

Definition at line 19 of file OutputTransformStage.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\OutputTransform\OutputTransformStage::__construct	(	ServiceOptions	$options,
		LoggerInterface	$logger )

Access: internal

Reimplemented in MediaWiki\OutputTransform\Stages\AddRedirectHeader, MediaWiki\OutputTransform\Stages\ExpandToAbsoluteUrlsText, MediaWiki\OutputTransform\Stages\ExtractBody, MediaWiki\OutputTransform\Stages\HandleTOCMarkersDOM, MediaWiki\OutputTransform\Stages\HardenNFC, and MediaWiki\OutputTransform\Stages\HydrateHeaderPlaceholders.

Definition at line 28 of file OutputTransformStage.php.

References MediaWiki\OutputTransform\OutputTransformStage\$logger, MediaWiki\OutputTransform\OutputTransformStage\$options, and MediaWiki\Config\ServiceOptions\assertRequiredOptions().

Member Function Documentation

◆ shouldRun()

MediaWiki\OutputTransform\OutputTransformStage::shouldRun	(	ParserOutput	$po,
		ParserOptions	$popts,
		array	$options = [] )

Decides whether or not the stage should be run.

Parameters

ParserOutput $po

Stability: unstable

Parameters

ParserOptions	$popts
array	$options

Returns: bool

Definition at line 46 of file OutputTransformStage.php.

◆ transform()

MediaWiki\OutputTransform\OutputTransformStage::transform	(	ParserOutput	$po,
		ParserOptions	$popts,
		array &	$options )

abstract

Transforms the input ParserOutput into the returned ParserOutput.

The returned ParserOutput can explicitly be a modified version of the input ParserOutput; if modifications to that object are unexpected, a copy should be made before passing it to this method. TODO Some transformations require the possibility of modifying options (this is the case of ExecutePostCacheTransformHooks in particular). We do NOT want to keep this mechanism for later versions of this interface - the currently foreseen goal is to not pass $options at all. Modifying $options during this pass is considered deprecated.

Stability: unstable

Reimplemented in MediaWiki\OutputTransform\ContentDOMTransformStage, MediaWiki\OutputTransform\ContentHolderTransformStage, MediaWiki\OutputTransform\ContentTextTransformStage, MediaWiki\OutputTransform\Stages\DeduplicateStylesDOM, MediaWiki\OutputTransform\Stages\DeduplicateStylesText, MediaWiki\OutputTransform\Stages\ExecuteFirstStageTransformHooks, MediaWiki\OutputTransform\Stages\ExecuteLastStageTransformHooks, and MediaWiki\OutputTransform\Stages\ParsoidLanguageConverter.

Member Data Documentation

◆ $logger

LoggerInterface MediaWiki\OutputTransform\OutputTransformStage::$logger

protected

Definition at line 22 of file OutputTransformStage.php.

◆ $options

ServiceOptions MediaWiki\OutputTransform\OutputTransformStage::$options

protected

Definition at line 21 of file OutputTransformStage.php.

◆ CONSTRUCTOR_OPTIONS

const MediaWiki\OutputTransform\OutputTransformStage::CONSTRUCTOR_OPTIONS = []

Access: internal

Definition at line 25 of file OutputTransformStage.php.

The documentation for this class was generated from the following file:

includes/OutputTransform/OutputTransformStage.php

Public Member Functions

Public Attributes

Protected Attributes