=== Very Simple Contact Form ===
Contributors: Guido07111975
Version: 11.0
License: GNU General Public License v3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html
Requires PHP: 5.6
Requires at least: 4.7
Tested up to: 5.5
Stable tag: trunk
Tags: simple, contact, form, contact form, email


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.


== 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 privacy consent checkbox and a simple numeric captcha.

You can personalize your form via the settingspage 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.

= Settingspage =
You can personalize your form via the settingspage. This page can be found via Settings > VSCF.

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.

Misc:

* Change admin email address: `email_to="your-email-here"`
* Send to multiple email addresses: `email_to="first-email-here, second-email-here"`
* Change "From" email header: `from_header="your-email-here"`
* Change prefix of email subject: `prefix_subject="your prefix here"`
* Change email subject: `subject="your subject here"`
* Change CSS class of form: `class="your-class-here"`

Field labels:

* Change name label: `label_name="your label here"`
* Change email label: `label_email="your label here"`
* Change subject label: `label_subject="your label here"`
* Change captcha label: `label_captcha="your label here"`
* Change sum captcha label: `label_captcha_sum="your label here"`
* Change message label: `label_message="your label here"`
* Change privacy consent label: `label_privacy="your label here"`
* Change submit label: `label_submit="your label here"`

Field error labels:

* Change name error label: `error_name="your label here"`
* Change email error label: `error_email="your label here"`
* Change subject error label: `error_subject="your label here"`
* Change captcha error label: `error_captcha="your label here"`
* Change sum captcha error label: `error_captcha_sum="your label here"`
* Change message error label: `error_message="your label here"`

Form messages:

* Change message when sending fails: `message_error="your message here"`
* Change message when sending succeeds: `message_success="your message here"`
* Change message in confirmation email when sending succeeds: `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" class="your-class-here"]`

= Widget attributes =
The widget supports the same attributes. You don't have to 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" class="your-class-here"`

= List form submissions in dashboard =
Via Settings > VSCF you can activate the listing of form submissions 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 should install an additional plugin for this, such as:

* [Post SMTP](https://wordpress.org/plugins/post-smtp/)
* [WP mail SMTP](https://wordpress.org/plugins/wp-mail-smtp/)
* [Easy WP SMTP](https://wordpress.org/plugins/easy-wp-smtp/)

Use these plugins at your own risk. For support visit the relevant plugin forum.

= 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 Settings > VSCF.

= Question? =
Please take a look at the FAQ section.

= Translation =
Not included but plugin supports WordPress language packs.

More [translations](https://translate.wordpress.org/projects/wp-plugins/very-simple-contact-form) are very welcome!

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

Enjoy!


== Installation ==
Please check Description section for installation info.


== Frequently Asked Questions ==
= About the FAQ =
The FAQ applies to the most recent plugin version, as they are regularly updated 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.

This means if you press submit and form has not been filled in completely or not correctly, the random number or sum is changed. This means you must fill in the number or result of the sum again.

= 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, it does not have its own contact form block and I'm not planning to add this feature.

= Why no Semantic versioning? =
At time of initial plugin release I wasn't aware of the Semantic versioning (sequence of three digits).

= How can I make a donation? =
You like my plugin and you're willing to make a donation? Nice! There's a PayPal donate link at my website.

= Other question or comment? =
Please open a topic in plugin forum.


== Changelog ==
= 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

For all versions please check file changelog.


== Screenshots ==
1. Very Simple Contact Form (Twenty Nineteen theme).
2. Very Simple Contact Form (Twenty Nineteen theme).
3. Very Simple Contact Form widget (Twenty Nineteen theme).
4. Very Simple Contact Form widget (dashboard).
5. Very Simple Contact Form settingspage (dashboard).
6. Very Simple Contact Form settingspage (dashboard).
7. Very Simple Contact Form settingspage (dashboard).
8. Very Simple Contact Form submissions (dashboard).