Skin:Citizen

MediaWiki skins manual - category
OOjs UI icon layout-ltr.svg
Citizen
Release status: stable
Screenshot-skin-citizen.png
Description A beautiful, usable, responsive MediaWiki skin with in-depth extension support. Originally developed for the Star Citizen Wiki.
Author(s) alistair3149, Octfx
Latest version Continuous updates
Compatibility policy Master maintains backwards compatibility.
MediaWiki 1.39.0+
License GNU General Public License 3.0 or later
Download
README on GitHub
Example Star Citizen Wiki (English, German (SMW), Chinese (Miraheze)), Wikimedia Skin Lab
Parameters
  • $wgCitizenThemeDefault
  • $wgCitizenEnableSearch
  • $wgCitizenSearchGateway
  • $wgCitizenSearchDescriptionSource
  • $wgCitizenMaxSearchResults
  • $wgCitizenEnableManifest
  • $wgCitizenManifestThemeColor
  • $wgCitizenManifestBackgroundColor
  • $wgCitizenShowPageTools
  • $wgCitizenThemeColor
  • $wgCitizenGlobalToolsPortlet
  • $wgCitizenEnableDrawerSiteStats
  • $wgCitizenUseNumberFormatter
  • $wgCitizenEnableCollapsibleSections
  • $wgCitizenEnableCJKFonts
Public wikis using 91 (Ranked 39th)
Public wikis using as default skin 47
Translate the Citizen skin if it is available at translatewiki.net

Citizen is a beautiful, usable, responsive MediaWiki skin that makes extensions part of the cohesive experience. It was initially created for the Star Citizen Wiki but is flexible to run on various MediaWiki configurations.

If you find an issue or there is some improvements that you would like to work on, please feel free to submit patches or report issues over at Github. Alternatively you can also use the discussion page for any help regarding the skin.

Notable featuresEdit

  • Responsive layout: Responsive and able to adapt to different screen sizes.
  • Light/dark mode: Switch between light and dark mode.
  • Cohesive extension styles: Supported extensions blend with the rest of the UI.
  • Reading preferences: Adjust page width, font size, and line height.
  • Collapsible sections: Collapse and expand article sections.
  • Persistent ToC: Access ToC anywhere in the article.
  • Rich search suggestions: More helpful search suggestions with images and descriptions.
  • Progressive Web App: Give a more app-like experience when users add your wiki to their home screen.

ScreenshotsEdit

InstallationEdit

  • Download and place the file(s) in a directory called Citizen in your skins/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
wfLoadSkin( 'Citizen' );
  • Put wfLoadSkin( 'Citizen' ); after all extensions
  • Configure as required.
  •   Done - Navigate to Special:Version on your wiki to verify that the skin is successfully installed.

MobileFrontendEdit

To use Citizen with MobileFrontend, simply add this to your localsettings.php:

$wgDefaultMobileSkin = 'citizen';

ConfigurationEdit

The skin works out of the box without any configurations. The config flags allow more customization on the specific features in the skin. Check out this page on how to adapt Citizen styles on your wiki.

AppearanceEdit

Name Description Values Default
$wgCitizenThemeDefault The default theme of the skin 'auto' - switch between light and dark according to OS/browser settings; 'light'; 'dark' 'auto'
$wgCitizenEnableCollapsibleSections Enables or disable collapsible sections on content pages true - enable; false - disable true
$wgCitizenShowPageTools The condition of page tools visibility true - always visible; 'login' - visible to logged-in users; 'permission' - visible to users with the right permissions true
$wgCitizenGlobalToolsPortlet ID of the portlet to attach the global tools string ''
$wgCitizenEnableDrawerSiteStats Enables the site statistics in drawer menu true - enable; false - disable true
$wgCitizenUseNumberFormatter Use NumberFormatter for site statistics, which allows formatting number in a localized way true - enable; false - disable true
$wgCitizenThemeColor The color defined in the theme-color meta tag Hex color code '#131a21'
$wgCitizenEnableCJKFonts Enable included Noto Sans CJK for wikis that serves CJK languages true - enable; false - disable false

Search suggestionsEdit

Name Description Values Default
$wgCitizenEnableSearch Enable or disable rich search suggestions true - enable; false - disable true
$wgCitizenSearchGateway Which gateway to use for fetching search suggestion mwActionApi; mwRestApi mwActionApi
$wgCitizenSearchDescriptionSource Source of description text on search suggestions wikidata - Use description provided by WikibaseLib or ShortDescription; textextracts - Use description provided by TextExtracts; pagedescription - Use description provided by Description2 or any other extension that sets the description page property textextracts
$wgCitizenMaxSearchResults Max number of search suggestions Integer > 0 6

Webapp manifestEdit

Name Description Values Default
$wgCitizenEnableManifest Enable or disable web app manifest true - enable; false - disable true
$wgCitizenManifestThemeColor Theme color of the web app manifest Hex color code #131a21
$wgCitizenManifestBackgroundColor Background color of the web app manifest Hex color code #131a21