Skin:BlueSky

From mediawiki.org
MediaWiki skins manual - category
BlueSky
Release status: beta
Description A modern, scalable and attractive skin for MediaWiki
Author(s)
  • Various wikiHow developers (Reuben Smith, Bebeth Steudel, Gershon Bialer and others)
  • Jack Phoenix
Latest version 1.1
MediaWiki 1.23+
PHP 5.3+
License GNU General Public License 2.0 or later
Download
Example Example on Skins wiki
Quarterly downloads 43 (Ranked 15th)
Public wikis using 5 (Ranked 90th)
Public wikis using as default skin 2
Translate the BlueSky skin if it is available at translatewiki.net
Issues : Open tasks · Report a bug

BlueSky skin is a modern, scalable and attractive skin for MediaWiki, based on wikiHow's third redesign (which was introduced in autumn 2013). It was written by Jack Phoenix, mentored by Emufarmers and Isarra, as a part of Summer of Code 2014. The skin is based on work done by Reuben Smith, Bebeth Steudel, Gershon Bialer and others for wikiHow.

The skin has been tested against MediaWiki 1.23 and 1.24alpha.

Installation[edit]

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

To users running MediaWiki 1.24 or earlier:

The instructions above describe the new way of installing skins using wfLoadSkin(), since MediaWiki 1.25. If you need to install this skin in earlier versions, instead of wfLoadSkin( 'BlueSky' );, you need to use:

require_once "$IP/skins/BlueSky/BlueSky.php";

(To run a skin on an earlier release, you may need to download the version of it tagged for that release from Special:SkinDistributor.)

Hooks[edit]

Hook name What it does When it is called Parameters
ShowSideBar Calls any hooks in place to see if a module has requested that the right rail on the site shouldn't be displayed. In SkinBlueSky::showSideBar()
  • &$result (boolean, true by default)
ShowBreadCrumbs Calls any hooks in place to see if a module has requested that the bread crumb (category) links at the top of the article shouldn't be displayed. In SkinBlueSky::showBreadCrumbs
  • &$result (boolean, true by default)
ShowGrayContainer Determines if the #bodycontents element should get the minor_section class In SkinBlueSky::showGrayContainer
  • &$result (boolean, true by default)
pageTabs Allows to construct non-default content action tabs (i.e. "page", "edit", etc.). In SkinBlueSky::getTabsArray
  • &$tabs (empty array; appending stuff to this array causes SkinBlueSky::getTabsArray to return this variables contents instead of performing its default processing)
getToolStatus In BlueSkyTemplate::execute
  • &$isTool (boolean, false by default; if this is true, the div#actionbar element gets the isTool class)
JustBeforeOutputHTML In BlueSkyTemplate::execute, right before the ‎<html> tag, along with the rest of the page head, is output
  • &$template (instance of BlueSkyTemplate class)
PageHeaderDisplay In BlueSkyTemplate::execute, right after the ‎<html> tag, along with the rest of the page head, is output
  • $isUserAgentMobile (boolean, determined by SkinBlueSky::isUserAgentMobile)
EndOfHeader In BlueSkyTemplate::execute
  • $output (instance of the OutputPage class)
AfterHeader In BlueSkyTemplate::execute, after div#header_outer has been closed
  • $output (instance of the OutputPage class)
BeforeActionbar In BlueSkyTemplate::execute, inside div#main but before div#actionbar is generated
  • $output (instance of the OutputPage class)
BeforeTabsLine In BlueSkyTemplate::execute, inside div#article, before the page body text is rendered
  • &$output (instance of the OutputPage class)
ArticleJustBeforeBodyClose In BlueSkyTemplate::execute, right before $this->printTrail() is called and the ‎<body> and ‎<html> tags are closed (no arguments)

Social media support[edit]

When [[MediaWiki:Bluesky-follow-table]] contains some HTML, this HTML is shown on the right side of the page (on LTR interfaces; the opposite for RTL).

For example:

<table id="follow_table">
	<tr>
		<td><a href="http://www.facebook.com/Example" target="_blank" id="gatFollowFacebook"><div class="follow-facebook"></div></a></td>
		<td><a href="https://www.twitter.com/Example" target="_blank" id="gatFollowTwitter"><div class="follow-twitter"></div></a></td>
		<td><a href="http://www.example.com/feed.rss" target="_blank" id="gatFollowRss"><div class="follow-feed"></div></a></td>
		<!--<td><a href="#" onclick="return false;" id="ccsfg_btn"><div class="follow-email"></div></a></td>-->
		<td><a href="https://plus.google.com/u/0/b/000000000000000000000/" target="_blank" id="gatFollowPlus"><div class="follow-plus"></div></a></td>
	</tr>
	<tr>
		<td><a href="http://pinterest.com/example/" target="_blank" id="gatFollowPinterest"><div class="follow-pinterest"></div></a></td>
		<td><a href="http://example.tumblr.com/" target="_blank" id="gatFollowTumblr"><div class="follow-tumblr"></div></a></td>
		<td><a href="http://www.stumbleupon.com/channel/example" target="_blank" id="gatFollowStumbleupon"><div class="follow-stumbleupon"></div></a></td> 
		<td><a href="https://market.android.com/details?id=com.example.mobileapp" target="_blank" id="gatFollowAndroid"><div class="follow-android"></div></a></td>
		<!--<td><a href="http://itunes.apple.com/us/app/example-dot-com/id000000000?mt=8" target="_blank" id="gatFollowApp"><div class="follow-iphone"></div></a></td>-->
	</tr>
</table>

Featured contributor widget[edit]

You can feature some of your wiki's hard-working members in the skin's sidebar by editing [[MediaWiki:Bluesky-featured-contributor-list]]. The format for that message is:

== User name ==
The blurb goes here.

== Foo Bar ==
Foo Bar is one of {{SITENAME}}'s administrators, and they have over a thousand edits on {{SITENAME}} and they've been a member of the community for three years.

To insert a newline, use the HTML ‎<br /> tag instead of an actual newline.

When the SocialProfile extension is installed, the user's avatar will also be shown on the sidebar.

Themes[edit]

Even if the Theme extension is not installed, BlueSky supports the following themes:

  • blue (default if no other theme is specified)
  • green
  • grey
  • red
  • white

The default site-wide theme can be set by specifying $wgDefaultTheme in LocalSettings.php , and each theme can be previewed by appending usetheme= to the URL, followed by the desired theme name (from the list above).