Home CiviUser Readme
CiviUser Documentation PDF Print E-mail
Software - Joomla

Civiuser Component com_civiuser for Joomla 1.5.x and CiviCRM v3.x

ReadMe for version 1.0

Based on the standard com_user from Joomla 1.5.15 this component replaces the standard new user registration form with one that allows someone to register as a website user only if they already exist as a CiviCRM contact.
It should be used in conjunction with mod_civilogin if you also want a simple login form displayed in a module position.

You need to disable the built in Joomla user registration (under Site-Global Configuration-System) and also the standard login module (mod_login) if you are using it, and use menu links to the com_civiuser component for login, user details and registration.

Additional parameters allow you to further restrict registration to only contacts belonging to a specific group (or one of a list of groups) in CiviCRM and/or only having valid current membership details in the CiviMember component of CiviCRM.

The default action of a standard CiviCRM installation on Joomla is to automatically create a new CiviCRM contact every time someone registers on the website if they are not already in the CiviCRM database. This is fine for many applications but may be undesirable if you are running a 'members only' site where you wish to allow members themselves to register to use the website with their own username and password rather than pre-registering all members as Joomla users.

NB: - com_civiuser does not respect the global settings under Site Configuration for allowing user registration or user activation. Registration is always allowed, and users must always activate their accounts by confirming their email.

Contact matching to CiviCRM is by email address and optionally name. There is no checking for duplicates in the CiviCRM database - the first matching record returned is used. NB It checks only the primary email address for the contact, not any alternates in CiviCRM.

There are global parameters for CiviCRM groups allowed or excluded, CiviMember status check, strict name matching, whether to allow users to change their email address, and a contact to be notified of changes (eg Membership Secretary)
In addition there are view parameters to set text at the top and bottom of the registration and user edit forms - set these when creating your menu items for CiviUser.

The groups allowed to register or excluded are comma separated lists of Group IDs from CiviCRM. If you include '0' than the group checks are bypassed. Also note that only static (non-smart) groups can be used.

CHANGELOG and Notes:

  • v1.0 29/12/2009 Initial release compatible with CiviCRM v3.x

Any bugs, problems with use, or suggestions for improvement please contact the author.
Roger C-O (Creagh-Osborne)    This e-mail address is being protected from spambots. You need JavaScript enabled to view it