VS Contact Form

Description

About

This is a lightweight plugin to create a customized contact form.

Add shortcode [contact] on a page or use the widget to display your form.

Form has fields for Name, Email, Subject and Message. It also has a sum to solve (to avoid abuse) and a privacy consent checkbox.

You can personalize your form via the settings page or by adding attributes to the shortcode or the widget.

It’s also possible to list form submissions in your dashboard.

How to use

After installation add shortcode [contact] on a page or use the widget to display your form.

Settings page

You can personalize your form via the settings page. This page is located at Settings > VS Contact Form.

Settings and labels can be overridden when using the relevant (shortcode) attributes below.

This can be useful when having multiple contact forms on your website.

Shortcode attributes

You can also personalize your form by adding attributes to the shortcode mentioned above. Attributes will override the settings page.

Misc:

• Add custom CSS class to form: class="your-class-here"
• Change default email address: email_to="your-email-here"
• Send to multiple email addresses (max 5): email_to="first-email-here, second-email-here"
• Change «From» email header: from_header="your-email-here"
• Change subject in email to admin: subject="your subject here"
• Change subject in auto-reply email to sender: subject_auto_reply="your subject here"

Field labels:

• Name: label_name="your label here"
• Email: label_email="your label here"
• Subject: label_subject="your label here"
• Message: label_message="your label here"
• Privacy consent: label_privacy="your label here"
• Submit: label_submit="your label here"

Field placeholders:

• Name: placeholder_name="your placeholder here"
• Email: placeholder_email="your placeholder here"
• Subject: placeholder_subject="your placeholder here"
• Message: placeholder_message="your placeholder here"

Field error labels:

• Name: error_name="your label here"
• Email: error_email="your label here"
• Subject: error_subject="your label here"
• Sum: error_sum="your label here"
• Message: error_message="your label here"
• Links: error_links="your label here"
• Bad words: error_bad_words="your label here"
• Privacy consent: error_privacy="your label here"

Messages:

• Displayed when sending succeeds: thank_you_message="your message here"
• Displayed in the auto-reply email to sender: auto_reply_message="your message here"

Examples:

• One attribute: [contact email_to="your-email-here"]
• Multiple attributes: [contact email_to="your-email-here" subject="your subject here" label_submit="your label here"]

Widget attributes

The widget supports the same attributes. Don’t add the main shortcode tag or the brackets.

Examples:

• One attribute: email_to="your-email-here"
• Multiple attributes: `email_to=»your-email-here» subject=»your subject here» label_submit=»your label here»

List form submissions in dashboard

You can activate the listing of form submissions in your dashboard via the settings page.

After activation you will notice a new menu item called «Submissions».

SMTP

SMTP (Simple Mail Transfer Protocol) is an internet standard for sending emails.

WordPress supports the PHP mail() function by default, but when using SMTP there’s less chance your form submissions are being marked as spam.

You must install an additional plugin for this, such as WP mail SMTP.

Uninstall

If you uninstall plugin via dashboard all form submissions and settings will be removed from database.

All posts of the (custom) post type «submission» will be removed.

You can avoid this via the settings page.

Question?

Please take a look at the FAQ section.

Translation

Not included but plugin supports WordPress language packs.

More translations are very welcome!

The translation folder inside this plugin is redundant but kept for reference.

Credits

Without the WordPress codex and help from the WordPress community I was not able to develop this plugin, so: thank you!

Enjoy!