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	0
Public wikis using	9 (Ranked 109th)
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 previously 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 $wgMirageEnableImageWordmark 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

$wgMirageEnableImageWordmark

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.