Wikibase\Client\Usage\UsageTracker Interface Reference

Service interface for tracking the usage of entities across pages on the local wiki. More...

Inheritance diagram for Wikibase\Client\Usage\UsageTracker:

Public Member Functions
	addUsedEntities (int $pageId, array $usages)
	Adds new entity usage information for the given page.
	replaceUsedEntities (int $pageId, array $usages)
	Replaces entity usage information for the given page.
	pruneUsages (int $pageId)
	Removes all usage tracking entries for a given page.

Detailed Description

Service interface for tracking the usage of entities across pages on the local wiki.

See also

docs/usagetracking.wiki

Copyright

GPL-2.0-or-later

Author

Daniel Kinzler

Marius Hoch

Member Function Documentation

addUsedEntities()

Wikibase\Client\Usage\UsageTracker::addUsedEntities	(	int	$pageId,
		array	$usages )

Adds new entity usage information for the given page.

New usage records are added, but old ones are not removed.

Parameters

int	$pageId	The ID of the page the entities are used on.
EntityUsage[]	$usages	A list of entity usages.

See also

Usage tracking for details.

Implemented in Wikibase\Client\Usage\NullUsageTracker, and Wikibase\Client\Usage\Sql\SqlUsageTracker.

pruneUsages()

Wikibase\Client\Usage\UsageTracker::pruneUsages

(

int

$pageId

)

Removes all usage tracking entries for a given page.

Parameters

int

$pageId

Returns

EntityUsage[] the pruned usages

Implemented in Wikibase\Client\Usage\NullUsageTracker, and Wikibase\Client\Usage\Sql\SqlUsageTracker.

replaceUsedEntities()

Wikibase\Client\Usage\UsageTracker::replaceUsedEntities	(	int	$pageId,
		array	$usages )

Replaces entity usage information for the given page.

All usages not present in $usages will be removed.

Parameters

int	$pageId	The ID of the page the entities are used on.
EntityUsage[]	$usages	A list of entity usages.

See also

Usage tracking for details.

Returns

EntityUsage[] Usages that have been removed

Implemented in Wikibase\Client\Usage\NullUsageTracker, and Wikibase\Client\Usage\Sql\SqlUsageTracker.

---

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

• client/includes/Usage/UsageTracker.php