MediaWiki  1.27.2
MediaWikiPageLinkRenderer Class Reference

A service for generating links from page titles. More...

Inheritance diagram for MediaWikiPageLinkRenderer:
Collaboration diagram for MediaWikiPageLinkRenderer:

Public Member Functions

 __construct (TitleFormatter $formatter, $baseUrl=null)
 
 getPageUrl (LinkTarget $page, $params=[])
 Returns the (partial) URL for the given page (including any section identifier). More...
 
 renderHtmlLink (LinkTarget $linkTarget, $text=null)
 Returns an HTML link to the given page, using the given surface text. More...
 
 renderWikitextLink (LinkTarget $page, $text=null)
 Returns a wikitext link to the given page, using the given surface text. More...
 

Protected Attributes

string $baseUrl
 
TitleFormatter $formatter
 

Detailed Description

A service for generating links from page titles.

See also
https://www.mediawiki.org/wiki/Requests_for_comment/TitleValue
Since
1.23

Definition at line 32 of file MediaWikiPageLinkRenderer.php.

Constructor & Destructor Documentation

MediaWikiPageLinkRenderer::__construct ( TitleFormatter  $formatter,
  $baseUrl = null 
)
Note
$formatter and $baseUrl are currently not used for generating links, since we still rely on the Linker class to generate the actual HTML. Once this is reversed so that Linker becomes a legacy interface to HtmlPageLinkRenderer, we will be using them, so it seems prudent to already declare the dependency and inject them.
Parameters
TitleFormatter$formatterFormatter for generating the target title string
string$baseUrl(currently unused, pending refactoring of Linker). Defaults to $wgArticlePath.

Definition at line 54 of file MediaWikiPageLinkRenderer.php.

References $baseUrl, $formatter, and $GLOBALS.

Member Function Documentation

MediaWikiPageLinkRenderer::getPageUrl ( LinkTarget  $page,
  $params = [] 
)

Returns the (partial) URL for the given page (including any section identifier).

Parameters
LinkTarget$pageThe link's target
array$paramsAny additional URL parameters.
Returns
string

Implements PageLinkRenderer.

Definition at line 71 of file MediaWikiPageLinkRenderer.php.

References $name, $params, MediaWiki\Linker\LinkTarget\getFragment(), wfArrayToCgi(), and wfUrlencode().

MediaWikiPageLinkRenderer::renderHtmlLink ( LinkTarget  $linkTarget,
  $text = null 
)

Returns an HTML link to the given page, using the given surface text.

Parameters
LinkTarget$linkTargetThe link's target
string$textThe link's surface text (will be derived from $page if not given).
Returns
string

Implements PageLinkRenderer.

Definition at line 102 of file MediaWikiPageLinkRenderer.php.

References $link, $title, Linker\link(), and Title\newFromLinkTarget().

MediaWikiPageLinkRenderer::renderWikitextLink ( LinkTarget  $page,
  $text = null 
)

Returns a wikitext link to the given page, using the given surface text.

Parameters
LinkTarget$pageThe link's target
string$textThe link's surface text (will be derived from $page if not given).
Returns
string

Implements PageLinkRenderer.

Definition at line 125 of file MediaWikiPageLinkRenderer.php.

References $name, and wfEscapeWikiText().

Member Data Documentation

string MediaWikiPageLinkRenderer::$baseUrl
protected

Definition at line 41 of file MediaWikiPageLinkRenderer.php.

Referenced by __construct().

TitleFormatter MediaWikiPageLinkRenderer::$formatter
protected

Definition at line 36 of file MediaWikiPageLinkRenderer.php.

Referenced by __construct().


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