|
Software -
Joomla
|
Civiuser Component com_civiuser for Joomla 1.5.xReadme for version 0.2
NB THIS IS AN ALPHA RELEASE - PLEASE TEST IN YOUR ENVIRONMENT BEFORE USING ON A LIVE SITE
The code is based on the standard com_user from Joomla 1.5.6
This component is designed to replace the standard com_user component. It should be used in conjunction with mod_civilogin if you want a login form displayed in a module position.
The main function of Civiuser is to replace the standard new user registration form with one that only allows someone to register as a website user if they already exist as a CiviCRM contact.
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 (not working in v0.1)
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 undesirtable 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.
To use this component you should also disable the standard Joomla user registration (under Site Configuration) and also disable the standard mod_login module; and use menu links to the com_civiuser component for login, user details and registration.
You may also install the mod_civilogin module as well (or instead of using menu links to login or register) as this correctly links to the com_civiuser forms instead of the com_user ones.
NB - com_civiuser does not respect the global settings under Site Configuration for allowing user registration or user activation. In this component registration is always allowed, and users must always activate their accounts by confirming their email.
The matching of registration details to CiviCRM contact requires FirstName, LastName and email all to be correct. 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 6 parameters which you need to set - groups allowed to register, whether CiviMember check is included, and the text to be displayed to the user if either their contact details do not exist, or their membership or group permissions are not correct, and the text displayed to the user above and below the registration form.
The groups allowed to register is a comma separated list of Group IDs from CiviCRM. If you include '0' than the group checks are bypassed.
NB The CiviMember check is not enabled in v0.2 of com_civiuser.
In v2.0.x of CiviCRM running on Joomla 1.5.x in legacy mode there is some confusion as to whether and when editing details on either Joomla user or CiviCRM contact are cascaded to the other system. Joomla real name is only a single field. com_civiuser requires firstname and lastname to find a contact match, and then creates a Joomla real name by concatenating them with a space between. This can not then be edited.
If the user edits the email address in the com-civiuser uesr details form then this is NOT YET cascaded to the primary email address for the contact in CiviCRM. If the user has access to a CiviCRM profile on the front-end which allows them to edit their email address then it does not seem to change the matching Joomla user email address. This may be fixed in v2.1 of CiviCRM but for now is a problem. The production release of com_civiuser will cascade email address changes into CiviCRM as the primary email address for the contact.
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
Check for latest version at www.crosborne.uk/software/joomla and the CiviCRM confluence wiki and the Joomla extensions directory
v0.2 includes security updates issued with Joomla 1.5.6
|
CiviUser Readme
