=== SMSPlus for WooCommerce ===
Contributors: smsplus
Tags: sms, woocommerce, notifications, order status, SMSPlus
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
WC requires at least: 5.0
WC tested up to: 9.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Send SMS notifications to your customers when WooCommerce order statuses change, powered by the SMSPlus API.

== Description ==

SMSPlus for WooCommerce automatically sends SMS notifications to your customers when their order status changes. Keep your customers informed at every step of the order process.

**Features:**

* Automatic SMS on order status changes (processing, completed, on-hold, cancelled, refunded, failed)
* Customizable message templates per status with placeholder support
* Easy setup — just enter your SMSPlus API URL and API key
* Test connection button to verify your API settings
* Order notes for every SMS sent or failed
* Full logging via WooCommerce Status > Logs
* Compatible with common shipment tracking plugins

**Available placeholders for message templates:**

* `{order_number}` — Order number
* `{customer_name}` — Customer full name
* `{first_name}` — Customer first name
* `{status}` — New order status
* `{total}` — Order total with currency
* `{site_name}` — Your site name
* `{items}` — Comma-separated list of ordered items
* `{tracking_number}` — Shipment tracking number (if available)

== Installation ==

1. Upload the `smsplus-for-woocommerce` folder to the `/wp-content/plugins/` directory, or install directly from the WordPress plugin screen.
2. Activate the plugin through the "Plugins" screen in WordPress.
3. Go to **WooCommerce > Settings > SMSPlus** to configure the plugin.
4. Enter your SMSPlus API URL and API Key.
5. Click **Test Connection** to verify your settings.
6. Enable the order statuses you want to send SMS notifications for.
7. Customize the message templates as needed.

== Frequently Asked Questions ==

= Where do I get my API key? =

You can obtain your API key from your SMSPlus dashboard at [smsplus.bg](https://smsplus.bg).

= Which order statuses are supported? =

The plugin supports: Processing, Completed, On hold, Cancelled, Refunded, and Failed.

= Can I customize the messages? =

Yes! Each order status has its own message template with full placeholder support. Go to WooCommerce > Settings > SMSPlus to customize them.

= What happens if a customer has no phone number? =

The plugin will skip sending the SMS and add an order note indicating the notification was skipped.

= Where can I see SMS logs? =

Go to **WooCommerce > Status > Logs** and look for log files with the source `smsplus-for-woocommerce`.

= Does it work with shipment tracking plugins? =

Yes, the plugin supports the `{tracking_number}` placeholder and is compatible with WooCommerce Shipment Tracking and plugins that store tracking data in order meta.

== Privacy Notice ==

This plugin sends customer phone numbers to the [SMSPlus](https://smsplus.bg) API in order to deliver SMS notifications. No other personal data is transmitted. By using this plugin, you agree to the SMSPlus [Terms of Service](https://smsplus.bg/bg/terms/), [Privacy Policy](https://smsplus.bg/bg/privacy-policy/), and [GDPR Policy](https://smsplus.bg/bg/gdpr/).

We recommend disclosing in your store's privacy policy that customer phone numbers are shared with SMSPlus for order notification purposes.

== Changelog ==

= 1.0.0 =
* Initial release
* SMS notifications on order status changes
* Customizable message templates with placeholders
* WooCommerce settings integration
* API connection testing
* Order notes and WooCommerce logging
