This documentation relates to CiviCRM version 3.2. It's not maintained anymore.
Current version of documentation.

Joomla User Registration Restriction

Aller directement à la fin des métadonnées
Aller au début des métadonnées

This page refers to outdated version of CiviCRM. Check current version of documentation.

Documentation Search

CiviCRM 3.2 Documentation

Support and Participation

Developer Resources

CiviCRM book!

Make sure to check out Understanding CiviCRM as well! You can also support this project by ordering a hard copy.

v1.0 Now works with Civi v3.0.3 and v3.1.beta3

A few other minor tweaks; codebase now com_user from Jomla 1.5.15. Download from here:  CiviUser v1.0 CiviLogin Module RogerCO

Want to only allow existing members to create user accounts on your Joomla site?

This is a component and module for Joomla 1.5 (native, not legacy mode, will not work with J1.0.x) which replace the standard user registration form and login module with one which checks for a matching contact in CiviCRM and only allows registration to proceed if a match is found. In addition you can specify that the contact must be a member of a CiviCRM group (static group only) or restrict access based on the membership status of the contact.

A future enhancement could be to set the Joomla user level (registered/author/publisher/manager/admin) automatically based on group membership, for now all accounts start as 'Registered' and you need tomanually grant author/editor/publisher/backend privileges. Best wait and see what happens with Civi ACL for Joomla in 3.2 and Joonla ACL in 1.6

In conjunction with the CiviCRM authentication plugin,these extensions provide an effective solution for ensuring that only valid members can sign up for user accounts on the front-end and also preventing them continuing to login if they become lapsed or drop off the membership list.

CiviUser v1.0 should still work with CiviCRM v2.1

CiviUser v0.5 added option for user to edit their own email address - this updates both the Joomla user record and the CiviCRM contact record. It also corrects the uf_match table which links them and sends notification to both old and new email addresses and the site administrator or membership secretary.

CiviUser v0.4 is compatible with CiviCRM v2.1+ and now includes the ability to restrict access based on the membership status level, and exclude contacts who are members of a group(s). It also includes several minor improvements throughout. CiviLogin 0.4 is the corresponding module updated for CiviUser v0.3 and CiviCRM v2.1.

To restrict access based on membership status level you must enable that feature in the core component parameters or when creating your menu item. You must identify the lowest status level (id number) for which access is permitted. For example, the default membership status levels begin with:

  • New = 1
  • Current = 2
  • Grace = 3
  • Expired = 4
  • etc.

By placing "3" in the parameter field you indicate that anyone with a membership status of New, Current, or Grace may register to access the site. Note that the restrictions do respect status overrides.

This version was modified by Brian Shaughnessy. Email brian at lcdservices dot org with questions or problems.


Install in the standard way through the Joomla administrator extension installer. Change the default parameters as required to set messages to users and groups and/or membership status to validate against. You can include simple html in the messages.

If you create a menu item to bring up the registration form then you can override the default component parameters for that menu entry.

Be sure to disable standard user registration (under Site > Global Configuration > System tab) and also the standard login module. Leaving these enabled would allow users to bypass the checks.


In this version there is no facility to disable registration, and users are always required to authenticate their email address (this is to block a loophole where a person could register with someone else's details and then change the Joomla user email address after registration and thus take-over the member's access).

Contact matching is by email and optionally First + Last name as entered by the user. The email check is on the primary email for the contact, not any alternates. If your membership database is out of date, eg if the user hasn't bothered to tell you about their new email, then they may be unexpectedly told that they are not valid. You can write a nice message in the parameters for the component to pacify them or direct them to organization staff to resolve the matter.

Please note that this is a BETA version and has not been extensively tested. Please test thoroughly before using on a production site.

Also note that v0.2 is compatible with CiviCRM v2.0.x. CiviUser v0.3+ is compatible with CiviCRM v2.1+ and CiviUser v1.0 is compatible with CiviCrM 3.x

Possible enhancements (in no particular order)

  • Check CiviMember records for valid membership DONE
  • Use re-direct links instead of text in case of no membership to redirect to joining form
  • Set initial user level based on group membership
  • Re-instate parameters to turn off (eg temporarily) registration and authentication
  • Possible backend enhancement to clean-up uf-match when Joomla user is deleted (at the moment you have to manually delete the record in uf_match otherwise the email is blocked from ever signing up again.
  • Possible backend enhancement to manually create a Joomla account for a contact - select contact from list and create Joomla user to match


  • CiviUser v1.0 and CiviLogin v1.0 - compatible with CiviCRM 3.x. Joomla codebase 1.5.15
  • CiviUser v0.5 - user can edit their email address. Codebase Joomla 1.5.12
  • CiviLogin Module v0.4 - updates styling and codebase to Joomla 1.5.11 core module
  • CiviUser v0.4 - adds ability to exclude contacts based on group membership
  • v0.3.2 - minor bug fix to status check mechanism
  • v0.3.1 - improves member status check mechanism to accomodate contacts with multiple membership records.
  • v0.3 - adds ability to restrict access based on membership status
  • v0.2 - security update: There are two zip files associated with this - is the component and mod_civilogin.zipis the login module. Install the component first and set the parameters in the backend, then disable the standard user registration. If you are using the standard login module disable it and replace with the civilogin module.
  • Aucun

Creative Commons License
Except where otherwise noted, content on this site is licensed under a Creative Commons Attribution-Share Alike 3.0 United States Licence.