MediaWiki master
BaseTemplate Class Reference

Extended QuickTemplate with additional MediaWiki-specific helper methods. More...

Inherits QuickTemplate.

Collaboration diagram for BaseTemplate:

Public Member Functions

 getIndicators ()
 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.
 
 getMsg ( $name,... $params)
 Get a Message object with its context set.
 
 getPersonalTools ()
 
 makeListItem ( $key, $item, $options=[])
 Wrapper for Skin method.
 
 msg ( $str)
 
- Public Member Functions inherited from QuickTemplate
 __construct (?Config $config=null)
 
 deprecate (string $name, string $version)
 Sets a template key as deprecated.
 
 execute ()
 Main function, used by classes that subclass QuickTemplate to show the actual HTML output.
 
 extend ( $name, $value)
 extends the value of data with name $name with the value $value
 
 get ( $name, $default=null)
 Gets the template data requested.
 
 getHTML ()
 Fetch the output of a QuickTemplate and return it.
 
 getSkin ()
 Get the Skin object related to this object.
 
 html ( $str)
 
 set ( $name, $value)
 Sets the value $value to $name.
 

Protected Member Functions

 getClear ()
 Get a div with the core visualClear class, for clearing floats.
 
 getFooter ( $iconStyle='icononly', $linkStyle='flat')
 Renderer for getFooterIcons and getFooterLinks.
 
 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.
 
 getSidebar ( $options=[])
 
 makeLink ( $key, $item, $options=[])
 Wrapper for Skin method.
 
 makeSearchButton ( $mode, $attrs=[])
 Wrapper for Skin method.
 
 makeSearchInput ( $attrs=[])
 Wrapper for Skin method.
 
- Protected Member Functions inherited from QuickTemplate
 haveMsg ( $msgKey)
 
 text ( $str)
 

Additional Inherited Members

- Public Attributes inherited from QuickTemplate
array $data
 
- Protected Attributes inherited from QuickTemplate
Config $config
 

Detailed Description

Extended QuickTemplate with additional MediaWiki-specific helper methods.

Todo
Phase this class out and make it an alias for QuickTemplate. Move methods individually as-appropriate either down to QuickTemplate, or (with deprecation) up to SkinTemplate.
Stability: stable
to extend

Definition at line 36 of file BaseTemplate.php.

Member Function Documentation

◆ getClear()

BaseTemplate::getClear ( )
protected

Get a div with the core visualClear class, for clearing floats.

Returns
string html
Since
1.29

Definition at line 349 of file BaseTemplate.php.

Referenced by getFooter().

◆ getFooter()

BaseTemplate::getFooter ( $iconStyle = 'icononly',
$linkStyle = 'flat' )
protected

Renderer for getFooterIcons and getFooterLinks.

Parameters
string$iconStyle$option for getFooterIcons: "icononly", "nocopyright" the "nocopyright" option is deprecated in 1.35 because of its association with getFooterIcons
string$linkStyle$option for getFooterLinks: "flat"
Returns
string html
Since
1.29

Definition at line 292 of file BaseTemplate.php.

References getClear(), getFooterIcons(), getFooterLinks(), and QuickTemplate\getSkin().

◆ getFooterIcons()

BaseTemplate::getFooterIcons ( $option = null)
protected

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.

Parameters
string | null$option
Deprecated
since 1.35 read footer icons from template data requested via $this->get('footericons')
Returns
array

Definition at line 247 of file BaseTemplate.php.

References wfDeprecated().

Referenced by getFooter().

◆ getFooterLinks()

BaseTemplate::getFooterLinks ( $option = null)
protected

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.

Parameters
string | null$option
Returns
array

Definition at line 208 of file BaseTemplate.php.

Referenced by getFooter().

◆ getIndicators()

BaseTemplate::getIndicators ( )

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.

Your skin may implement this differently, for example by handling some indicator names specially with a different UI. However, it is recommended to use a <div class="mw-indicator" id="mw-indicator-<id>" /> as a wrapper element for each indicator, for better compatibility with extensions and user scripts.

The raw data is available in ‘$this->data['indicators’]` as an associative array (keys: identifiers, values: contents) internally ordered by keys.

Returns
string HTML
Since
1.25

Definition at line 368 of file BaseTemplate.php.

◆ getMsg()

BaseTemplate::getMsg ( $name,
$params )

Get a Message object with its context set.

Parameters
string$nameMessage name @phpcs:ignore Generic.Files.LineLength
MessageParam|MessageSpecifier|string|int|float|list<MessageParam|MessageSpecifier|string|int|float>...$params See Message::params()
Returns
Message

Definition at line 47 of file BaseTemplate.php.

References $params, and QuickTemplate\getSkin().

Referenced by getSidebar(), and msg().

◆ getPersonalTools()

BaseTemplate::getPersonalTools ( )
Returns
array

Definition at line 58 of file BaseTemplate.php.

References QuickTemplate\getSkin().

◆ getSidebar()

BaseTemplate::getSidebar ( $options = [])
protected
Parameters
array$options(optional) allows disabling certain sidebar elements. The keys search, toolbox and languages are accepted.
Returns
array representing the sidebar

Definition at line 67 of file BaseTemplate.php.

References getMsg(), and QuickTemplate\getSkin().

◆ makeLink()

BaseTemplate::makeLink ( $key,
$item,
$options = [] )
protected

Wrapper for Skin method.

Parameters
string$keyof link
array$itemto render
array$optionsfor link
Returns
string

Definition at line 162 of file BaseTemplate.php.

References QuickTemplate\getSkin().

◆ makeListItem()

BaseTemplate::makeListItem ( $key,
$item,
$options = [] )

Wrapper for Skin method.

Parameters
string$keyof list item
array$itemto render
array$optionsfor list item
Returns
string

Definition at line 174 of file BaseTemplate.php.

References QuickTemplate\getSkin().

◆ makeSearchButton()

BaseTemplate::makeSearchButton ( $mode,
$attrs = [] )
protected

Wrapper for Skin method.

Parameters
string$mode
array$attrs
Returns
string

Definition at line 195 of file BaseTemplate.php.

References QuickTemplate\getSkin().

◆ makeSearchInput()

BaseTemplate::makeSearchInput ( $attrs = [])
protected

Wrapper for Skin method.

Parameters
array$attrs
Returns
string

Definition at line 184 of file BaseTemplate.php.

References QuickTemplate\getSkin().

◆ msg()

BaseTemplate::msg ( $msgKey)
Parameters
string$msgKey

Reimplemented from QuickTemplate.

Definition at line 51 of file BaseTemplate.php.

References getMsg().


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