=== LocalLoyalty ===
Contributors: discgolfshopping
Donate link: https://localsitebuilder.com/
Tags: local, loyalty, rewards, points, coupons
Requires at least: 5.6
Tested up to: 6.9
Requires PHP: 7.2
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A simple, powerful WooCommerce loyalty points plugin. Customers earn points per purchase and redeem them at checkout for instant discounts.

== Description ==

**LocalLoyalty** is a lightweight, fast, and user-friendly loyalty points system for WooCommerce. 

Unlike complex enterprise suites, LocalLoyalty is designed to "just work." Customers earn points automatically for every purchase. When their order is marked **Completed**, points move from *Pending* to *Available* and can be redeemed at checkout like store credit.

**New in v1.0.1:** You can now rename your points currency! Call them "Coins," "Stars," "Tokens," or anything that fits your brand via the new Dashboard.

### 🎁 Features

- **Earn 1 point per $1** spent (Simple, fixed rate)
- **Custom Currency Name:** Rename "Points" to anything you want (e.g., "Gold," "Stars")
- **Smart Status Handling:** Points go *Pending* → *Available* automatically when orders complete
- **Checkout Redemption:** Customers can apply points for discounts directly on the checkout page
- **Refund Protection:** Automatically removes points if an order is refunded or cancelled
- **My Account Dashboard:** Beautiful summary showing Current Balance, Pending Points, and Unlocked Rewards
- **Floating Widget:** Optional "Sticky" widget to remind customers of their balance
- **No Bloat:** Built for speed with minimal database impact

### 🚀 Unlock More with LocalLoyalty Pro

Need more power? Upgrade to **LocalLoyalty Pro** for:

- **Multipliers:** 2x Points on specific Categories, Brands, or Tags
- **Custom Tiers:** Create unlimited reward levels (e.g., 500 pts = $25)
- **Percentage Rewards:** Offer % discounts (e.g., 100 pts = 10% Off)
- **Brand Blocking:** Prevent rewards from being used on MAP-protected items
- **Point Adjustments:** Easy admin dashboard to manually add/remove points
- **History Log:** Detailed audit trail for every point earned or spent

[Upgrade to Pro](https://localsitebuilder.com/plugin/local-loyalty-pro/)

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/localloyalty/` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to **LocalLoyalty** in your admin menu to configure your Points Label (e.g., "Coins").
4. That's it! Customers will now earn points on future orders.

== Frequently Asked Questions ==

= Do I need WooCommerce installed? =
Yes. LocalLoyalty is an extension for WooCommerce and requires it to be active.

= Can I change the earning rate (e.g., 2 points per dollar)? =
The Free version is fixed at **1 Point = $1.00**. The Pro version allows you to set custom earning rates and add multipliers for specific products or categories.

= Can I rename "Points" to something else? =
Yes! Go to the **LocalLoyalty** menu in your dashboard. You can change the label to "Coins," "Stars," "Tokens," etc.

= What happens if I refund an order? =
LocalLoyalty is smart. If you refund an order, the points earned from that order are automatically removed from the customer's balance. If the customer *used* points to pay for the order, those points are returned to them.

= Does this work with variable products? =
Yes. All product types (Simple, Variable, Digital) earn points normally based on the order total.

== Screenshots ==

1. **Loyalty Dashboard** - Customers can see their balance and progress inside "My Account".
2. **Checkout Redemption** - Easy radio buttons let customers apply discounts instantly.
3. **Admin Settings** - Rename your points currency and view upgrade options.
4. **Floating Widget** - A subtle reminder that encourages customers to log in and shop.

== Changelog ==

= 1.0.1 =
* Added: Admin Settings page
* Added: Option to rename "Points" label (e.g. Coins, Stars)
* Improved: "My Account" dashboard UI with rewards list
* Improved: Internationalization (i18n) support
* Fixed: Refund logic to strictly handle returns

= 1.0.0 =
* Initial release
* Earn 1 point per $1 spent
* Pending → Available system
* My Account loyalty dashboard
* Checkout redemption options

== Upgrade Notice ==

= 1.0.1 =
Added a new settings dashboard! You can now rename your points currency.