=== Controls for Contact Form 7 (Redirects, Analytics & Tracking) ===

Contributors: kasparsd, buzztone   
Donate link: https://formcontrols.com/pro   
Tags: contact form 7, gtm, matomo, analytics, facebook pixel  
Requires at least: 4.6   
Tested up to: 6.7   
Stable tag: 0.10.0   
License: GPLv2 or later

Analytics, tracking, redirects and storage for Contact Form 7.


== Description ==

**NEW:** Subscribe to the [🚀 PRO version](https://formcontrols.com/pro) for advanced analytics and tracking features, and professional support by the plugin author.

This is an addon for the [Contact Form 7](https://wordpress.org/plugins/contact-form-7/) plugin with the following features:

- [Track form submissions, errors and completions](https://formcontrols.com/docs) with Google Analytics (GA4), Google Tag (gtag.js), Google Tag Manager (GTM), Matomo (formerly Piwik) and Facebook Pixel.
- Redirect to URL on form submission.
- Enable native WordPress shortcodes in form content.
- Disable AJAX form submissions.
- Disable default form CSS.
- Disable automatic paragraph formatting.
- Disable HTML5 input field types or enable the HTML5 input type fallback.
- Specify the Google reCAPTCHA language.
- Store form submissions in [Storage for Contact Form 7](https://preseto.com/go/cf7-storage?utm_source=wporg) or [TablePress](https://wordpress.org/plugins/tablepress/).

Please note that some settings work on the per-page level and will apply to all forms on the same page. For example, disabling AJAX form submissions for one form will disable AJAX submissions on all forms on the same page.

= Requirements =

- [Contact Form 7](https://wordpress.org/plugins/contact-form-7/) version 4.3 or later for features related to submission tracking and redirects.

= Usage =

The plugin adds a new "Controls" tab for each Contact Form 7 form in the WordPress administration area.

= Form Submission Storage =

*Setup the official companion plugin [Storage for Contact Form 7 plugin](https://preseto.com/go/cf7-storage?utm_source=wporg) for capturing the form submissions safely in the WordPres database.*

Alternatively, there is also a basic integration with the [TablePress plugin](https://wordpress.org/plugins/tablepress/). Select the TablePress table where to store the form submissions. The plugin will add any missing columns for each form field, and append the form entries as rows to the table. Additionally, fields `cf7_time` (submission time as [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) and `cf7_url` (URL where the form was submitted) are stored along with the form data.

= Analytics Tracking =

The plugin *automatically* triggers analytics events for the following services:

- [Google Analytics (GA4)](https://support.google.com/analytics/topic/14088998) using [Google Tag Manager](https://support.google.com/tagmanager/answer/9442095) and [Global Tag (gtag.js)](https://developers.google.com/tag-platform/gtagjs) with `ga()`, `_gaq.push()` and `dataLayer.push()` implementations,
- [Matomo](https://matomo.org/) (formerly Piwik),
- [Facebook Pixel Conversion Tracking](https://developers.facebook.com/docs/facebook-pixel/implementation/conversion-tracking).

It passes the following data with the event:

- "Contact Form" as the event category,
- "Submit", "Sent", "Error" or "Spam" as the event action, and
- the form title as the event title.

= Facebook Pixel =

The [standard Contact event](https://developers.facebook.com/docs/facebook-pixel/implementation/conversion-tracking#standard-events) is used for Facebook Pixel with `content_category` property set to the event type (Submit, Sent, Error, Spam) and `content_name` set to the form title.

= Contribute =

- Report issues and suggest improvements [on GitHub](https://github.com/kasparsd/contact-form-7-extras).
- Add [a translation to your language](https://translate.wordpress.org/projects/wp-plugins/contact-form-7-extras).


== Changelog ==

See the [release notes](https://github.com/kasparsd/contact-form-7-extras/releases) for the complete changelog.


== Installation ==

= From your WordPress dashboard =

Search for "Controls for Contact Form 7" under "Plugins" → "Add New" in your WordPress administration panel.

= Using Composer =

Add it as [a Composer dependency](https://packagist.org/packages/kasparsd/contact-form-7-extras):

	composer require kasparsd/contact-form-7-extras


== Frequently Asked Questions ==

= How to save Contact Form 7 submissions in the WordPress database? =

The "[Storage for Contact Form 7](https://preseto.com/go/cf7-storage?utm_source=wporg)" plugin stores all contact form submissions (including attachments) securely in the WordPress database. It also provides a CSV export of the form entries.


== Screenshots ==

1. Google Analytics events associated with form submissions.
2. Facebook Pixel "Contact" event associated with form submission.
3. Controls for Contact Form 7 plugin settings.


== Upgrade Notice ==

= 0.9.0 =

New feature: enable storing form submissions in TablePress plugin tables.