Setup Web to Lead Form

The CRM Web to Lead feature allow you to build a web form based on leads fields and custom fields to place on your website, landing page, etc as an iframe.

The visitors can then enter their names, email addresses, upload attachments, and other basic information to create a lead directly in the CRM.

To create a new web to lead form, from the main admin menu navigate to Setup->Leads->Web To Lead

Click on the button on the top left side New Form

NOTE: You will be able to build the form after you first create the initial form including all the settings.

1. Form Name – Give your form a name, it’s for personal use and also will be displayed in the lead profile when you open a lead.
2. Language – The language is currently used only for the validation messages.
3. Submit button text – The bottom where the user will need to click to submit the form E.q. Request a Quote or Contact us, feel free to adjust to fit your needs.
4. Message to show after the form is successfully submitted – This message will be shown after use successfully submitting the form.
5. Allow duplicate Leads to be inserted into a database? – Often in web to lead forms duplicate leads are inserted into the database. the CRM has the ability to prevent this from happening by auto-creating the lead as a task including all form data as a description instead of inserting directly into the lead’s database, in this case, the responsible staff member will need to analyze the lead data and take further actions.
6. Source – Default lead source
7. Status – The lead will need to be in status after successfully being imported into the CRM database.
8. Responsible – Auto-assign the lead to a specific staff member.
9. Notification settings – All users based on the notification type will be notified via built-in notification inside the CRM and additionally the responsible lead staff member will get an email notification if in Setup->Email Templates -> New Lead Assigned to Staff Member is not checked as disabled.
10. Recaptcha – You can use Google Recaptcha to prevent spamming. The field for Google Recaptcha will be shown only if you have previously configured the Recaptcha keys.

After you create the form 2 new tabs will be shown in the form area Form Builder and Integration Code.

• Form Builder – The place where you build the form and adjust all the fields you need.
• Integration Code is the code you will need to place into your website for the form to be shown, note that from the link you will be able to see that each has a unique key.

Building The Form

When you save the initial form settings you will be automatically pointed on the Form Builder tab and on the left side you will be able to see all the available form fields taken from the lead profile. Note that if you have custom fields for leads you will be able to include your custom fields inside the form easily with drag and drop.

There is only 1 exception where the custom fields of type Hyperlink do not have support to be included in the web to lead form.

To add a field to the form just drag the field to the right side in the form area. 

After you drag the field you will be able to see on the left side the dragging ability to this field will be disabled. You can only add the field in the form once to prevent confusion with the form data.

Customizing The Fields

If the fields don’t fit exactly your needs you can customize the labels, add help text, placeholders and make them required. When you drag the field in the form area just hover over the field on the top right side you will be able to see 2 buttons (edit and remove)

After you customize the form click on the bottom left button SAVE and click on the tab Integration Code to get the code you need to add to your website. The code will be placed as an iframe and you can adjust the width and height directly to the code snippet provided by the CRM.

Styling

If you need to style the color of the input fields to fit with your website you can create a custom.css file in assets/CSS and apply the necessary styles.

Example changing inputs border color:

body.web-to-lead input {
	border-color:red;
}

Example changing submit button background color:

body.web-to-lead #form_submit {
	background:red;
}

body.web-to-lead #form_submit:hover,
body.web-to-lead #form_submit:active {
	background:green;
}

Redirect User to Custom URL After Form Submission

Via FTP/cPanel go to application/helpers/ and create (if don’t exist) file my_functions_helper.php and add the following code snippet:

hooks()->add_action('web_to_lead_form_submitted','my_web_to_lead_form_submitted_redirect_to_custom_url');

function my_web_to_lead_form_submitted_redirect_to_custom_url($data){
    echo json_encode(array(
      'success'=>true,
      'redirect_url'=>'http://yourcustomurl.com'
    ));
    die;
}

Don’t forget to include the <?php opening tag at the top of the file if it’s not already added.

Include logo in the form

To include your company logo in the form, you can either share or embed the URL with query string parameter as shown below:

https://your-crm-installation.com/forms/wtl/715d3e13cea500fc168faa4e3dcb8e24?with_logo=1

Direct link sharing

The forms can be shared directly to your customers without actually embedding the form on your website, this feature is useful for example if you want to include a link in emails, SMS, etc…

In order for the CRM can know that the form link is shared directly and not embedded into an iframe, you need to specify the URL query string, in this case, the CRM will provide better styling to the form.

https://your-crm-installation.com/forms/wtl/715d3e13cea500fc168faa4e3dcb8e24?with_logo=1&styled=1

Create Multi-Column Form Layouts in Web To Lead Form (available from v1.9.0)

By default, the form fields will be added in a single column full width of the document if you want to customize the form and have the fields displayed in multiple columns we have added the ability to achieve this with custom classes applied to the field, you can add up to 12 columns in 1 row.

In the following example, we will create 2 fields in 2 columns and 1 row.

Keep in mind that the columns won’t be applied in the form builder, only when the form is viewed by accessing the integration link or is in an iframe.

Here is a quick example:

Final result:

Assume that in your form builder you have 4 fields, as in order Name, Email Address, Company, Address.

For the first 2 fields click on the EDIT button on the top right side of the field wrapper to slide down the edit area, in the class input add an additional class for both fields form-col-6 as shown in the image below.

Save the form by clicking on the save button and previewing the form from the integration link to see the final result.

As mentioned before you can add up to 12 columns, in this case, form-col-6 + form-col-6 = 12, in case you want to add 3 columns apply the class form-col-4 on 3 fields (form-col-4*3 fields will be 12 and the fields will fit the document) that are one by one in order.

Few things to consider

1. Never leave the form without the required fields. By default, the name field will be required and it’s not recommended to uncheck as required.
2. When placing the iframe snippet code there are a few things you need to consider.
   1. If the protocol of your CRM installation is HTTP then use an HTTP page inside the iframe.
   2. If the protocol of your CRM installation is HTTPS then use an HTTPS page inside the iframe.
   3. Summarized will be no SSL the CRM installation will need to place the link in no SSL eq landing page and backward, SSL websites with SSL the CRM installation and no SSL website with none SSL the CRM installation. You can read more about this here