=== VoidPulse - Social Proof Notifications for WooCommerce ===
Tags: woocommerce, sales notification, social proof, fomo, recent sales
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.0
WC requires at least: 8.0
WC tested up to: 11.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn WooCommerce sales into powerful social proof that builds trust, creates urgency, and helps shoppers buy with confidence.

== Description ==

VoidPulse shows small pop-up messages when customers buy products from your store.

= WHAT'S INCLUDED =

* **Recent sales notification:** Build a notification from genuine WooCommerce orders.
* **Unlimited views:** Display it as often as you like, with no cap, quota, trial, or time limit.
* **Full design control:** Set every colour, the layout, corner radius, width, image shape, and desktop and mobile position.
* **Design presets:** Start from 27 curated light and dark palettes, then adjust anything.
* **Typography:** Choose the font, weight, size, and colour for the activity label, headline, and message, including Google Fonts.
* **Optional label and headline:** Show or hide the activity label and headline above the message.
* **Animation and timing:** Pick the animation, easing, speed, delay, duration, gap, and rotation order.
* **Privacy choices:** Control how customer names and general locations appear.
* **Order rules:** Choose which order statuses, date range, and products may be shown.
* **Display rules:** Choose which pages it appears on and hide it on mobile or desktop.
* **Pacing controls:** Set a frequency cap, dismissal snooze, repeat protection, and cross-page pacing.
* **Product links:** Send visitors directly to the product being shown.
* **Analytics:** View impressions, clicks, dismissals, click-through rate, and an activity chart over any range from 7 up to 365 days, plus a WordPress dashboard widget.
* **Import and export:** Save or move your configuration as a JSON file.
* **Accessible display:** Support keyboards, visible focus, and reduced motion.
* **HPOS support:** Work with WooCommerce High-Performance Order Storage.
* **Safe updates:** Keep your configuration and activity when the plugin is updated or deactivated.

Every feature above is fully functional. There is no licence key, account, upgrade prompt requirement, or external service needed to use any of it.

= PRO FEATURES =

* ⭐ **Multiple campaigns:** Create campaigns for different products and goals.
* ⭐ **Review notifications:** Show real, approved WooCommerce product reviews.
* ⭐ **Sales milestones:** Highlight genuine purchase milestones and customer activity.
* ⭐ **Product sales totals:** Show authentic sales momentum such as how many times a product sold this week.
* ⭐ **Advanced targeting:** Choose where, when, and to whom a campaign appears.
* ⭐ **Scheduling:** Set campaign dates, days, and daily display times.
* ⭐ **Display priority:** Decide which campaign should appear first.
* ⭐ **Conversion analytics:** Explore per-campaign funnels, attributed orders, revenue, and CSV exports.
* ⭐ **Experiments:** Compare campaign variations.
* ⭐ **External sale webhooks:** Display verified purchase activity from another service using secure signed webhooks.
* ⭐ **Role controls:** Choose which store roles can manage campaigns and reports.
* ⭐ **Priority support:** Get faster help when you need it.

== Installation ==

1. In WordPress, go to Plugins > Add New.
2. Upload the plugin ZIP and select Activate.
3. Make sure WooCommerce is active.
4. Go to WooCommerce > VoidPulse to create your first campaign.

== Frequently Asked Questions ==

= Does the plugin show fake sales? =

No. Public notifications use eligible WooCommerce orders.

= What customer information can be shown? =

You can show a shortened name and a general location. The plugin does not display street addresses, email addresses, phone numbers, IP addresses, order numbers, or payment details.

= Does it work with WooCommerce HPOS? =

Yes.

= What if WooCommerce is not active? =

The plugin stays active and shows an admin notice. Sales notifications wait until WooCommerce is available.

= Will I lose data if I deactivate or downgrade? =

No. Your data is kept by default.

= How do I remove all plugin data? =

Turn on “Delete all plugin data on uninstall” before uninstalling the plugin.

== Screenshots ==

1. Dashboard overview with campaign status, performance totals and the completed setup checklist.
2. Campaign editor with dynamic message tokens, customer privacy controls and responsive live preview.
3. Design preset library with curated light and dark notification styles shown beside the live preview.
4. Privacy-safe analytics with selectable reporting range, impressions, clicks, dismissals and click-through rate reporting.

== External services ==

This plugin includes the Freemius SDK for optional usage sharing, account management, licensing, billing, and plugin updates.

To rebuild the generated assets:

1. `npm install`
2. `npx wp-scripts build`

== Changelog ==

= 1.0.0 =

* Initial release.

== Upgrade Notice ==

= 1.0.0 =

Initial release.
