Plugin - Joomla! User Registration (Create custom user registration forms)

RSForm!Pro - Joomla! user registrationThe RSForm!Pro - Joomla! user registration Plugin allows you to create a user registration form with RSform!Pro.

With this plugin you will be able to create your own custom registration forms for that extra information that you need to collect.

Joomla! 3.x

The RSForm!Pro - Joomla! user registration Plugin allows you to create user registration forms with just a few configuration clicks.


Video tutorial

The video tutorial below presents all the features that this integration has to offer, along with explanations on how to use them:


Installation

Technical requirements

In order to make the plugin work, you need:

  • Joomla! 3.0
  • Latest version of RSForm! Pro (at least Ver. 1.50.13)

Getting the RSForm!Pro - Joomla! user registration plugin

In order to download the RSForm!Pro - Joomla! user registration Plugin you must have at least one active code of RSForm!Pro. Simply go to the My Downloads section of our website (You must be logged-in in order to see the My Downloads section).

In the list of downloads go to the RSForm!Pro section, and download the RSForm!Pro - Joomla! user registration plugin.

Installing the plugin

Once you have downloaded the RSForm!Pro - Joomla! user registration Plugin, you can install it using the default Joomla! installer as explained in the article linked below:

The RSForm!Pro - Joomla! user registration Plugin should auto-publish itself, but if that doesn't happen, you can go to Extensions >> Plugin Manager and enable it. The plugin is located in the System group and you can identify it by the name of "System - RSForm!Pro Registration Form".



Configuring the integration


Once you have enabled the plugin, go to RSForm!Pro » Manage Forms and edit the form where you want to use the Joomla! registration integration. You will notice that, in the Properties area, one more tab has appeared:

The configuration parameters are split, depending on the selections made in the fields, into a number of 2 to 4 areas:

Joomla! User Registration

In this area, you can set up the behaviour of the registration process by the following options:

  • Use Joomla! Registration integration: Yes / No - you can enable / disable the Joomla! registration functionality by setting this option to Yes or No.
  • Action: Always create the user / Based on another field - you can either offer the form's submitter the choice of having a new user account created on your website after the form's submission (by using the Based on another field option) or to force the creation of a new account (by setting this option to Always create the user).
  • New User Account Activation: None / Self / Admin
  • Defer Admin Email: No / Yes - set to Yes in order to delay the sending of the Admin Email until after the user clicks on the activation link.
  • User Group: choose the Joomla! user group in which you wish to add the newly created account.
  • Menu Item ID: the item ID that will be appended to the links received in the email. Use this to create a SEF link pointing to a menu item other than the default one that the user is on.

User Activation

This area gets displayed when New User Account Activation is set to either Self or Admin. A single parameter is configurable:

  • User Activation Action: None (Joomla! default) / Redirect to the URL specified below / Show message specified below - Set the action to be taken after the user clicks the Activation Link. When selecting Redirect to the URL specified below a new field will be displayed, URL, in which you must specify the URL of the page where the user will be redirected. If Show message specified below is selected, you will need to specify, in the newly added Message field, the message that will get displayed.

Admin Activation

This area gets displayed when New User Account Activation is set to Admin. A single parameter is configurable:

  • Admin Activation Action: Set the action to be taken after the admin clicks the Activation Link. When selecting Redirect to the URL specified below a new field will be displayed, URL, in which you must specify the URL of the page where the admin will be redirected. If Show message specified below is selected, you will need to specify, in the newly added Message field, the message that will get displayed.

Map Fields

  • Name: Map the Joomla! registration Name field with one of your form's fields.
  • Username: Map the Joomla! registration Username field with one of your form's fields.
  • Email: Map the Joomla! registration Email field with one of your form's fields.
  • Verify Email: Map the Joomla! registration Verify Email field with one of your form's fields.
  • Password: Map the Joomla! registration Password field with one of your form's fields.
  • Verify Password: Map the Joomla! registration Verify Password field with one of your form's fields.
  • Consent: this is only available when the Joomla! "System - Privacy Consent" plugin is enabled (useful so the consent is given directly from your custom form, instead of having the user give an extra consent, imposed by System - Privacy Consent plugin). You can map this to one of your form fields (usually the one you're using for users to give their consent; for example a checkbox). Note that the field you're choosing to be mapped, has to return a value (it can be anything, though blank/empty values won't work).

RSForm!Pro Emails

The new version of the Joomla! Registration Plugin overrides the standard Joomla! account activation emails, replacing them with the RSForm!Pro User / Admin Emails instead.


To include activation links for both the user and website administrator, just add either the {user_activation} or {admin_activation} placeholders in the User and Admin emails and they will get replaced with the proper activation links.

Editing / Translating the Confirmation Email

The latest version of the Joomla! Registration Integration plugin also overrides the confirmation email sent to the user after the account has been activated. Its text and subject are controlled by the plugin's main language file. There are 2 ways in which you can edit them:


  1. Edit the following file:


    \administrator\language\en-GB\en-GB.plg_system_rsfpregistration.ini


    and add your preferred text and subject for the following language constants:


    RSFP_REG_EMAIL_ACTIVATED_BY_ADMIN_ACTIVATION_BODY

    RSFP_REG_EMAIL_ACTIVATED_BY_ADMIN_ACTIVATION_SUBJECT


    The same needs to be done when translating this into other languages, the only difference being that you will need to edit the file that gets loaded by the language you are using (for example, for French you need to edit \administrator\language\fr-FR\fr-FR.plg_system_rsfpregistration.ini instead).

  2. Perform a language override for the same language constants mentioned above.

Important: Make sure to include the %s syntax as seen in the original translation in order to include the proper information in the emails.


Configuration Form

Changing the default registration form can be done with ease by going to COMPONENTS >> RSForm!Pro >> Configuration and access the Registration Form tab. In this tab you can find a dropdown element that will allow you to choose which form you want to be displayed in the registration page and the Redirect URL which will allow you to manually enter the URL you want to be redirected to when you click the Register link.

29 Oct 2019
Version 2.0.4
  • Updated - Can now map the 'Consent' field if the 'System - Privacy Consent' Plugin is enabled.
29 Oct 2019
Version 2.0.3
  • Updated - Admin activation emails now support HTML as well.
  • Updated - Old code removed.
18 Oct 2019
Version 2.0.2
  • Updated - Progress bar for Bootstrap 4
  • Fixed - If layout doesn't have its own progress bar, default to our own Responsive progress bar.
10 May 2019
Version 2.0.1
  • Updated - Progress bar for Zurb Foundation.
  • Fixed - Password progress bar color strength ordering.
10 Apr 2019
Version 2.0.0
  • Updated - Support for minimum lowercase characters password requirements introduced in Joomla! 3.9.5
  • Updated - Bumped minimum requirements to Joomla! 3.6.5
29 May 2017
Version 1.52.1
  • Fixed - Resolved an issue that could cause unwanted redirects.
07 Mar 2017
Version 1.52.0
  • Updated - Can now use placeholders in the activation URLs.
10 Aug 2016
Version 1.51.3
  • Fixed - Emails were not being sent if the user was not created.
17 Mar 2016
Version 1.51.2
  • Fixed - Uninstalling the plugin would not remove its database entries.
29 Jan 2016
Version 1.51.1
  • Updated - Password Strength improvements.
  • Updated - Bumped minimum requirements to Joomla! 2.5.28
  • Fixed - SQL installation files were not being run when using the MySQL PDO adapter.
09 Oct 2015
Version 1.51.0
  • Added - Joomla! automatic updates support.
  • Added - Show password strength next to the password field.
  • Updated - Bumped minimum requirements to Joomla! 2.5.28 and RSForm! Pro 1.51.0
  • Fixed - SQL installation files were not being run when using the MySQL PDO adapter.
26 Mar 2015
Version 1.5.2
  • Added - Ability to specify a Menu Item ID for the activation links.
09 Mar 2015
Version 1.5.1
  • Fixed - The creation of a new user did not work when using the "AJAX Validation" option.
26 Feb 2015
Version 1.5.0
  • Added - Configurable HTML message when the user confirms his account.
  • Added - Configurable redirect URL when the user confirms his account.
  • Added - Configurable HTML message when the admin confirms a user account.
  • Added - Configurable redirect URL when the admin confirms a user account.
  • Added - Ability to defer the sending of the Admin Email.
  • Added - Select the User Groups the newly created account will belong to.
  • Updated - Validation messages are now overwritten by the plugin (for example, if the user already exists).
  • Updated - No longer sends Joomla! registration emails (use RSForm! Pro Emails to do that instead).
  • Updated - All language strings are now included in the language file instead of using COM_USERS.
  • Updated - Now allows to create the account based on a condition.
22 Nov 2013
Initial Release

36 persons found this article helpful.


Was this article helpful?

Yes No
Sorry about that

You Should Also Read

Unique registration number HOT

Create a Joomla! registration form with dynamic user group assignment HOT