fata: Mirage

MediaWiki skins manual - category

Mirage Release status: stable
Author(s)	Mainframe98
Compatibility policy	Snapshots releases along with MediaWiki. Master is not backwards compatible.
MediaWiki	1.41+
License	MIT License
Download	Download skin Git [?]: Download Git master browse repository (Phabricator · GitHub) commit history repository contributors (GitHub) code review Readme.md
Example	Example on MediaWiki Skins Wiki, Wikimedia Skins Lab
Hooks provided MirageBuildNavigation MirageBuildSiteTools MirageExtraFooterLinks MirageGetExtraIcons MirageGetRightRailModules
Quarterly downloads	18 (Ranked 22nd)
Public wikis using	9 (Ranked 101st)
Public wikis using as default skin	0
Translate the Mirage skin if it is available at translatewiki.net
Vagrant role	mirage
Issues :	Open tasks · Report a bug

Mirage is a responsive skin that focuses on displaying content with a rail on the right.

About the name

Mirage is based on Oasis, the skin used by FANDOM. Rather than be an exact copy of the Oasis skin, Mirage is a reflection of Oasis' appearance; a mirage of an oasis.

Features

Mirage supports on-wiki configuration for several of its features.

Wordmark

Mirage will use the wordmark from mirage-wordmark.png when that file exists and $wgMirageEnableWordmark is enabled. The file should be 250 pixels wide and 65 pixels high.

Navigation

Mirage can use navigation defined in MediaWiki:sidebar, but also supports enhanced navigation through the MediaWiki:mirage-navigation message. It uses the same syntax as MediaWiki:sidebar does, but with support for nesting, allowing each navigation dropdown to have a submenu.

Community messages

Community messages is a right rail module that displays the content of MediaWiki:mirage-community-messages. It only shows if that message is not disabled.

Avatars

Mirage supports avatars through three extensions:

• Gravatar
• SocialProfile
• Avatar

Installation

• If using Vagrant , install with vagrant roles enable mirage -p

Manual installation

• Download and place the file(s) in a directory called Mirage in your skins/ folder.
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadSkin( 'Mirage' );
  

•  Done - Navigate to Special:Version on your wiki to verify that the skin is successfully installed.

Themes

Mirage supports the Theme extension out of the box. Additionally, if the Theme extension isn't installed, setting$wgMirageTheme to any of the supported themes listed below, allows enabling the theme manually. This is currently the only way Mirage can provide a dark mode.

Configuration

$wgMirageEnableWordmark

This setting controls if the file mirage-wordmark.png should be used as the wordmark. When enabled, users can change the wordmark by uploading a new version of that file. The file should be 250 pixels wide and 65 pixels high.

This file should be protected against re-uploads to prevent changes to the wordmark without the proper permissions.

If the file does not exist, or if this setting is disabled, a wordmark will be created from the value of $wgLogos .

$wgMirageTheme

This setting controls the default theme of Mirage, when the Theme extension isn't installed. Currently, Mirage supports the neutral and darkmirage themes.

$wgMirageForceTemplateRecompilation

This setting is for development use and disables the caching of the Mustache templates that make up Mirage.

$wgMirageHiddenRightRailModules

This setting contains a list of right rail modules that should not be shown. The list consists of module names.

$wgMirageRightRailVisibleToAnonByDefault

This setting affects the initial visibility of the right rail for anonymous users. By default, the right rail is not visible.

See also

• Cosmos - A more true-to-the-original skin of Oasis.
• Onyx - Another Oasis inspired skin.