Installation guide for Joomla 2.5 module mod_scoutlogin by Scouting Nederland
====================================================================================

Contents
--------
1. Purpose of the module
2. Configuration settings


1. Purpose of the module
------------------------

This module provides a login button. The module triggers the authentication process of Joomla.

After the user has logged in a welcome message is displayed and a button for 'logout' is provided.

Scouting Nederland uses this module in combination with the OpenID plugin to allow users to login to https://login.scouting.nl.


2. Configuration settings
-------------------------

a. TITLE_LOGIN (login)
URL to redirect to after login. Is only used when no 'return' parameter is provided by the request that loads the module.
This ensures that when a user accesses a restricted page and is asked to login, the user will be redirected to the restricted page after login.
When the setting is empty, user is returned to page he started login from.

b. TITLE_LOGOUT (logout)
URL to redirect to after logout. Same restrictions apply as with login.

c. TITLE_GREETING (greeting)
Option to enable/disable the welcome message for the user.

d. TITLE_NAME (name)
Option to select if user should be greeted by his normal name of username.