=== CodeKitSoft Loyalty Engine for WooCommerce ===
Contributors: pranaykantey
Tags: woocommerce, points, rewards, loyalty, discount
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
WC requires at least: 5.0
WC tested up to: 10.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Reward WooCommerce customers with points for purchases and redeem them for discounts.

== Description ==

CodeKitSoft Loyalty Engine is a powerful yet simple plugin that allows you to implement a customer loyalty program in your WooCommerce store. Reward your customers with points for their purchases and allow them to redeem those points for discounts.

Perfect for WooCommerce stores that want to increase repeat purchases, customer retention, and loyalty using a flexible points and rewards system.

= Features =

* Automatic Points Earning - Points are automatically awarded when an order is completed
* Flexible Redemption - Customers can apply points for discounts in their cart
* Configurable Rates - Set how many points customers earn per dollar spent
* Flexible Discount Rules - Set how much discount each point is worth
* Auto-Redeem Option - Automatically apply points for maximum discount
* Maximum Discount Limit - Set a maximum percentage of cart subtotal that can be discounted
* Shortcode Support - Display the points redemption form anywhere using [wcpr_points]
* Multiple Display Locations - Points box automatically shows on cart and checkout pages
* My Account Integration - Displays user's current points on their account page
* HPOS Compatible - Fully compatible with WooCommerce High-Performance Order Storage
* Translation Ready - All strings are internationalized

= How It Works =

1. **Earn Points**: Customers earn points for every purchase they make
2. **Track Points**: Points are automatically tracked in the customer's account
3. **Redeem Points**: Customers can apply their points for discounts on cart/checkout

== Installation ==

1. Go to **Plugins → Add New**
2. Search for "CodeKitSoft Loyalty Engine for WooCommerce"
3. Click **Install Now**
4. Click **Activate**
5. Make sure WooCommerce is activated before using this plugin.

Or upload the plugin files to the `/wp-content/plugins/codekitsoft-loyalty-engine` directory and activate through the WordPress plugins screen.

== Configuration ==

After activating the plugin, configure the settings:

1. Go to **WooCommerce → Settings → Products → Points**
2. Configure the following options:

=== Points Earning Settings ===

* **Points per Dollar Spent**: How many points customers earn for each dollar spent (default: 1)

=== Points Redemption Settings ===

* **Discount per Point**: How much discount each point provides (default: $1.00)
* **Maximum Discount Percentage**: Maximum percentage of cart subtotal that can be discounted (default: 100%)
* **Enable Auto-Redeem**: Automatically apply available points for maximum discount (default: No)

== Usage ==

=== Shortcode ===

Use the `[wcpr_points]` shortcode to display the points redemption form on any page or widget:

`[wcpr_points]`


The points box will also automatically appear on:

The points redemption box automatically appears on:
* Cart page
* Checkout page  
* My Account page (displays current points balance)

=== How Customers Use Points ===

1. Customer adds items to cart
2. On cart/checkout page, they see their available points
3. They enter the number of points to use
4. Click "Apply Points" to see the discount applied
5. The discount shows as "Points Discount" in the cart totals

== Frequently Asked Questions ==

= How do customers earn points? =
Points are automatically awarded when an order status changes to "completed". The number of points is calculated based on the order total multiplied by the "Points per Dollar Spent" setting.

= Can customers use partial points? =
No, customers must use whole numbers of points.

= What happens to points after checkout? =
Points are automatically deducted from the customer's balance after the order is placed.

= Is this compatible with HPOS? =
Yes, this plugin is fully compatible with WooCommerce High-Performance Order Storage (HPOS).

= Can I use this with the Gutenberg block editor? =
Yes, you can use the `[wcpr_points]` shortcode with any shortcode block in the Gutenberg editor.
== Screenshots ==

1. Loyalty Engine dashboard and settings
2. WooCommerce points apply box
3. points on my account page


== Changelog ==

= 1.0.0 =
* Initial release
* Award points on order completion
* Point redemption for discounts
* My Account page display
* Configurable settings
* HPOS compatible
* Shortcode support
== Upgrade Notice ==

= 1.0.0 =
Initial stable release of CodeKitSoft Loyalty Engine for WooCommerce.

== License ==

This plugin is licensed under the GPL v2 or later license. See https://www.gnu.org/licenses/gpl-2.0.html
