A clean and simple AJAX contact form with Google reCAPTCHA, Twitter Bootstrap markup and Akismet spam filtering.
Clean: all user inputs are stripped in order to avoid cross-site scripting (XSS) vulnerabilities.
Simple: AJAX enabled validation and submission for immediate response and guidance for your users (can be switched off).
Stylish: Use the included stylesheet or switch it off and use your own for seamless integration with your website.
Uses Twitter Bootstrap classes.
Safe: All incoming data is scanned for spam with Akismet.
This is a straightforward contact form for your WordPress site. There is very minimal set-up
required. Simply install, activate, and then place the short code [cscf-contact-form] on your web page.
A standard set of input boxes are provided, these include Email Address, Name, Message and a nice big ‘Send Message’ button.
When your user has completed the form an email will be sent to you containing your user’s message.
To reply simply click the ‘reply’ button on your email client.
The email address used is the one you have set up in WordPress under ‘Settings’ -> ‘General’, so do check this is correct.
To help prevent spam all data is scanned via Akismet.
For this to work you must have the Akismet Plugin installed and activated.
All spam will be placed in your ‘comments’ list which you can then review if you want to,
For added piece of mind this plugin also allows you to add a ‘reCAPTCHA’.
This adds a picture of a couple of words to the bottom of the contact form.
Your user must correctly type the words before the form can be submitted, and in so doing, prove that they are human.
Why Choose This Plugin?
Granted there are many plugins of this type in existence already. Why use this one in-particular?
Minimal setup. Simply activate the plugin and place the shortcode [cscf-contact-form] on any post or page.
Safe. All input entered by your user is stripped back to minimise as far as possible the likelihood of any
malicious user attempting to inject a script into your website.
If the Akismet plugin is activated all form data will be scanned for spam.
You can turn on reCAPTCHA to avoid your form being abused by bots.
Ajax enabled. You have the option to turn on AJAX (client-side) validation and submission which gives your users an immediate response when completing the form without having to wait for the page to refresh.
The form can integrate seamlessly into your website. Turn off the plugin’s default css style sheet so that your theme’s style sheet can be used instead.
If your theme is based on twitter bootstrap then this plugin will fit right in because it already has all the right div’s and CSS classes for bootstrap.
This plugin will only link in its jQuery file where it’s needed, it will not impose itself on every page of your whole site!
Works with the latest version of WordPress.
Original plugin written by an experienced PHP programmer, Megan Nicholas, the code is rock solid, safe, and rigorously tested as standard practice.
Hopefully this plugin will fulfil all your needs.
PHP 8 Ready
Tested on PHP 8.0
How to Use
Unless you want to change messages or add reCAPTCHA to your contact form then this plugin will work out of the box without any additional setup.
Important: Check that you have an email address set-up in your WordPress ‘Settings’->’General’ page. This is the address that the plugin will use to send the contents of the contact form.
To add the contact form to your WordPress website simply place the shortcode [cscf-contact-form] on the post or page that you wish the form to appear on.
If you have Jetpack plugin installed disable the contact form otherwise the wrong form might display.
This plugin will work out of the box without any additional setup. You have the option to change the default messages that are displayed to your user and to add reCAPTCHA capabilities.
Go to the settings screen for the contact form plugin.
You will find a link to the setting screen against the entry of this plugin on the ‘Installed Plugins’ page.
Here is a list of things that you can change
Message: The message displayed to the user at the top of the contact form.
Message Sent Heading: The message heading or title displayed to the user after the message has been sent.
Message Sent Content: The message content or body displayed to the user after the message has been sent.
Use this plugin’s default stylesheet: The plugin comes with a default style sheet to make the form look nice for your user. Untick this if you want to use your theme’s stylesheet instead. The default stylesheet will simply not be linked in.
Use client side validation (Ajax): When ticked the contact form will be validated and submitted on the client giving your user instant feedback if they have filled the form in incorrectly. If you wish the form to be validated and submitted only to the server then untick this option.
Use reCAPTCHA: Tick this option if you wish your form to have a reCAPTCHA box. ReCAPTCHA helps to avoid spam bots using your form by checking that the form filler is actually a real person. To use reCAPTCHA you will need to get a some special keys from google https://www.google.com/recaptcha/admin/create. Once you have your keys enter them into the Public key and Private key boxes
reCAPTCHA Public Key: Enter the public key that you obtained from here.
reCAPTCHA Private Key: Enter the private key that you obtained from here.
reCAPTCHA Theme: Here you can change the reCAPTCHA box theme so that it fits with the style of your website.
Recipient Emails: The email address where you would like all messages to be sent.
This will default to the email address you have specified under ‘E-Mail Address’ in your WordPress General Settings.
If you want your mail sent to a different address then enter it here.
You may enter multiple email addresses by clicking the ‘+’ button.
Confirm Email Address: Email confirmation is now optional. To force your user to re-type their email address tick ‘Confirm Email Address’.
It is recommended that you leave this option on. If you turn this option off your user will only have to enter their email address once,
but if they enter it incorrectly you will have no way of getting back to them!
Email Subject: This is the email subject that will appear on all messages. If you would like to set it to something different then enter it here.
Override ‘From’ Address: If you tick this and then fill in the ‘From Address:’ box then all email will be sent from the given address NOT from the email address given by the form filler.
**Option to allow enquiry to email themselves a copy of the message.
Contact consent: This option allows you to be GDPR compliant by adding a ‘Consent to contact’ check box at the bottom of the form.
Demo site coming soon.
There are two ways to install:
Click the ‘Install Now’ link from the plugin library listing to automatically download and install.
Download the plugin as a zip file. To install the zip file simply double click to extract it and place the whole folder in your wordpress plugins folder, e.g. [wordpress]/wp-content/plugins where [wordpress] is the directory that you installed WordPress in.
Then visit the plugin page on your wordpress site and click ‘Activate’ against the ‘Clean and Simple Contact Form’ plugin listing.
To place the contact form on your page use the shortcode [cscf-contact-form]
I get a message to say that the message could not be sent
If you get this message then you have a general problem with email on your server. This plugin uses WordPress’s send mail function.
So a problem sending mail from this plugin indicates that WordPress as a whole cannot send email.
Contact your web host provider for help, or use an SMTP plugin to use a third party email service.
I don’t receive the email
- Check the recipient email on your settings screen, is it correct?
- Check in your spam or junk mail folder
- For Gmail check in ‘All Mail’, the email might have gone straight to archive
- Try overriding the ‘From’ email address in the settings screen. Use an email address you own or is from your own domain
Why is a different contact form displayed?
You may have a conflict with another plugin. Either deactivate the other contact form plugin, if you don’t need it, or use
this alternative short code on your webpage –
This problem often occurs when Jetpack plugin is installed.
How do I display the contact form on my page/post?
To put the contact form on your page, add the text:
The contact form will appear when you view the page.
When I use the style sheet that comes with the plugin my theme is affected
It is impossible to test this plugin with all themes. Styling incompatibilities can occur. In this case, switch off the default stylesheet on the settings
screen so you can add your own styles to your theme’s stylesheet.
Can I have this plugin in my own language?
Yes, I am currently building up translation files for this plugin.
If your language is not yet available you are very welcome to translate it.
How do I change the text box sizes?
The plugin now uses Bootstrap 3. The text box widths now use up 100% of the available width.
This makes the form responsive to all types of media. If you want to have a fixed width for the form you can put some styling around the shortcode:
Can I have multiple forms?
Currently you may only have one contact form per page. You CAN however put the contact form on more than one page using the same shortcode.
Note that making changes to the settings will affect all implementations of the plugin across your site.
Will this work with other plugins that use Google reCAPTCHA?
Yes it will. HOWEVER, you cannot have more than one reCAPTCHA on a page. This is a constraint created by Google.
So for example, if your ‘Contact Me’ page has comments below it,
the reCAPTCHA for the contact form will be displayed correctly but not in the comments form below.
The comments form will never validate due to no supplied reCAPTCHA code.
- update donation lib
- Add donatation and contribution information
- update readme
- tested PHP 8.0
- Introduced optional input field for phone number
- Exclude consent message from email if disabled
- Fixed spacing and line breaks in email template
- Fixed minor issues on settings page
- Added consent & email to copy email if requested
- Set copy email headers to text
- correct a couple of text domain issues introduced at 4.7.2
- correct santization
- correct from email in certain circumstances
- Updated santization and escaping to current plugin directory recommendations
- add email header to specify text to improve formatting
- tested up to 5.8 beta 2 and PHP 8.0
- Tested with WordPress version 5.3
Fixed XSS vulnerability in GDPR consent message
- Tested with WordPress version 4.9.6
- Added consent to contact checkbox for GDPR compliance
- Turkish translation update. Thanks to Abdullah Manaz! Tested up to WordPress 4.6.1.
- Fixed untranslated strings. Thanks to Abdullah Manaz!
- Prevent multiple ‘send message’ clicks.
- Changed text domain to plugin slug to allow for WP translation system import
- Removed advertising from settings screen
- Added Korean translation thanks to Lee Dae-yeop
- Added Romanian translation. Thanks to Marius Pruna.
- Update French translation thanks to Steph
- Added Hungarian translation. Thanks to János Sánta.
- Updated Polish translations thanks to Kacper
- Updated French translation
- Added support for google recaptcha2. Replaces recaptcha version 1
- Update to Italian translation thanks to Silvano
- Added back the DIV to the contact form view as this introduced a display issue
- Updated German translation thanks to schasoli
- Polish translation update thanks to Kacper Rucinski
- Added Serbian translation thanks to Borisa Djuraskovic
- Added Slovenian translation thanks to Bekim Lutolli
- Fixed some ‘notice’ errors
- Recaptcha styling workaround for twenty fifteen theme
- Remove empty divs from view
- Remove branding
- Akismet tweak only log as spam if akismet_result = ‘true’
- Updated Turkish translations thanks again to Abdullah Manaz
- Added Indonesian translations thanks to Beny Hirmansyah
- Fixed XSS issue
- Add option for enquiry to email themselves a copy of the message
- Update to Polish translation thanks to Radosław “Robaczek” Rak
- Added the wordpress page of contact form to the email
- Removed link in main contact form view
- Before overriding the from address, check that another plugin has not done it first.
Any plugin that overrides ‘from email address’ and ‘from name’ such as wp-mail-smtp plugin will take precedence over the settings in this plugin.
- Added ‘reply-to’ to the email header
- Moved the Name field before Email field
- Added Hebrew translation thanks to Shay Cohen
- Added Norwegian Bokmål translation thanks to Jann Vestby
- Added Brazilian Portugese translation originally a Portugese translation by Ricardo Santos aka BogasoBogolha
- Polish translation has been updated thanks to Arkadiusz Baron
- Updated Turkish translations thanks again to Abdullah Manaz
- New installations now have default stylesheet, ajax, and confirm-email options turned on
- Compatibility with WordPress 3.8
- Tested with twentyfourteen theme
- Contact form is now filtered for spam when the Akisturkishturkishturkmet plugin is present.
- Fixed bug that caused a PHP notice to be generated when ‘Confirm Email Message’ option is switched off.
Thanks to MarrsAttax
- The requirement for users to confirm their email address is now optional.
When turned off users only need to enter their email address once.
- Added Arabic translation thanks to Omar AlQabandi
- Added ability to specify multiple recipient email addresses
- Recaptcha library has now been namespaced to ‘cscf’ to remove ALL possibility of conflicts with other plugins that also include this library.
- Fixed potential conflict with other themes or plugins that use Google reCAPTCHA. reCAPTCHA library is not loaded if it already loaded by another plugin or theme.
- Recaptcha library function is now used to generate the sign up url on the settings page. The site domain is passed into the url for convenience.
- Options subject, message, heading, and body text are now translated when they are retrieved from the the database. Previously only the default messages were translated when no values were found in the database.
- Improved housekeeping: generic name for settings array has been changed from ‘array_key’ to ‘cscf-options’
- Updated Turkish translations thanks again to Abdullah Manaz
- Fixed a problem where certain texts on the settings screen were not being translated
thanks to Abdullah Manaz again for finding this
- Updates to FAQ section
- The settings link on the plugin page may now be translated
- The text ‘Contact Form’ on the admin screen menu may now be translated
- Added Greek translations thanks to Georgios Diamantopoulos
- Added support for Bootstrap 3.0.0. Plugin is still compatible with Bootstrap 2.3.2, but if your theme uses this version
please do not use the plugin’s default style sheet (uncheck the box in the settings screen)
more information here.
- Added Russian Translation thanks to Oleg
- Correct character encoding in Estonian translation thanks to Marko Punnar
- Correct some Spanish translation errors thanks to rowanda
- Added a note about the short code to use on the settings screen.
- Added Estonian Translation thanks to Marko Punnar
- Added Japanese language thanks to Nikhil Khullar
- Updated Turkish translation thanks again to Abdullah Manaz http://manaz.net
- Added ability to specify a ‘from’ address. When supplied the email will come from that address instead of the form filler’s email address.
- Changed type of email input boxes to “email”
- Added Turkish translation thanks to Abdullah Manaz http://manaz.net
- Removed all carriage returns from views to avoid problems with wptexturize
- Fixed typo in Dutch translation.
- Added Slovak translation file – thanks to Peter Gašparík
- Added Catalan translation file – thanks to Llorenç
- Fixed escaped characters.
- Added more translation files
- Forms now submit via ajax.
- Upgraded jquery-validate.js to 1.11. Removed jquery metadata plugin, form validation is now built with data attributes instead of json in classes.
- Improved view html.
- Added translations: Dutch thanks to Daniel Tetteroo, Armenian thanks to Artak Kolyan,
Polish thanks to Patryk Peas
- Added some FAQs
- Added alternative shortcode [cscf-contact-form] for use when conflicts could occur.
- Updated the documentation.
- Recaptcha form now responds to language changes
- Updated pot file to reflect new name space
- Changed name space from cff to cscf
- Settings screen: recaptcha theme and key inputs are immediately enabled/disabled as the ‘Use reCAPTCHA’ box is clicked.
- Corrected some html seen as invalid by http://validator.w3.org/
- removed ‘<?=’ and replaced with ‘<?php echo’ in cscf_settings, thanks go to andrewbacon
- Added notice to setting screen when JetPack’s contact form is active
- Fixed problem where ‘Please enter a valid email address’ was not translating in the ‘confirm email address’ input
- Fixed potential conflicts with themes that use bootstrap
- Enabled internationalisation, this plugin will now work with multiple languages
- Added German translation file for my German friends, thanks to faktorzweinet for the translation
- Fixed a bug in class.cff_settings.php where php opening tag had got missed off. This problem caused the settings screen not to display correctly but only occurred with some versions of php. Please upgrade if you have this problem.
- Switched header argument of wp_mail over to a filter to remove any potential conflicts with other emailing plugins or themes
- The ability to set a different recipient email address. Previously all email was sent to the WordPress administrator email address.
- Allow the email subject to be customised.
- Fixed a bug: When using reCAPTCHA ajax did not work.
- Fixed a bug: Ajax validation was not checking email address were equal (server side was doing it instead)
- Improvement: Ajax now works better.
- Documentation update: nicer links (worked how to do them in markdown!), changelog and upgrade notice sections now correctly formatted.
- Fixed a bug: Plugin name is actually clean-and-simple-contact-form now (not contact-form) but this new name needed to be updated in the plugin settings definitions. I also needed to rename contact-form.php to clean-and-simple-contact-form.php. My thanks to Jakub for finding this bug.
- If your webpage is ssl then reCAPTCHA will now also use ssl mode.