=== ProofNexus Live Sales Popup & Social Proof ===
Contributors: wpmanagestudio
Tags: sales popup, social proof, woocommerce notification, live sales, proofnexus
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.5.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Text Domain: proofnexus-live-sales-popup-social-proof

Show real-time WooCommerce sales notifications and social proof popups that build trust and boost conversions — lightweight and fast.

== Description ==

ProofNexus is a lightweight, high-performance social proof plugin for WordPress and WooCommerce. It displays unobtrusive "recent activity" popups — such as live sales notifications — so visitors can see that real people are buying, building trust and encouraging conversions without slowing your site down.

**Core features (100% free):**

* **Live WooCommerce Sales Popups** — automatically pull recent completed/processing orders and show them as real-time notification popups on the front end. Works entirely without WooCommerce too — see below.
* **Custom Notifications** — create manual, custom social proof popups for any use case (signups, downloads, announcements, etc.), with no limit on how many you can create.
* **WordPress Comment Popups** — a free, always-available module that shows a popup whenever a new comment is approved, no other plugin required.
* **REST API Delivery** — popups are fetched via a lightweight, cache-friendly REST endpoint instead of blocking page load.
* **Full Design Control** — configure popup position, colors, border radius, display duration, delay, and frequency from a clean tabbed settings screen.
* **Privacy-Conscious Display Modes** — show a buyer's full name, first name + city, or a fully anonymized city-only label.
* **Role Management & Reporting Frequency** — control which roles can manage settings and how often summary data is considered.
* **Developer-Friendly** — clean action/filter hooks throughout so the plugin can be extended without touching core files.

ProofNexus is built to be fully functional as a standalone free plugin. Optional Pro integrations (ActiveCampaign, LearnDash, Google Reviews, Elementor, Mailchimp, Zapier) are available separately and never disable or degrade the free feature set.

= Privacy Notice =

The free WooCommerce module only ever displays data the site owner has explicitly enabled via the privacy mode setting (full name, first name + city, or anonymized city). No email addresses, order IDs, or other personally identifying order data are ever exposed on the front end or via the REST endpoint.

== Installation ==

**Automatic installation**

1. Log in to your WordPress dashboard and navigate to Plugins → Add New.
2. Search for "ProofNexus Live Sales Popup & Social Proof".
3. Click Install Now, then Activate.
4. Go to ProofNexus in the admin menu to configure your popups.

**Manual installation**

1. Download the plugin zip file.
2. Navigate to Plugins → Add New → Upload Plugin in your WordPress dashboard.
3. Select the downloaded zip file and click Install Now.
4. Activate the plugin through the Plugins menu.
5. Go to ProofNexus in the admin menu to configure your popups.

**Requirements**

* WordPress 5.8 or higher.
* PHP 7.4 or higher.
* WooCommerce 6.0+ is required only for the Live Sales Popup module. The plugin remains fully usable for custom/manual notifications without WooCommerce installed.

== Frequently Asked Questions ==

= Does ProofNexus work without WooCommerce? =

Yes. ProofNexus is fully functional on a standard WordPress site with no WooCommerce installed at all — the Custom Notifications and WordPress Comment modules work independently of WooCommerce, and the settings screen shows a friendly notice (rather than an error) when WooCommerce isn't active. The Live Sales Popup module specifically requires WooCommerce, since it reads real order data, and simply doesn't appear as an option until WooCommerce is installed and active.

= Will ProofNexus slow down my site? =

No. Popup data is served through a small, cache-friendly REST endpoint and the front-end script is loaded asynchronously, so there is no render-blocking impact on page load.

= What visitor or order data is shown in a popup? =

Only what you configure. For WooCommerce popups you choose a privacy mode: full name, first name plus city, or anonymized city only. No raw order IDs, emails, or addresses are ever included in the popup payload.

= Is ProofNexus free to use? =

Yes. The Live Sales Popup, WordPress Comment, and Custom Notifications modules are all 100% free and fully functional with no limits. ProofNexus Pro is entirely optional and adds third-party integrations (ActiveCampaign, LearnDash, Google Reviews, Elementor, Mailchimp, Zapier) for stores that want them — it never disables or restricts anything in the free feature set.

= Where can I get support? =

Please use the WordPress.org support forum for this plugin. We aim to respond to all support requests promptly.

== Screenshots ==

1. General settings tab — configure popup position, timing, and display rules.
2. Design tab — customize popup colors, border radius, and image shape with a live color picker.
3. Notifications tab — manage WooCommerce and custom notification sources.
4. A live sales popup as shown to front-end visitors.
5. Integrations tab — connect optional Pro integrations.

== Changelog ==

= 1.5.0 =
* Added: public extension hooks for the separate ProofNexus Pro add-on — `proofnexus_admin_tabs`, `proofnexus_settings_fields`, `proofnexus_notification_item`, `proofnexus_rest_items`, `proofnexus_front_localize_data`, and the `proofnexus_can_{capability}` filter family (via a new `ProofNexus_Freemium::can()`/`require_capability()` capability gate). See FREE_1_5_0_HOOK_CONTRACT.md for the full hook contract.
* No behavior change for sites without ProofNexus Pro installed: every new hook is a no-op (`apply_filters()` returns its input unchanged) with no callback attached, and the public REST popup endpoint remains strictly whitelisted to the same documented fields regardless of what any hook does.

= 1.4.1 =
* Fixed: front-end and admin CSS/JS assets now version their enqueue URL from the file's own last-modified time (`filemtime()`) instead of a static plugin version, so an edited stylesheet or script is picked up immediately by browsers, page caches, and CDNs — no more needing a hard refresh (or a full plugin version bump) to see a CSS change. Falls back to the plugin version if `filemtime()` can't read the file.
* Fixed: popup position CSS (`bottom-left` / `bottom-right` / `top-left` / `top-right`) now explicitly resets the opposite `left`/`right`/`top`/`bottom` property on every position change, at higher selector specificity, so a leftover value from an older cached stylesheet can no longer make a "move to the right" setting appear stuck on the left.

= 1.4.0 =
* Removed: the 5-item Free-version cap on Custom Notifications. Every site, free or Pro, can now create an unlimited number of custom notifications.
* Removed: the Pro lock on Role Management. Granting Editor/Shop Manager access to ProofNexus settings is now free on every site.
* Removed: the default "by ProofNexus" / "Verified by ProofNexus" credit line from the front-end popup. Popups render with no forced branding or back-link.
* Added: a GPLv2 LICENSE file at the plugin root.
* Compliance: full pass against the WordPress.org Plugin Directory guidelines — no artificial limitations gate already-included free functionality; remaining "PRO" badges and upgrade links apply only to separate, unreleased third-party integrations (ActiveCampaign, LearnDash, Google Reviews, Elementor, Mailchimp, Zapier).

= 1.2.0 =
* New: Custom Notifications avatar images now use the native WordPress Media Uploader instead of a raw URL field, with a built-in square-crop tool that saves every avatar as a uniform, distortion-free image.
* Improved: popup title/message text is larger and bolder for better on-page readability, with more breathing room in the line height.
* New: a subtle "Verified by ProofNexus" credit badge on the front-end popup card.
* Compliance: new image-upload AJAX endpoint is nonce- and capability-protected, and re-validates the uploaded image server-side (real image check, MIME allow-list, size cap) regardless of what the browser sent.

= 1.1.0 =
* New: Custom Notifications module — manually create popups with a title/customer name, message/action, location, time string, and optional avatar image, right from the Notifications tab. Free version stores up to 5; ProofNexus Pro is unlimited.
* Improved: the plugin now runs cleanly on a standard WordPress site with no WooCommerce active — the settings screen shows a friendly, informational notice instead of an alarming warning, and only on the ProofNexus settings screen itself.
* Compliance: updated "Tested up to" and "WC tested up to" versions, added a `.pot` translation template, and completed a full sanitization/escaping pass on all new inputs and the REST endpoint.

= 1.0.0 =
* Initial public release.
* Live WooCommerce sales popup module.
* Custom/WP Core notification module.
* REST API-based popup delivery with response whitelisting and sanitization.
* Tabbed admin settings screen with design controls and privacy modes.

== Upgrade Notice ==

= 1.4.1 =
Fixes stale/cached CSS and JS not updating after an edit, plus a popup-position CSS specificity fix (left/right, top/bottom).

= 1.4.0 =
Custom Notifications are now unlimited and Role Management is fully unlocked on every site. The front-end popup no longer shows a "by ProofNexus" credit line.

= 1.2.0 =
Custom Notifications avatars now use the Media Uploader with built-in square cropping, plus bolder popup typography and a new credit badge.

= 1.1.0 =
Adds the Custom Notifications module (up to 5 free) and improves standalone WordPress (non-WooCommerce) compatibility.

= 1.0.0 =
Initial public release.
