This is a utility class with only static functions for dealing with namespaces that encodes all the "magic" behaviors of them based on index. More...

Collaboration diagram for MWNamespace:

[legend]

Static Public Member Functions
static	canTalk ( $index)
	Does this namespace ever have a talk namespace? More...

static	clearCaches ()
	Clear internal caches. More...

static	equals ( $ns1, $ns2)
	Returns whether the specified namespaces are the same namespace. More...

static	exists ( $index)
	Returns whether the specified namespace exists. More...

static	getAssociated ( $index)
	Get the associated namespace. More...

static	getCanonicalIndex ( $name)
	Returns the index for a given canonical name, or NULL The input must be converted to lower case first. More...

static	getCanonicalName ( $index)
	Returns the canonical (English) name for a given index. More...

static	getCanonicalNamespaces ( $rebuild=false)
	Returns array of all defined namespaces with their canonical (English) names. More...

static	getCategoryLinkType ( $index)
	Returns the link type to be used for categories. More...

static	getContentNamespaces ()
	Get a list of all namespace indices which are considered to contain content. More...

static	getNamespaceContentModel ( $index)
	Get the default content model for a namespace This does not mean that all pages in that namespace have the model. More...

static	getRestrictionLevels ( $index, User $user=null)
	Determine which restriction levels it makes sense to use in a namespace, optionally filtered by a user's rights. More...

static	getSubject ( $index)
	Get the subject namespace index for a given namespace Special namespaces (NS_MEDIA, NS_SPECIAL) are always the subject. More...

static	getSubjectNamespaces ()
	List all namespace indices which are considered subject, aka not a talk or special namespace. More...

static	getTalk ( $index)
	Get the talk namespace index for a given namespace. More...

static	getTalkNamespaces ()
	List all namespace indices which are considered talks, aka not a subject or special namespace. More...

static	getValidNamespaces ()
	Returns an array of the namespaces (by integer id) that exist on the wiki. More...

static	hasGenderDistinction ( $index)
	Does the namespace (potentially) have different aliases for different genders. More...

static	hasSubpages ( $index)
	Does the namespace allow subpages? More...

static	hasTalkNamespace ( $index)
	Does this namespace ever have a talk namespace? More...

static	isCapitalized ( $index)
	Is the namespace first-letter capitalized? More...

static	isContent ( $index)
	Does this namespace contain content, for the purposes of calculating statistics, etc? More...

static	isMovable ( $index)
	Can pages in the given namespace be moved? More...

static	isNonincludable ( $index)
	It is not possible to use pages from this namespace as template? More...

static	isSubject ( $index)
	Is the given namespace is a subject (non-talk) namespace? More...

static	isTalk ( $index)
	Is the given namespace a talk namespace? More...

static	isWatchable ( $index)
	Can pages in a namespace be watched? More...

static	subjectEquals ( $ns1, $ns2)
	Returns whether the specified namespaces share the same subject. More...

static	wantSignatures ( $index)
	Might pages in this namespace require the use of the Signature button on the edit toolbar? More...

Static Private Member Functions
static	isMethodValidFor ( $index, $method)
	Throw an exception when trying to get the subject or talk page for a given namespace where it does not make sense. More...

Static Private Attributes
static	$alwaysCapitalizedNamespaces = [ NS_SPECIAL, NS_USER, NS_MEDIAWIKI ]
	These namespaces should always be first-letter capitalized, now and forevermore. More...

static string[] null	$canonicalNamespaces = null
	Canonical namespaces cache. More...

static array false	$namespaceIndexes = false
	Canonical namespaces index cache. More...

static int[] null	$validNamespaces = null
	Valid namespaces cache. More...

Detailed Description

This is a utility class with only static functions for dealing with namespaces that encodes all the "magic" behaviors of them based on index.

The textual names of the namespaces are handled by Language.php.

These are synonyms for the names given in the language file Users and translators should not change them

Definition at line 32 of file MWNamespace.php.

Member Function Documentation

◆ canTalk()

static MWNamespace::canTalk ( $index )

static

Does this namespace ever have a talk namespace?

Deprecated:: since 1.30, use hasTalkNamespace() instead.

Parameters

int $index Namespace index

Returns: bool True if this namespace either is or has a corresponding talk namespace.

Definition at line 308 of file MWNamespace.php.

References hasTalkNamespace().

Referenced by ChangesFeed\buildItems(), and MWNamespaceTest\testCanTalk().

◆ clearCaches()

static MWNamespace::clearCaches ( )

static

Clear internal caches.

For use in unit testing when namespace configuration is changed.

Since: 1.31

Definition at line 76 of file MWNamespace.php.

Referenced by getCanonicalNamespaces(), and MediaWikiTestCase\resetNamespaces().

◆ equals()

static MWNamespace::equals	(	$ns1,
		$ns2
	)

static

Returns whether the specified namespaces are the same namespace.

Note: It's possible that in the future we may start using something other than just namespace indexes. Under that circumstance making use of this function rather than directly doing comparison will make sure that code will not potentially break.

Parameters

int	$ns1	The first namespace index
int	$ns2	The second namespace index

Returns: bool

Since: 1.19

Definition at line 201 of file MWNamespace.php.

Referenced by Title\inNamespace(), and MWNamespaceTest\testEquals().

◆ exists()

static MWNamespace::exists ( $index )

static

Returns whether the specified namespace exists.

Parameters

int $index

Returns: bool

Since: 1.19

Definition at line 182 of file MWNamespace.php.

References getCanonicalNamespaces().

Referenced by NamespaceImportTitleFactory\__construct(), NaiveImportTitleFactory\createTitleFromForeignTitle(), Linker\getInvalidTitleDescription(), Title\isValid(), Title\makeTitleSafe(), TitleCleanup\moveInconsistentPage(), and WikiImporter\setTargetNamespace().

◆ getAssociated()

static MWNamespace::getAssociated ( $index )

static

Get the associated namespace.

For talk namespaces, returns the subject (non-talk) namespace For subject (non-talk) namespaces, returns the talk namespace

Parameters

int $index Namespace index

Returns: int|null If no associated namespace could be found

Definition at line 162 of file MWNamespace.php.

References getSubject(), getTalk(), and isMethodValidFor().

Referenced by ChangesListSpecialPage\buildQuery(), ContribsPager\getNamespaceCond(), MWNamespaceTest\testGetAssociated(), MWNamespaceTest\testGetAssociatedExceptionsForNsMedia(), and MWNamespaceTest\testGetAssociatedExceptionsForNsSpecial().

◆ getCanonicalIndex()

static MWNamespace::getCanonicalIndex ( $name )

static

Returns the index for a given canonical name, or NULL The input must be converted to lower case first.

Parameters

string $name Namespace name

Returns: int

Definition at line 267 of file MWNamespace.php.

References $name, and as.

Referenced by Language\getNsIndex().

◆ getCanonicalName()

static MWNamespace::getCanonicalName ( $index )

static

Returns the canonical (English) name for a given index.

Parameters

int $index Namespace index

Returns: string|bool If no canonical definition.

Definition at line 255 of file MWNamespace.php.

References getCanonicalNamespaces().

Referenced by SpecialContributions\contributionsSub(), RevisionDbTestBase\createPage(), PagePropsTest\createPage(), SpecialPasswordPolicies\execute(), SpecialListGroupRights\execute(), Linker\formatLinksInComment(), SpecialStatistics\getGroupStats(), Title\getNamespaceKey(), Title\getNsText(), DeletedContributionsPage\getSubTitle(), ExternalUserNames\getUserLinkTitle(), Linker\makeCommentLink(), Title\makeName(), Title\moveSubpages(), EditPage\showIntro(), and Article\showMissingArticle().

◆ getCanonicalNamespaces()

static MWNamespace::getCanonicalNamespaces ( $rebuild = false )

static

Returns array of all defined namespaces with their canonical (English) names.

Parameters

bool $rebuild Rebuild namespace list (default = false). Used for testing. Deprecated since 1.31, use self::clearCaches() instead.

Returns: array

Since: 1.17

Definition at line 230 of file MWNamespace.php.

References $canonicalNamespaces, $wgCanonicalNamespaceNames, $wgExtraNamespaces, clearCaches(), ExtensionRegistry\getInstance(), NS_MAIN, and Hooks\run().

Referenced by NamespaceDupes\checkAll(), exists(), getCanonicalName(), ResourceLoaderStartUpModule\getConfigSettings(), ReplaceAll\getNamespaces(), Language\getNamespaces(), and ReplaceAll\listNamespaces().

◆ getCategoryLinkType()

static MWNamespace::getCategoryLinkType ( $index )

static

Returns the link type to be used for categories.

This determines which section of a category page titles in the namespace will appear within.

Since: 1.32

Parameters

int $index Namespace index

Returns: string One of 'subcat', 'file', 'page'

Definition at line 554 of file MWNamespace.php.

References isMethodValidFor(), NS_CATEGORY, and NS_FILE.

Referenced by UpdateCollation\execute(), LinksUpdate\getCategoryInsertions(), MovePage\move(), MWNamespaceTest\testGetCategoryLinkType(), and WikiPage\updateCategoryCounts().

◆ getContentNamespaces()

static MWNamespace::getContentNamespaces ( )

static

Get a list of all namespace indices which are considered to contain content.

Returns: array Array of namespace indices

Definition at line 373 of file MWNamespace.php.

References $wgContentNamespaces, and NS_MAIN.

Referenced by RandomPage\__construct(), SiteStatsInit\articles(), Title\canUseNoindex(), RebuildFileCache\execute(), ResourceLoaderStartUpModule\getConfigSettings(), MediaWikiTestCase\getDefaultWikitextNS(), UncategorizedPagesPage\getOrderFields(), DeadendPagesPage\getOrderFields(), LonelyPagesPage\getOrderFields(), ShortPagesPage\getQueryInfo(), FewestrevisionsPage\getQueryInfo(), MostinterwikisPage\getQueryInfo(), AncientPagesPage\getQueryInfo(), MostcategoriesPage\getQueryInfo(), UncategorizedPagesPage\getQueryInfo(), LonelyPagesPage\getQueryInfo(), DeadendPagesPage\getQueryInfo(), WithoutInterwikiPage\getQueryInfo(), and MWNamespaceTest\testGetContentNamespaces().

◆ getNamespaceContentModel()

static MWNamespace::getNamespaceContentModel ( $index )

static

Get the default content model for a namespace This does not mean that all pages in that namespace have the model.

Since: 1.21

Parameters

int $index Index to check

Returns: null|string Default model name for the given namespace, if set

Definition at line 469 of file MWNamespace.php.

References $wgNamespaceContentModels.

Referenced by ContentHandler\getDefaultModelFor().

◆ getRestrictionLevels()

static MWNamespace::getRestrictionLevels	(		$index,
		User	$user = `null`
	)

static

Determine which restriction levels it makes sense to use in a namespace, optionally filtered by a user's rights.

Since: 1.23

Parameters

int	$index	Index to check
User \| null	$user	User to check

Returns: array

Definition at line 483 of file MWNamespace.php.

References $user, $wgNamespaceProtection, $wgRestrictionLevels, array(), as, User\getGroupsWithPermission(), and use.

Referenced by EditPage\addPageProtectionWarningHeaders(), SkinTemplate\buildContentNavigationUrls(), ProtectionForm\buildSelector(), ProtectionForm\execute(), MediaWiki\EditPage\TextboxBuilder\getTextboxProtectionCSSClasses(), and ProtectionForm\loadData().

◆ getSubject()

static MWNamespace::getSubject ( $index )

static

Get the subject namespace index for a given namespace Special namespaces (NS_MEDIA, NS_SPECIAL) are always the subject.

Parameters

int $index Namespace index

Returns: int

Definition at line 143 of file MWNamespace.php.

References isTalk(), and NS_MAIN.

Referenced by getAssociated(), Title\getNamespaceKey(), Title\getSubjectNsText(), Title\getSubjectPage(), ApiQueryInfo\getTSIDs(), isCapitalized(), MovePage\move(), SpecialReplaceText\namespaceTables(), MediaWiki\Widget\Search\SearchFormWidget\powerSearchBox(), subjectEquals(), SkinTemplate\tabAction(), MWNamespaceTest\testGetSubject(), and SpecialEditWatchlist\watchTitles().

◆ getSubjectNamespaces()

static MWNamespace::getSubjectNamespaces ( )

static

List all namespace indices which are considered subject, aka not a talk or special namespace.

◆ getTalk()

static MWNamespace::getTalk ( $index )

static

Get the talk namespace index for a given namespace.

Parameters

int $index Namespace index

Returns: int

Definition at line 129 of file MWNamespace.php.

References isMethodValidFor(), and isTalk().

Referenced by getAssociated(), NamespaceDupes\getDestinationTitle(), Title\getTalkNsText(), Title\getTalkPage(), ApiQueryInfo\getTSIDs(), MWNamespaceTest\testGetTalk(), MWNamespaceTest\testGetTalkExceptionsForNsMedia(), MWNamespaceTest\testGetTalkExceptionsForNsSpecial(), and SpecialEditWatchlist\watchTitles().

◆ getTalkNamespaces()

static MWNamespace::getTalkNamespaces ( )

static

List all namespace indices which are considered talks, aka not a subject or special namespace.

◆ getValidNamespaces()

static MWNamespace::getValidNamespaces ( )

static

Returns an array of the namespaces (by integer id) that exist on the wiki.

Used primarily by the api in help documentation.

Returns: array

Definition at line 286 of file MWNamespace.php.

References $validNamespaces, and as.

Referenced by MediaWikiTestCase\getDefaultWikitextNS(), ApiHelp\getHelpInternal(), ApiBase\getParameterFromSettings(), TrackingCategories\getTrackingCategories(), SpecialListGroupRights\outputNamespaceProtectionInfo(), ApiBaseTest\provideGetParameterFromSettings(), ApiQueryAllRevisions\run(), ApiQueryAllDeletedRevisions\run(), SpecialSearch\saveNamespaces(), and MediaWiki\Preferences\DefaultPreferencesFactory\searchPreferences().

◆ hasGenderDistinction()

static MWNamespace::hasGenderDistinction ( $index )

static

Does the namespace (potentially) have different aliases for different genders.

Not all languages make a distinction here.

Since: 1.18

Parameters

int $index Index to check

Returns: bool

Definition at line 445 of file MWNamespace.php.

References NS_USER, and NS_USER_TALK.

Referenced by GenderCache\doLinkBatch(), GenderCache\doTitlesArray(), MediaWikiTitleCodec\getNamespaceName(), ApiPageSet\initFromQueryResult(), ApiPageSet\processTitlesArray(), ApiQueryAllPages\run(), and MWNamespaceTest\testHasGenderDistinction().

◆ hasSubpages()

static MWNamespace::hasSubpages ( $index )

static

Does the namespace allow subpages?

Parameters

int $index Index to check

Returns: bool

Definition at line 364 of file MWNamespace.php.

References $wgNamespacesWithSubpages.

Referenced by SubpageImportTitleFactory\__construct(), MWNamespaceTest\assertHasNotSubpages(), MWNamespaceTest\assertHasSubpages(), MovePageForm\doSubmit(), Title\getBaseText(), Title\getEditNotices(), Title\getRootText(), Title\getSubpages(), Title\getSubpageText(), Title\hasSubpages(), Title\isSubpage(), Title\moveSubpages(), Linker\normalizeSubpageLink(), InfoAction\pageCounts(), InfoAction\pageInfo(), WikiImporter\setTargetRootPage(), MovePageForm\showSubpages(), and Skin\subPageSubtitle().

◆ hasTalkNamespace()

static MWNamespace::hasTalkNamespace ( $index )

static

Does this namespace ever have a talk namespace?

Since: 1.30

Parameters

int $index Namespace ID

Returns: bool True if this namespace either is or has a corresponding talk namespace.

Definition at line 320 of file MWNamespace.php.

References NS_MAIN.

Referenced by Title\canHaveTalkPage(), canTalk(), and MWNamespaceTest\testHasTalkNamespace().

◆ isCapitalized()

static MWNamespace::isCapitalized ( $index )

static

Is the namespace first-letter capitalized?

Parameters

int $index Index to check

Returns: bool

Definition at line 417 of file MWNamespace.php.

References $wgCapitalLinkOverrides, $wgCapitalLinks, getSubject(), NS_FILE, and NS_MEDIA.

Referenced by FileRepo\__construct(), UploadForm\addUploadJS(), MWNamespaceTest\assertIsCapitalized(), MWNamespaceTest\assertIsNotCapitalized(), Title\capitalize(), CleanupCaps\execute(), ResourceLoaderStartUpModule\getConfigSettings(), FileRepo\getNameFromTitle(), XmlDumpWriter\namespaces(), and MWNamespaceTest\testIsCapitalizedHardcodedAssertions().

◆ isContent()

static MWNamespace::isContent ( $index )

static

Does this namespace contain content, for the purposes of calculating statistics, etc?

Parameters

int $index Index to check

Returns: bool

Definition at line 331 of file MWNamespace.php.

References $wgContentNamespaces, and NS_MAIN.

Referenced by MWNamespaceTest\assertIsContent(), MWNamespaceTest\assertIsNotContent(), MediaWiki\Linker\LinkRenderer\getLinkClasses(), and Title\isContentPage().

◆ isMethodValidFor()

static MWNamespace::isMethodValidFor	(	$index,
		$method
	)

staticprivate

Throw an exception when trying to get the subject or talk page for a given namespace where it does not make sense.

Special namespaces are defined in includes/Defines.php and have a value below 0 (ex: NS_SPECIAL = -1 , NS_MEDIA = -2)

Parameters

int	$index
string	$method

Exceptions

MWException

Returns: bool

Definition at line 62 of file MWNamespace.php.

References NS_MAIN.

Referenced by getAssociated(), getCategoryLinkType(), and getTalk().

◆ isMovable()

namespace are movable Hooks may change this value to override the return value of MWNamespace::isMovable ( $index )

static

Can pages in the given namespace be moved?

Parameters

int $index Namespace index

Returns: bool

Definition at line 88 of file MWNamespace.php.

References $wgAllowImageMoving, NS_FILE, NS_MAIN, and Hooks\run().

Referenced by Title\checkActionPermissions(), Title\isMovable(), MovePageForm\showForm(), and MWNamespaceTest\testIsMovable().

◆ isNonincludable()

static MWNamespace::isNonincludable ( $index )

static

It is not possible to use pages from this namespace as template?

Since: 1.20

Parameters

int $index Index to check

Returns: bool

Definition at line 456 of file MWNamespace.php.

References $wgNonincludableNamespaces.

Referenced by MWNamespaceTest\testIsNonincludable().

◆ isSubject()

static MWNamespace::isSubject ( $index )

static

Is the given namespace is a subject (non-talk) namespace?

Parameters

int $index Namespace index

Returns: bool

Since: 1.19

Definition at line 108 of file MWNamespace.php.

References isTalk().

Referenced by MWNamespaceTest\assertIsNotSubject(), MWNamespaceTest\assertIsSubject(), NamespaceDupes\getDestinationTitle(), and NamespaceDupes\getTargetList().

◆ isTalk()

static MWNamespace::isTalk ( $index )

static

Is the given namespace a talk namespace?

Parameters

int $index Namespace index

Returns: bool

Definition at line 118 of file MWNamespace.php.

References NS_MAIN.

Referenced by MWNamespaceTest\assertIsNotTalk(), MWNamespaceTest\assertIsTalk(), MediaWikiTestCase\getDefaultWikitextNS(), getSubject(), getTalk(), ApiQueryInfo\getTSIDs(), SpecialEditWatchlist\getWatchlistInfo(), isSubject(), Title\isTalkPage(), DumpNotalkFilter\pass(), and wantSignatures().

◆ isWatchable()

static MWNamespace::isWatchable ( $index )

static

Can pages in a namespace be watched?

Parameters

int $index

Returns: bool

Definition at line 354 of file MWNamespace.php.

References NS_MAIN.

Referenced by MWNamespaceTest\assertIsNotWatchable(), MWNamespaceTest\assertIsWatchable(), and Title\isWatchable().

◆ subjectEquals()

static MWNamespace::subjectEquals	(	$ns1,
		$ns2
	)

static

Returns whether the specified namespaces share the same subject.

eg: NS_USER and NS_USER wil return true, as well NS_USER and NS_USER_TALK will return true.

Parameters

int	$ns1	The first namespace index
int	$ns2	The second namespace index

Returns: bool

Since: 1.19

Definition at line 216 of file MWNamespace.php.

References getSubject().

Referenced by MWNamespaceTest\assertDifferentSubject(), MWNamespaceTest\assertSameSubject(), and Title\hasSubjectNamespace().

◆ wantSignatures()

static MWNamespace::wantSignatures ( $index )

static

Might pages in this namespace require the use of the Signature button on the edit toolbar?

Parameters

int $index Index to check

Returns: bool

Definition at line 343 of file MWNamespace.php.

References $wgExtraSignatureNamespaces, and isTalk().

Member Data Documentation

◆ $alwaysCapitalizedNamespaces

MWNamespace::$alwaysCapitalizedNamespaces = [ NS_SPECIAL, NS_USER, NS_MEDIAWIKI ]

staticprivate

These namespaces should always be first-letter capitalized, now and forevermore.

Historically, they could've probably been lowercased too, but some things are just too ingrained now. :)

Definition at line 39 of file MWNamespace.php.

◆ $canonicalNamespaces

string [] null MWNamespace::$canonicalNamespaces = null

staticprivate

Canonical namespaces cache.

Definition at line 42 of file MWNamespace.php.

Referenced by getCanonicalNamespaces().

◆ $namespaceIndexes

array false MWNamespace::$namespaceIndexes = false

staticprivate

Canonical namespaces index cache.

Definition at line 45 of file MWNamespace.php.

◆ $validNamespaces

int [] null MWNamespace::$validNamespaces = null

staticprivate

Valid namespaces cache.

Definition at line 48 of file MWNamespace.php.

Referenced by getValidNamespaces().

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

includes/MWNamespace.php
docs/hooks.txt

Static Public Member Functions

Static Private Member Functions

Static Private Attributes

Detailed Description

Member Function Documentation

◆ canTalk()

◆ clearCaches()

◆ equals()

◆ exists()

◆ getAssociated()

◆ getCanonicalIndex()

◆ getCanonicalName()

◆ getCanonicalNamespaces()

◆ getCategoryLinkType()

◆ getContentNamespaces()

◆ getNamespaceContentModel()

◆ getRestrictionLevels()

◆ getSubject()

◆ getSubjectNamespaces()

◆ getTalk()

◆ getTalkNamespaces()

◆ getValidNamespaces()

◆ hasGenderDistinction()

◆ hasSubpages()

◆ hasTalkNamespace()

◆ isCapitalized()

◆ isContent()

◆ isMethodValidFor()

◆ isMovable()

◆ isNonincludable()

◆ isSubject()

◆ isTalk()

◆ isWatchable()

◆ subjectEquals()

◆ wantSignatures()

Member Data Documentation

◆ $alwaysCapitalizedNamespaces

◆ $canonicalNamespaces

◆ $namespaceIndexes

◆ $validNamespaces