Configure the CMS Login Page - BloomReach Experience - Open Source CMS

This article covers a Hippo CMS version 10. There's an updated version available that covers our most recent release.

04-03-2016

Configure the CMS Login Page

Introduction 

The login page of Hippo CMS can be configured with several options. This page discusses how and when to use these options.

Configuring Captcha

To prevent brute force attacks, the login page can be configured to show a captcha widget after a given amount of failed log in attempts.

To configure and use captcha with the login plugin, log in to the console and browse to the login plugin configuration node at

/hippo:configuration/hippo:frontend/login/login/loginPage

and specify the following two properties:

+ loginPage
    - use.captcha = true (defaults to false)
    - show.captcha.after.how.many.times = n (defaults to 3)

Specifying a negative integer for the latter property causes the system to fall back on the default of 3.

Signin Form Auto-Completion

Browsers can remember values of the fields of previously visited forms and offer them to the user when they start filling in the form. This may not always be the most secure behavior. Html offers a feature [ 1] [ 2] to tell browsers not to try and automatically complete a form. By default, the login plugin allows the browser to use autocomplete on the login form.
To disable autocompletion on the login form, log in to the console, browse to the login plugin configuration node at

/hippo:configuration/hippo:frontend/login/login/loginPage

and specify the following property:

+ loginPage
    - signin.form.autocomplete = false (defaults to true)

Language Selection Dropdown

By default, the UI of the CMS is accessible in English, French, German and Dutch. The desired language is chosen on the login page.
To add a new language to the dropdown on the login page (for example German), log in to the console, browse to the login plugin configuration node at

/hippo:configuration/hippo:frontend/login/login/loginPage

and specify the following multi-value property:

+ locales
    - en
    - nl
    - de

The values of the locales property should be a proper language code as specified by the ISO 639 standard.

The login page tries to translate the language codes into human readable values in the same way as all the other translation are handled. By default it knows how to translate: en, nl, de and fr. If you want a different language to be used, e.g. Spanish, you would need to do the following.

Log in to the console, browse to the login plugin configuration node at

/hippo:configuration/hippo:frontend/login/login/loginPage

and specify the following multi-value property:

+ locales
    - en
    - nl
    - es

In your custom CMS project, create or open the folder cms/src/main/resources/org/hippoecm/frontend/plugins/login and add the appropriate properties files:

LoginPanel.properties
LoginPanel_nl.properties
LoginPanel_es.properties

These properties files should contain the translations of the language codes that were added. So in this case, the file LoginPanel.properties should contain:

es: Spanish
Please note that when adding a language option to the login page, all CMS UI components need to have their labels translated into that language too.
Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?