MediaWiki  master
WikiMap Class Reference

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 getCurrentWikiDbDomain ()
 
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 getWikiIdFromDbDomain ( $domain)
 Get the wiki ID of a database domain. More...
 
static getWikiIdFromDomain ( $domain)
 
static getWikiName ( $wikiID)
 Convenience to get the wiki's display name. More...
 
static isCurrentWikiDbDomain ( $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$wikiIDWiki'd id (generally database name)
string$userUser name (must be normalised before calling this function!)
string | null$textLink'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().

◆ getCurrentWikiDbDomain()

◆ getForeignURL()

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

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

Parameters
string$wikiIDWiki'd id (generally database name)
string$pagePage 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$wikiIDWiki'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().

◆ getWikiIdFromDbDomain()

static WikiMap::getWikiIdFromDbDomain (   $domain)
static

◆ getWikiIdFromDomain()

static WikiMap::getWikiIdFromDomain (   $domain)
static
Parameters
string$domain
Returns
string
Deprecated:
Since 1.33; use getWikiIdFromDbDomain()

Definition at line 278 of file WikiMap.php.

◆ 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$wikiIDWiki'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().

◆ isCurrentWikiDbDomain()

static WikiMap::isCurrentWikiDbDomain (   $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 297 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 320 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$wikiIDWiki'd id (generally database name)
string$pagePage name (must be normalised before calling this function!)
string | null$textLink'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: