Login Redirect for Community Builder Documentation

Last Updated on Tuesday, 09 March 2010 07:31 Written by olan chancy Monday, 01 February 2010 11:54

Overview

The Login Redirect for Community Builder Component is very simple to configure and has the following features:

• Define a default login URL (page) to display for which a specific URL is not defined.
• Define up to 70 different URLs (pages) to display based on the value of  a Community Builder field.  
• Can use any field from Community Builder that is a select field.
• Easy to set up as you only define the CB field value and the URL.
• Can work to redirect users to any URL, including a completely different Website, a specific Joomla page, or a specific Joomla component! Anything reached via a URL on any Website can be used as a redirect.
• Designed specifically for  Community Builder!
• Makes a great compliment to any site with different user groups.

Installation

The Login Redirect Component installs into Joomla 1.5 the same as any other component. Simply download the zip file, and install using the Joomla installer in the administrator backend.

Component Configuration

Once it is installed you access it by going to Components in the back-end and select Login Redirect CB.  You will see a select box that is prepopulated with all Community Builder fields that are defined as select fields.  Typically fields such as state or zip code. Below is an example of the select field that will display.  Mouse over the select field and all fields defined as select type will be display.  Click on the field that will control the redirect at login. 

1) Pick the target URL for each of your redirects. You will need to enter all of them as fully-qualified URLs into the component. That means entering all of them with the http:// prefix and the full URL. Don't use relative URLs. One of the URLs can be a default for User Groups which do not have a specified URL for login.

2) Pick the CB field value which will have custom URL redirects.  To do this, simply invoke Login Redirect CB from the backend.   A number of select boxes prepopulated with the values assigned to the selected key field will appear.  Choose the value and enter the URL to redirect to.  You do not have to specify a URL for each User Group. Any User Group without a specified URL will see the default URL specified first in the list in the component.   To reset, choose select for the key field and press save.  This will cause everything to be reset.  This should be used only if the key field used to control redirecting is changed. 

3) Click on  the Select and choose the field value.  Then fill in the corresponding URL to be used when the value is encountered.

For each CB field value to redirect (up to 70 different groups) select the value to redirect and the fully qualified URL to display after login. The URL can be either a SEF or non-SEF URL. It can be a URL to a page locally, to an outside URL, or to a URL which invokes a Joomla Component. The first URL also functions as a default URL. Any user signing in to the system belonging who's CB profile field value doesn't have a specified URL will be directed to the default URL.

Login Module Configuration

Login modules for Joomla offer two different types of login URL functionality.

Direct URL Entry:

The first type allows you to specify a URL. An example of this type is the Community Builder (CB) login module as shown below:

You can enter the URL to the Login Redirect Component as a relative URL in most login modules. Enter the following URL:

index.php?option=com_loginredirectcb

If your login module requires a fully qualified URL, then simply enter it as http://www.mysite.com/index.php?option=com_loginredirect

After setting the URL to the Login Redirect component in your login module, you are done with setup. Any user logging in through the module will see the correct Web page based on either the default URL or the URL assigned to that user's User Group.