Wikibase\Client\Store\DescriptionLookup Class Reference

Retrieves up page descriptions. More...

Public Member Functions
	__construct (EntityIdLookup $idLookup, TermBuffer $termLookup)
	getDescriptions (array $titles, $sources, &$actualSources=null)
	Look up descriptions for a set of pages.
	getDescription (Title $title, $sources, &$actualSource=null)
	Look up description of a page.

Public Attributes
const	SOURCE_LOCAL = 'local'
	Local description, in the form of a {{SHORTDESC:...}} parser function.
const	SOURCE_CENTRAL = 'central'
	Central description, from a associated Wikibase repo installation.
const	LOCAL_PROPERTY_NAME = 'wikibase-shortdesc'
	page_props key.

Private Member Functions
	getLocalDescriptions (array $titlesByPageId)
	Look up local descriptions (stored in the page wikitext via parser function) for a set of pages.
	getCentralDescriptions (array $titlesByPageId)
	Look up central descriptions (stored in a linked Wikibase instance) for a set of pages.

Private Attributes
	$idLookup
	$termLookup

Detailed Description

Retrieves up page descriptions.

A description is an explanation of what the page is about, in the content language of the page, short enough that it can be used in interface elements such as dropdowns to contextualize or disambiguate pages.

Constructor & Destructor Documentation

__construct()

Wikibase\Client\Store\DescriptionLookup::__construct	(	EntityIdLookup	$idLookup,
		TermBuffer	$termLookup
	)

Member Function Documentation

getCentralDescriptions()

Wikibase\Client\Store\DescriptionLookup::getCentralDescriptions ( array  $titlesByPageId )

private

Look up central descriptions (stored in a linked Wikibase instance) for a set of pages.

Parameters

Title[]

$titlesByPageId

Associative array of page ID => Title object.

Returns

string[] Associative array of page ID => description.

getDescription()

Wikibase\Client\Store\DescriptionLookup::getDescription	(	Title	$title,
			$sources,
		&	$actualSource = null
	)

Look up description of a page.

Convenience wrapper for getDescriptions().

Parameters

Title	$title	Title to look up (will be loaded).
array | string	$sources	One or both of the DescriptionLookup::SOURCE_* constants. When an array is provided, the second element will be used as fallback.
null	$actualSource	Will be set to one of the DescriptionLookup::SOURCE_* constants, indicating where the description came from, or null if no description was found.

Returns

string|null The description, or null if none was found.

getDescriptions()

Wikibase\Client\Store\DescriptionLookup::getDescriptions	(	array	$titles,
			$sources,
		&	$actualSources = null
	)

Look up descriptions for a set of pages.

Parameters

Title[]	$titles	Titles to look up (will be loaded).
array | string	$sources	One or both of the DescriptionLookup::SOURCE_* constants. When an array is provided, the second element will be used as fallback.
null	$actualSources	Will be set to an associative array of page ID => SOURCE_*, indicating where each description came from, or null if no description was found.

Returns

string[] Associative array of page ID => description. Pages with no description will be omitted.

getLocalDescriptions()

Wikibase\Client\Store\DescriptionLookup::getLocalDescriptions ( array  $titlesByPageId )

private

Look up local descriptions (stored in the page wikitext via parser function) for a set of pages.

Parameters

Title[]

$titlesByPageId

Associative array of page ID => Title object.

Returns

string[] Associative array of page ID => description.

Member Data Documentation

$idLookup

Wikibase\Client\Store\DescriptionLookup::$idLookup

private

$termLookup

Wikibase\Client\Store\DescriptionLookup::$termLookup

private

LOCAL_PROPERTY_NAME

const Wikibase\Client\Store\DescriptionLookup::LOCAL_PROPERTY_NAME = 'wikibase-shortdesc'

page_props key.

SOURCE_CENTRAL

const Wikibase\Client\Store\DescriptionLookup::SOURCE_CENTRAL = 'central'

Central description, from a associated Wikibase repo installation.

SOURCE_LOCAL

const Wikibase\Client\Store\DescriptionLookup::SOURCE_LOCAL = 'local'

Local description, in the form of a {{SHORTDESC:...}} parser function.

---

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

• client/includes/Store/DescriptionLookup.php