=== GetShouting ===
Contributors: getshouting
Tags: woocommerce, social media, marketing, automation, abandoned cart, sms marketing
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.0
WC requires at least: 8.9
WC tested up to: 9.4
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect your WooCommerce store to Get Shouting for product promotion, abandoned-cart recovery, and TCPA-aligned SMS marketing.

== Description ==

**Get Shouting** makes it incredibly easy to connect your WooCommerce store to Get Shouting, enabling automated product promotion across social media platforms.

= Features =

* ✅ **One-Click Connection** - Connect your store in seconds (no manual API key generation required)
* ✅ **Automatic Product Sync** - Your products are automatically synced to Get Shouting
* ✅ **Real-Time Updates** - Inventory changes and new products sync automatically via webhooks
* ✅ **Order Tracking** - Track product performance and sales analytics
* ✅ **Abandoned Cart Recovery** - Hourly scanner detects idle carts and triggers your Get Shouting recovery journey (new in 1.1.0)
* ✅ **TCPA-Aligned SMS Consent** - Native checkbox on both the classic and Block-based checkout (new in 1.1.0)
* ✅ **Inventory Alerts** - Get notified about low stock and slow-moving products
* ✅ **Secure** - Enterprise-grade encryption for all data transmission

= How It Works =

1. Install and activate the plugin
2. Go to WooCommerce → Get Shouting in your WordPress admin
3. Click "Connect to Get Shouting"
4. Log in to your Get Shouting account (or create one)
5. Select which brand to connect
6. Done! Your products will automatically sync

= What is Get Shouting? =

Get Shouting is a social media marketing automation platform designed specifically for e-commerce businesses. Turn your products into engaging social media content with just a few clicks.

**Key Benefits:**
* Create professional social media posts from your products
* Schedule posts across multiple platforms
* Track performance and analytics
* Identify slow-moving inventory for promotions
* Automate product launches and sales announcements

= Requirements =

* WordPress 5.8 or higher
* WooCommerce 8.9 or higher (for the Block-based checkout SMS-consent field; classic checkout works on any version)
* PHP 7.4 or higher
* HTTPS enabled (required for secure API communication)
* Pretty permalinks enabled (Settings → Permalinks)
* WP-Cron enabled (required for the hourly abandoned-cart scanner — DISABLE_WP_CRON must not be set, or you must configure a system cron)

= Privacy & Data =

This plugin connects your WooCommerce store to Get Shouting. When connected:

* **Product data** (titles, descriptions, prices, images, inventory) is synced to Get Shouting.
* **Order data** is synced for performance tracking, journey enrollment, and revenue analytics.
* **Customer email and phone** are transmitted when:
  - The customer ticks the SMS-marketing consent checkbox at checkout (express written consent for TCPA), AND/OR
  - The customer abandons a logged-in cart (so Get Shouting can send the recovery message). Email/phone only — no addresses, IP addresses, or payment data.
* No customer **addresses, IP addresses, user-agent strings, or payment details** are transmitted.
* All data transmission uses HTTPS encryption.
* GDPR `customers/redact`-style requests anonymize the customer's record on the Get Shouting side while preserving anonymized aggregate analytics (lifetime spend, order count) — see [Get Shouting's data retention policy](https://www.getshouting.app/privacy).
* You can disconnect at any time and optionally delete all synced data.

For more details, see our [Privacy Policy](https://www.getshouting.app/privacy).

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Go to **Plugins → Add New**
3. Search for **"Get Shouting"** (or "GetShouting")
4. Click **"Install Now"** and then **"Activate"**
5. After activation, go to **WooCommerce** in the left navigation menu
6. Click **"Get Shouting"** under the WooCommerce menu
7. Click **"Connect to Get Shouting"** button
8. You'll be redirected to the Get Shouting website to complete your store connection
9. Log in or create your Get Shouting account
10. Select which brand to connect to this store
11. Once connected, you can create posts or ads directly from your store items in Get Shouting

= Manual Installation =

1. Download the plugin ZIP file
2. Log in to your WordPress admin panel
3. Go to **Plugins → Add New → Upload Plugin**
4. Choose the ZIP file and click **"Install Now"**
5. Click **"Activate Plugin"**
6. After activation, go to **WooCommerce** in the left navigation menu
7. Click **"Get Shouting"** under the WooCommerce menu
8. Click **"Connect to Get Shouting"** button
9. You'll be redirected to the Get Shouting website to complete your store connection
10. Log in or create your Get Shouting account
11. Select which brand to connect to this store
12. Once connected, you can create posts or ads directly from your store items in Get Shouting

= After Installation =

1. Navigate to **WooCommerce → Get Shouting** in your WordPress admin
2. Click **"Connect to Get Shouting"** button
3. You'll be redirected to the Get Shouting website to complete your store connection
4. Log in or create your Get Shouting account
5. Select which brand to connect to this store
6. You'll be redirected back to WordPress
7. Your products will start syncing automatically!
8. Once connected, you can create posts or ads directly from your store items in Get Shouting

== Frequently Asked Questions ==

= Do I need a Get Shouting account? =

Yes, you'll need a Get Shouting account to use this plugin. You can sign up for free at [getshouting.app](https://www.getshouting.app/signup).

= Is this plugin free? =

Yes, the plugin is completely free. Get Shouting has various pricing plans, including a free tier to get started.

= Will this slow down my WooCommerce store? =

No. The plugin uses webhooks for real-time synchronization, which means it doesn't add any load to your store's frontend or checkout process.

= What data is synced to Get Shouting? =

* Product information (titles, descriptions, prices, images, SKUs)
* Inventory levels
* Order data for performance tracking and journey enrollment (line items, totals, currency)
* Customer email **only when** the customer ticks the SMS-marketing consent checkbox or abandons a logged-in cart
* Customer phone **only when** the customer ticks the SMS-marketing consent checkbox (TCPA prior express written consent)
* No customer **addresses, IP addresses, user-agent strings, or payment details** are synced

= Can I disconnect at any time? =

Yes! You can disconnect your store at any time from the WooCommerce → Get Shouting page. You can also choose to delete all API keys when disconnecting.

= Does this work with product variations? =

Yes! The plugin fully supports WooCommerce variable products and their variations.

= What happens if I deactivate the plugin? =

If you deactivate the plugin, the connection to Get Shouting will stop working, but your data will remain. If you uninstall the plugin, you can choose to delete all API keys and connection data.

= Do I need to manually sync my products? =

No! After the initial connection, all product updates, new products, and inventory changes are automatically synced in real-time via webhooks.

= What if I have thousands of products? =

No problem! The initial sync handles large catalogs efficiently with pagination. After that, only changes are synced via webhooks.

= Is HTTPS required? =

Yes, HTTPS is required for secure API communication. Most modern WordPress hosting includes free SSL certificates.

= What are "Pretty Permalinks"? =

Pretty permalinks are required for the WooCommerce REST API to work. You can enable them in WordPress Settings → Permalinks. Choose any option except "Plain".

== Screenshots ==

1. Connection dashboard - One-click connect button
2. Connected status - View connection details and sync status
3. Disconnect confirmation - Optional data deletion
4. Integration with WooCommerce admin menu

== Changelog ==

= 1.1.0 - 2026-05-10 =
* NEW: SMS marketing consent checkbox on the WooCommerce Block-based checkout (WC 8.9+). The classic shortcode checkout was already supported in 1.0.x; this release reaches the block-based checkout that is now the WC default.
* NEW: Updated SMS consent disclosure to TCPA-aligned copy ("Msg & data rates may apply. Reply STOP to cancel.").
* NEW: Hourly abandoned-cart scanner. When a logged-in customer's cart is idle for 30+ minutes (configurable via the `getshouting_abandoned_cart_idle_minutes` filter), the plugin fires a `action.getshouting_abandoned_cart` custom-topic webhook that Get Shouting forwards into your abandoned-cart journey.
* NEW: Plugin version is reported on connect, so Get Shouting's journey-trigger picker can correctly enable WooCommerce abandoned-cart only on stores running this plugin or newer.
* NEW: Plugin deactivation now clears the scheduled WP-Cron hook so no orphan entries remain.
* CHANGED: Bumped minimum WooCommerce version to 8.9 (required for the Block-based checkout SMS field). Classic shortcode checkout still works on older WC versions.
* CHANGED: Privacy disclosure updated to accurately describe what data is transmitted (email/phone when the customer opts in; addresses/IP/payment details never).

= 1.0.7 - 2026-02-04 =
* Updated plugin slug to "getshouting" (was "getshouting-connector")
* Updated plugin name to "GetShouting" (was "GetShouting for WooCommerce")
* Updated text domain to "getshouting" throughout all files
* Updated menu slug and page references to match new plugin slug

= 1.0.6 - 2026-02-03 =
* Added "Requires Plugins: woocommerce" header for proper dependency declaration
* Confirmed proper use of wp_enqueue_script() and wp_enqueue_style() functions

= 1.0.5 - 2026-02-03 =
* CRITICAL FIX: Removed extra spaces after asterisks in plugin header (WordPress.org parser requirement)
* Plugin headers now match exact format from WordPress.org documentation

= 1.0.4 - 2026-02-03 =
* Fixed text domain consistency across all files
* Ensured complete WordPress.org header compliance
* Verified all translation functions use correct text domain

= 1.0.3 - 2026-02-03 =
* Fixed plugin header formatting for WordPress.org submission
* Updated license format to GPL v2 or later (WordPress.org standard)
* Added Domain Path for internationalization support
* Improved build verification and debugging tools

= 1.0.0 - 2026-01-23 =
* Initial release
* One-click connection to Get Shouting
* Automatic API key generation
* Real-time product synchronization via webhooks
* Order tracking integration
* Secure credential management
* GDPR compliant

== Upgrade Notice ==

= 1.1.0 =
Adds Block-based checkout SMS consent + abandoned-cart recovery. Requires WooCommerce 8.9+. Privacy disclosure updated to reflect what's transmitted when customers opt in.

= 1.0.7 =
Updated plugin slug to "getshouting" to match WordPress.org requirements. All functionality remains the same.

= 1.0.6 =
Added WooCommerce dependency declaration for proper plugin dependency management.

= 1.0.5 =
CRITICAL FIX: Plugin header format now matches WordPress.org parser requirements exactly.

= 1.0.4 =
Fixed text domain consistency and ensured complete WordPress.org compliance.

= 1.0.3 =
Fixed plugin header formatting and improved WordPress.org compatibility.

= 1.0.0 =
Initial release of Get Shouting Connector for WooCommerce.

== Support ==

For support, please visit:
* [Get Shouting Help Center](https://www.getshouting.app/help)
* [Plugin Support Forum](https://wordpress.org/support/plugin/getshouting/)

== Developer Documentation ==

For developer documentation and API details, visit:
* [Get Shouting Developer Docs](https://www.getshouting.app/developers)
* [WooCommerce REST API](https://woocommerce.github.io/woocommerce-rest-api-docs/)

