WA Stack

== Description ==

WA Stack is a WhatsApp-first plugin for WordPress and WooCommerce.

It helps stores and businesses turn website visitors and buyers into WhatsApp conversations through:

• Floating WhatsApp support widgets
• Single-agent and multi-agent support flows
• WooCommerce product support buttons
• Order-based WhatsApp notification delivery
• Queue, logs, retry, and gateway diagnostics
• Click, queue, and delivery analytics

WA Stack is built for businesses that want one plugin for both pre-sales support and operational notification workflows.

== Landing Highlights ==

Use these as product highlights for a landing page:

• Floating WhatsApp widget with icon-only, single support, and multi support modes
• Multi-agent support popup for sales, admin, or customer service teams
• WooCommerce product-level WhatsApp CTA to capture pre-purchase questions
• Product-specific support override for selected products or support teams
• Manual order-based WhatsApp sending directly from WooCommerce admin
• Notification queue with processing lifecycle, retry support, and logs
• Gateway layer for official delivery and addon-based experimental connectors
• Live message preview and gateway payload preview before manual sending
• Queue and log inspection with detailed response debugging
• Recent queue/log history with inline payload and response debugging
• Latest retry action directly from the WooCommerce order screen
• Order-level delivery inspection without leaving the order admin view
• Analytics for storefront clicks, queued notifications, and sent delivery logs
• Dashboard-ready operational reporting for support and notification activity

== Core Features ==

=== Support Widget ===

• Floating WhatsApp trigger for desktop and mobile
• Position control for left or right placement
• Custom primary color and trigger label
• Single support mode with direct WhatsApp CTA
• Multi support mode with multiple support contacts
• Icon-only mode for compact WhatsApp access
• Rotary agent mode for client-side message distribution with session-stickiness

=== WooCommerce Product Support ===

• WhatsApp support button on product pages
• Configurable button label and message template
• Product-level override for support mode and support contacts
• Single and multi support options per product
• Inherit global Rotary routing or customize Rotary configuration per product
• Mobile-specific display override to force Icon Only mode when Rotary is active

=== Notification Engine ===

• Order notification payload preparation
• Database-backed queue and logs
• Manual queue processing and scheduled background processing
• Queue retry flow with delay handling
• Status lifecycle for pending, processing, sent, failed, retry, and cancelled states

=== Order Admin Workflow ===

• Manual send action from WooCommerce order admin
• Event-based queueing from order metabox
• Live message preview before sending
• Temporary custom message override
• Direct retry action for the latest queue attempt
• Latest payload and latest raw response preview
• Order-level recent queue and log history

=== Gateway & Delivery ===

• Official gateway transport via authenticated HTTP POST
• Experimental gateway path through separate addon registration
• Gateway settings, validation, and test-send tools
• Request payload, endpoint, HTTP status, and raw response diagnostics

=== Analytics ===

• Storefront click tracking for widget and product support actions
• Analytics admin page
• Dashboard widget summary
• Daily funnel reporting for clicks, queued notifications, and sent logs
• Event funnel reporting for queued versus sent notification outcomes

== Installation ==

1. Upload the plugin to /wp-content/plugins/ or install it through WordPress admin.
2. Activate WA Stack.
3. Go to WA Stack to configure support widget and WooCommerce support settings.
4. Go to WA Stack > Gateways to configure notification transport.
5. Optional: activate WA Stack Experimental Gateway if you want the addon-based experimental transport path.

== Frequently Asked Questions ==

= Can I use WA Stack without WooCommerce? = Yes. The floating support widget works for regular WordPress websites too.

= Does WA Stack support multiple support contacts? = Yes. You can use single support, multi support, or icon-only mode.

= Can I send WhatsApp notifications from WooCommerce orders? = Yes. WA Stack supports manual order-based sending, queue processing, logs, retries, and gateway diagnostics.

= Is the experimental gateway built into the core plugin? = The experimental transport now follows an addon path. Use the separate experimental gateway addon if you need it.