This is a very simple translation-ready contact form. Use shortcode [contact] (email from admin will be used) or shortcode [contact email="your@e
Author: | Guido (profile at wordpress.org) |
WordPress version required: | 4.7 |
WordPress version tested: | 5.9.2 |
Plugin version: | 11.4 |
Added to WordPress repository: | 22-11-2013 |
Last updated: | 13-04-2024 |
Rating, %: | 96 |
Rated by: | 42 |
Plugin URI: | |
Total downloads: | 414 600 |
Active installs: | 10 000+ |
Click to start download
|
About
With this lightweight plugin you can create a contact form.
Add shortcode [contact] to 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 customize your form via the settings page or by adding attributes to the shortcode or the widget.
It’s also possible to display form submissions in your dashboard.
How to use
After installation add shortcode [contact] to a page to display your form.
You can also go to Appearance > Widgets and use the VS Contact Form widget to display your form.
Settings page
You can customize 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 attributes below.
This can be useful when having multiple contact forms on your website.
Attributes
You can also customize your form by adding attributes to the shortcode or the widget. Attributes will override the settings page.
Misc:
- Add custom CSS class to form:
class="your-class-here"
- Change 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:
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"
- Message – when links are not allowed:
error_message_has_links="your label here"
- Message – when email addresses are not allowed:
error_message_has_email="your label here"
- Banned words:
error_banned_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"
Example: [contact email_to="your-email-here" subject="your subject here" label_submit="your label here"]
When using the widget, don’t add the main shortcode tag or the brackets.
Example: email_to="your-email-here" subject="your subject here" label_submit="your label here"
Display form submissions in dashboard
Via the settings page you can activate form submissions being displayed in your dashboard.
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.
Cache
If you’re using a caching plugin and want to avoid conflicts with the contact form, I recommend excluding your contact page(s) from caching. This can be done via the settings page of most caching plugins.
Have a question?
Please take a look at the FAQ section.
Translation
Translations are not included, but the 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!
Screenshots
Very Simple Contact Form (GeneratePress theme).
Very Simple Contact Form (GeneratePress theme).
Very Simple Contact Form widget (GeneratePress theme).
Very Simple Contact Form widget (dashboard).
Very Simple Contact Form settingspage (dashboard).
Very Simple Contact Form settingspage (dashboard).
Very Simple Contact Form settingspage (dashboard).
Very Simple Contact Form settingspage (dashboard).
Very Simple Contact Form submissions (dashboard).
FAQ
About the FAQ
The FAQ are updated regularly to include support for newly added or changed plugin features.
How do I set plugin language?
Plugin will use the website language, set in Settings > General.
If plugin isn’t translated into this language, language fallback will be English.
What is the default admin email address?
By default form submissions will be send to the email address set in Settings > General.
You can change this via Settings > VSCF or by using an attribute.
What is the default email subject?
By default the email subject contains a prefix (the title of your website), followed by the subject that sender has filled in. If subject field is disabled it only contains the prefix (the title of your website).
You can change this by using an attribute.
The same subject will also be used in the confirmation email to sender.
Why is the “from” email address not from sender?
I have used a default so called “From” email header to avoid form submissions being marked as spam.
Best practice is using a “From” email header (an email address) that ends with your website domain.
That’s why the default “From” email header starts with “wordpress” and ends with your website domain.
You can change this by using an attribute.
Your reply to sender will use another email header, called “Reply-To”, which is the email address that sender has filled in.
How does the captcha work?
The captcha is a random number or a simple sum that changes on submit.
If you press submit and form has not been filled in completely or not correctly, the random number or sum changes. This means you must fill in the number or result of the sum again.
Can I disable the captcha?
No, this is not possible because it’s added for anti-spam reasons.
Can I display multiple forms on the same page?
Do not add multiple shortcodes on the same page. This might cause a conflict.
But you can display a form by using the shortcode and a form by using the widget, on the same page.
Why does form submission fail?
An error message is displayed if plugin was unable to send form. This might be caused by the settings of your server.
Your hosting provider might have disabled the mail function of your server. Please contact them for info.
They might advice you to install a SMTP plugin. For more info check the “SMTP” section.
Why am I not receiving form submissions?
- Please also check the junk/spam folder of your mailbox
- Check installation info above and check shortcode (attributes) for mistakes
- Install another contact form plugin to determine whether it’s caused by my plugin or something else
- In case you’re using a SMTP plugin, please check their settingspage for mistakes
Does this plugin have anti-spam features?
Of course, the native WordPress sanitizing and escaping functions are included.
It also contains 2 hidden honeypot fields and a simple numeric captcha.
Does this plugin meet the conditions of the GDPR?
The General Data Protection Regulation (GDPR) is a regulation in EU law on data protection and privacy for all individuals within the European Union.
I did my best to meet the conditions of the GDPR:
- You can activate a privacy consent checkbox on form
- You can disable collection of IP address
- Form submissions are safely stored in database, similar to how the native posts and pages are stored
- You can easily delete form submissions
Does this plugin have its own contact form block?
No, plugin doesn’t have its own block in the editor and there are no plans to add this anytime soon.
No Semantic versioning?
Version number doesn’t give you info about the type of update (major, minor, patch). You should check changelog for that.
How can I make a donation?
You like my plugin and you’re willing to make a donation? Thanks, I really appreciate that! There’s a PayPal donate link at my website.
ChangeLog
Version 11.4
- Fix: widget constructor
- This means you need to set existing widgets again
- Minor changes in code
Version 11.3
Version 11.2
- Fix: privacy checkbox in Twenty Twenty-One theme
- Increased width of input and textarea
- Width percentage does now include padding and border
- Changed setting for captcha type
- You may need to set captcha type again
Version 11.1
- Updated stylesheet
- Textual changes
Version 11.0
- New: sum captcha
- Changed query string parameters for shortcode and widget
- Thank you: when using the shortcode it’s “vscf-sh=success” and when using the widget it’s “vscf-wi=success”
- Server error: when using the shortcode it’s “vscf-sh=fail” and when using the widget it’s “vscf-wi=fail”
- Renamed file vscf-labels into vscf-variables
- Updated file uninstall
Version 10.9
- Display privacy consent info in submission only when feature is activated
- Minor changes in code
Version 10.8
- Removed files vscf-page-shortcode and vscf-widget-shortcode
- Added file vscf-shortcodes instead
Version 10.7
- Re-added attribute to change the prefix of the email subject
- By default this prefix is the title of your website
- Fix: redirect to success or fail message when using the WPBakery plugin
- Fix: undefined index
Version 10.6
- Added extra clearfixes in stylesheet
- Minor changes in code
Version 10.5
- Added extra CSS class to each field group
- This makes form customization much easier
For all versions please check file changelog.