Manual:Hooks/SkinAddFooterLinks

SkinAddFooterLinks
Available from version 1.35.0 Add items to the footer for skins using SkinAddFooterLinks. By design this hook cannot be used to disable existing links. To disable existing links please consult the documentation for the extension which adds the link you want to disable or disable the associated message key.
Define function:	public static function onSkinAddFooterLinks( Skin $skin, string $key, array &$footerlinks ) { ... }
Attach hook:	In extension.json: { "Hooks": { "SkinAddFooterLinks": "MediaWiki\\Extension\\MyExtension\\Hooks::onSkinAddFooterLinks" } }
Called from:	File(s): skins/SkinTemplate.php
Interface:	SkinAddFooterLinksHook.php

For more information about attaching hooks, see Manual:Hooks .
For examples of extensions using this hook, see Category:SkinAddFooterLinks extensions.

Details

This hook allows alteration of the footer.

Parameters:

• $skin: the Skin object
• $key: the current key for the current group (row) of footer links. Currently either info or places.
• &$footerItems: the array of links that can be changed. Keys will be used for generating the ID of the footer item; values should be HTML strings.

Default footer items

• info:
  • lastmod: timestamp of last modification of the current page
  • numberofwatchingusers: obsolete(?)
  • credits: list of contributors to the current page (only when $wgMaxCredits is set)
  • copyright: copyright information (see $wgRightsText and related settings)
• places:
  • privacy: privacy policy (shows text from MediaWiki:Privacy, links to the page set in MediaWiki:Privacypage)
  • about: about page (shows text from MediaWiki:Aboutsite, links to the page set in MediaWiki:Aboutpage)
  • disclaimer: disclaimers page (shows text from MediaWiki:Disclaimers, links to the page set in MediaWiki:Disclaimerpage)

Setting a text-generating message for one of the places items to - removes that item from the footer. For instance to disable the "Disclaimers" link, you should edit MediaWiki:Disclaimers and set its content to "-" or set it to be blank.

Examples

// Add a link to this page (https://www.mediawiki.org/wiki/?curid=6031)
// test-desc is an i18n message of the text
public static function onSkinAddFooterLinks( Skin $skin, string $key, array &$footerlinks  ) {
    if ( $key === 'places' ) {
        $footerlinks['test'] = Html::rawElement( 'a',
            [
                'href' => 'https://www.mediawiki.org/wiki/?curid=6031',
                'rel' => 'noreferrer noopener' // not required, but recommended for security reasons
            ],
        $skin->msg( 'test-desc' )->text()
    }
}

In older MediaWiki versions

MediaWiki version:

≤ 1.40

// Add a link to the page "Test Page" with the text "Test", allowing modification by wiki administrators
// test-desc and test-page are i18n messages with the text of the link and the name of the page, respectively
public static function onSkinAddFooterLinks( Skin $skin, string $key, array &$footerlinks  ) {
    if ( $key === 'places' ) {
        $footerlinks['test'] = $skin->footerLink( 'test-desc', 'test-page' );
    }
}

See also

• Manual:Footer