WordPress.org

Ready to get started?Download WordPress

Plugin Directory

Easy Contact Forms

Easy Contact Forms is a simple solution for those who need comprehensive contact forms to run business.

1. How do I configure email notifications and confirmations?

When setting outgoing email addresses, please use addresses from your site domain name. There are several places to pay attention to. 1. Open the Easy Contact Forms Settings page and set an email address to be used for sending notifications. If you do not set it the WP Admin address will be used for this. 2. Open the SuperAdmin profile and change its name, or anything but never change its role. 3. Open the contact form mailing list and add users who should receive contact form submission notifications.

2. Where I can find additional information?

Please visit http://easy-contact-forms.com.

3. Sample contact form

Do not use the sample contact form, which is supplied with the plugin. Use a form copy. It is easy to create by pressing the Copy button found at the bottom of the contact form settings page

4. Which field types are supported by Easy Contact Forms?

  1. Field set - this is a container grouping the contact form fields into logical groups. Depending on your theme, the front-end contact form may show a frame label and a square frame around the fields.
  2. Field list - this is a container, which is similar to the field set except it does not show a frame around the contact form field groups and has an extra option allowing selecting the list label style: h1, h2, etc.
  3. Text is an ordinary contact form field allowing entering short text. It is useful when it is necessary to enter short textual data such as names, titles, etc.
  4. Text area, in opposite, is a contact form field, which is useful when it is necessary to enter long text, such as request descriptions, or biographical info.
  5. Email is a contact form field checking the email format and informing a site visitor when he or she makes a mistake in their email.
  6. Number is a contact form field, which accepts only decimal numbers.
  7. Checkbox is a contact form checkbox field.
  8. Select is a contact form dropdown list.
  9. Radio Group is a group of radio buttons.
  10. Hidden fields add a contact form anti-spam protection layer. It is hard to recognize this field among real contact form fields. This field uses server side validation only. It may protect a contact form from the majority of spam bots.
  11. reCaptcha is great at anti-spam job. In order to use it in your contact form, you should obtain private and public keys from google.com.
  12. Submit button just submits contact form data.
  13. File Upload field allows to upload a file and to attach it to contact form entry. To attach several files add several File fields to your contact form.

5. Which contact form field settings are available?

  1. Show label indicates whether the field label should display on the contact form.
  2. The Label box holds the field label text.
  3. Label position allows to indicate how the label is placed on the contact form.
  4. If it is necessary to change how a label looks on a front-end contact form, set Label CSS class and CSS style field value.
  5. Field description allows entering a brief message to explain the field purpose helping site visitors to fill out a contact form.
  6. Unset the Show description checkbox to quickly remove the description from a contact form.
  7. Description position allows moving the field description. It adds more flexibility to how a contact form looks.
  8. If it is necessary to adjust the field description style to improve the general contact form look, set the Description CSS class and/or CSS style fields.
  9. When the Set Default Value checkbox is set, the contact form field will display the defined value.
  10. The Blank checkbox allows indicating whether a contact form should treat this value as empty.
  11. If a field is required, the contact form validation functions, on both client and server sides, will not allow leaving this contact form field empty.
  12. The Set Required suffix checkbox allows displaying an asterisk (by default), which signals that this field is required.
  13. The CSS Class and CSS style field pair allows adjusting prefix style.
  14. The Required message text box allows changing the default error message.
  15. If the Absolute position checkbox is unset the error message the error message will be embedded into a contact form.
  16. The Validate check box triggers contact form validation actions.
  17. If the Set valid message checkbox is set a contact form will show a success message.
  18. The Set style checkbox allows indicating whether a field should use the style settings defined in the CSS Class and CSS Style fields.
  19. The Set size checkbox allows applying the field size settings.
  20. The Set contact options checkbox allows creating a link between a contact form and a database contact.
  21. The Registered Users option allows adjusting the contact form behavior when a registered site user visits the contact form page.
  22. Link to application field allows to select which database field should a contact form link to.

6. Where can I find information about other Easy Contact Form objects?

  1. The Entries tab of the contact form object contains a list of form entry list. The Process entry data button adds a new contact.
  2. The Users object is intended to store information coming from contact forms.
  3. If a contact form is configured to store data in the database, the plugin will try to find a user, having an entered email address and will create a new contact if the contact is not found.
  4. The Application settings Send from field is an email address, used to send notification messages.
  5. The Admin part of intensively uses jQuery, but the front end part contact forms do not use jQuery.
  6. Plugin successfully works in browsers even when JavaScript is disabled.

7. I have installed Easy Contact Forms, but I do not receive contact form submission notifications. What did I do wrong?

First, check if outgoing messages are sent if all the email address fields on the contact form Notifications and Confirmations pages are blank. In this case your default wp admin address will be used. (The only place where you should fill the address is your contact form primary recipient email). If you do not see any messages from your contact form, check your WordPress email settings and make sure that your WordPress installation sends email messages at all. After you begin receiving messages step by step add more addresses and names on the contact form Confirmation and Notification pages not forgetting to test each step.

8. Which phone formats are supported by your contact form?

Phone format regular expression is found on the Easy Contact Forms (Web) -> Settings page.

9. I click on the links to add the fields to the contact form notification email template, but nothing happens.

This issue occurs occasionally with Internet Explorer 9. Please try using Firefox or Chrome to edit your contact form settings.

10. I tried putting a reCaptcha field on my contact form, but it never showed up (not in the preview and not in the saved form on the web page.)

Open the Set reCatpcha options panel. You will find a link where you can get reCaptcha private and public keys for your site. It will take up to a minute. Insert the public and private keys into the corresponding contact form setting fields. Please make sure that you do not insert a public key into the private key field and vice-versa. Avoid inserting extra symbols and spaces

11. When I press the submit button the contact form returns 'Error. Status=0' error.

You will most likely see this error message because the site domain names in WP Settings Word Press Address (URL) and Site Address (URL) fields are different. Several browsers take this a security issue and do not allow normal contact form data sending. The best way to fix this issue is to set equal domain names in both fields. Another way is to try to set the Fix Status = 0 checkbox on the ECF Settings page. In this case the contact form submission function in the contact form preview window may stop working correctly.

12. I deleted the placeholder users and now it just says 'Please Log in' and I can no longer making any changes to my contact form

You will see this message because you have deleted the user with admin credentials. The simplest way is just to reinstall the plugin. WARNING: this will delete your contact form settings. If you already have important information entered, please contact our support team. After reactivating the plugin please add a new user, enter your contact data and assign the Super Admin role to that user.

13. I have created a contact form, but no what I do, the submit button will not display

Most probably your theme does not support loading wp_enqueue_script function when it loads shortcode content. The simplest way to check is to open the page html source and to try to find a file 'easy-contact-forms-forms.(version).js'. If you do not find the file, try to go to the Settings Page and select the Fix JS loading check-box. That may fix this issue. If, after that, it is still not fixed, that means that there are other compatibility issues. We wish you every success in trying other contact form plugins. One more common reason of this error is third-party JavaScript errors produced by the pages which contains the contact form.

14. Where can I find a detailed description of the contact form builder fields?

Settings

This object contains a list of general settings used by both the contact form admin part and a contact form on the front-end.

Object Fields:

Use Tiny MCE

If this checkbox is unset, it disables the TinyMCE editor on the contact form settings GUI. After this checkbox is set again, press your browser Reload button

Tiny MCE configuration

TinyMCE configuration string. Defines how TinyMCE looks on the contact form settings GUI. This field value normally should not be changed.

Show Powered by link

Unset this checkbox if you do not wish to display the Powered by link under your contact form.

Phone validation RegEx

Enter a new regular expression here, than go to each contact form phone number field and click Apply

Date format

Select a date format from the list below and click Apply. The date format will be applied to the date fields of the contact form settings GUI

Secret word

A string used for encryption. The longer the better. It should not be changed once it is set

File folder

This folder contains files attached to contact form entries. If you change the folder name do not forget to copy existent files into the new directory. If you are trying to attach a file to a contact form you receive 'It is not possible to create the folder. Please check folder access credentials', then you need to manually create a directory ../wp-content/plugins/easycontact_templates/your_file_dir_name, were your_file_dir_name - is the file directory name found in this field. Please make sure that the php process has permissions to read from and write to this directory. We also suggest placing 2 simple index.html files to the ../wp-content/plugins/easycontact_templates/your_file_dir_name and ../wp-content/plugins/easycontact_templates directories. This will help to prevent file directory browsing.

Fix JS loading (see the FAQ Section)

If you do not see a contact form submit button set this checkbox, then make any change to the form and save it

Fix Status = 0

Set this checkbox if your contact form shows Error Status = 0, then make any change to the form and save it

Admin part application width

Change this value if you need to change the contact form settings width in the admin panel

Application width

Change this value if you need to change the contact form settings GUI width on the site front end

Default style

Change this value if you have your own contact form settings style on the site front end

Admin part default style

Change this value if you have your own contact form settings style

Send from (address)

This address will be used to send contact form notification messages instead of default (WP admin)

Form completion min time (sec)

Set this value in order to restrict minimum contact form completion time (anti-spam protection)

Form completion max time (sec)

Set this value in order to restrict max contact form completion time (anti-spam protection)

Not logged in message

This text will display when a user does not have a user profile in the application, or does not have rights to access the contact form settings GIU. (His/her role is not Admin)

Entry files

This object is a wrapper for files which are uploaded by contact forms

Object Fields:

Date

The date of contact form submission

Entries

A contact form entry to which the file belongs

Form

A name of contact form the file was attached to

Entry id

Contact form entry id

Field

Contact form field name

Forms

This object is used to store contact form settings. It has all the necessary attributes to customize how contact form looks, which fields it has, to adjust confirmation and notification email message settings, to set a success message and a page to which to redirect after the contact form is submitted.

Object Fields:

Form name

This name will be used in the contact form notification email messages (i.e. From: "Contact form")

Form short code

Copy the shortcode below and paste it to a page or a post where you are planning to place a contact form.

Send email confirmations

Set this checkbox to send contact form confirmation email messages to those who submitted the form. Please make sure that the contact form has a field of 'Email' type.

Confirmation subject

Contact form confirmation email message subject. Supports {112.FirstName} fields

Send from (name)

Contact form confirmation email messages "From" name. i.e. "John Doe" or "My Company"

Reply-to email address

Use this field if you want to receive replies to contact form confirmation messages to other email address (i.e. jonhdoe@anotherdomain.com)

Send from (address)

Changes the default outgoing email address for contact form confirmation email messages. Use email addresses from your domain, i.e. anothername@my-wp-domain-name.com

Reply-to name

Use this field if you want to receive replies to contact form confirmation messages to other name, i.e. "John Smith"

Confirmation message template

This is a template used to compose a contact form confirmation message. Field names will be replaced with submitted values, i.e. "{112.FirstName}" will be replaced with John

Redirect

To redirect a visitor to any page after a contact form is submitted, set this check box and enter the target page URL

Redirect to URL

The URL to which a visitor is redirected after he or she submits a contact form

Show on dashboard

Show on the contact form statistics on the dashboard

Impressions

Contact form display count

Total entries

Contact form entry count

Total processed entries

A count of processed contact form entries

Show submission success text

Set this checkbox to show a thank you message after a contact form is submitted and enter the message text into the text box below

Submission success text

The thank you message text to appear after a contact form is submitted

Form mailing lists

This is a list of users who will receive contact form submission notifications

Notification message subject (for internal messages)

Contact form notification email message subject. Supports template (i.e. {112.FirstName}) fields

Primary notification message recipient

Select a user from the User list, who will receive notification messages from the contact form. If you need to add additional recipients, add them to the contact form mailing list. Make sure that all the recipients have a valid email address

Reply-to submitted address

Set this checkbox if you want to reply directly to a contact form submitter when you press Reply button

Reply-to name template

Set the email recipient name format, e.g. {nnn.FirstName} {nnn.LastName}, or just {nnn.FirstName}. Just add necessary fields to the contact form template field and then copy/paste them into this field

Notification message template (optional)

Contact form field names will be replaced with submitted values, i.e. "{112.FirstName}" will be replaced with John

Entries

A list of contact form submission entries

Fields

This is a contact form builder tab

Style sheet

CSS style settings to be applied by the front-end contact form

Confirmation message style

CSS style records, which will be sent along with a confirmation message in response to contact form submissions. Use this option very carefully, as not all email clients will support this.

Notification message style

CSS style records, which will be sent along with a contact form notification message in response to the contact form submission. Use this option very carefully as not all email clients will support this.

Form width

Use this field to explicitly set a contact form width

Row top margin

Vertical spacing between contact form fields

Line height unit

Front-end contact form line height unit

Style

Select a front-end contact form style from the list

More styles

A link to the style library

Form class

Contact form CSS class (optional). The CSS class may be defined in the Style sheet text box

Form style

CSS code, which will be added to the contact form style. Use this field when it is necessary to adjust how a contact form looks on a front-end page.

Success message class

Contact form 'Thank you' message CSS class (optional). You can define this class in the Style sheet text box or any other external css file which is loaded on the page where the contact form is placed.

Failure message class

CSS class, which will be used for an error message if the contact form server side validation routine returns an error

Send confirmations as text

Set this field to send contact form confirmation email messages in the text format

Send notification as text

Set this checkbox to send contact form notification email in the text format

Fading delay

Contact form fading duration, i.e. 1000 milliseconds. Defines how long a contact form switches to a thank you message. Leave it empty to use the default value

Message delay

Contact form success message display duration, i.e. 3000 milliseconds. Leave it empty to use the default value

Entries

This object holds contact form submission data

Object Fields:

Date

Contact form submission date

Form

A name of the submitted contact form

Page name

A name of a page the contact form was submitted on

Content

Contact form submission content

Entry files

A list of attached to a contact form files

User

A user from the plugin's contact list, who submitted the contact form

Site user

A WordPress user name of a visitor who submitted the contact form

Users

This object contains user profile information. This object is used to provide a structured way to store contact form submission values. One more purpose of this object is to manage access to the contact form settings interface.

Object Fields:

Last name

Last name. This field value cannot be directly set from contact form submission values.

Contact type

A field which can be used for simple contact segmentation. . This field value cannot be directly set from contact form submission values.

Role

User's role. If it is Admin, the user will get access to the Easy Contact Form back end.

First name

First name. This field value can be directly set from contact form submission values.

Site user

A link to WordPress user profile. This field is intended to use Wordperss user credentials to access contact form settings GUI.

Extra notes

A text field which can be used for business specific purposes. This field value cannot be directly set from contact form submission values.

Misc.

A text field which can be used for business specific purposes. This field value cannot be directly set from contact form submission values.

Date of Birth

The day of user birth. This field value cannot be directly set from contact form submission values.

Country

Country. This field value cannot be directly set from contact form submission values.

City

City. This field value cannot be directly set from contact form submission values.

State

State. This field value cannot be directly set from contact form submission values.

Zip

Zip code. This field value cannot be directly set from contact form submission values.

Address

Address line. This field value cannot be directly set from contact form submission values.

Email

Primary email address. This field value can be directly set from contact form submission values.

Email 2

Secondary email address. This field value cannot be directly set from contact form submission values.

Mobile

Mobile phone number. This field value cannot be directly set from contact form submission values.

Phone 1

Phone 1. This field value cannot be directly set from contact form submission values.

Phone 2

Phone 2. This field value cannot be directly set from contact form submission values.

Phone 3

Phone 3. This field value cannot be directly set from contact form submission values.

Skype id

Skype id. This field value cannot be directly set from contact form submission values.

Website

User's website URL. This field value cannot be directly set from contact form submission values.

Form mailing lists

A set of contact form mailing lists the user belongs to

Forms

A list of contact forms which mailing lists the user does not belong to

15. How do I make my contact form W3C (XHTML and HTML5) compliant?

Please take into consideration that a contact form may behave in this mode slightly different and after you made this change you should revisit each contact form you have on your site.
1. Open the Easy Contact Forms Settings panel and check the Run in w3c compliant mode checkbox. 2. Open each contact form and make a slight change to it. For example check (or uncheck) the Redirect checkbox font on the contact form General Settings page, click Apply, then change it back and click Apply again. 3. Open each Text Area field you have on a contact form and do the same. I.e. Set (or unset) the Show label checkbox, click Apply, change the value back and click Apply again. 4. Do the same with each Submit button found on your contact form. 5. Open the contact form on the front end and check if it looks good and test it. 6. Open the contact form on the front end and check if it looks good and test it. The function allowing to see a contact form in the preview window is currently (v.1.4.5) not compatible with the w3c compliant mode. In order to change everything back, please uncheck the the Run in w3c compliant mode checkbox. Click Apply and repeat steps 3-6

Requires: 3.3 or higher
Compatible up to: 3.7.1
Last Updated: 2013-11-20
Downloads: 546,074

Ratings

4 stars
4.3 out of 5 stars

Support

1 of 16 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

4 people say it works.
4 people say it's broken.

100,5,5 100,5,5 83,6,5 100,1,1
100,2,2 81,16,13 100,2,2 100,4,4 100,1,1
50,2,1
88,8,7
0,2,0
40,5,2
67,3,2 42,12,5 100,2,2 100,2,2 100,1,1
100,1,1 0,2,0
0,1,0 67,3,2
80,5,4
100,4,4
71,7,5
86,7,6
0,2,0
0,4,0
50,8,4