The main skin class which provides methods and properties for all other skins. More...

Inheritance diagram for Skin:

[legend]

Collaboration diagram for Skin:

[legend]

Public Member Functions
	aboutLink ()
	Gets the link to the wiki's about page. More...

	addToBodyAttributes ( $out, &$bodyAttrs)
	This will be called by OutputPage::headElement when it is creating the "<body>" tag, skins can override it if they have a need to add in any body attributes or classes of their own. More...

	addToSidebar (&$bar, $message)
	Add content from a sidebar system message Currently only used for MediaWiki:Sidebar (but may be used by Extensions) More...

	addToSidebarPlain (&$bar, $text)
	Add content from plain text. More...

	bottomScripts ()
	This gets called shortly before the "</body>" tag. More...

	buildSidebar ()
	Build an array that represents the sidebar(s), the navigation bar among them. More...

	disclaimerLink ()
	Gets the link to the wiki's general disclaimers page. More...

	doEditSectionLink (Title $nt, $section, $tooltip=null, $lang=false)
	Create a section edit link. More...

	drawCategoryBrowser ( $tree)
	Render the array as a series of links. More...

	editUrlOptions ()
	Return URL options for the 'edit page' link. More...

	escapeSearchLink ()

	footerLink ( $desc, $page)
	Returns an HTML link for use in the footer. More...

	getCategories ()

	getCategoryLinks ()

	getCopyright ( $type='detect')

	getCopyrightIcon ()

	getDefaultModules ()
	Defines the ResourceLoader modules that should be added to the skin It is recommended that skins wishing to override call parent::getDefaultModules() and substitute out any modules they wish to change by using a key to look them up. More...

	getHtmlElementAttributes ()
	Return values for <html> element. More...

	getLogo ()
	URL to the logo. More...

	getNewtalks ()
	Gets new talk page messages for the current user and returns an appropriate alert message (or an empty string if there are no messages) More...

	getPageClasses ( $title)
	TODO: document. More...

	getPoweredBy ()
	Gets the powered by MediaWiki icon. More...

	getRelevantTitle ()
	Return the "relevant" title. More...

	getRelevantUser ()
	Return the "relevant" user. More...

	getRevisionId ()
	Get the current revision ID. More...

	getSearchLink ()

	getSiteNotice ()
	Get the site notice. More...

	getSkinName ()

	getSkinStylePath ( $name)
	Return a fully resolved style path url to images or styles stored in the current skins's folder. More...

	getUndeleteLink ()

	initPage (OutputPage $out)

	isRevisionCurrent ()
	Whether the revision displayed is the latest revision of the page. More...

	logoText ( $align='')

	mainPageLink ()
	Gets the link to the wiki's main page. More...

	makeFooterIcon ( $icon, $withImage='withImage')
	Renders a $wgFooterIcons icon according to the method's arguments. More...

	outputPage (OutputPage $out=null)
	Outputs the HTML generated by other functions. More...

	printSource ()
	Text with the permalink to the source page, usually shown on the footer of a printed page. More...

	privacyLink ()
	Gets the link to the wiki's privacy policy page. More...

	setRelevantTitle ( $t)
	Set the "relevant" title. More...

	setRelevantUser ( $u)
	Set the "relevant" user. More...

	setupSkinUserCss (OutputPage $out)
	Add skin specific stylesheets Calling this method with an $out of anything but the same OutputPage inside ->getOutput() is deprecated. More...

	shouldPreloadLogo ()
	Whether the logo should be preloaded with an HTTP link header or not. More...

	showEmailUser ( $id)

	showIPinHeader ()

	subPageSubtitle ( $out=null)

Public Member Functions inherited from ContextSource
	canUseWikiPage ()
	Check whether a WikiPage object can be get with getWikiPage(). More...

	exportSession ()
	Export the resolved user IP, HTTP headers, user ID, and session ID. More...

	getConfig ()
	Get the Config object. More...

	getContext ()
	Get the base IContextSource object. More...

	getLanguage ()
	Get the Language object. More...

	getOutput ()
	Get the OutputPage object. More...

	getRequest ()
	Get the WebRequest object. More...

	getSkin ()
	Get the Skin object. More...

	getStats ()
	Get the Stats object. More...

	getTiming ()
	Get the Timing object. More...

	getTitle ()
	Get the Title object. More...

	getUser ()
	Get the User object. More...

	getWikiPage ()
	Get the WikiPage object. More...

	msg ( $key)
	Get a Message object with context set Parameters are the same as wfMessage() More...

	setContext (IContextSource $context)
	Set the IContextSource object. More...

Static Public Member Functions
static	checkTitle (&$title, $name)
	make sure we have some title to operate on More...

static	getAllowedSkins ()
	Fetch the list of user-selectable skins in regards to $wgSkipSkins. More...

static	getDynamicStylesheetQuery ()
	Get the query to generate a dynamic stylesheet. More...

static	getSkinNameMessages ()
	Fetch the skinname messages for available skins. More...

static	getSkinNames ()
	Fetch the set of available skins. More...

static	makeI18nUrl ( $name, $urlaction='')

static	makeInternalOrExternalUrl ( $name)
	If url string starts with http, consider as external URL, else internal. More...

static	makeKnownUrlDetails ( $name, $urlaction='')
	Make URL details where the article exists (or at least it's convenient to think so) More...

static	makeMainPageUrl ( $urlaction='')

static	makeNSUrl ( $name, $urlaction='', $namespace=NS_MAIN)
	this can be passed the NS number as defined in Language.php More...

static	makeSpecialUrl ( $name, $urlaction='', $proto=null)
	Make a URL for a Special Page using the given query and protocol. More...

static	makeSpecialUrlSubpage ( $name, $subpage, $urlaction='')

static	makeUrl ( $name, $urlaction='')

static	makeUrlDetails ( $name, $urlaction='')
	these return an array with the 'href' and boolean 'exists' More...

static	makeVariablesScript ( $data)

static	normalizeKey ( $key)
	Normalize a skin preference value to a form that can be loaded. More...

Public Attributes
string	$stylename = null
	Stylesheets set to use. More...

Protected Member Functions
	afterContentHook ()
	This runs a hook to allow extensions placing their stuff after content and article metadata (e.g. More...

	generateDebugHTML ()
	Generate debug data HTML for displaying at the bottom of the main content area. More...

	lastModified ()
	Get the timestamp of the latest revision, formatted in user language. More...

	preloadExistence ()
	Preload the existence of three commonly-requested pages in a single query. More...

Protected Attributes
	$mRelevantTitle = null

	$mRelevantUser = null

	$skinname = null

Private Member Functions
	footerLinkTitle ( $desc, $page)

	getCachedNotice ( $name)
	Get a cached notice. More...

Detailed Description

The main skin class which provides methods and properties for all other skins.

See docs/skin.txt for more information.

Definition at line 36 of file Skin.php.

Member Function Documentation

◆ aboutLink()

Skin::aboutLink ( )

Gets the link to the wiki's about page.

Returns: string HTML

Definition at line 1020 of file Skin.php.

References footerLink().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ addToBodyAttributes()

Skin::addToBodyAttributes	(		$out,
		&	$bodyAttrs
	)

This will be called by OutputPage::headElement when it is creating the "<body>" tag, skins can override it if they have a need to add in any body attributes or classes of their own.

Parameters

OutputPage	$out
array	&$bodyAttrs

Definition at line 454 of file Skin.php.

Referenced by OutputPage\headElement().

◆ addToSidebar()

Skin::addToSidebar	(	&	$bar,
			$message
	)

Add content from a sidebar system message Currently only used for MediaWiki:Sidebar (but may be used by Extensions)

This is just a wrapper around addToSidebarPlain() for backwards compatibility

Parameters

array	&$bar
string	$message

Definition at line 1291 of file Skin.php.

References addToSidebarPlain(), plain, and wfMessage().

Referenced by buildSidebar().

◆ addToSidebarPlain()

Skin::addToSidebarPlain	(	&	$bar,
			$text
	)

Add content from plain text.

Since: 1.17

Parameters

array	&$bar
string	$text

Returns: array

Definition at line 1302 of file Skin.php.

References $line, $lines, $link, $title, $wgExternalLinkTarget, $wgNoFollowDomainExceptions, $wgNoFollowLinks, as, captcha-old\count, ContextSource\getConfig(), ContextSource\getTitle(), global, ContextSource\msg(), Title\newFromText(), Title\newMainPage(), MessageCache\singleton(), wfMatchesDomainList(), and wfUrlProtocols().

Referenced by addToSidebar(), and SideBarTest\assertSideBar().

◆ afterContentHook()

Skin::afterContentHook ( )

protected

This runs a hook to allow extensions placing their stuff after content and article metadata (e.g.

categories). Note: This function has nothing to do with afterContent().

This hook is placed here in order to allow using the same hook for all skins, both the SkinTemplate based ones and the older ones, which directly use this class to get their data.

The output of this function gets processed in SkinTemplate::outputPage() for the SkinTemplate based skins, all other skins should directly echo it.

Returns: string Empty by default, if not changed by any hook function.

Definition at line 605 of file Skin.php.

References Hooks\run(), and wfDebug().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ bottomScripts()

Skin::bottomScripts ( )

This gets called shortly before the "</body>" tag.

Returns: string HTML-wrapped JS code to be put before "</body>"

Definition at line 640 of file Skin.php.

References ContextSource\getOutput(), and Hooks\run().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ buildSidebar()

Skin::buildSidebar ( )

Build an array that represents the sidebar(s), the navigation bar among them.

BaseTemplate::getSidebar can be used to simplify the format and id generation in new skins.

The format of the returned array is [ heading => content, ... ], where:

heading is the heading of a navigation portlet. It is either:
- magic string to be handled by the skins ('SEARCH' / 'LANGUAGES' / 'TOOLBOX' / ...)
- a message name (e.g. 'navigation'), the message should be HTML-escaped by the skin
- plain text, which should be HTML-escaped by the skin
content is the contents of the portlet. It is either:
- HTML text (
  - ......
  )
- array of link data in a format accepted by BaseTemplate::makeListItem()
- (for a magic string as a key, any value)

Note that extensions can control the sidebar contents using the SkinBuildSidebar hook and can technically insert anything in here; skin creators are expected to handle values described above.

Returns: array

Reimplemented in SkinApi.

Definition at line 1251 of file Skin.php.

References $cache, $wgEnableSidebarCache, $wgSidebarCacheExpiry, addToSidebar(), global, Hooks\run(), and MessageCache\singleton().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ checkTitle()

static Skin::checkTitle	(	&	$title,
			$name
	)

static

make sure we have some title to operate on

Parameters

Title	&$title
string	$name

Definition at line 1221 of file Skin.php.

References $name, $title, and Title\newFromText().

Referenced by SkinTemplate\makeArticleUrlDetails(), makeI18nUrl(), makeKnownUrlDetails(), makeMainPageUrl(), makeNSUrl(), SkinTemplate\makeTalkUrlDetails(), makeUrl(), and makeUrlDetails().

◆ disclaimerLink()

Skin::disclaimerLink ( )

Gets the link to the wiki's general disclaimers page.

Returns: string HTML

Definition at line 1028 of file Skin.php.

References footerLink().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ doEditSectionLink()

Skin::doEditSectionLink	(	Title	$nt,
			$section,
			$tooltip = `null`,
			$lang = `false`
	)

Create a section edit link.

This supersedes editSectionLink() and editSectionLinkForOther().

Parameters

Title	$nt	The title being linked to (may not be the same as the current page, if the section is included from a template)
string	$section	The designation of the section being pointed to, to be included in the link, like "&section=$section"
string	$tooltip	The tooltip to use for the link: will be escaped and wrapped in the 'editsectionhint' message
string	$lang	Language code

Returns: string HTML to use for edit link

Definition at line 1573 of file Skin.php.

References $attribs, $lang, $section, as, Linker\link(), Hooks\run(), wfGetLangObj(), and wfMessage().

◆ drawCategoryBrowser()

Skin::drawCategoryBrowser ( $tree )

Render the array as a series of links.

Parameters

array $tree Categories tree returned by Title::getParentCategoryTree

Returns: string Separated by >, terminate with "\\n"

Definition at line 547 of file Skin.php.

References as, Linker\link(), and Title\newFromText().

Referenced by getCategoryLinks().

◆ editUrlOptions()

Skin::editUrlOptions ( )

Return URL options for the 'edit page' link.

This may include an 'oldid' specifier, if the current page view is such.

Returns: array

Access:\n private

Definition at line 1039 of file Skin.php.

References $options, getRevisionId(), and isRevisionCurrent().

Referenced by SkinTemplate\buildContentNavigationUrls().

◆ escapeSearchLink()

Skin::escapeSearchLink ( )

Returns: string

Definition at line 776 of file Skin.php.

References getSearchLink().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ footerLink()

Skin::footerLink	(	$desc,
		$page
	)

Returns an HTML link for use in the footer.

Parameters

string	$desc	The i18n message key for the link text
string	$page	The i18n message key for the page to link to

Returns: string HTML anchor

Definition at line 977 of file Skin.php.

References $title, footerLinkTitle(), Linker\linkKnown(), and ContextSource\msg().

Referenced by aboutLink(), disclaimerLink(), and privacyLink().

◆ footerLinkTitle()

Skin::footerLinkTitle	(	$desc,
		$page
	)

private

Parameters

string	$desc
string	$page

Returns: Title|null

Definition at line 994 of file Skin.php.

References $title, ContextSource\msg(), Title\newFromText(), and text.

Referenced by footerLink(), and preloadExistence().

◆ generateDebugHTML()

Skin::generateDebugHTML ( )

protected

Generate debug data HTML for displaying at the bottom of the main content area.

Returns: string HTML containing debug data, if enabled (otherwise empty).

Definition at line 631 of file Skin.php.

References MWDebug\getHTMLDebugLog().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ getAllowedSkins()

static Skin::getAllowedSkins ( )

static

Fetch the list of user-selectable skins in regards to $wgSkipSkins.

Useful for Special:Preferences and other places where you only want to show skins users can use.

Returns: string[]

Since: 1.23

Definition at line 74 of file Skin.php.

References $wgSkipSkins, as, getSkinNames(), and global.

Referenced by Preferences\generateSkinOptions(), and ApiParse\getAllowedParams().

◆ getCachedNotice()

Skin::getCachedNotice ( $name )

private

Get a cached notice.

Parameters

string $name Message name, or 'default' for $wgSiteNotice

Returns: string|bool HTML fragment, or false to indicate that the caller should fall back to the next notice in its sequence

Definition at line 1487 of file Skin.php.

References $cache, $name, $wgContLang, $wgRenderHashAppend, $wgSiteNotice, ContextSource\getOutput(), global, ContextSource\msg(), Html\rawElement(), and use.

Referenced by getSiteNotice().

◆ getCategories()

Skin::getCategories ( )

Returns: string HTML

Definition at line 570 of file Skin.php.

References $out, getCategoryLinks(), ContextSource\getOutput(), ContextSource\getTitle(), ContextSource\getUser(), NS_CATEGORY, and Html\rawElement().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ getCategoryLinks()

Skin::getCategoryLinks ( )

Returns: string HTML

Definition at line 479 of file Skin.php.

References $link, $out, $s, $t, $title, $wgUseCategoryBrowser, captcha-old\count, drawCategoryBrowser(), ContextSource\getOutput(), ContextSource\getTitle(), ContextSource\getUser(), global, Linker\link(), ContextSource\msg(), Title\newFromText(), NS_CATEGORY, and wfMessage().

Referenced by getCategories().

◆ getCopyright()

Skin::getCopyright ( $type = 'detect' )

Parameters

string $type

Returns: string

Definition at line 784 of file Skin.php.

References $link, $title, $type, $wgRightsPage, $wgRightsText, $wgRightsUrl, ContextSource\getTitle(), global, isRevisionCurrent(), Linker\linkKnown(), Linker\makeExternalLink(), ContextSource\msg(), Title\newFromText(), and Hooks\run().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ getCopyrightIcon()

Skin::getCopyrightIcon ( )

Returns: null|string

Definition at line 830 of file Skin.php.

References $out, $wgFooterIcons, $wgRightsIcon, $wgRightsText, $wgRightsUrl, and global.

Referenced by SkinTemplate\prepareQuickTemplate().

◆ getDefaultModules()

Skin::getDefaultModules ( )

Defines the ResourceLoader modules that should be added to the skin It is recommended that skins wishing to override call parent::getDefaultModules() and substitute out any modules they wish to change by using a key to look them up.

For style modules, use setupSkinUserCss() instead.

Returns: array Array of modules with helper keys for easy overriding

Definition at line 159 of file Skin.php.

References $modules, $out, $user, $wgEnableAPI, $wgEnableWriteAPI, $wgUseAjax, ContextSource\getConfig(), ContextSource\getOutput(), getRelevantTitle(), and global.

◆ getDynamicStylesheetQuery()

static Skin::getDynamicStylesheetQuery ( )

static

Get the query to generate a dynamic stylesheet.

Returns: array

Definition at line 383 of file Skin.php.

References $wgSquidMaxage, and global.

Referenced by FileRepo\getDescriptionStylesheetUrl().

◆ getHtmlElementAttributes()

Skin::getHtmlElementAttributes ( )

Return values for <html> element.

Returns: array Array of associative name-to-value elements for <html> element

Definition at line 438 of file Skin.php.

References $lang, and ContextSource\getLanguage().

Referenced by OutputPage\headElement().

◆ getLogo()

Skin::getLogo ( )

URL to the logo.

Returns: string

Definition at line 462 of file Skin.php.

References $wgLogo, and global.

Referenced by logoText().

◆ getNewtalks()

Skin::getNewtalks ( )

Gets new talk page messages for the current user and returns an appropriate alert message (or an empty string if there are no messages)

Returns: string

Reimplemented in SkinApi.

Definition at line 1394 of file Skin.php.

References $newtalks, $out, $user, as, captcha-old\count, Xml\element(), ContextSource\getOutput(), ContextSource\getUser(), Linker\linkKnown(), ContextSource\msg(), Revision\newFromTitle(), Hooks\run(), and wfWikiID().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ getPageClasses()

Skin::getPageClasses ( $title )

TODO: document.

Parameters

Title $title

Returns: string

Reimplemented in SkinVector.

Definition at line 410 of file Skin.php.

References $name, $title, $type, list, and SpecialPageFactory\resolveAlias().

Referenced by OutputPage\headElement().

◆ getPoweredBy()

Skin::getPoweredBy ( )

Gets the powered by MediaWiki icon.

Returns: string

Definition at line 860 of file Skin.php.

References $wgResourceBasePath, global, and Hooks\run().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ getRelevantTitle()

Skin::getRelevantTitle ( )

Return the "relevant" title.

A "relevant" title is not necessarily the actual title of the page. Special pages like Special:MovePage use set the page they are acting on as their "relevant" title, this allows the skin system to display things such as content tabs which belong to to that page instead of displaying a basic special page tab which has almost no meaning.

Returns: Title

Definition at line 309 of file Skin.php.

References $mRelevantTitle, and ContextSource\getTitle().

Referenced by SkinTemplate\buildContentNavigationUrls(), getDefaultModules(), getRelevantUser(), and preloadExistence().

◆ getRelevantUser()

Skin::getRelevantUser ( )

Return the "relevant" user.

A "relevant" user is similar to a relevant title. Special pages like Special:Contributions mark the user which they are relevant to so that things like the toolbox can display the information they usually are only able to display on a user's userpage and talkpage.

Returns: User

Definition at line 333 of file Skin.php.

References $mRelevantUser, $title, $user, getRelevantTitle(), User\isIP(), User\newFromName(), and NS_USER.

Referenced by SkinTemplate\buildNavUrls().

◆ getRevisionId()

Skin::getRevisionId ( )

Get the current revision ID.

Returns: int

Definition at line 276 of file Skin.php.

References ContextSource\getOutput().

Referenced by SkinTemplate\buildNavUrls(), editUrlOptions(), isRevisionCurrent(), lastModified(), and printSource().

◆ getSearchLink()

Skin::getSearchLink ( )

Returns: string

Definition at line 768 of file Skin.php.

References SpecialPage\getTitleFor().

Referenced by escapeSearchLink().

◆ getSiteNotice()

Skin::getSiteNotice ( )

Get the site notice.

Returns: string HTML fragment

Reimplemented in SkinApi.

Definition at line 1537 of file Skin.php.

References getCachedNotice(), ContextSource\getUser(), and Hooks\run().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ getSkinName()

Skin::getSkinName ( )

Returns: string Skin name

Definition at line 139 of file Skin.php.

References $skinname.

Referenced by OutputPage\headElement().

◆ getSkinNameMessages()

static Skin::getSkinNameMessages ( )

static

Fetch the skinname messages for available skins.

Returns: string[]

Definition at line 59 of file Skin.php.

References $messages, and as.

◆ getSkinNames()

static Skin::getSkinNames ( )

static

Fetch the set of available skins.

Returns: array Associative array of strings

Definition at line 51 of file Skin.php.

References SkinFactory\getDefaultInstance().

Referenced by ResourceLoaderContext\__construct(), getAllowedSkins(), ResourceLoaderFileModule\getAllSkinStyleFiles(), ResourceLoaderStartUpModule\getConfigSettings(), EditPage\isWrongCaseCssJsPage(), normalizeKey(), and SpecialGadgets\showMainForm().

◆ getSkinStylePath()

Skin::getSkinStylePath ( $name )

Return a fully resolved style path url to images or styles stored in the current skins's folder.

This method returns a url resolved using the configured skin style path and includes the style version inside of the url.

Requires $stylename to be set, otherwise throws MWException.

Parameters

string $name The name or path of a skin resource file

Returns: string The fully resolved style path url including styleversion

Exceptions

MWException

Definition at line 1077 of file Skin.php.

References $wgStylePath, $wgStyleVersion, class, and global.

◆ getUndeleteLink()

Skin::getUndeleteLink ( )

Returns: string HTML

Definition at line 674 of file Skin.php.

References ContextSource\getRequest(), ContextSource\getTitle(), SpecialPage\getTitleFor(), ContextSource\getUser(), Linker\linkKnown(), and ContextSource\msg().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ initPage()

Skin::initPage ( OutputPage $out )

Parameters

OutputPage $out

Reimplemented in SkinVector, and SkinFallback.

Definition at line 146 of file Skin.php.

References preloadExistence().

Referenced by SkinTemplate\outputPage().

◆ isRevisionCurrent()

Skin::isRevisionCurrent ( )

Whether the revision displayed is the latest revision of the page.

Returns: bool

Definition at line 285 of file Skin.php.

References getRevisionId(), and ContextSource\getTitle().

Referenced by SkinTemplate\buildContentNavigationUrls(), editUrlOptions(), getCopyright(), and SkinTemplate\prepareQuickTemplate().

◆ lastModified()

Skin::lastModified ( )

protected

Get the timestamp of the latest revision, formatted in user language.

Returns: string

Definition at line 884 of file Skin.php.

References $s, $t, ContextSource\getLanguage(), ContextSource\getOutput(), getRevisionId(), Revision\getTimestampFromId(), ContextSource\getTitle(), ContextSource\getUser(), ContextSource\msg(), and wfGetLB().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ logoText()

Skin::logoText ( $align = '' )

Parameters

string $align

Returns: string

Definition at line 911 of file Skin.php.

References $s, getLogo(), ContextSource\msg(), and Title\newMainPage().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ mainPageLink()

Skin::mainPageLink ( )

Gets the link to the wiki's main page.

Returns: string

Definition at line 962 of file Skin.php.

References $s, Linker\linkKnown(), ContextSource\msg(), and Title\newMainPage().

◆ makeFooterIcon()

Skin::makeFooterIcon	(	$icon,
		$withImage = `'withImage'`
	)

Renders a $wgFooterIcons icon according to the method's arguments.

Parameters

array	$icon	The icon to build the html for, see $wgFooterIcons for the format of this array.
bool \| string	$withImage	Whether to use the icon's image or output a text-only footericon.

Returns: string HTML

Definition at line 936 of file Skin.php.

References $html, $wgExternalLinkTarget, Html\element(), global, and Html\rawElement().

◆ makeI18nUrl()

static Skin::makeI18nUrl	(	$name,
		$urlaction = `''`
	)

static

Parameters

string	$name
string	$urlaction

Returns: string

Definition at line 1137 of file Skin.php.

References $name, $title, checkTitle(), Title\newFromText(), text, and wfMessage().

◆ makeInternalOrExternalUrl()

static Skin::makeInternalOrExternalUrl ( $name )

static

If url string starts with http, consider as external URL, else internal.

Parameters

string $name

Returns: string URL

Definition at line 1161 of file Skin.php.

References $name, makeUrl(), and wfUrlProtocols().

Referenced by EmailNotification\composeCommonMailtext(), LoginSignupSpecialPage\getFieldDefinitions(), EditPage\showIntro(), EditPage\showStandardInputs(), and CologneBlueTemplate\sysLinks().

◆ makeKnownUrlDetails()

static Skin::makeKnownUrlDetails	(	$name,
		$urlaction = `''`
	)

static

Make URL details where the article exists (or at least it's convenient to think so)

Parameters

string	$name	Article name
string	$urlaction

Returns: array

Definition at line 1205 of file Skin.php.

References $name, $title, checkTitle(), Title\newFromText(), and true.

Referenced by SkinTemplate\setupTemplateForOutput().

◆ makeMainPageUrl()

static Skin::makeMainPageUrl ( $urlaction = '' )

static

Parameters

string $urlaction

Returns: string

Definition at line 1094 of file Skin.php.

References $title, checkTitle(), and Title\newMainPage().

Referenced by SkinTemplate\buildNavUrls().

◆ makeNSUrl()

static Skin::makeNSUrl	(	$name,
		$urlaction = `''`,
		$namespace = `NS_MAIN`
	)

static

this can be passed the NS number as defined in Language.php

Parameters

string	$name
string	$urlaction
int	$namespace

Returns: string

Definition at line 1176 of file Skin.php.

References $name, $title, checkTitle(), and Title\makeTitleSafe().

◆ makeSpecialUrl()

static Skin::makeSpecialUrl	(	$name,
		$urlaction = `''`,
		$proto = `null`
	)

static

Make a URL for a Special Page using the given query and protocol.

If $proto is set to null, make a local URL. Otherwise, make a full URL with the protocol specified.

Parameters

string	$name	Name of the Special page
string	$urlaction	Query to append
string \| null	$proto	Protocol to use or null for a local URL

Returns: string

Definition at line 1112 of file Skin.php.

References $name, $title, and SpecialPage\getSafeTitleFor().

Referenced by SkinTemplate\buildNavUrls(), and SkinTemplate\buildPersonalUrls().

◆ makeSpecialUrlSubpage()

static Skin::makeSpecialUrlSubpage	(	$name,
		$subpage,
		$urlaction = `''`
	)

static

Parameters

string	$name
string	$subpage
string	$urlaction

Returns: string

Definition at line 1127 of file Skin.php.

References $name, $title, and SpecialPage\getSafeTitleFor().

Referenced by SkinTemplate\buildNavUrls(), and SkinTemplate\buildPersonalUrls().

◆ makeUrl()

static Skin::makeUrl	(	$name,
		$urlaction = `''`
	)

static

Parameters

string	$name
string	$urlaction

Returns: string

Definition at line 1148 of file Skin.php.

References $name, $title, checkTitle(), and Title\newFromText().

Referenced by Action\addHelpLink(), SpecialPage\addHelpLink(), Article\addHelpLink(), and makeInternalOrExternalUrl().

◆ makeUrlDetails()

static Skin::makeUrlDetails	(	$name,
		$urlaction = `''`
	)

static

these return an array with the 'href' and boolean 'exists'

Parameters

string	$name
string	$urlaction

Returns: array

Definition at line 1189 of file Skin.php.

References $name, $title, checkTitle(), and Title\newFromText().

Referenced by SkinTemplate\setupTemplateForOutput().

◆ makeVariablesScript()

static Skin::makeVariablesScript ( $data )

static

Parameters

array $data

Returns: string

Definition at line 368 of file Skin.php.

◆ normalizeKey()

static Skin::normalizeKey ( $key )

static

Normalize a skin preference value to a form that can be loaded.

If a skin can't be found, it will fall back to the configured default ($wgDefaultSkin), or the hardcoded default ($wgFallbackSkin) if the default skin is unavailable too.

Parameters

string $key 'monobook', 'vector', etc.

Returns: string

Definition at line 95 of file Skin.php.

References $fallback, $wgDefaultSkin, $wgFallbackSkin, getSkinNames(), and global.

Referenced by ApiParse\execute(), User\getDefaultOptions(), and RequestContext\getSkin().

◆ outputPage()

Skin::outputPage ( OutputPage $out = null )

abstract

Outputs the HTML generated by other functions.

Parameters

OutputPage $out

Reimplemented in SkinTemplate.

◆ preloadExistence()

Skin::preloadExistence ( )

protected

Preload the existence of three commonly-requested pages in a single query.

Definition at line 231 of file Skin.php.

References $title, $titles, $user, as, footerLinkTitle(), getRelevantTitle(), ContextSource\getUser(), and Hooks\run().

Referenced by initPage().

◆ printSource()

Skin::printSource ( )

Text with the permalink to the source page, usually shown on the footer of a printed page.

Returns: string HTML text with an URL

Definition at line 656 of file Skin.php.

References getRevisionId(), ContextSource\getTitle(), ContextSource\msg(), and wfExpandIRI().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ privacyLink()

Skin::privacyLink ( )

Gets the link to the wiki's privacy policy page.

Returns: string HTML

Definition at line 1012 of file Skin.php.

References footerLink().

Referenced by SkinTemplate\prepareQuickTemplate().

◆ setRelevantTitle()

Skin::setRelevantTitle ( $t )

Set the "relevant" title.

See also: self::getRelevantTitle()

Parameters

Title $t

Definition at line 295 of file Skin.php.

References $t.

◆ setRelevantUser()

Skin::setRelevantUser ( $u )

Set the "relevant" user.

See also: self::getRelevantUser()

Parameters

User $u

Definition at line 321 of file Skin.php.

◆ setupSkinUserCss()

Skin::setupSkinUserCss ( OutputPage $out )

abstract

Add skin specific stylesheets Calling this method with an $out of anything but the same OutputPage inside ->getOutput() is deprecated.

The $out arg is kept for compatibility purposes with skins.

Parameters

OutputPage $out

Todo:: delete

Reimplemented in SkinVector, SkinTemplate, SkinModern, SkinCologneBlue, SkinMonoBook, SkinApi, and SkinFallback.

◆ shouldPreloadLogo()

Skin::shouldPreloadLogo ( )

Whether the logo should be preloaded with an HTTP link header or not.

Since: 1.29

Returns: bool

Reimplemented in SkinVector.

Definition at line 472 of file Skin.php.

◆ showEmailUser()

Skin::showEmailUser ( $id )

Parameters

User | int $id

Returns: bool

Definition at line 1053 of file Skin.php.

References ContextSource\getUser(), User\newFromId(), and SpecialEmailUser\validateTarget().

Referenced by SkinTemplate\buildNavUrls().

◆ showIPinHeader()

Skin::showIPinHeader ( )

Deprecated:: since 1.27, feature removed

Returns: bool Always false

Definition at line 760 of file Skin.php.

References wfDeprecated().

◆ subPageSubtitle()

Skin::subPageSubtitle ( $out = null )

Parameters

OutputPage $out Defaults to $this->getOutput() if left as null

Returns: string

Definition at line 703 of file Skin.php.

References $lang, $link, $out, $title, as, ContextSource\getLanguage(), ContextSource\getOutput(), MWNamespace\hasSubpages(), Linker\linkKnown(), ContextSource\msg(), Title\newFromText(), and Hooks\run().

Referenced by SkinTemplate\prepareQuickTemplate().

Member Data Documentation

◆ $mRelevantTitle

Skin::$mRelevantTitle = null

protected

Definition at line 38 of file Skin.php.

Referenced by getRelevantTitle().

◆ $mRelevantUser

Skin::$mRelevantUser = null

protected

Definition at line 39 of file Skin.php.

Referenced by getRelevantUser().

◆ $skinname

Skin::$skinname = null

protected

Definition at line 37 of file Skin.php.

Referenced by getSkinName().

◆ $stylename

string Skin::$stylename = null

Stylesheets set to use.

Subdirectory in skins/ where various stylesheets are located. Only needs to be set if you intend to use the getSkinStylePath() method.

Definition at line 45 of file Skin.php.

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

includes/skins/Skin.php

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Private Member Functions

Detailed Description

Member Function Documentation

◆ aboutLink()

◆ addToBodyAttributes()

◆ addToSidebar()

◆ addToSidebarPlain()

◆ afterContentHook()

◆ bottomScripts()

◆ buildSidebar()

◆ checkTitle()

◆ disclaimerLink()

◆ doEditSectionLink()

◆ drawCategoryBrowser()

◆ editUrlOptions()

◆ escapeSearchLink()

◆ footerLink()

◆ footerLinkTitle()

◆ generateDebugHTML()

◆ getAllowedSkins()

◆ getCachedNotice()

◆ getCategories()

◆ getCategoryLinks()

◆ getCopyright()

◆ getCopyrightIcon()

◆ getDefaultModules()

◆ getDynamicStylesheetQuery()

◆ getHtmlElementAttributes()

◆ getLogo()

◆ getNewtalks()

◆ getPageClasses()

◆ getPoweredBy()

◆ getRelevantTitle()

◆ getRelevantUser()

◆ getRevisionId()

◆ getSearchLink()

◆ getSiteNotice()

◆ getSkinName()

◆ getSkinNameMessages()

◆ getSkinNames()

◆ getSkinStylePath()

◆ getUndeleteLink()

◆ initPage()

◆ isRevisionCurrent()

◆ lastModified()

◆ logoText()

◆ mainPageLink()

◆ makeFooterIcon()

◆ makeI18nUrl()

◆ makeInternalOrExternalUrl()

◆ makeKnownUrlDetails()

◆ makeMainPageUrl()

◆ makeNSUrl()

◆ makeSpecialUrl()

◆ makeSpecialUrlSubpage()

◆ makeUrl()

◆ makeUrlDetails()

◆ makeVariablesScript()

◆ normalizeKey()

◆ outputPage()

◆ preloadExistence()

◆ printSource()

◆ privacyLink()

◆ setRelevantTitle()

◆ setRelevantUser()

◆ setupSkinUserCss()

◆ shouldPreloadLogo()

◆ showEmailUser()

◆ showIPinHeader()

◆ subPageSubtitle()

Member Data Documentation

◆ $mRelevantTitle

◆ $mRelevantUser

◆ $skinname

◆ $stylename