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:

  1. The title of the site;
  2. The box of external links;
  3. The content and the display of the toolbox;
  4. 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:

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,
                             )