Creating a User Registration formPro

Freeform allows you to easily create and manage beautiful User registration forms in only minutes! Using the Elements integration, you can enhance your forms with 1-click to enable AJAX, set conditional field logic to show and hide fields, confirm emails and passwords, add Captchas and send custom email notifications! Pair with Payments and you can even accept one time or recurring subscription payments for membership! Leave the heavy lifting to Freeform!

Instructions

This feature requires the Freeform Pro and Craft Pro edition in order to work, as Users are a Craft Pro feature.

1

Set up a User Element Integration

• Go to the Elements integration area in the Freeform settings (Freeform → Settings → Elements).
• Click on the New Integration button at the top right.
• Select User for the Service Provider setting.
• Provide a name for the integration, e.g. Users.
• Configure the default setting (this can be overrided for each form inside the form builder):
  • Activate Users - toggle whether the new user account should be active or not.
• Save the integration.

2

Prepare the Form

• Create a new form in Freeform. We'll call it User Registration.
• Add the fields to the form layout. You can set things up however you like, but keep in mind that some fields are required by Craft. A common registration form might have the following (but not limited to):
  • First Name
  • Last Name
  • Username
  • Email Address
  • Confirm Email Address
    • Use the Confirm field type to set this up.
  • Password
    • Use the Password field type for this. It will NOT save any password data in the Freeform database tables.
    • Set a value for the Min Length setting to ensure users are creating long enough passwords.
    • Enable the Use Character Variability setting to force users to create strong passwords.
  • Confirm Password
    • Use the Confirm field type to set this up.
  • A checkbox to sign up for a newsletter.

3

Enable the Integration and Map Fields

• Click on the Integrations tab in the form builder.
• Find your Users element integration in the list on the left and click on it.
• Toggle ON the Enabled setting.
• The default settings will show. If you need to override any of these, you can do so here:
  • User Group - select the user group to assign new users to.
    All user groups (including ones with access to CP) will show here. Use extreme caution if allowing users to self-register for accounts that can access the Craft control panel!

  • Activate Users - toggle whether the new user account should be active or not.
  • Send Activation Email - whether to send an activation email to the user (if Activate Users is toggled off).
    • If you'd like new users created from Freeform submissions to not yet be activated (and receive the Craft User Activation email) when submitted, toggle on the Activate Users setting. If you'd like to manually approve registrations (please see warning below) and suppress the email notification to users, toggle off the Send Activation Email setting.
      When using a manual Admin approving approach, it's still possible for a Pending user to circumvent this process if a Forgot Password form is available to them, as Craft currently does not have a concept of Admin approval only, and allows users to verify their account either through an email notification or using a Forgot Password form.

    • If you wish to have users automatically logged in upon success, please be sure to use the 'autoLoginAfterAccountActivation' => true, config item in your Craft config file, and toggle on the Activate Users setting.
• In the Attribute Mapping table, map your Freeform fields to the core Craft User fields.
• In the Field Mapping table, map your Freeform fields to your custom Craft User fields.
  There are some obvious limitations with field mapping, as Freeform does not have anything like a Matrix or Table field, etc. Most traditional fields that are similar to each other should be able to correctly map to each other however.

Finished!

Once that's all finished, you'll have something that looks like the screenshots above. Check out your form in the Freeform demo templates and see if everything works correctly.

Important Notes

• Freeform submissions can map to sections with auto-generated titles. Just make sure to set the fields you're using to map to Craft fields that populate the title field to be required on Freeform's end, otherwise the submission likely won't generate the Craft Entry if data for the title is missing.
• Freeform attempts to route User-based errors to the mapped fields. In some cases you might see more than 1 error for a Freeform field because of this. The fields that are mapped to essential fields like username, email and password will mention that "Email cannot be blank", etc.
• While multipage forms do appear to map correctly to users, you may see some slightly unusual behavior. For example, if you have your Password field placed in the second page, when submitting from the first page to the second page, the second page will highlight the field mapped to the Password field highlighted with an error. The whole process still works, but there's that visual issue.
• If the submission is blocked or flagged as spam, there's currently no way to retroactively map submission data to Users. The best option for avoiding this would be using Captchas.