Manual:Skin configuration

From MediaWiki.org

This page contains information for administrators on how to configure skins on a wiki. Please refer to Help:Skins for general skin information and Manual:Skinning for developer information on creating new skins.

[edit] Set a Default Skin for a Wiki

A default skin can be set for new users of a wiki by setting the variable $wgDefaultSkin in LocalSettings.php to the lowercase skin name specified in the skin file. Users can still change their skin later by going to their preferences page. If an admin would like to change a large number of existing user's skin settings, they can use the script in the maintenance folder called userOptions.php. The syntax to use would be:

$ php userOptions.php skin --old <old skin name> --new <new skin name>

Example:

 $ php userOptions.php skin --old "monobook" --new "modern"

The script will then change all users preferences from <old skin name> to <new skin name>.

[edit] Suppress Skins

The administrator can limit the skin choices that are offered site-wide in user's preferences by listing skin(s) to suppress in the $wgSkipSkins array. To do this, put something like this in LocalSettings.php:

# To remove various skins from the User Preferences choices
$wgSkipSkins = array("chick", "cologneblue", "myskin", "nostalgia", "simple", "standard");

[edit] Site-Wide CSS

MediaWiki allows administrators to specify site-wide CSS rules to be added to every page rendered. These rules can be added by editing the page MediaWiki:Common.css. See the rules for this page for example.

[edit] User CSS

Users can also specify their own CSS rules by creating the page "User:Username/skinname.css". If a user uses the monobook skin for example, they would edit the page User:MyPage/monobook.css. This feature can be enabled by setting $wgAllowUserCss to true in LocalSettings.php.

[edit] Remove Skin tab from User Preferences

The system administrator can completely remove the Skin tab/link so that it does not show up at all in User Preferences. This makes sense if your site will use a customized skin and would not look right in any other skin.

To remove the Skin link/tab from User Preferences, go in includes/specials/SpecialPreferences.php and comment out (put another # at the beginning of each line or put /* before the first line and */ after the last line) these lines (starts on line ~815, ends on line ~843):

# Skin
#
$wgOut->addHTML( "<fieldset>\n<legend>\n" . wfMsg('skin') . "</legend>\n" );
$mptitle = Title::newMainPage();
$previewtext = wfMsg('skinpreview');
# Only show members of $wgValidSkinNames rather than
# $skinNames (skins is all skin names from Language.php)
foreach ($wgValidSkinNames as $skinkey => $skinname ) {
    if ( in_array( $skinkey, $wgSkipSkins ) ) {
        continue;
    }
    $checked = $skinkey == $this->mSkin ? ' checked="checked"' : '';
    $sn = isset( $skinNames[$skinkey] ) ? $skinNames[$skinkey] : $skinname;
    $mplink = htmlspecialchars($mptitle->getLocalURL("useskin=$skinkey"));
    $previewlink = "<a target='_blank' href=\"$mplink\">$previewtext</a>";
    if( $skinkey == $wgDefaultSkin )
        $sn .= ' (' . wfMsg( 'default' ) . ')';
    $wgOut->addHTML( "<input type='radio' name='wpSkin' id=\"wpSkin$skinkey\" value=\"$skinkey\"$checked /> <label for=\"wpSkin$skinkey\">{$sn}</label> $previewlink<br/>\n" );
}
$wgOut->addHTML( "</fieldset>\n\n" );

It is also possible to just remove all the choices for skins, except for one: see $wgSkipSkin and $wgDefaultSkin.

Languages:

English  • Deutsch  • 日本語