=== RCSZilla SMS / WhatsApp Notifications for WooCommerce ===
Contributors: rcszilla
Tags: sms, whatsapp, woocommerce, notifications, order status, abandoned cart
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: MIT
License URI: https://opensource.org/licenses/MIT

Send automated SMS and WhatsApp notifications to customers and admins using your self-hosted RCSZilla installation.

== Description ==

**RCSZilla SMS / WhatsApp Notifications** connects your WooCommerce store to your self-hosted [RCSZilla](https://rcszilla.com) installation and sends real-time SMS and WhatsApp messages to customers and admins.

= Features =

* **Order status notifications** — SMS/WhatsApp sent to the customer on every WooCommerce order status change (Pending, Processing, On Hold, Completed, Cancelled, Refunded, Failed)
* **Abandoned cart reminders** — automatically message logged-in customers who added items to the cart but never checked out
* **New customer welcome** — send a welcome message when a new account is registered
* **Admin order alerts** — notify an admin phone number the moment a new order is placed
* **SMS & WhatsApp** — choose your default channel per installation
* **Custom message templates** — personalise every message with dynamic variables
* **Test button** — send a live test message directly from the settings page

= Message Template Variables =

**Order / Admin:** `{order_id}`, `{order_date}`, `{order_total}`, `{first_name}`, `{last_name}`, `{shipping_method}`, `{order_status}`, `{store_name}`, `{store_url}`

**Abandoned cart:** `{first_name}`, `{last_name}`, `{cart_total}`, `{store_name}`, `{store_url}`, `{cart_url}`

**New customer:** `{first_name}`, `{last_name}`, `{email}`, `{store_name}`, `{store_url}`

= Requirements =

* WordPress 6.0+
* WooCommerce 7.0+
* PHP 7.4+ with `curl` enabled
* A running [RCSZilla](https://rcszilla.com) installation (v1.0+) with the Android app paired and online, or an SMS provider configured

== Installation ==

1. Upload the `rcszilla-sms` folder to `/wp-content/plugins/` or install via **Plugins → Add New → Upload Plugin**.
2. Activate the plugin.
3. Go to **WooCommerce → RCSZilla SMS**.
4. Enter your **API Token** (from RCSZilla admin → Devices), choose your channel, enable the module, and click **Save Settings**.

== Frequently Asked Questions ==

= Where do I get the API Token? =

Log in to your RCSZilla admin panel, go to **Devices**, and copy the token shown under the QR code (looks like `ABCD1234EFGH5678`).

= Does this work without a phone/Android device? =

Yes — if you have an SMS provider (e.g. Twilio, Vonage) configured in RCSZilla, messages are sent through that provider instead.

= Can I use WhatsApp instead of SMS? =

Yes. Set **Default Channel** to WhatsApp on the General tab. Requires WhatsApp configured in your RCSZilla installation.

== Screenshots ==

1. General settings tab — API token, channel and module status
2. Order status notifications tab — per-status enable/disable and message templates
3. Abandoned cart tab — delay and message template
4. New customer and admin alerts tabs

== Changelog ==

= 1.0.0 =
* Initial release
* Order status notifications (7 WooCommerce statuses)
* Abandoned cart reminders with 30-day reset
* New customer welcome SMS
* Admin new-order alert
* SMS & WhatsApp channel support

== Upgrade Notice ==

= 1.0.0 =
Initial release.
