Wikibase
MediaWiki Wikibase extension
Loading...
Searching...
No Matches
Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler Class Reference

Handler for the HtmlPageLinkRendererEnd hook, used to change the default link text of links to wikibase Entity pages to the respective entity's label. More...

Public Member Functions

 __construct (EntityExistenceChecker $entityExistenceChecker, EntityIdParser $entityIdParser, TermLookup $termLookup, EntityNamespaceLookup $entityNamespaceLookup, InterwikiLookup $interwikiLookup, EntityLinkFormatterFactory $linkFormatterFactory, SpecialPageFactory $specialPageFactory, LanguageFallbackChainFactory $languageFallbackChainFactory, EntityUrlLookup $entityUrlLookup, LinkTargetEntityIdLookup $linkTargetEntityIdLookup, ?string $federatedPropertiesSourceScriptUrl, bool $federatedPropertiesEnabled)
 
 doHtmlPageLinkRendererEnd (LinkRenderer $linkRenderer, Title $target, &$text, array &$customAttribs, RequestContext $context, &$html=null)
 

Static Public Member Functions

static onHtmlPageLinkRendererEnd (LinkRenderer $linkRenderer, LinkTarget $target, bool $isKnown, &$text, array &$extraAttribs, &$ret)
 Special page handling where we want to display meaningful link labels instead of just the items ID.
 

Private Member Functions

 federatedPropsDegradedDoHtmlPageLinkRendererEnd (LinkTarget $linkTarget, &$text, array &$customAttribs)
 Hook handling logic for the HtmlPageLinkRendererEnd hook in case federated properties are enabled, but access to the source wiki failed.
 
 internalDoHtmlPageLinkRendererEnd (LinkRenderer $linkRenderer, Title $target, &$text, array &$customAttribs, RequestContext $context, &$html=null)
 Parts of the hook handling logic for the HtmlPageLinkRendererEnd hook that potentially interact with entity storage.
 
 removeNewClass (string $classes)
 Remove the new class from a space separated list of classes.
 
 termFallbackToTermData (TermFallback $term=null)
 
 parseForeignEntityId (LinkTarget $target)
 
 extractForeignIdString (LinkTarget $linkTarget)
 Should be given an already confirmed valid interwiki link that uses Special:EntityPage to link to an entity on a remote Wikibase.
 
 extractForeignIdStringMainNs (LinkTarget $linkTarget)
 
 extractForeignIdStringSpecialNs (LinkTarget $linkTarget)
 
 shouldConvert (?Title $currentTitle, RequestContext $context)
 Whether we should try to convert links on this page.
 
 getLabelDescriptionLookup (RequestContext $context)
 

Static Private Member Functions

static newFromGlobalState ()
 

Private Attributes

 $entityExistenceChecker
 
 $entityIdParser
 
 $termLookup
 
 $entityNamespaceLookup
 
 $interwikiLookup
 
 $linkFormatterFactory
 
 $specialPageFactory
 
 $languageFallbackChainFactory
 
 $labelDescriptionLookup
 
 $entityUrlLookup
 
 $linkTargetEntityIdLookup
 
 $federatedPropertiesSourceScriptUrl
 
 $federatedPropertiesEnabled
 

Detailed Description

Handler for the HtmlPageLinkRendererEnd hook, used to change the default link text of links to wikibase Entity pages to the respective entity's label.

This is used mainly for listings on special pages or for edit summaries, where it is useful to see pages listed by label rather than their entity ID.

Label lookups are relatively expensive if done repeatedly for individual labels. If possible, labels should be pre-loaded and buffered for later use via the HtmlPageLinkRendererEnd hook.

See also
LabelPrefetchHookHandler
Author
Katie Filbert < aude..nosp@m.wiki.nosp@m.@gmai.nosp@m.l.co.nosp@m.m >

Constructor & Destructor Documentation

◆ __construct()

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::__construct ( EntityExistenceChecker  $entityExistenceChecker,
EntityIdParser  $entityIdParser,
TermLookup  $termLookup,
EntityNamespaceLookup  $entityNamespaceLookup,
InterwikiLookup  $interwikiLookup,
EntityLinkFormatterFactory  $linkFormatterFactory,
SpecialPageFactory  $specialPageFactory,
LanguageFallbackChainFactory  $languageFallbackChainFactory,
EntityUrlLookup  $entityUrlLookup,
LinkTargetEntityIdLookup  $linkTargetEntityIdLookup,
?string  $federatedPropertiesSourceScriptUrl,
bool  $federatedPropertiesEnabled 
)

Member Function Documentation

◆ doHtmlPageLinkRendererEnd()

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::doHtmlPageLinkRendererEnd ( LinkRenderer  $linkRenderer,
Title  $target,
$text,
array &  $customAttribs,
RequestContext  $context,
$html = null 
)
Parameters
LinkRenderer$linkRenderer
Title$target
HtmlArmor | string | null&$text
array&$customAttribs
RequestContext$context
string | null&$html
Returns
bool true to continue processing the link, false to use $html directly for the link

◆ extractForeignIdString()

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::extractForeignIdString ( LinkTarget  $linkTarget)
private

Should be given an already confirmed valid interwiki link that uses Special:EntityPage to link to an entity on a remote Wikibase.

◆ extractForeignIdStringMainNs()

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::extractForeignIdStringMainNs ( LinkTarget  $linkTarget)
private

◆ extractForeignIdStringSpecialNs()

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::extractForeignIdStringSpecialNs ( LinkTarget  $linkTarget)
private

◆ federatedPropsDegradedDoHtmlPageLinkRendererEnd()

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::federatedPropsDegradedDoHtmlPageLinkRendererEnd ( LinkTarget  $linkTarget,
$text,
array &  $customAttribs 
)
private

Hook handling logic for the HtmlPageLinkRendererEnd hook in case federated properties are enabled, but access to the source wiki failed.

Parameters
Title$linkTarget
HtmlArmor | string | null&$text
array&$customAttribs

◆ getLabelDescriptionLookup()

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::getLabelDescriptionLookup ( RequestContext  $context)
private

◆ internalDoHtmlPageLinkRendererEnd()

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::internalDoHtmlPageLinkRendererEnd ( LinkRenderer  $linkRenderer,
Title  $target,
$text,
array &  $customAttribs,
RequestContext  $context,
$html = null 
)
private

Parts of the hook handling logic for the HtmlPageLinkRendererEnd hook that potentially interact with entity storage.

Parameters
LinkRenderer$linkRenderer
Title$target
HtmlArmor | string | null&$text
array&$customAttribs
RequestContext$context
string | null&$html
Returns
bool true to continue processing the link, false to use $html directly for the link

◆ newFromGlobalState()

static Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::newFromGlobalState ( )
staticprivate
Returns
self

◆ onHtmlPageLinkRendererEnd()

static Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::onHtmlPageLinkRendererEnd ( LinkRenderer  $linkRenderer,
LinkTarget  $target,
bool  $isKnown,
$text,
array &  $extraAttribs,
$ret 
)
static

Special page handling where we want to display meaningful link labels instead of just the items ID.

This is only handling special pages right now and gets disabled in normal pages.

See also
https://www.mediawiki.org/wiki/Manual:Hooks/HtmlPageLinkRendererEnd
Parameters
LinkRenderer$linkRenderer
LinkTarget$target
bool$isKnown
HtmlArmor | string | null&$text
array&$extraAttribs
string | null&$ret
Returns
bool true to continue processing the link, false to use $ret directly as the HTML for the link

◆ parseForeignEntityId()

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::parseForeignEntityId ( LinkTarget  $target)
private
Parameters
LinkTarget$target
Returns
EntityId|null

◆ removeNewClass()

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::removeNewClass ( string  $classes)
private

Remove the new class from a space separated list of classes.

Parameters
string$classes
Returns
string

◆ shouldConvert()

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::shouldConvert ( ?Title  $currentTitle,
RequestContext  $context 
)
private

Whether we should try to convert links on this page.

This caches that result within a static variable, thus it can't change (except in phpunit tests).

Parameters
Title | null$currentTitle
RequestContext$context
Returns
bool

◆ termFallbackToTermData()

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::termFallbackToTermData ( TermFallback  $term = null)
private
Parameters
TermFallback | null$term
Returns
string[]|null

Member Data Documentation

◆ $entityExistenceChecker

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::$entityExistenceChecker
private

◆ $entityIdParser

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::$entityIdParser
private

◆ $entityNamespaceLookup

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::$entityNamespaceLookup
private

◆ $entityUrlLookup

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::$entityUrlLookup
private

◆ $federatedPropertiesEnabled

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::$federatedPropertiesEnabled
private

◆ $federatedPropertiesSourceScriptUrl

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::$federatedPropertiesSourceScriptUrl
private

◆ $interwikiLookup

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::$interwikiLookup
private

◆ $labelDescriptionLookup

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::$labelDescriptionLookup
private

◆ $languageFallbackChainFactory

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::$languageFallbackChainFactory
private

◆ $linkFormatterFactory

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::$linkFormatterFactory
private

◆ $linkTargetEntityIdLookup

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::$linkTargetEntityIdLookup
private

◆ $specialPageFactory

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::$specialPageFactory
private

◆ $termLookup

Wikibase\Repo\Hooks\HtmlPageLinkRendererEndHookHandler::$termLookup
private

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