MediaWiki  REL1_20
BaseTemplate Class Reference

New base template for a skin's template extended from QuickTemplate this class features helper methods that provide common ways of interacting with the data stored in the QuickTemplate. More...

Inheritance diagram for BaseTemplate:
Collaboration diagram for BaseTemplate:

List of all members.

Public Member Functions

 getFooterIcons ($option=null)
 Returns an array of footer icons filtered down by options relevant to how the skin wishes to display them.
 getFooterLinks ($option=null)
 Returns an array of footerlinks trimmed down to only those footer links that are valid.
 getMsg ($name)
 Get a Message object with its context set.
 getPersonalTools ()
 Create an array of personal tools items from the data in the quicktemplate stored by SkinTemplate.
 getSidebar ($options=array())
 getToolbox ()
 Create an array of common toolbox items from the data in the quicktemplate stored by SkinTemplate.
 makeLink ($key, $item, $options=array())
 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=array())
 Generates a list item for a navigation, portlet, portal, sidebar...
 makeSearchButton ($mode, $attrs=array())
 makeSearchInput ($attrs=array())
 msg ($str)
 msgHtml ($str)
 msgWiki ($str)
 An ugly, ugly hack.
 printTrail ()
 Output the basic end-page trail including bottomscripts, reporttime, and debug stuff.

Detailed Description

New base template for a skin's template extended from QuickTemplate this class features helper methods that provide common ways of interacting with the data stored in the QuickTemplate.

Definition at line 1342 of file SkinTemplate.php.


Member Function Documentation

BaseTemplate::getFooterIcons ( option = null)

Returns an array of footer icons filtered down by options relevant to how the skin wishes to display them.

If you pass "icononly" as the option all footer icons which do not have an image icon set will be filtered out. If you pass "nocopyright" then MediaWiki's copyright icon will not be included in the list of footer icons. This is mostly useful for skins which only display the text from footericons instead of the images and don't want a duplicate copyright statement because footerlinks already rendered one.

Returns:

Definition at line 1845 of file SkinTemplate.php.

Referenced by ModernTemplate\execute(), MonoBookTemplate\execute(), and VectorTemplate\execute().

BaseTemplate::getFooterLinks ( option = null)

Returns an array of footerlinks trimmed down to only those footer links that are valid.

If you pass "flat" as an option then the returned array will be a flat array of footer icons instead of a key/value array of footerlinks arrays broken up into categories.

Returns:
array|mixed

Definition at line 1806 of file SkinTemplate.php.

Referenced by ModernTemplate\execute(), MonoBookTemplate\execute(), and VectorTemplate\execute().

BaseTemplate::getMsg ( name)

Get a Message object with its context set.

Parameters:
$namestring message name
Returns:
Message

Definition at line 1350 of file SkinTemplate.php.

References QuickTemplate\getSkin().

Referenced by getSidebar(), msg(), msgHtml(), and msgWiki().

Create an array of personal tools items from the data in the quicktemplate stored by SkinTemplate.

The resulting array is built acording to a format intended to be passed through makeListItem to generate the html. This is in reality the same list as already stored in personal_urls however it is reformatted so that you can just pass the individual items to makeListItem instead of hardcoding the element creation boilerplate.

Returns:
array

Definition at line 1435 of file SkinTemplate.php.

Referenced by ModernTemplate\execute(), MonoBookTemplate\execute(), and VectorTemplate\renderNavigation().

BaseTemplate::getSidebar ( options = array())

Create an array of common toolbox items from the data in the quicktemplate stored by SkinTemplate.

The resulting array is built acording to a format intended to be passed through makeListItem to generate the html.

Returns:
array

Definition at line 1373 of file SkinTemplate.php.

References wfProfileIn(), wfProfileOut(), and wfRunHooks().

Referenced by getSidebar(), VectorTemplate\renderPortals(), and MonoBookTemplate\toolbox().

BaseTemplate::makeLink ( key,
item,
options = array() 
)

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...

Parameters:
$keystring usually a key from the list you are generating this link from.
$itemarray contains some of a specific set of keys.

The text of the link will be generated either from the contents of the "text" key in the $item array, if a "msg" key is present a message by that name will be used, and if neither of those are set the $key will be used as a message name.

If a "href" key is not present makeLink will just output htmlescaped text. The "href", "id", "class", "rel", and "type" keys are used as attributes for the link if present.

If an "id" or "single-id" (if you don't want the actual id to be output on the link) is present it will be used to generate a tooltip and accesskey for the link.

If you don't want an accesskey, set $item['tooltiponly'] = true;

Parameters:
$optionsarray can be used to affect the output of a link. Possible options are:
  • 'text-wrapper' key to specify a list of elements to wrap the text of a link in. This should be an array of arrays containing a 'tag' and optionally an 'attributes' key. If you only have one element you don't need to wrap it in another array. eg: To use ... in all links use array( 'text-wrapper' => array( 'tag' => 'span' ) ) for your options.
  • 'link-class' key can be used to specify additional classes to apply to all links.
  • 'link-fallback' can be used to specify a tag to use instead of "<a>" if there is no link. eg: If you specify 'link-fallback' => 'span' than any non-link will output a "<span>" instead of just text.
Returns:
string

Definition at line 1626 of file SkinTemplate.php.

References $options, $title, Html\rawElement(), Linker\titleAttrib(), and Linker\tooltipAndAccesskeyAttribs().

Referenced by makeListItem().

BaseTemplate::makeListItem ( key,
item,
options = array() 
)

Generates a list item for a navigation, portlet, portal, sidebar...

list

Parameters:
$keystring, usually a key from the list you are generating this link from.
$itemarray, of list item data containing some of a specific set of keys. The "id" and "class" keys will be used as attributes for the list item, if "active" contains a value of true a "active" class will also be appended to class.
$optionsarray

If you want something other than a "<li>" you can pass a tag name such as "tag" => "span" in the $options array to change the tag used. link/content data for the list item may come in one of two forms A "links" key may be used, in which case it should contain an array with a list of links to include inside the list item, see makeLink for the format of individual links array items.

Otherwise the relevant keys from the list item $item array will be passed to makeLink instead. Note however that "id" and "class" are used by the list item directly so they will not be passed to makeLink (however the link will still support a tooltip and accesskey from it) If you need an id or class on a single link you should include a "links" array with just one link item inside of it. $options is also passed on to makeLink calls

Returns:
string

Definition at line 1711 of file SkinTemplate.php.

References $options, makeLink(), and Html\rawElement().

Referenced by MonoBookTemplate\cactions(), MonoBookTemplate\customBox(), ModernTemplate\execute(), MonoBookTemplate\execute(), getSidebar(), MonoBookTemplate\languageBox(), VectorTemplate\renderNavigation(), VectorTemplate\renderPortal(), and MonoBookTemplate\toolbox().

Access:
private

Reimplemented from QuickTemplate.

Definition at line 1358 of file SkinTemplate.php.

References echo, and getMsg().

An ugly, ugly hack.

Access:
private

Reimplemented from QuickTemplate.

Definition at line 1362 of file SkinTemplate.php.

References echo, and getMsg().

Output the basic end-page trail including bottomscripts, reporttime, and debug stuff.

This should be called right before outputting the closing body and html tags.

Definition at line 1879 of file SkinTemplate.php.

References echo, MWDebug\getDebugHTML(), QuickTemplate\getSkin(), and QuickTemplate\html().

Referenced by ModernTemplate\execute(), MonoBookTemplate\execute(), LegacyTemplate\execute(), and VectorTemplate\execute().


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