Autofilling registration forms with URL queries
Introduction
If on a VCP Event or Conference, you need to autofill any of the registration form fields, this can be done by adding parameters to the URL and configuring the webform to allow this. Below are the instructions to complete this.
There is also a special parameter in the last section which will allow you to redirect the user to a specific page after they've submitted the registration form.
Instructions
Webform Configuration
Before constructing the URL, you need to make sure the registration form for the Event or Conference is configured to allow population via parameters.
- Log in to the admin for the VCP platform.
- Navigate to the list of Webforms;
Structure > Webforms
. - Find the form you want to configure to allow this.
- From the Operations dropdown for your registration form, select
Settings
. - Whilst in the Settings tab, select
Form
. - Scroll down to the Form Behaviors section.
- Under the Pre-populate heading, tick the box for
Allow all elements to be populated using query string parameters
. - Save the webform.
Now the webform is configured to allow it's fields to be populated using parameters from the URL.
URL Configuration
Configuring the URL will need to be done in the software you use to generate it. Here is an example of a constructed URL followed by a breakdown of its elements.
https://www.vcplive.com/equities-summit?first_name=John&last_name=Smith&email=john.smith@asset.tv&company=Asset.tv&job_title=Marketing#register-form
The URL can be broken down in 3 sections:
- Path to the Registration Page - a link to the event or conference.
- Parameters to be autofilled.
- Trigger to open the Registration Form - this opens the registration form for the user.
Parameters
Please make sure you test your URL configuration works prior to sending out a batch of emails to clients.
Parameter | Example |
---|---|
first_name |
John |
last_name |
Smith |
email |
john.smith@asset.tv |
company |
Asset.tv |
job_title |
Marketing |
Warning
These parameters must correspond to the key related to each of the field names else they will not work.
Redirect to a page
This URL parameter is special one which allows you to redirect a user to a specific page (most likely a video page) after they've registered for an event.
Parameter | Example |
---|---|
destination |
/[url minus the domain] |
Here is an example of the URL with the reg details from above included.
https://www.vcplive.com/equities-summit?first_name=Test2&last_name=Account&email=test3.account@asset.tv&company=Asset%20TV&job_title=Job%20Title&destination=/equities-summit/stages/equities-summit/thousand-dollar-hot-dog-blind-monkey-and-other-investment-insights-morgan-housel#register-form
In order for this to work consistently for all users, you'll need to either disable or lower the pass score for the recaptcha. This setting is adjusted in the Form Handler settings. Only adjust this if you know what you're doing.
Warning
Changing the recaptcha settings will lower the security for the page. This could affect registrations and performance by allowing bots to click through to content on the site.