Table of Contents

Portal customization

The portal is the visible part of LemonLDAP::NG, all user interactions are displayed on it.

Skin

LemonLDAP::NG is shipped with 4 skins:

It is recommended to use bootstrap skin, as other may be deprecated in the future.

But you can make your own, see Skin customization below.

Default skin

You can change the default skin in Manager: General Parameters > Portal > Customization > Default skin.

Select the Custom skin, then set the name of the skin you want to use in the input below.

Skin background

Go in General Parameters > Portal > Customization > Skin background. You can define a background by selecting one of the available image. Use None to use the default skin background configuration.

Skin rules

You might want to display different skin depending on the URL that was called before being redirected to the portal, or the IP address of the user.

To achieve this, you can create a rule in the Manager: select General Parameters > Portal > Customization > Skin display rules on click on "New key". Then fill the two fields;

Skin files

A skin is composed of different files:

A skin will often refer to the common skin, which is not a real skin, but shared skin objects (like scripts, images and CSS).

Skin customization

If you modify directly the skin files, your modifications will certainly be erased on the next upgrade. The best is to create your own skin, based on an existing skin.

Here we explain how to create a new skin, named myskin, from the bootstrap skin.

cd /usr/share/lemonldap-ng/portal-skins/
mkdir myskin
cd myskin/
cp -a ../bootstrap/fonts/ .
cp -a ../bootstrap/js/ .
cp -a ../bootstrap/css/ .
mkdir images

Then create symbolic links on template files, as you might not want to rewrite all HTML code (else, do as you want).

ln -s ../bootstrap/*.tpl .

We include some template files that can be customized:

To use custom files, delete links and copy them into your skin folder:

rm -f custom*
cp ../bootstrap/custom* .

Create a symlink in main skin directory:

ln -s /usr/share/lemonldap-ng/portal-skins/myskin /var/lib/lemonldap-ng/portal/skins/

Then you only have to edit JS/CSS and add your media to myskin/images. Put all custom HTML code in the custom template files.

To configure your new skin in Manager, select the custom skin, and enter your skin name in the configuration field.

Messages

Messages are defined in source code. If they really do not please you, override them! You just need to know the ID of the message (look at Portal/Simple.pm) and then add to lemonldap-ng.ini:

[portal]
 
# Custom error messages
error_0 = Big brother is watching you, authenticated user
 
# Custom standard messages
msg_22 = Your last connections
You can alse define messages in several languages:
[portal]
error_en_0 = Big brother is watching you, authenticated user
error_fr_0 = Souriez vous ĂȘtes surveillĂ©s !

Template parameters

Template parameters are defined in source code. If you need to add a template parameter for your customization, then add to lemonldap-ng.ini:

[portal]
 
# Custom template parameters
tpl_myparam = world

Then you will be able to use it in your template like this:

Hello <TMPL_VAR NAME="myparam">!

Buttons

This node allows one to enable/disable buttons on the login page:

Password management

Other parameters