Helper tools for dealing with other locally-hosted wikis. More...

Static Public Member Functions
static	foreignUserLink ( $wikiID, $user, $text=null)
	Convenience to get a link to a user page on a foreign wiki. More...

static	getCanonicalServerInfoForAllWikis ()
	Get canonical server info for all local wikis in the map that have one. More...

static	getCurrentWikiDomain ()

static	getForeignURL ( $wikiID, $page, $fragmentId=null)
	Convenience to get a url to a page on a foreign wiki. More...

static	getWiki ( $wikiID)
	Get a WikiReference object for $wikiID. More...

static	getWikiFromUrl ( $url)

static	getWikiIdFromDomain ( $domain)
	Get the wiki ID of a database domain. More...

static	getWikiName ( $wikiID)
	Convenience to get the wiki's display name. More...

static	isCurrentWikiDomain ( $domain)

static	isCurrentWikiId ( $wikiId)

static	makeForeignLink ( $wikiID, $page, $text=null)
	Convenience to get a link to a page on a foreign wiki. More...

Static Private Member Functions
static	getWikiReferenceFromWgConf ( $wikiID)

static	getWikiWikiReferenceFromSites ( $wikiID)

Detailed Description

Helper tools for dealing with other locally-hosted wikis.

Definition at line 29 of file WikiMap.php.

Member Function Documentation

◆ foreignUserLink()

static WikiMap::foreignUserLink	(	$wikiID,
		$user,
		$text = `null`
	)

static

Convenience to get a link to a user page on a foreign wiki.

Parameters

string	$wikiID	Wiki'd id (generally database name)
string	$user	User name (must be normalised before calling this function!)
string \| null	$text	Link's text; optional, default to "User:$user"

Returns: string HTML link or false if the wiki was not found

Definition at line 137 of file WikiMap.php.

Referenced by RightsLogFormatter\makePageLink(), and WikiMapTest\testForeignUserLink().

◆ getCanonicalServerInfoForAllWikis()

static WikiMap::getCanonicalServerInfoForAllWikis ( )

static

Get canonical server info for all local wikis in the map that have one.

Returns: array Map of (local wiki ID => map of (url,parts))

Since: 1.30

Definition at line 187 of file WikiMap.php.

References $cache, $wgCanonicalServer, $wgLocalDatabases, as, and wfParseUrl().

Referenced by WikiMapTest\testGetCanonicalServerInfoForAllWikis().

◆ getCurrentWikiDomain()

static WikiMap::getCurrentWikiDomain ( )

static

Returns: DatabaseDomain Database domain of the current wiki

Since: 1.33

Definition at line 276 of file WikiMap.php.

References $wgDBmwschema, $wgDBname, and $wgDBprefix.

Referenced by MediaWiki\Logger\Monolog\WikiProcessor\__invoke(), MediaWiki\Logger\LegacyLogger\formatAsWfDebugLog(), MediaWiki\Logger\LegacyLogger\formatAsWfLogDBError(), MediaWiki\Interwiki\ClassicInterwikiLookup\getAllPrefixesCached(), ObjectCache\getDefaultKeyspace(), MediaWiki\Interwiki\ClassicInterwikiLookup\getInterwikiCacheEntry(), MachineReadableRCFeedFormatter\getLine(), User\getNewMessageLinks(), Profiler\getProfileID(), UserMailer\makeMsgId(), WikiPage\purgeInterwikiCheckKey(), LockManagerGroup\singleton(), JobQueueGroup\singleton(), and WikiMapTest\testIsCurrentWikiDomain().

◆ getForeignURL()

static WikiMap::getForeignURL	(	$wikiID,
		$page,
		$fragmentId = `null`
	)

static

Convenience to get a url to a page on a foreign wiki.

Parameters

string	$wikiID	Wiki'd id (generally database name)
string	$page	Page name (must be normalised before calling this function!)
string \| null	$fragmentId

Returns: string|bool URL or false if the wiki was not found

Definition at line 171 of file WikiMap.php.

Referenced by Linker\makeCommentLink(), and WikiMapTest\testGetForeignURL().

◆ getWiki()

static WikiMap::getWiki ( $wikiID )

static

Get a WikiReference object for $wikiID.

Parameters

string $wikiID Wiki'd id (generally database name)

Returns: WikiReference|null WikiReference object or null if the wiki was not found

Definition at line 37 of file WikiMap.php.

Referenced by WikiMapTest\testGetWiki().

◆ getWikiFromUrl()

static WikiMap::getWikiFromUrl ( $url )

static

Parameters

string $url

Returns: bool|string Wiki ID or false

Since: 1.30

Definition at line 223 of file WikiMap.php.

References as, and wfParseUrl().

Referenced by MediaWiki\getUrlDomainDistance(), and WikiMapTest\testGetWikiFromUrl().

◆ getWikiIdFromDomain()

static WikiMap::getWikiIdFromDomain ( $domain )

static

Get the wiki ID of a database domain.

This is like DatabaseDomain::getId() without encoding (for legacy reasons) and without the schema if it merely set to the generic value "mediawiki"

Parameters

string | DatabaseDomain $domain

Returns: string

Definition at line 254 of file WikiMap.php.

References null, and true.

Referenced by MediaWiki\Logger\Monolog\WikiProcessor\__invoke(), MediaWiki\Logger\LegacyLogger\formatAsWfDebugLog(), MediaWiki\Logger\LegacyLogger\formatAsWfLogDBError(), MediaWiki\Interwiki\ClassicInterwikiLookup\getAllPrefixesCached(), LinksDeletionUpdate\getAsJobSpecification(), LinksUpdate\getAsJobSpecification(), JobQueueGroup\getCachedConfigVar(), MediaWiki\Interwiki\ClassicInterwikiLookup\getInterwikiCacheEntry(), MachineReadableRCFeedFormatter\getLine(), User\getNewMessageLinks(), JobQueueRedis\getQueueKey(), JobQueueGroup\singleton(), and WikiMapTest\testGetWikiIdFromDomain().

◆ getWikiName()

static WikiMap::getWikiName ( $wikiID )

static

Convenience to get the wiki's display name.

Todo:: We can give more info than just the wiki id!

Parameters

string $wikiID Wiki'd id (generally database name)

Returns: string|int Wiki's name or $wiki_id if the wiki was not found

Definition at line 120 of file WikiMap.php.

Referenced by WikiMapTest\testGetWikiName().

◆ getWikiReferenceFromWgConf()

static WikiMap::getWikiReferenceFromWgConf ( $wikiID )

staticprivate

Parameters

string $wikiID

Returns: WikiReference|null WikiReference object or null if the wiki was not found

Definition at line 51 of file WikiMap.php.

References $path, $wgConf, list, and null.

◆ getWikiWikiReferenceFromSites()

static WikiMap::getWikiWikiReferenceFromSites ( $wikiID )

staticprivate

Parameters

string $wikiID

Returns: WikiReference|null WikiReference object or null if the wiki was not found

Definition at line 86 of file WikiMap.php.

References $path, null, and wfParseUrl().

◆ isCurrentWikiDomain()

static WikiMap::isCurrentWikiDomain ( $domain )

static

Parameters

DatabaseDomain | string $domain

Returns: bool Whether $domain has the same DB/prefix as the current wiki

Since: 1.33

Definition at line 287 of file WikiMap.php.

References null, and true.

Referenced by JobQueueGroup\getCachedConfigVar(), JobQueue\pop(), JobQueueGroup\singleton(), and WikiMapTest\testIsCurrentWikiDomain().

◆ isCurrentWikiId()

static WikiMap::isCurrentWikiId ( $wikiId )

static

Parameters

string $wikiId

Returns: bool Whether $wikiId has the same DB/prefix as the current wiki

Since: 1.33

Definition at line 310 of file WikiMap.php.

Referenced by UserrightsPage\fetchUser(), SiteConfiguration\getConfig(), UserRightsProxy\getDB(), User\getNewMessageRevisionId(), Skin\getNewtalks(), MediaWiki\getUrlDomainDistance(), LocalIdLookup\isAttached(), and WikiMapTest\testIsCurrentWikiId().

◆ makeForeignLink()

static WikiMap::makeForeignLink	(	$wikiID,
		$page,
		$text = `null`
	)

static

Convenience to get a link to a page on a foreign wiki.

Parameters

string	$wikiID	Wiki'd id (generally database name)
string	$page	Page name (must be normalised before calling this function!)
string \| null	$text	Link's text; optional, default to $page

Returns: string|false HTML link or false if the wiki was not found

Definition at line 149 of file WikiMap.php.

References Linker\makeExternalLink().

Referenced by WikiMapTest\testMakeForeignLink().

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

includes/WikiMap.php

Static Public Member Functions

Static Private Member Functions

Detailed Description

Member Function Documentation

◆ foreignUserLink()

◆ getCanonicalServerInfoForAllWikis()

◆ getCurrentWikiDomain()

◆ getForeignURL()

◆ getWiki()

◆ getWikiFromUrl()

◆ getWikiIdFromDomain()

◆ getWikiName()

◆ getWikiReferenceFromWgConf()

◆ getWikiWikiReferenceFromSites()

◆ isCurrentWikiDomain()

◆ isCurrentWikiId()

◆ makeForeignLink()