Skip to content

Xymph/monaco-port

 
 

Repository files navigation

Monaco Skin for MediaWiki

About

This is an unbranded fork of the Monaco skin originally developed by Wikia which is being maintained for use at DoomWiki.org. It was also previously deployed at the Orain non-profit wiki farm before it went offline.

Compared to the original version of the skin, this fork now supports MediaWiki versions 1.27 to 1.32 officially, with verified support for 1.33+ in the works. This codebase will usually remain up-to-date against MediaWiki, and will drop support for older versions unconditionally once it becomes impractical to continue to support them.

New features in this fork over dantman/monaco-port include:

  • A new Widgets framework which cooperates with Extension:Gadgets to allow sidebar content to be defined through the MediaWiki frontend.
  • Special support for Extension:FlaggedRevs and Extension:MobileFrontend when they are installed.
  • Wiki copyright notice is displayed in the footer of every page as with Wikimedia-maintained skins.
  • Numerous bug fixes to stylesheets, JavaScript, and PHP HTML generation.

This fork is maintained by James Haley. I do not offer support for this software beyond basic installation help, however. Please do not contact me requesting any customizations for your particular site. Bug reports are however very much welcome, as are generic feature requests that would be useful to everyone that might use it.

Installation

To install, install monaco-port into a monaco/ folder in your skins/ folder. From the command line you can do this by cd'ing to your skins/ folder inside your MediaWiki installation and running:

git clone git://github.com/haleyjd/monaco-port.git monaco

After you have placed the skin into that folder add:

wfLoadSkin('monaco');

near the end of your LocalSettings.php to finish installation of the skin.

You can also include the ExtendedBodyAttributes.php code if you wish to re-introduce the mainpage and loggedout classes that were in Wikia's version of Monaco. Doing this will actually make these CSS classes available globally to all skins that are programmed using the MediaWiki 1.16 headElement code.

Additionally you can install the ContentRightSidebar extension using:

require_once("$IP/skins/monaco/ContentRightSidebar.php");

Doing so will provide you with a <right-sidebar>...</right-sidebar> tag which will create right-floated content in the page that will be moved into the right sidebar in Monaco based skins. You can also use it with the args:

<right-sidebar with-box="true" title="My Title">...</right-sidebar>

to include that sidebar in a sidebar box. Note that a value is required for the with-box attribute when this extension is used with MediaWiki 1.25 or later. For consistency, it is suggested that you provide this value anyway, since it also works with earlier versions of MediaWiki.

Configuration

The following configuration settings can be used in LocalSettings.php, shown with their default values:

$wgMonacoAllowUsetheme = false;         // Set to false to disable &usetheme= support
$wgMonacoTheme = "sapphire";            // Load a pre-made Monaco theme from the styles folder
$wgMonacoDynamicCreateOverride = false; // Override "Special:CreatePage" urls with something else
$wgMonacoUseMoreButton = true;          // Set to false to disable the more button and just list out links
$wgMonacoUseSitenoticeIsland = false;   // Use an island above the content area for the sitenotice instead of embedding it above the page title
$wgMonacoUseMasthead = true;            // Show the masthead on userpages
$wgMonacoCompactSpecialPages = false;   // Compact the tab_bar on special pages
$wgMonacoEnablePaypal = false;          // Enable a Paypal button
$wgMonacoPaypalID = "";                 // Set to Paypal ID if button is enabled
$wgMonacoEnablePatreon = false;         // Enable a Patreon button
$wgMonacoPatreonURL = "";               // Set to Patreon URL if button is enabled

License

All of the code released by Wikia was made available under GPL v2.0 or later. This license can be found in the COPYING file.

About

Maintaining the Monaco skin as a brandless skin for vanilla MediaWiki

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • CSS 51.3%
  • PHP 33.6%
  • JavaScript 15.1%