Jump to content

Extension:LogoFunctions

From mediawiki.org
MediaWiki extensions manual
LogoFunctions
Release status: stable
Implementation Parser function
Description Adds a parser function about the wiki's logo
Author(s) JuneHyeon Bae (*devunttalk)
Latest version 2.0 (2019-09-15)
MediaWiki 1.31+
PHP 7.0+
Database changes No
License GNU General Public License 2.0 or later
Download
  • $wgNamespaceLogos
Quarterly downloads 9 (Ranked 123rd)
Translate the LogoFunctions extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The LogoFunctions extension adds parser functions to override or add stamps to the wiki's logo.

Usage

[edit]
#setlogo
{{#setlogo:ExampleLogo.png}}

This sets the logo to file [[File:ExampleLogo.png]]

#stamplogo
{{#stamplogo:Featured.png|190px|top|-1em|-1em}}

This adds a featured article stamp to the logo ([[File:Featured.png]]), 190px wide, -1em from the left, -1em from the top, as seen on uncyclopedia:Page title.

top or bottom options can be used, for up to two stamps applied to the logo on a page.

Installation

[edit]
This extension was broken for several years. Use master or respectively the versions for MediaWiki 1.34 and later once available to install it.
  • Download and move the extracted LogoFunctions folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/LogoFunctions
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'LogoFunctions' );
    
  • Configure as required.
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration

[edit]

This extension can be used to set per-namespace logos via configuration by mapping a namespace number to a file available on the wiki:

$wgNamespaceLogos = [
	6 => 'Uncyclomedia Commons.png',
	7 => 'Uncyclomedia Commons.png',
];

The above code added to your "LocalSettings.php" file will set the specified files as logos for the "File" and "File talk" namespace. For these in particular, do remember to protect the files and also to mark them as used to prevent them from being deleted.

Do not use namespace constants but namespace numbers for configuration since the former will not work. See task T232952 for further information.