Contact Form Clean and Simple vs Store file uploads for Contact Form 7

A clean and simple AJAX contact form with Google reCAPTCHA, flexible CSS framework support, spam filtering, and REST API support for headless WordPress implementations. 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). Flexible Styling: Choose your CSS framework – Bootstrap (default), Theme Native (inherits your theme’s styles), or Minimal (semantic classes for complete custom styling). REST API Support: Enable headless WordPress implementations to submit forms via authenticated REST API endpoints. Accessible: Built with accessibility in mind – proper ARIA attributes, keyboard navigation, screen reader support, and WCAG AA compliant color contrast. 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 can be scanned with Fullworks Anti Spam Pro. For this to work you must have the Fullworks Anti Spam Pro Plugin installed and activated. Fullworks Anti Spam Pro will also log all your messages, categorized as spam or not, automatically. 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? Here’s why: 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 Fullworks Anti Spam Pro plugin is activated all form data will be scanned for spam. You can turn on reCAPTCHA to avoid your form being abused by bots, however Fullworks Anti Spam Pro will do this without reCAPTCHA. 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. Flexible CSS styling: Choose from Bootstrap, Modern (with dark mode), Theme Native, or Minimal styling modes to match your site’s design. 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. Headless WordPress ready. REST API support allows you to submit forms from decoupled frontends, mobile apps, or any external application with proper authentication. Hopefully this plugin will fulfil all your needs. PHP 8 Ready Tested on PHP 8.4 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. Additional Settings 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. CSS Framework: Choose how the form is styled: Bootstrap (Default): Uses Bootstrap CSS classes for full Bootstrap compatibility. Best for themes already using Bootstrap. Modern (Card style): A beautiful, opinionated modern design with card-style layout, large inputs, and CSS variables for easy customization. Includes automatic dark mode support. Theme Native: Uses minimal classes with WordPress’s wp-element-button for the submit button. The form inherits your theme’s native form styles. Minimal: Uses semantic CSS classes only (cscf-field, cscf-input, etc.) for complete custom styling control. 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. This option is most relevant when using the Bootstrap CSS framework. 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. Enable REST API: Turn on REST API support to allow headless WordPress implementations to submit forms. Required User Capability: Set the minimum WordPress user capability required to use the REST API (default: edit_posts). REST API for Headless WordPress This plugin includes REST API support, making it perfect for headless WordPress implementations, mobile applications, and decoupled frontend frameworks like React, Vue.js, or Angular. Enabling REST API Go to the plugin settings page Find the “REST API Settings” section Check “Enable REST API” Set the required user capability (default: edit_posts) Save your settings API Endpoint POST /wp-json/cscf/v1/submit Authentication The REST API requires WordPress user authentication. Users must be logged in and have the capability specified in settings (default: edit_posts). For headless implementations, you can use: – Application Passwords (WordPress 5.6+) – JWT Authentication plugins – OAuth plugins – Basic Authentication (development only) Request Format Send a POST request with JSON body: `json { “name”: “John Doe”, “email”: “[email protected]”, “confirm_email”: “[email protected]”, “message”: “Your message here”, “phone_number”: “+1234567890”, “contact_consent”: true, “email_sender”: false, “post_id”: 123 } ` Required fields: – name: Sender’s name – email: Sender’s email address – message: The message content Optional fields: – confirm_email: Required if email confirmation is enabled in settings – phone_number: Required if phone number is set as mandatory in settings – contact_consent: Required if contact consent is enabled in settings – email_sender: Set to true to send a copy to the sender – post_id: The ID of the page/post where the form would normally be displayed Response Format Success Response (200): json { "success": true, "message": "Message Sent" } Validation Error Response (400): json { "code": "validation_failed", "message": "Validation failed.", "data": { "status": 400, "errors": { "email": "Please enter a valid email address.", "message": "Please enter a message." } } } Authentication Error Response (401): json { "code": "rest_forbidden", "message": "Authentication required.", "data": { "status": 401 } } Example Implementation JavaScript (fetch API): `javascript const formData = { name: “John Doe”, email: “[email protected]”, confirm_email: “[email protected]”, message: “This is a test message from the REST API” }; fetch(‘https://yoursite.com/wp-json/cscf/v1/submit’, { method: ‘POST’, headers: { ‘Content-Type’: ‘application/json’, ‘Authorization’: ‘Bearer YOUR_AUTH_TOKEN’ }, body: JSON.stringify(formData) }) .then(response => response.json()) .then(data => { if (data.success) { console.log(‘Message sent successfully!’); } else { console.error(‘Validation errors:’, data.data.errors); } }); ` Important Notes REST API is disabled by default for security reCAPTCHA is bypassed for REST API submissions (authentication provides security) All other form validations and spam filtering still apply Form submissions via REST API are processed identically to regular submissions Email notifications work the same way as standard form submissions Demo Demo site coming soon.

By default, Contact Form 7 dose not keep data it sends trough it’s contact forms. While plugins like Flamingo save that data, uploaded files are not added to Media Library. This plugin will save uploaded files to Media Library before email is sent by CF7. This plugin will raise an event with the the full file path & name. Subscribe to nmr_create_attachment_file_name filter to get and/or update data before attachment is added to media library. // The filter callback function. function example_callback( $file_name ) { // (maybe) modify $file_name. return $file_name; } add_filter( 'nmr_create_attachment_file_name', 'example_callback', 10, 1 ); Subscribe to nmr_before_insert_attachment filter to be able to change attachment attributes: caption and description are ‘post_excerpt’ and ‘post_content’. For other attributes, check documentation for wp_insert_attachment. // The filter callback function. function before_insert_attachment_callback( $attachment ) { // (maybe) modify $attachment array. return $attachment; } add_filter( 'nmr_before_insert_attachment', 'before_insert_attachment_callback', 10, 1 ); Optionally, subscribe to nmr_should_skip_save_attachment_to_media_library filter to be able to skip saving the attachment to media library: return true to skip, false is the default behaviour that saves the attachment to media library. Filter nmr_before_insert_attachment will not be called if skip was true. // The filter callback function. function skip_media_library_callback( $skip_save_to_media_library ) { // return true to skip saving to Media Library, false to save. return true; } add_filter( 'nmr_should_skip_save_attachment_to_media_library', 'skip_media_library_callback', 10, 1 ); This plugin will send the final attachment id if you are interested in getting other details, like attachment url. Listen to nmr_create_attachment_id_generated action. // The action callback function. function example_callback_id_generated( $attachment_id ) { // (maybe) do something with the args. $url = wp_get_attachment_url( $attachment_id ); } add_action( 'nmr_create_attachment_id_generated', 'example_callback_id_generated', 10, 1 ); Docs & Support Check the support forum on WordPress.org. If you can’t locate any topics that pertain to your particular issue, post a new topic for it. Store file uploads for Contact Form 7 Needs Your Support It is hard to continue development and support for this free plugin without contributions from users like you. If you enjoy using -Store file uploads for Contact Form 7- and find it useful, please consider making a donation. Your donation will help encourage and support the plugin’s continued development and better user support. Privacy Notices With the default configuration, this plugin, in itself, does not: track users by stealth; write any user personal data to the database; send any data to external servers; use cookies. It will, however store uploaded files trough Contact Form 7 in WordPress Media Library. Make sure your website users are aware of this fact!!! Pro Version Need more? The Pro version adds 13 features: Per-form control — choose which forms save files, set custom folder and rename pattern per form Auto-rename — rename files using patterns like {name}-{date}.{ext} from other CF7 fields Unique filenames — automatically avoid overwriting files with the same name Custom upload folder — save files to a specific subfolder per form File URL in email — replace [file] mail tag with a clickable link instead of an attachment Skip-mail compatibility — save files even when CF7’s skip_mail: on is set Upload log — admin screen listing every uploaded file with form, date, size, and download link Private files — store files outside the Media Library with access protection Admin notification — receive an email with file link on every upload Flamingo integration — link uploaded files to Flamingo inbound message entries Auto-delete — remove uploads older than a configurable number of days Image resize / compress — resize and compress images on upload Duplicate detection — skip saving if the same file was already uploaded (MD5 check) Get Pro →