=== Points Vault ===
Contributors: yodsira
Tags: woocommerce, loyalty, points, rewards, retention
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 1.1.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A transparent loyalty program for WooCommerce: earn points for paid orders, spend them with one checkbox at checkout, full ledger for everyone.

== Description ==

Keeping a customer costs less than finding a new one. Points Vault
runs a clear points program: no hidden tricks, an append-only ledger,
and one checkbox at checkout.

= What it does =

* Points for paid orders: 1 point per every N of currency spent (you
  set the rate). Cancellation or refund reverses the points exactly
  once - the ledger stays honest.
* Redemption with one checkbox at checkout: "use my points". The
  discount cannot exceed the order total, and the spent part earns no
  new points.
* "My points" page in My Account: the balance and the full movement
  history (when, why, how many).
* A manual adjustment field in the admin user profile - every change
  lands in the ledger with a reason.
* The completed-order e-mail tells the customer how many points they
  just earned (optional).
* Works with WooCommerce High-Performance Order Storage (HPOS).

= Points Vault Pro =

The Pro companion adds bonus rules (registration, reviews, birthday),
bronze/silver/gold levels with earn multipliers, points expiry with a
warning e-mail and a referral program. Learn more:
https://yodsira.com/en/product/points-vault/

== Screenshots ==

1. The checkout checkbox with the points value.
2. "My points" in My Account.
3. The manual adjustment in the admin profile.

== Installation ==

1. Install the plugin through the WordPress plugins screen (Plugins ->
   Add New -> Upload Plugin) and activate it.
2. WooCommerce must be active.
3. Open WooCommerce -> Points Vault and set your rates.

== Frequently Asked Questions ==

= Do guests earn points? =

No - points belong to accounts. A guest order earns nothing; when the
same person registers, future orders earn points.

= Can a customer spend more points than they have? =

No. The checkbox shows the exact value of the current balance and the
checkout validation caps the discount at the order total.

= What happens on a refund? =

The earned points are reversed once. If part of them was already
spent, only the unspent part is reversed.

= Is anything sent to third parties? =

No. Points Vault works entirely on your site and sends nothing
anywhere.

== Changelog ==

= 1.0.0 =
* First release: earning on completed orders with reversal, checkout
  redemption with one checkbox, My Account balance and history, manual
  admin adjustment, earning line in e-mails, HPOS support.

== Privacy & Data ==

Points Vault stores the points ledger in your own WordPress database.
Nothing is sent to any external service.
