MediaWiki  1.23.6
MediaWikiSite Class Reference

Class representing a MediaWiki site. More...

Inheritance diagram for MediaWikiSite:
Collaboration diagram for MediaWikiSite:

Public Member Functions

 __construct ( $type=self::TYPE_MEDIAWIKI)
 Constructor. More...
 
 getFileUrl ( $path=false)
 Returns the full file path (ie site url + relative file path). More...
 
 getLinkPathType ()
 
 getPageUrl ( $pageName=false)
 
 getRelativeFilePath ()
 Returns the relative file path. More...
 
 getRelativePagePath ()
 Returns the relative page path. More...
 
 normalizePageName ( $pageName)
 Returns the normalized form of the given page title, using the normalization rules of the given site. More...
 
 setFilePath ( $path)
 Sets the relative file path. More...
 
 setPagePath ( $path)
 Sets the relative page path. More...
 
 toDBKey ( $title)
 Returns the database form of the given title. More...
 
- Public Member Functions inherited from Site
 addInterwikiId ( $identifier)
 Adds an interwiki id to the site. More...
 
 addLocalId ( $type, $identifier)
 Adds a local identifier. More...
 
 addNavigationId ( $identifier)
 Adds a navigation id to the site. More...
 
 getAllPaths ()
 Returns the paths as associative array. More...
 
 getDomain ()
 Returns the domain of the site, ie en.wikipedia.org Or false if it's not known. More...
 
 getExtraConfig ()
 Returns the type specific config. More...
 
 getExtraData ()
 Returns the type specific fields. More...
 
 getGlobalId ()
 Returns the global site identifier (ie enwiktionary). More...
 
 getGroup ()
 Gets the type of the site (ie wikipedia). More...
 
 getInternalId ()
 Returns the set internal identifier for the site. More...
 
 getInterwikiIds ()
 Returns the interwiki link identifiers that can be used for this site. More...
 
 getLanguageCode ()
 Returns language code of the sites primary language. More...
 
 getLinkPath ()
 Returns the path used to construct links with or false if there is no such path. More...
 
 getLocalIds ()
 Returns all local ids. More...
 
 getNavigationIds ()
 Returns the equivalent link identifiers that can be used to make the site show up in interfaces such as the "language links" section. More...
 
 getPath ( $pathType)
 Returns the path of the provided type or false if there is no such path. More...
 
 getProtocol ()
 Returns the protocol of the site. More...
 
 getSource ()
 Returns the source of the site data (ie 'local', 'wikidata', 'my-magical-repo'). More...
 
 getType ()
 Returns the type of the site (ie mediawiki). More...
 
 removePath ( $pathType)
 Removes the path of the provided type if it's set. More...
 
 serialize ()
 
 setExtraConfig (array $extraConfig)
 Sets the type specific config. More...
 
 setExtraData (array $extraData)
 Sets the type specific fields. More...
 
 setForward ( $shouldForward)
 Sets if site.tld/path/key:pageTitle should forward users to the page on the actual site, where "key" is the local identifier. More...
 
 setGlobalId ( $globalId)
 Sets the global site identifier (ie enwiktionary). More...
 
 setGroup ( $group)
 Sets the type of the site (ie wikipedia). More...
 
 setInternalId ( $internalId=null)
 Sets the internal identifier for the site. More...
 
 setLanguageCode ( $languageCode)
 Sets language code of the sites primary language. More...
 
 setLinkPath ( $fullUrl)
 Sets the path used to construct links with. More...
 
 setPath ( $pathType, $fullUrl)
 Sets the path used to construct links with. More...
 
 setSource ( $source)
 Sets the source of the site data (ie 'local', 'wikidata', 'my-magical-repo'). More...
 
 shouldForward ()
 Gets if site.tld/path/key:pageTitle should forward users to the page on the actual site, where "key" is the local identifier. More...
 
 unserialize ( $serialized)
 

Static Public Member Functions

static newFromGlobalId ( $globalId)
 
- Static Public Member Functions inherited from Site
static newForType ( $siteType)
 

Public Attributes

const PATH_FILE = 'file_path'
 
const PATH_PAGE = 'page_path'
 
- Public Attributes inherited from Site
const GROUP_NONE = 'none'
 
const ID_EQUIVALENT = 'equivalent'
 
const ID_INTERWIKI = 'interwiki'
 
const PATH_LINK = 'link'
 
const SERIAL_VERSION_ID = '2013-01-23'
 
const SOURCE_LOCAL = 'local'
 
const TYPE_MEDIAWIKI = 'mediawiki'
 
const TYPE_UNKNOWN = 'unknown'
 

Static Private Member Functions

static extractPageRecord ( $externalData, $pageTitle)
 Get normalization record for a given page title from an API response. More...
 

Additional Inherited Members

- Protected Attributes inherited from Site
array $extraConfig = array()
 
array $extraData = array()
 
bool $forward = false
 
string null $globalId = null
 
string $group = self::GROUP_NONE
 
int null $internalId = null
 
string null $languageCode = null
 
array[] $localIds = array()
 Holds the local ids for this site. More...
 
string $source = self::SOURCE_LOCAL
 
string $type = self::TYPE_UNKNOWN
 

Detailed Description

Class representing a MediaWiki site.

Since
1.21

Definition at line 35 of file MediaWikiSite.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWikiSite::__construct (   $type = self::TYPE_MEDIAWIKI)

Constructor.

Since
1.21
Parameters
string$type

Reimplemented from Site.

Definition at line 61 of file MediaWikiSite.php.

References Site\$type.

Member Function Documentation

◆ extractPageRecord()

static MediaWikiSite::extractPageRecord (   $externalData,
  $pageTitle 
)
staticprivate

Get normalization record for a given page title from an API response.

Since
1.21
Parameters
array$externalDataA reply from the API on a external server.
string$pageTitleIdentifies the page at the external site, needing normalization.
Returns
array|boolean a 'page' structure representing the page identified by $pageTitle.

Definition at line 182 of file MediaWikiSite.php.

References array(), and as.

◆ getFileUrl()

MediaWikiSite::getFileUrl (   $path = false)

Returns the full file path (ie site url + relative file path).

The path should go at the $1 marker. If the $path argument is provided, the marker will be replaced by it's value.

Since
1.21
Parameters
string | boolean$path
Returns
string

Definition at line 342 of file MediaWikiSite.php.

References $path, and Site\getPath().

Referenced by normalizePageName().

◆ getLinkPathType()

MediaWikiSite::getLinkPathType ( )
See also
Site::getLinkPathType Returns Site::PATH_PAGE
Since
1.21
Returns
string

Reimplemented from Site.

Definition at line 254 of file MediaWikiSite.php.

References PATH_PAGE.

◆ getPageUrl()

MediaWikiSite::getPageUrl (   $pageName = false)
See also
Site::getPageUrl

This implementation returns a URL constructed using the path returned by getLinkPath(). In addition to the default behavior implemented by Site::getPageUrl(), this method converts the $pageName to DBKey-format by replacing spaces with underscores before using it in the URL.

Since
1.21
Parameters
string | boolean$pageNamePage name or false (default: false)
Returns
string

Reimplemented from Site.

Definition at line 316 of file MediaWikiSite.php.

References Site\getLinkPath(), toDBKey(), and wfUrlencode().

◆ getRelativeFilePath()

MediaWikiSite::getRelativeFilePath ( )

Returns the relative file path.

Since
1.21
Returns
string

Definition at line 276 of file MediaWikiSite.php.

References Site\getPath().

◆ getRelativePagePath()

MediaWikiSite::getRelativePagePath ( )

Returns the relative page path.

Since
1.21
Returns
string

Definition at line 265 of file MediaWikiSite.php.

References Site\getPath().

◆ newFromGlobalId()

static MediaWikiSite::newFromGlobalId (   $globalId)
static
Since
1.21
Deprecated:
Just use the constructor or the factory Site::newForType
Parameters
integer$globalId
Returns
MediaWikiSite

Definition at line 48 of file MediaWikiSite.php.

References Site\$globalId.

◆ normalizePageName()

MediaWikiSite::normalizePageName (   $pageName)

Returns the normalized form of the given page title, using the normalization rules of the given site.

If the given title is a redirect, the redirect weill be resolved and the redirect target is returned.

Note
: This actually makes an API request to the remote site, so beware that this function is slow and depends on an external service.
: If MW_PHPUNIT_TEST is defined, the call to the external site is skipped, and the title is normalized using the local normalization rules as implemented by the Title class.
See also
Site::normalizePageName
Since
1.21
Parameters
string$pageName
Returns
string
Exceptions
MWException

Reimplemented from Site.

Definition at line 97 of file MediaWikiSite.php.

References $args, $ret, $t, array(), UtfNormal\cleanUp(), FormatJson\decode(), Http\get(), getFileUrl(), Title\newFromText(), wfAppendQuery(), and wfDebugLog().

◆ setFilePath()

MediaWikiSite::setFilePath (   $path)

Sets the relative file path.

Since
1.21
Parameters
string$path

Definition at line 298 of file MediaWikiSite.php.

References $path, and Site\setPath().

◆ setPagePath()

MediaWikiSite::setPagePath (   $path)

Sets the relative page path.

Since
1.21
Parameters
string$path

Definition at line 287 of file MediaWikiSite.php.

References $path, and Site\setPath().

◆ toDBKey()

MediaWikiSite::toDBKey (   $title)

Returns the database form of the given title.

Since
1.21
Parameters
string$titlethe target page's title, in normalized form.
Returns
String

Definition at line 74 of file MediaWikiSite.php.

References $title.

Referenced by getPageUrl().

Member Data Documentation

◆ PATH_FILE

const MediaWikiSite::PATH_FILE = 'file_path'

Definition at line 37 of file MediaWikiSite.php.

Referenced by TestSites\getSites().

◆ PATH_PAGE

const MediaWikiSite::PATH_PAGE = 'page_path'

Definition at line 38 of file MediaWikiSite.php.

Referenced by getLinkPathType(), and TestSites\getSites().


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