Base class for template-based skins. More...

Inheritance diagram for SkinTemplate:

[legend]

Collaboration diagram for SkinTemplate:

[legend]

Public Member Functions
	generateHTML ()
	Subclasses not wishing to use the QuickTemplate render method can rewrite this method, for example to use TemplateParser::processTemplate.

	getPersonalToolsList ()
	Get the HTML for the p-personal list.

	getStructuredPersonalTools ()
	Get personal tools for the user.

	makeArticleUrlDetails ( $name, $urlaction='')

	makePersonalToolsList ( $personalTools=null, $options=[])
	Get the HTML for the personal tools list Please ensure setupTemplateContext is called before calling this method.

	outputPage ()
	Initialize various variables and generate the template Stable to override.

	tabAction ( $title, $message, $selected, $query='', $checkEdit=false)
	Builds an array with tab definition.

Public Member Functions inherited from Skin
	__construct ( $options=null)

	aboutLink ()
	Gets the link to the wiki's about page.

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

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

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

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

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

	doEditSectionLink (Title $nt, $section, $tooltip, Language $lang)
	Create a section edit link.

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

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

	getAfterPortlet (string $name)
	Allows extensions to hook into known portlets and add stuff to them.

	getCategories ()

	getCategoryLinks ()

	getCopyright ( $type='detect')

	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.

	getHtmlElementAttributes ()
	Return values for <html> element.

	getIndicatorsHTML ( $indicators)
	Get the suggested HTML for page status indicators: icons (or short text snippets) usually displayed in the top-right corner of the page, outside of the main content.

	getLanguages ()
	Generates array of language links for the current page.

	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)

	getPageClasses ( $title)
	TODO: document.

	getPersonalToolsForMakeListItem ( $urls)
	Create an array of personal tools items from the data in the quicktemplate stored by SkinTemplate.

	getRelevantTitle ()
	Return the "relevant" title.

	getRelevantUser ()
	Return the "relevant" user.

	getRevisionId ()
	Get the current revision ID.

	getSiteFooterLinks ()
	Gets the link to the wiki's privacy policy, about page, and disclaimer page.

	getSiteNotice ()
	Get the site notice.

	getSkinName ()

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

	getUndeleteLink ()

	initPage (OutputPage $out)
	Stable to override.

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

	logoText ( $align='')

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

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

	makeLink ( $key, $item, $options=[])
	Makes a link, usually used by makeListItem to generate a link for an item in a list used in navigation lists, portlets, portals, sidebars, etc...

	makeListItem ( $key, $item, $options=[])
	Generates a list item for a navigation, portlet, portal, sidebar... list.

	makeSearchButton ( $mode, $attrs=[])

	makeSearchInput ( $attrs=[])

	makeToolbox ( $navUrls, $feedUrls)
	Create an array of common toolbox items from the data in the quicktemplate stored by SkinTemplate.

	mapInterwikiToLanguage ( $code)
	Allows correcting the language of interlanguage links which, mostly due to legacy reasons, do not always match the standards compliant language tag.

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

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

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

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

	setupSkinUserCss (OutputPage $out)
	Hook point for adding style modules to OutputPage.

	showEmailUser ( $id)

	subPageSubtitle ( $out=null)

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

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

	getConfig ()

	getContext ()
	Get the base IContextSource object.

	getLanguage ()

	getOutput ()

	getRequest ()

	getSkin ()

	getStats ()

	getTiming ()

	getTitle ()

	getUser ()
	Stable to override.

	getWikiPage ()
	Get the WikiPage object.

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

	setContext (IContextSource $context)

Public Attributes
	$loggedin

string	$skinname = 'monobook'
	Name of our skin, it probably needs to be all lower case.

string	$template = QuickTemplate::class
	For QuickTemplate, the name of the subclass which will actually fill the template.

	$thispage

	$thisquery

	$titletxt

	$username

	$userpage

	$userpageUrlDetails

Public Attributes inherited from Skin
string	$stylename = null
	Stylesheets set to use.

Protected Member Functions
	buildContentNavigationUrls ()
	a structured array of links usually used for the tabs in a skin

	buildNavUrls ()
	build array of common navigation links and run the SkinTemplateBuildNavUrlsNav_urlsAfterPermalink hook.

	buildPersonalUrls ()
	build array of urls for personal toolbar Please ensure setupTemplateContext is called before calling this method.

	getFooterIcons ()
	Get template representation of the footer.

	getJsConfigVars ()
	Returns array of config variables that should be added only to this skin for use in JavaScript.

	getNameSpaceKey ()
	Generate strings used for xml 'id' names.

	prepareQuickTemplate ()
	initialize various variables and generate the template

	prepareSubtitle ()
	Prepare the subtitle of the page for output in the skin if one has been set.

	prepareUndeleteLink ()
	Prepare undelete link for output in page.

	prepareUserLanguageAttributes ()
	Prepare user language attribute links.

	setupTemplate ( $classname)
	Create the template engine object; we feed it a bunch of data and eventually it spits out some HTML.

	setupTemplateContext ()
	Setup class properties that are necessary prior to calling setupTemplateForOutput.

	setupTemplateForOutput ()

	wrapHTML ( $title, $html)
	Wrap the body text with language information and identifiable element.

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

	buildFeedUrls ()
	Build data structure representing syndication links.

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

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

	getCopyrightIcon ()

	getFooterLinks ()
	Get template representation of the footer containing site footer links as well as standard footer links.

	getIndicatorsData ( $indicators)
	Return an array of indicator data.

	getLogo ()
	URL to the default square logo (1x key) Please use ResourceLoaderSkinModule::getAvailableLogos.

	getPoweredBy ()
	Gets the powered by MediaWiki icon.

	getSearchLink ()

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

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

Private Member Functions
	buildContentActionUrls ( $content_navigation)
	an array of edit links by default used for the tabs

	getWatchLinkAttrs (string $mode, User $user, Title $title, ?string $action, bool $onPage)
	Get the attributes for the watch link.

	makeTalkUrlDetails ( $name, $urlaction='')

Additional Inherited Members
Static Public Member Functions inherited from Skin
static	checkTitle (&$title, $name)
	make sure we have some title to operate on

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

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

static	getSkinNames ()
	Fetch the set of available skins.

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

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

static	makeMainPageUrl ( $urlaction='')

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

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

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

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

static	makeVariablesScript ( $data, $nonce=null)

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

Static Protected Member Functions inherited from Skin
static	makeKnownUrlDetails ( $name, $urlaction='')
	Make URL details where the article exists (or at least it's convenient to think so)

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

Protected Attributes inherited from Skin
	$mRelevantTitle = null

	$mRelevantUser = null

array	$options = []
	Skin options passed into constructor.

string null	$skinname = null

Detailed Description

Base class for template-based skins.

Template-filler skin base class Formerly generic PHPTal (http://phptal.sourceforge.net/) skin Based on Brion's smarty skin

Note: Copyright © Gabriel Wicke – http://www.aulinx.de/

Todo: Needs some serious refactoring into functions that correspond to the computations individual esi snippets need. Most importantly no body parsing for most of those of course.

Stable to extend

Definition at line 39 of file SkinTemplate.php.

Member Function Documentation

◆ buildContentActionUrls()

SkinTemplate::buildContentActionUrls ( $content_navigation )

private

an array of edit links by default used for the tabs

Parameters

array $content_navigation

Returns: array

Definition at line 1162 of file SkinTemplate.php.

References wfDebug().

◆ buildContentNavigationUrls()

SkinTemplate::buildContentNavigationUrls ( )

protected

a structured array of links usually used for the tabs in a skin

There are 4 standard sections namespaces: Used for namespace tabs like special, page, and talk namespaces views: Used for primary page views like read, edit, history actions: Used for most extra page actions like deletion, protection, etc... variants: Used to list the language variants for the page

Each section's value is a key/value array of links for that section. The links themselves have these common keys:

class: The css classes to apply to the tab
text: The text to display on the tab
href: The href for the tab to point to
rel: An optional rel= for the tab's link
redundant: If true the tab will be dropped in skins using content_actions this is useful for tabs like "Read" which only have meaning in skins that take special meaning from the grouped structure of content_navigation

Views also have an extra key which can be used:

primary: If this is not true skins like vector may try to hide the tab when the user has limited space in their browser window

content_navigation using code also expects these ids to be present on the links, however these are usually automatically generated by SkinTemplate itself and are not necessary when using a hook. The only things these may matter to are people modifying content_navigation after it's initial creation:

id: A "preferred" id, most skins are best off outputting this preferred id for best compatibility.
tooltiponly: This is set to true for some tabs in cases where the system believes that the accesskey should not be added to the tab.

Returns: array

Definition at line 833 of file SkinTemplate.php.

References $title, getContext(), Title\getLocalURL(), getTitle(), SpecialPage\getTitleFor(), getUser(), User\isWatched(), NS_MEDIAWIKI, true, and wfMessageFallback().

◆ buildNavUrls()

SkinTemplate::buildNavUrls ( )

protected

build array of common navigation links and run the SkinTemplateBuildNavUrlsNav_urlsAfterPermalink hook.

Build array of common navigation links.Assumes thispage property has been set before execution.

Since: 1.35

Returns: array

Returns: array

Reimplemented from Skin.

Definition at line 1203 of file SkinTemplate.php.

◆ buildPersonalUrls()

SkinTemplate::buildPersonalUrls ( )

protected

build array of urls for personal toolbar Please ensure setupTemplateContext is called before calling this method.

Returns: array

Definition at line 495 of file SkinTemplate.php.

References $title, getTitle(), getUser(), Title\isSpecialPage(), wfArrayToCgi(), and wfCgiToArray().

◆ generateHTML()

SkinTemplate::generateHTML ( )

Subclasses not wishing to use the QuickTemplate render method can rewrite this method, for example to use TemplateParser::processTemplate.

Since: 1.35

Returns: string of complete document HTML to output to the page which includes <!DOCTYPE> and opening and closing html tags.

Reimplemented in SkinMustache.

Definition at line 126 of file SkinTemplate.php.

References prepareQuickTemplate().

Referenced by outputPage().

◆ getFooterIcons()

SkinTemplate::getFooterIcons ( )

protected

Get template representation of the footer.

Since: 1.35

Returns: array

Definition at line 227 of file SkinTemplate.php.

◆ getJsConfigVars()

SkinTemplate::getJsConfigVars ( )

protected

Returns array of config variables that should be added only to this skin for use in JavaScript.

Skins can override this to add variables to the page.

Since: 1.35

Returns: array

Definition at line 154 of file SkinTemplate.php.

Referenced by outputPage().

◆ getNameSpaceKey()

SkinTemplate::getNameSpaceKey ( )

protected

Generate strings used for xml 'id' names.

Deprecated: since 1.35, use Title::getNamespaceKey() instead

Returns: string

Definition at line 1229 of file SkinTemplate.php.

References getTitle().

◆ getPersonalToolsList()

SkinTemplate::getPersonalToolsList ( )

Get the HTML for the p-personal list.

Deprecated: since 1.35, use SkinTemplate::makePersonalToolsList()

Returns: string

Definition at line 443 of file SkinTemplate.php.

◆ getStructuredPersonalTools()

SkinTemplate::getStructuredPersonalTools ( )

Get personal tools for the user.

Since: 1.31

Returns: array Array of personal tools

Definition at line 481 of file SkinTemplate.php.

◆ getWatchLinkAttrs()

SkinTemplate::getWatchLinkAttrs	(	string	$mode,
		User	$user,
		Title	$title,
		?string	$action,
		bool	$onPage )

private

Get the attributes for the watch link.

Parameters

string	$mode	Either 'watch' or 'unwatch'
User	$user
Title	$title
string \| null	$action
bool	$onPage

Returns: array

Definition at line 772 of file SkinTemplate.php.

◆ makeArticleUrlDetails()

SkinTemplate::makeArticleUrlDetails	(		$name,
			$urlaction = '' )

Deprecated: since 1.35, no longer used

Parameters

string	$name
string \| array	$urlaction

Returns: array

Definition at line 752 of file SkinTemplate.php.

References $title, and wfDeprecated().

◆ makePersonalToolsList()

SkinTemplate::makePersonalToolsList	(		$personalTools = null,
			$options = [] )

Get the HTML for the personal tools list Please ensure setupTemplateContext is called before calling this method.

Since: 1.31

Parameters

array \| null	$personalTools
array	$options

Returns: string

Definition at line 457 of file SkinTemplate.php.

◆ makeTalkUrlDetails()

SkinTemplate::makeTalkUrlDetails	(		$name,
			$urlaction = '' )

private

Parameters

string	$name
string \| array	$urlaction

Returns: array

Definition at line 733 of file SkinTemplate.php.

References $title.

◆ outputPage()

SkinTemplate::outputPage ( )

Initialize various variables and generate the template Stable to override.

Reimplemented from Skin.

Definition at line 136 of file SkinTemplate.php.

References generateHTML(), getJsConfigVars(), ContextSource\getOutput(), and Skin\initPage().

◆ prepareQuickTemplate()

SkinTemplate::prepareQuickTemplate ( )

protected

initialize various variables and generate the template

Since: 1.23

Returns: QuickTemplate The template to be executed by outputPage

Definition at line 280 of file SkinTemplate.php.

References $title, ResourceLoaderSkinModule\getAvailableLogos(), getTitle(), SpecialPage\getTitleFor(), wfDebug(), and wfReportTime().

Referenced by generateHTML().

◆ prepareSubtitle()

SkinTemplate::prepareSubtitle ( )

finalprotected

Prepare the subtitle of the page for output in the skin if one has been set.

Since: 1.35

Returns: string HTML

Definition at line 190 of file SkinTemplate.php.

Referenced by SkinMustache\getTemplateData().

◆ prepareUndeleteLink()

SkinTemplate::prepareUndeleteLink ( )

finalprotected

Prepare undelete link for output in page.

Since: 1.35

Returns: null|string HTML, or null if there is no undelete link.

Definition at line 269 of file SkinTemplate.php.

Referenced by SkinMustache\getTemplateData().

◆ prepareUserLanguageAttributes()

SkinTemplate::prepareUserLanguageAttributes ( )

finalprotected

Prepare user language attribute links.

Since: 1.35

Returns: string HTML attributes

Definition at line 204 of file SkinTemplate.php.

Referenced by SkinMustache\getTemplateData().

◆ setupTemplate()

SkinTemplate::setupTemplate ( $classname )

protected

Create the template engine object; we feed it a bunch of data and eventually it spits out some HTML.

Should have interface roughly equivalent to PHPTAL 0.7.

Parameters

string $classname

Returns: QuickTemplate

Reimplemented in SkinVector.

Definition at line 68 of file SkinTemplate.php.

References ContextSource\getConfig().

Referenced by setupTemplateForOutput().

◆ setupTemplateContext()

SkinTemplate::setupTemplateContext ( )

finalprotected

Setup class properties that are necessary prior to calling setupTemplateForOutput.

It must be called inside prepareQuickTemplate. This function may set local class properties that will be used by other methods, but should not make assumptions about the implementation of setupTemplateForOutput

Since: 1.35

Definition at line 90 of file SkinTemplate.php.

References $title, ContextSource\getRequest(), getTitle(), getUser(), and wfArrayToCgi().

Referenced by SkinMustache\generateHTML(), and setupTemplateForOutput().

◆ setupTemplateForOutput()

SkinTemplate::setupTemplateForOutput ( )

protected

Returns: QuickTemplate

Definition at line 75 of file SkinTemplate.php.

References setupTemplate(), and setupTemplateContext().

◆ tabAction()

SkinTemplate::tabAction	(	$title,
		$message,
		$selected,
		$query = '',
		$checkEdit = false )

Builds an array with tab definition.

Parameters

Title	$title	Page Where the tab links to
string \| array	$message	Message key or an array of message keys (will fall back)
bool	$selected	Display the tab as selected
string	$query	Query string attached to tab URL
bool	$checkEdit	Check if $title exists and mark with .new if one doesn't

Returns: array

Definition at line 671 of file SkinTemplate.php.

References $title, getContext(), true, and wfMessageFallback().

◆ wrapHTML()

SkinTemplate::wrapHTML	(		$title,
			$html )

protected

Wrap the body text with language information and identifiable element.

Parameters

Title	$title
string	$html	body text

Returns: string html

Definition at line 165 of file SkinTemplate.php.

References $title, NS_FILE, and NS_SPECIAL.

Referenced by SkinMustache\getTemplateData().

Member Data Documentation

◆ $loggedin

SkinTemplate::$loggedin

Definition at line 56 of file SkinTemplate.php.

◆ $skinname

string SkinTemplate::$skinname = 'monobook'

Name of our skin, it probably needs to be all lower case.

Child classes should override the default.

Definition at line 44 of file SkinTemplate.php.

◆ $template

string SkinTemplate::$template = QuickTemplate::class

For QuickTemplate, the name of the subclass which will actually fill the template.

Child classes should override the default.

Definition at line 50 of file SkinTemplate.php.

Referenced by SkinMustache\generateHTML().

◆ $thispage

SkinTemplate::$thispage

Definition at line 52 of file SkinTemplate.php.

◆ $thisquery

SkinTemplate::$thisquery

Definition at line 55 of file SkinTemplate.php.

◆ $titletxt

SkinTemplate::$titletxt

Definition at line 53 of file SkinTemplate.php.

◆ $username

SkinTemplate::$username

Definition at line 57 of file SkinTemplate.php.

◆ $userpage

SkinTemplate::$userpage

Definition at line 54 of file SkinTemplate.php.

◆ $userpageUrlDetails

SkinTemplate::$userpageUrlDetails

Definition at line 58 of file SkinTemplate.php.

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

includes/skins/SkinTemplate.php

Public Member Functions

Public Attributes

Protected Member Functions

Private Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ buildContentActionUrls()

◆ buildContentNavigationUrls()

◆ buildNavUrls()

◆ buildPersonalUrls()

◆ generateHTML()

◆ getFooterIcons()

◆ getJsConfigVars()

◆ getNameSpaceKey()

◆ getPersonalToolsList()

◆ getStructuredPersonalTools()

◆ getWatchLinkAttrs()

◆ makeArticleUrlDetails()

◆ makePersonalToolsList()

◆ makeTalkUrlDetails()

◆ outputPage()

◆ prepareQuickTemplate()

◆ prepareSubtitle()

◆ prepareUndeleteLink()

◆ prepareUserLanguageAttributes()

◆ setupTemplate()

◆ setupTemplateContext()

◆ setupTemplateForOutput()

◆ tabAction()

◆ wrapHTML()

Member Data Documentation

◆ $loggedin

◆ $skinname

◆ $template

◆ $thispage

◆ $thisquery

◆ $titletxt

◆ $username

◆ $userpage

◆ $userpageUrlDetails