MediaWiki  master
CoreTagHooks Class Reference

Various tag hooks, registered in every Parser. More...

Static Public Member Functions

static gallery (?string $content, array $attributes, Parser $parser)
 Core parser tag hook function for 'gallery'. More...
 
static html (?string $content, array $attributes, Parser $parser)
 Core parser tag hook function for 'html', used only when $wgRawHtml is enabled. More...
 
static indicator (?string $content, array $attributes, Parser $parser, PPFrame $frame)
 XML-style tag for page status indicators: icons (or short text snippets) usually displayed in the top-right corner of the page, outside of the main content. More...
 
static langconvert (?string $content, array $attributes, Parser $parser, PPFrame $frame)
 Returns content converted into the requested language variant, using LanguageConverter. More...
 
static nowiki (?string $content, array $attributes, Parser $parser)
 Core parser tag hook function for 'nowiki'. More...
 
static pre (?string $content, array $attribs, Parser $parser)
 Core parser tag hook function for 'pre'. More...
 
static register ( $parser)
 

Detailed Description

Various tag hooks, registered in every Parser.

Definition at line 30 of file CoreTagHooks.php.

Member Function Documentation

◆ gallery()

static CoreTagHooks::gallery ( ?string  $content,
array  $attributes,
Parser  $parser 
)
static

Core parser tag hook function for 'gallery'.

Renders a thumbnail list of the given images, with optional captions. Full syntax documented on the wiki:

https://www.mediawiki.org/wiki/Help:Images#Gallery_syntax

Todo:
break Parser::renderImageGallery out here too.
Parameters
?string$content
array$attributes
Parser$parser
Returns
string HTML
Access: internal

Definition at line 161 of file CoreTagHooks.php.

References $content, and Parser\renderImageGallery().

◆ html()

static CoreTagHooks::html ( ?string  $content,
array  $attributes,
Parser  $parser 
)
static

Core parser tag hook function for 'html', used only when $wgRawHtml is enabled.

This is potentially unsafe and should be used only in very careful circumstances, as the contents are emitted as raw HTML.

Uses undocumented extended tag hook return values, introduced in r61913.

Parameters
?string$content
array$attributes
Parser$parser
Exceptions
MWException
Returns
array|string Output of tag hook
Access: internal

Definition at line 92 of file CoreTagHooks.php.

References $content, $wgRawHtml, Parser\getOptions(), Html\rawElement(), and wfMessage().

◆ indicator()

static CoreTagHooks::indicator ( ?string  $content,
array  $attributes,
Parser  $parser,
PPFrame  $frame 
)
static

XML-style tag for page status indicators: icons (or short text snippets) usually displayed in the top-right corner of the page, outside of the main content.

Parameters
?string$content
array$attributes
Parser$parser
PPFrame$frame
Returns
string
Since
1.25
Access: internal

Definition at line 178 of file CoreTagHooks.php.

References $content, Parser\getOutput(), Parser\recursiveTagParseFully(), Parser\stripOuterParagraph(), and wfMessage().

◆ langconvert()

static CoreTagHooks::langconvert ( ?string  $content,
array  $attributes,
Parser  $parser,
PPFrame  $frame 
)
static

Returns content converted into the requested language variant, using LanguageConverter.

Parameters
?string$content
array$attributes
Parser$parser
PPFrame$frame
Returns
string
Since
1.36
Access: internal

Definition at line 204 of file CoreTagHooks.php.

References $content, $lang, LanguageCode\bcp47(), Html\rawElement(), Parser\recursiveTagParse(), and wfMessage().

◆ nowiki()

static CoreTagHooks::nowiki ( ?string  $content,
array  $attributes,
Parser  $parser 
)
static

Core parser tag hook function for 'nowiki'.

Text within this section gets interpreted as a string of text with HTML-compatible character references, and wiki markup within it will not be expanded.

Uses undocumented extended tag hook return values, introduced in r61913.

Uses custom html escaping which phan-taint-check won't recognize hence we suppress the error.

Parameters
?string$content
array$attributes
Parser$parser
Returns
array
Access: internal

Definition at line 131 of file CoreTagHooks.php.

References $content.

◆ pre()

static CoreTagHooks::pre ( ?string  $content,
array  $attribs,
Parser  $parser 
)
static

Core parser tag hook function for 'pre'.

Text is treated roughly as 'nowiki' wrapped in an HTML 'pre' tag; valid HTML attributes are passed on.

Parameters
?string$content
array$attribs
Parser$parser
Returns
string HTML
Access: internal

Definition at line 59 of file CoreTagHooks.php.

References $content, StringUtils\delimiterReplace(), Html\rawElement(), and Sanitizer\validateTagAttributes().

◆ register()

static CoreTagHooks::register (   $parser)
static
Access: internal
Parameters
Parser$parser
Returns
void

Definition at line 36 of file CoreTagHooks.php.

References $wgRawHtml.

Referenced by Parser\__construct().


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