=== AVAK Form Tracking Listener ===
Contributors: ajayrajbanshi
Tags: form tracking, analytics, google tag manager, ga4, contact form 7
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 2.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Track form submissions, errors, and abandonment across popular form plugins with GTM and GA4 integration.

== Description ==

AVAK Form Tracking Listener tracks form submissions, errors, and abandonment across multiple popular WordPress form plugins, integrating with Google Tag Manager and Google Analytics 4.

= Supported Form Plugins =

* Contact Form 7 - Submissions, validation errors, spam detection, and mail failures
* WPForms - Submissions and validation errors
* Gravity Forms - Submissions and validation errors
* Ninja Forms - Submissions and validation errors
* HubSpot Forms - Embedded form submissions

= Event Tracking =

* Form Submissions - Track successful form submissions
* Validation Errors - Monitor form validation failures
* Spam Detection - Track spam submissions (CF7)
* Mail Failures - Detect email sending failures
* Form Abandonment - Track when users start but don't complete forms

= Analytics Integration =

* Google Tag Manager - Push events to GTM dataLayer
* Google Analytics 4 - Direct GA4 event tracking via gtag

= How It Works =

The plugin listens for form events on both the server side (via WordPress hooks) and the client side (via JavaScript). When a form event occurs, it pushes structured data to the GTM dataLayer and/or sends it to GA4.

== Installation ==

1. Upload the `avak-form-tracking-listener` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Form Tracking > Settings to configure

== Frequently Asked Questions ==

= Which form plugins are supported? =

Contact Form 7, WPForms (Free & Pro), Gravity Forms, Ninja Forms, and HubSpot Forms (embedded).

= Does this work with Google Tag Manager? =

Yes. The plugin pushes events to the GTM dataLayer. Configure triggers in GTM to listen for form events like `form_submission`, `form_validation_error`, and `form_abandonment`.

= Does this work with Google Analytics 4? =

Yes. Enable GA4 in settings, enter your Measurement ID, and events are sent via gtag.

= Does this plugin slow down my site? =

No. All tracking is asynchronous with minimal impact on page load.

== Changelog ==

= 2.0.0 =
* Major rewrite for WordPress.org submission
* Simplified plugin to core tracking functionality
* Removed database logging and custom endpoint features
* Single clean settings page
* Full WordPress Coding Standards compliance
* Added uninstall.php for clean removal

== Upgrade Notice ==

= 2.0.0 =
Major rewrite. Database logging and custom endpoints removed. Settings preserved on upgrade.

== Privacy ==

This plugin does not store any form data. It pushes event metadata (form type, form name, form ID, status) to Google Tag Manager and/or Google Analytics 4 based on your configuration. No personal data is collected or stored by the plugin itself.
