README

Contributors: peterhebert
Tags: contact form, contact, form, bootstrap, foundation
Requires at least: 4.4
Tested up to: 6.8.3
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A simple contact form plugin that allows you to customize the template to match your theme

Description

This plugin creates a simple contact form that allows you to customize the template to match your theme.

The contact form has only three fields, which is great for keeping things simple:

• name
• email
• message

All fields are required in order to submit the form.

Upon successful submission, a simple thank you message will be displayed to the visitor. This message can be customized on the settings page.

Form Security

The plugin uses WordPress' nonce field functionality, as well two honeypot fields in order to prevent spam submissions.

All submitted data is validated and sanitized using the GUMP PHP input validation class.

Form Templates

The form has three basic styles:

• Plain - only basic styles applied; uses the browsers' native field validation along side the server side validation
• Bootstrap - Bootstrap 4 markup and client side validation
• Foundation - Foundation 6 for Sites markup and Abide client-side validation

Note - the Bootstrap and Foundation templates only provide the HTML markup. Your theme must include either the Bootstrap 4 or Foundation 6 framework in order to make the form display and for the client-side validation to function properly.

In addition to these templates, you can override the form display with custom markup to match your theme. Simply copy the default template templates/contact-form.php to contact-form/contact-form.php within your theme, and then make sure to select 'Default' under 'Form Template' in the plugin settings page.

Installation

1. Extract the plugin .zip and upload folder to the /wp-content/plugins/ directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to 'Settings > Contact Form' in the WordPress admin to customize your email and template settings.
4. Insert shortcode [themeable_contact_form] in your contact page to place form.

Frequently Asked Questions

Screenshots

Changelog

1.0.0

First stable release. Removed dependency on RationalOptionsForm class better conformity with WordPress coding standards.

0.3.3

Updated composer and node dependencies. Looser restriction on composer/installers

0.3.2

Updated composer and node dependencies.

0.3.1

Updated composer dependencies, installation instructions.

0.3.0

Properly retrieve saved plugin options for send email to.

0.2.0

Properly retrieve saved plugin options for email from name and address.

0.1

Initial plugin release.