=== 1 Click Form Sync for Elementor Forms, WPForms and Google Sheets ===
Contributors: tajamalhussain
Donate link: https://taj.fectodigital.com/
Tags: elementor, google sheets, wpforms, forms, sync
Requires at least: 6.4
Tested up to: 7.0.4
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Send Elementor Pro Forms and WPForms submissions to Google Sheets with automatic field mapping and background retry queue.

== Description ==

1 Click Form Sync for Elementor Forms, WPForms and Google Sheets is a reliable, high-performance WordPress plugin that links your Google Account to send form submissions directly to Google Spreadsheets in real-time.

=== Key Features ===

* **Multi-Account Support**: Connect multiple named Google accounts effortlessly.
* **Smart Field Mapping**: Automatic column header detection or custom field layout configuration.
* **Exponential Retry Queue**: Failed requests (API rate limits, timeouts, server errors) are automatically retried in the background using WP-Cron.
* **Enterprise Security**: Symmetrical token encryption using Libsodium or OpenSSL AES-256-GCM, plus built-in defense against Spreadsheet Formula Injection (CSV Injection).
* **Developer Friendly**: Built on PSR-4 standards, DI container, and clean extensible hooks.

== Installation ==

1. Upload the `1-click-form-sync` folder to your `/wp-content/plugins/` directory, or install directly through the WordPress Plugins menu.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Navigate to '1 Click Form Sync' in your WordPress admin menu and complete the setup wizard to connect your Google Account.
4. Configure the Google Sheets integration action in your Elementor Pro Forms or WPForms settings.

== Frequently Asked Questions ==

= Does this plugin require paid Google Cloud API credentials? =

No. You can connect instantly using the built-in 1-Click authorization proxy or use your own custom Google Cloud OAuth credentials.

= What happens if Google Sheets API is temporarily unavailable? =

The plugin captures form entries locally and queues them for background processing via WP-Cron with exponential backoff retries.

= Is my form data secure? =

Yes. Credentials are encrypted using industry-standard AES-256-GCM / Libsodium encryption, and field values are sanitized to protect against formula injection.

== Screenshots ==

1. Admin Dashboard overview showing connected accounts and sync status.
2. Form connection mapping interface for Google Sheets.
3. Submission log and retry queue manager.

== Changelog ==

= 1.0.0 =
* Initial release of 1 Click Form Sync for Elementor Forms, WPForms, and Google Sheets.
* Integrated Elementor Pro Forms and WPForms form provider support.
* Added automatic field mapping, OAuth 2.0 authentication, and background retry queue.

== Upgrade Notice ==

= 1.0.0 =
Initial release. Upgrade to get seamless Google Sheets integration for Elementor Pro and WPForms.

== External Services ==

This plugin connects to external third-party services to establish OAuth connections and transmit form submissions.

1. **Google OAuth 2.0 API**
   - **Service Description**: Authenticates users, verifies identity, and manages OAuth tokens.
   - **Data Transmitted**: Client consent codes, client IDs, secrets, and refresh/access tokens.
   - **Privacy Policy**: https://policies.google.com/privacy
   - **Terms of Service**: https://policies.google.com/terms

2. **Google Sheets API v4**
   - **Service Description**: Reads spreadsheet headers, creates worksheets, and appends submission rows.
   - **Data Transmitted**: Form field values, headers, and spreadsheet identifiers.
   - **Privacy Policy**: https://policies.google.com/privacy
   - **Terms of Service**: https://policies.google.com/terms

3. **Fecto Digital Auth Proxy (https://auth-gsheet.fectodigital.com)**
   - **Service Description**: Redirect proxy used to return Google OAuth authorization codes to your local WordPress dashboard safely.
   - **Data Transmitted**: Callback URL, state parameters, and authorization tokens.
   - **Privacy Policy**: https://fectodigital.com/privacy-policy/
   - **Terms of Service**: https://fectodigital.com/privacy-policy/
