=== OrderAlerts – Instant Order Alerts for WooCommerce ===
Contributors: orderalerts
Donate link: https://orderalerts.app
Tags: woocommerce, order alert, order notification, push notification, realtime
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.3.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Realtime, instant WooCommerce order alerts. Pair free Chrome extension + mobile PWA. 100% free forever.

== Description ==

**OrderAlerts – Instant Order Alerts for WooCommerce**

**Realtime. Instant. 100% free.**

Get notified the moment a WooCommerce order is placed — on your **computer** (free Chrome extension) and **phone** (PWA). No paid plan. No clutter. Just instant order alerts.

= Why OrderAlerts =

* **Instant** order alerts when status becomes processing or completed
* **Realtime** push path (not slow email polling)
* **100% free** forever for the plugin + extension pairing
* Pair multiple staff devices and browser extensions
* Works while you work — no need to keep wp-admin open all day

= How it works =

1. Install and activate this plugin (WooCommerce required)
2. Open **Order Alerts** in WP admin
3. Scan the QR code with the OrderAlerts app (PWA) **or** copy the pair token into the free Chrome extension
4. Receive instant desktop/mobile alerts on new orders

= Features =

* Pairing token + QR code for instant setup
* Connected users list (app devices)
* Active browser extensions overview
* Secure token regenerate
* Multi-device / multi-extension support via OrderAlerts API
* Translated admin UI for major WooCommerce markets (15 languages)

== External Services ==

This plugin relies on an external API service to deliver instant order notifications to paired mobile apps and browser extensions.

* **Service Name:** OrderAlerts API
* **Service URL:** `https://api.orderalerts.app`
* **Data Transmitted:** Store name, store URL, pairing token, order numbers, order total amount, currency, customer name, email, phone, billing address, shipping address, and item details (SKU, item name, quantity, price).
* **When Sent:** Transmitted automatically when a WooCommerce order status changes to processing or completed, when an order is deleted, when registering a store pairing token, or when regenerating pair tokens.
* **Privacy Policy:** [https://orderalerts.app/privacy](https://orderalerts.app/privacy)
* **Terms of Service:** [https://orderalerts.app/terms](https://orderalerts.app/terms)

== Third-Party Libraries ==

This plugin bundles the following open-source client-side library:
* **QRCode.js** by Davidshimjs (MIT License) - included as a minified asset at `assets/js/qrcode.min.js` to render store pairing QR codes in the admin dashboard.

Chrome extension: search **OrderAlerts – Instant Order Alerts for WooCommerce** in the Chrome Web Store

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install via **Plugins → Add New**
2. Activate **OrderAlerts – Instant Order Alerts for WooCommerce**
3. Ensure **WooCommerce** is active
4. Go to **Order Alerts** in the admin menu
5. Pair the free extension or mobile app with the QR / token

== Frequently Asked Questions ==

= Is it really 100% free? =

Yes. The plugin and the pairing flow for the Chrome extension / PWA are free. There is no paywall on basic instant order alerts.

= Does OrderAlerts track site data or store customer info on third-party servers? =

No. OrderAlerts only transmits real-time order notifications (order ID, status, item details) to your paired devices via OrderAlerts API. No analytics, tracking data, or background user metrics are collected.

= Do I need the Chrome extension? =

The plugin sends order events to OrderAlerts. To hear/see alerts on a computer, install the free Chrome extension and paste your pair token (or use the mobile PWA for phones).

= Which order statuses trigger alerts? =

Orders moving to **processing** or **completed** (typical paid order flow).

= Can multiple people get alerts? =

Yes. Each person pairs with the QR or token (app or extension). Connected users appear on the admin page.

= What if I regenerate the token? =

Old QR codes and tokens stop working. Re-pair all devices and extensions with the new token.

= Which languages are supported? =

Admin UI translations ship for English plus Spanish, Portuguese (Brazil), French, German, Italian, Dutch, Polish, Russian, Turkish, Japanese, Chinese (Simplified), Arabic, Indonesian, and Swedish. Language follows your WordPress site language.

== Screenshots ==

1. Admin dashboard — connection status, QR pair, token
2. Connected users and live browser extensions
3. Pairing flow with free Chrome extension (optional)

== Changelog ==

= 1.3.1 =
* Manual language selector on admin page (or Automatic = site language)

= 1.3.0 =
* Full internationalization (Text Domain + 15 languages)
* Updated branding: Instant · Realtime · 100% free
* Hardened admin AJAX (localized JS strings, nonces)
* WordPress.org-ready plugin headers and readme

= 1.1.0 =
* Multi-user pairing, extension presence, regenerate token

== Upgrade Notice ==

= 1.3.0 =
Recommended update: translations and store-ready packaging.
