=== Sawir Pulse – Live Sales & Social Proof for WooCommerce ===
Contributors: sawirricardo
Tags: social proof, sales notification, fomo, woocommerce, live sales
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Live social proof from real activity: recent orders, live viewers, and reviews as corner notifications. No fake notifications, ever.

== Description ==

Sawir Pulse shows visitors what is genuinely happening in your store, as small corner notifications:

* **Recent orders** — "Rina from Jakarta bought Batik Tote · 12 mins ago · Verified order"
* **Live viewers** — "4 people are viewing this product right now"
* **Reviews** — snippets from your approved 4–5 star product reviews

Every notification comes from real activity. There is no option to invent purchases or inflate numbers — fake social proof is deceptive to shoppers and a legal risk for store owners, so Sawir Pulse simply does not do it. A brand-new store shows live viewer and review activity from day one, and purchase notifications appear as real orders come in.

= Features =

* Real orders, live viewer counts, and review snippets — pick any combination
* Inline "12 sold this week" badge on product pages (only when a product really sells 3+ units in a week)
* See how often notifications were shown and clicked this month, right in settings
* Privacy-first: shows first name and city only, with a one-click option to anonymize ("Someone from Jakarta")
* Hidden on cart and checkout by default to keep purchases distraction-free
* Visitors can dismiss notifications for their session
* Lightweight: one small stylesheet and one small script, no external services, no jQuery
* Respects reduced-motion preferences; screen-reader friendly
* Themeable via CSS custom properties
* HPOS compatible

= More free plugins from Sawir Studio =

* [Sawir Insights](https://wordpress.org/plugins/sawir-insights/) — Heatmaps, session recordings, surveys, funnels, and form analytics. Everything stays on your server.
* [Sawir Live Translate](https://wordpress.org/plugins/sawir-live-translate/) — Translate any front-end page live: pick a language, auto-translate the visible strings, save them, and let visitors switch languages.
* [Sawir Media Folders](https://wordpress.org/plugins/sawir-media-folders/) — Fast, unlimited folders for the WordPress media library with drag & drop.
* [Sawir Min Max Quantities for WooCommerce](https://wordpress.org/plugins/sawir-min-max-quantities-for-woocommerce/) — Set minimum and maximum purchase quantity rules for WooCommerce products, product categories, and the whole order.
* [Sawir Product Image Zoom for WooCommerce](https://wordpress.org/plugins/sawir-product-image-zoom-for-woocommerce/) — Adds a product image lightbox with navigation and click-to-zoom to WooCommerce product galleries.
* [Sawir Referral – Refer a Friend for WooCommerce](https://wordpress.org/plugins/sawir-referral/) — Give-and-get referral program for WooCommerce. Friends get a discount, advocates earn a reward coupon — shared by code or link, WhatsApp-first.
* [Sawir Restock Notifier for WooCommerce](https://wordpress.org/plugins/sawir-restock-notifier-for-woocommerce/) — Let customers request an email notification when an out-of-stock WooCommerce product is back in stock.
* [Sawir Role Capabilities Manager](https://wordpress.org/plugins/sawir-role-capabilities-manager/) — Create custom user roles and manage capabilities for new and existing WordPress roles.
* [Sawir Variation Gallery Tools for WooCommerce](https://wordpress.org/plugins/sawir-variation-gallery-tools-woocommerce/) — Manage variation-specific gallery images in WooCommerce. Works with Sawir Product Image Zoom for WooCommerce.

== Frequently Asked Questions ==

= How does it compare to alternatives? =

Most social-proof tools — TrustPulse, NotificationX, Fomo — are more configurable, and several let you compose notifications by hand or run as a hosted service. Sawir Pulse takes a stricter position: every notification comes from a real order, real viewers, or a real review, there is no option to fabricate activity, and everything runs on your own site with no external service. If you need cross-platform campaigns or elaborate targeting rules, a hosted platform serves that well; if you want social proof you can defend to your customers and to regulators, that constraint is the product.

= Can I create custom or fake notifications? =

No, and this is deliberate. Fabricated social proof misleads shoppers and can violate consumer-protection law. Sawir Pulse only ever shows real orders, real viewers, and real reviews.

= What customer data is shown? =

At most a first name and city from the billing address, alongside the product purchased. Enable "Hide customer names" to show "Someone from Jakarta" instead. Viewer counts are computed from a short-lived salted hash — no IP addresses or personal data are stored.

= My store is new and has no orders. What will visitors see? =

Live viewer counts and review snippets, if you have them. Purchase notifications appear automatically once real orders exist. If there is no real activity yet, nothing is shown — which is exactly as it should be.

== Screenshots ==

1. A recent-order notification on a product page.
2. The settings screen under WooCommerce → Pulse.

== Changelog ==

= 1.0.0 =
* Initial release: recent-order, live-viewer, and review notifications, "sold this week" badge, and monthly impression/click counts.
