How-to configure the skin
From Libre Entreprise Mediawiki Skin
The Libre Entreprise skin allows its users to configure the colors and the content of the skin.
Contents |
The colors
The colors of the skin can be configured via a php file called css.php that must be created into the directory conf. You can use the default-css.php file as template. The file must contain an array looking like that:
<?php
$config_values = array(
/* body */
'body-width' => '60%',
'body-min-width' => '400px',
'body-background-color' => 'white',
'body-background-image' => array(
'file_name' => 'bg.png',
'first_color' => '#c4c8dd',
'second_color' => 'white',
'height' => 500) ,
/* header */
'header-height' => '110px',
'header-background-color' => 'white',
/* #content */
'content-background-color' => '#c4c8dd',
'content-background-image' => array(
'file_name' => 'bg-updown.png',
'first_color' => 'white',
'second_color' => '#c4c8dd',
'height' => 500) ,
);
?>
The options of this array allows you to change the background gradient and colors of the skin. If you just want an uniform background color, just delete the '*-background-image' key from the array.
After customizing the colors, you must regenerate the css file of the skin with the command (from the root directory of the project):
php script/generate-main-css.php
and deploy the file into the wiki files:
sh script/deploy.sh serveur.example.com
Please refer to the installation documentation for the last two steps.
The content
The content of the skin can be configured in four places:
- The title of the site;
- The box of external links;
- The content and the display of the toolbox;
- The content of the footer.
All modification are done through the LeSettings.php file and in the $wgTemplateData variable.
The title of the site
The title of the site appears in the title html tag and in the header of the page. It can be changed in the $wgTemplateData['siteTitle'] variable.
The box of external links
The site can have one or several menu. These menus are described in the $wgTemplateData['navbars'] array. This array is a list of menus description.
Each menu description consists in an array with two keys:
-
title: Title of the menu -
links: List of links, each link being an array with two keys:- url
- name
The content and the display of the toolbox
The toolbox can be configured via the showToolbox and showToolboxitems keys of the $wgTemplateData array. The first one is a boolean whose value enables or disables the display of the toolbox. The second key, showToolboxitems, has for value an array describing the content of the toolbox. This array looks like that:
'showToolboxitems' => array('whatlinkshere' => true,
'recentchangeslinked' => true,
'trackbacklink' => true,
'feeds' => true,
'contributions' => false,
'emailuser' => false,
'upload' => false,
'specialpages' => false,
'printableversion' => true,
)
There is another key called showToolboxFirst which permits to decided which box comes first in the right column: if its value is true, the toolbox will come before your menus, else your menus will come first.
The content of the footer
The content of the footer is configurable via the key showFooteritems of the $wgTemplateData array. The value of this key is an array with the following aspect:
'showFooteritems' => array('poweredbyico' => true,
'copyrightico' => false,
'lastmod' => true,
'viewcount' => false,
'numberofwatchingusers' => false,
'credits' => false,
'copyright' => false,
'about' => false,
'disclaimer' => false,
'tagline' => false,
'skin-license' => true,
)

