Overview
The Divi Contact Form Helper plugin by Pee-Aye Creative adds new dynamic custom merge tags to the Divi Contact Form module! Please note, this feature is very limited with just Divi, and our new custom options are impossible without our plugin, so we hope you enjoy this exciting feature! This guide will give you all the information you need about these new merge tags.
What Are Merge Tags?
How It Works In Divi
The standard Divi Contact Form has a feature called Message Pattern that allows you to place dynamic data into the message that is sent from the form. This is based on the field ID of each field in the contact form and can be wrapped by two percentage symbols %% at the beginning and the end of it. By using this feature, you can include the values of that specific field in the message layout in any way you want using these dynamic merge tags. For example, if I add a field to my form for “Name” and the ID of that field is “Name” then the merge tag to include in the message would be %%Name%%.
New Features In Our Plugin
The Divi Contact Form Helper introduces many new dynamic custom merge tags that are not available in the regular module. Below is a list of the ones added by our plugin.
Don’t forget you can use dynamic merge tags in the subject line, admin email, confirmation email, and even the success message! Check our tutorial on merge tags here!
All Fields
If you want to automatically include all fields, you can use our “all fields” custom merge tag which will dynamically display all the field labels and values in the form. We highly recommend using this one to save you a lot of hassle!
%%dcfh_all_fields%%Form Related
Entry Number
Whenever you are saving entries to the database, they each receive an entry number. This custom merge tag will dynamically display that entry number, which can be handy for admin reference or even used in the subject line as a support ticket number.
%%dcfh_entry_number%%Form Title
This custom merge tag will dynamically display the contact form title of the form where the entry is submitted. Note, the form title is an optional input field in the Divi Contact Form module that shows the form title above the form and also acts as the name of the form.
%%dcfh_contact_form_title%%Form ID
This custom merge tag will dynamically display the unique ID of the contact form where the entry is submitted. This would probably not be used in most cases, but can be used for admin reference purposes.
%%dcfh_contact_form_id%%Site Related
Site Name
This custom merge tag will dynamically display the site name. This may be helpful to know from which site the form is being submitted in case you are managing multiple websites.
%%dcfh_site_name%%Site Tagline
Similar to the site name, this custom merge tag will dynamically display the tagline of the site where the form is being submitted. It’s a nice thing to also have this tagline whenever using the site name.
%%dcfh_site_tagline%%Site URL
This custom merge tag will dynamically display the URL link of the site where the form is being submitted. This would be nice to show along with the title and tagline.
%%dcfh_site_url%%Site Login URL
This custom merge tag will dynamically display the URL link of the login page of the site where the form is being submitted.
%%dcfh_site_login_url%%Site Admin Info
This custom merge tag will dynamically display the info about the administrator user of the site where the form is being submitted. To use this one, be sure to add the username of the site admin inside the brackets. This is convenient if you want to end the email with a signature.
%%dcfh_site_admininfo_[username]%%Page Related
Post/Page ID
This custom merge tag will dynamically display the post or page ID from where the form is being submitted.
%%dcfh_post_id%%Post/Page Title
This custom merge tag will dynamically display the post or page title from where the form is being submitted. This can be very useful especially when you have forms on multiple pages on your site which related to specific services, products, or info.
%%dcfh_post_title%%Post/Page URL
This custom merge tag will dynamically display the post or page URL from where the form is being submitted. This goes great alongside the post/page title.
%%dcfh_post_url%%Referer URL
This custom merge tag will dynamically display the URL link of the page where the person visited just prior to reaching the page with the contact form. This is very useful data to know in regard to which page the person was visiting before going converting the visitor into taking action by going to the contact page.
%%dcfh_referer_url%%Submitter Related
Submitter ID
This custom merge tag will dynamically display the user ID of the person submitting the form. This is for logged-in users only.
%%dcfh_site_userinfo_id%%Submitter Name
This custom merge tag will dynamically display the name of the person submitting the form. This is for logged-in users only.
%%dcfh_site_userinfo_name%%Submitter Email
This custom merge tag will dynamically display the email address of the person submitting the form. This is for logged-in users only.
%%dcfh_site_userinfo_email%%Submitter Username
This custom merge tag will dynamically display the username of the person submitting the form. This is for logged-in users only.
%%dcfh_site_userinfo_username%%Submitter Registered
This custom merge tag will dynamically display whether the person submitting the form is registered or not.
%%dcfh_site_userinfo_registered%%Submitter IP Address
This custom merge tag will dynamically display the IP address of the person submitting the form. Be sure to follow all privacy laws when collecting IP addresses.
%%dcfh_user_ip%%Submitter Browser
This custom merge tag will dynamically display the browser information of the person submitting the form, which indicates to the admin which browser the person was using.
%%dcfh_browser%%Submitter Operating System
This custom merge tag will dynamically display the operating system information of the person submitting the form, which indicates to the admin which operating system the person was using.
%%dcfh_platform%%.Meta Related
Date Submitted
This custom merge tag will dynamically display the date when the form is submitted. Most inboxes would show the date received, but this can be very helpful to have on record.
%%dcfh_date%%Time Submitted
This custom merge tag will dynamically display the time when the form is submitted. Most inboxes would show the time recieved, but this can be very helpful to have on record.
%%dcfh_time%%URL Parameters
This custom merge tag will dynamically display the data from your own URL query parameters. You can use as many as you need following the pattern of wrapping each parameter in double %% signs.
%%yourparameter%%