=== Points and Rewards for WooCommerce – LoyaltyX (Referral, Gamification & Loyalty Program) ===

Contributors: DevDiggers
Plugin URI: https://devdiggers.com/product/woocommerce-points-and-rewards/
Author: DevDiggers
Author URI: https://devdiggers.com/
Version: 1.1.1
License: GNU General Public License v3.0
License URI: http://www.gnu.org/licenses/gpl-3.0.html
Requires at least: 6.5
Tested up to: 7.0.2
Requires PHP: 7.4
WC requires at least: 9.0.0
WC tested up to: 10.9.4
Stable tag: 1.1.1
Tags: loyalty, points and rewards, loyalty program, woocommerce rewards, reward points

A lightweight WooCommerce points and rewards plugin to run a loyalty program where customers earn points on purchases and redeem them for discounts.

== Description ==

LoyaltyX is a simple, lightweight and performance-optimized **[WooCommerce points and rewards plugin](https://devdiggers.com/product/woocommerce-points-and-rewards/)** built for store owners who want to turn one-time buyers into regulars.

Now featuring a **Beautiful Floating Rewards Widget** to boost engagement and a **Smart Setup Wizard** that helps you launch your complete loyalty program in **under 1 minute** without coding or monthly SaaS fees.

Customers earn points automatically on purchases and redeem those points for discounts directly on the cart or checkout page.

= Quick Links =

* [View Free Demo](https://demo.devdiggers.com/woocommerce-loyaltyx-free/)
* [View Pro Demo](https://demo.devdiggers.com/woocommerce-loyaltyx/)
* [Full Documentation](https://docs.devdiggers.com/woocommerce-points-and-rewards/)
* [Free vs Pro Comparison](https://devdiggers.com/product/woocommerce-points-and-rewards/#free-vs-pro)
* [Upgrade to Pro](https://devdiggers.com/product/woocommerce-points-and-rewards/)

---

= Key Features =
* Earn points automatically for purchases
* Redeem points for discounts at cart or checkout
* **NEW:** Onboarding Setup Wizard for instant loyalty program launch
* **NEW:** Beautiful Floating Rewards Widget for customer engagement
* Customer rewards dashboard inside My Account
* Points notifications across product, cart, and checkout pages
* Manual admin adjustments and full transaction log
* Works with WooCommerce High-Performance Order Storage (HPOS)

= How It Works =
Setting up a loyalty program with LoyaltyX takes just a few minutes.

1. Install and activate the plugin
2. **Follow the Onboarding Setup Wizard** to configure your basic rules in seconds
3. Customize your Floating Rewards Widget colors to match your brand
4. Customers start earning points automatically

Customers see their points balance in their account and can redeem points during checkout with a single click.

= Why Loyalty Programs Work =
Repeat customers spend **67% more per order** than new customers.

Without a loyalty program, a customer who buys once has no strong reason to return to your store instead of a competitor.

A points system creates that incentive.

When customers know they already have points saved in your store, they are far more likely to come back and complete another purchase.

LoyaltyX makes this easy for WooCommerce stores without requiring a developer or an expensive SaaS platform.

---

== WooCommerce Points and Rewards - Free Version Features ==

=== Purchase-Based Points Earning ===

Customers automatically earn points when they place an order.

* Set a global conversion rate (example: earn 10 points per $1 spent)
* Choose which order statuses trigger points (processing or completed)
* Configure rounding rules for fractional points
* Exclude specific products or categories from earning points
* Optionally exclude sale products from earning
* Control whether shipping and taxes count toward points
* Choose whether coupon orders still earn points

=== Flexible Points Redemption at Cart and Checkout ===

Customers can redeem their points where they are already making purchase decisions.

* Redeem points for discount coupons directly at cart or checkout
* Set minimum and maximum redemption limits
* Define redemption conversion rates (example: 100 points = $1 discount)
* Partial redemption supported – customers choose how many points to spend
* Exclude specific products or categories from redemption
* Option to exclude sale products from redemption calculations

=== Customer Rewards Dashboard in My Account ===

Customers can see their entire rewards history and available balance.

* Dedicated Points and Rewards dashboard inside the My Account page
* Shows total points earned, available balance, and points redeemed
* Complete transaction history for all point events
* Visual summary cards for quick scanning of rewards data
* Fully customizable styling including colors, icons, and layout
* Rename “Points” to Stars, Credits, Coins, or any custom label

Shortcodes included:
`[ddwcpr_points_dashboard]` – Display the rewards dashboard anywhere
`[ddwcpr_available_points_value]` – Display the customer's points balance

=== Floating Rewards Widget ===

The all-new Floating Rewards Widget provides a premium, "SaaS-like" experience for your customers, keeping your loyalty program visible on every page without being intrusive.

* **One-Click Access:** Customers can check their balance and see "Ways to Earn" and "Redeem Rewards" from anywhere on your site.
* **Modern Design:** A clean, slide-out panel that matches modern e-commerce standards.
* **Fully Responsive:** Works perfectly on mobile and desktop devices.
* **Style Customization:** Match your brand by choosing primary colors, text colors, and spacing.
* **Guest Onboarding:** Encourages guest users to join your loyalty program with clear call-to-action buttons.
* **Powered by Ajax:** Fast, smooth interaction that doesn't slow down your site.

=== Points Notifications Across Your Store ===

Customers see reward messages during the shopping journey.

* Product pages show “Earn X Points with this purchase”
* Shop page displays points on product cards
* Cart page shows potential points earnings
* Checkout page reminds customers about available points
* Order confirmation page shows earned points

All text and styling are fully customizable.

=== Admin Management ===

Manage the loyalty program directly from WordPress.

* View all customers and points balances
* Manually adjust points with notes
* Full transaction log
* Automatic points revocation on refunds or cancellations
* Configure which order statuses trigger revocation

=== Developer-Friendly and Performance Focused ===
LoyaltyX is built with performance and extensibility in mind.

* HPOS compatible
* Translation ready (.pot file included)
* Compatible with WPML, Polylang, and Loco Translate
* Compatible with major WooCommerce themes
* Works with all WooCommerce payment gateways
* Ajax-powered redemption and dashboard updates
* Clean code with hooks and filters for developers

[View the Free Version Live Demo](https://demo.devdiggers.com/woocommerce-loyaltyx-free/)

---

== LoyaltyX Pro - Advanced Features ==

The [Pro version](https://devdiggers.com/product/woocommerce-points-and-rewards/) expands LoyaltyX into a full loyalty and engagement platform.

=== More Ways to Earn Points ===

* Sign-up bonus
* Product review rewards
* Daily login rewards
* Birthday rewards
* Referral program
* Loyalty tier bonuses
* Product and category specific earning rates
* User role based earning rules

=== Advanced Redemption Options ===

* Fixed amount discounts
* Percentage discounts
* Free shipping rewards
* Free products
* Buy X Get Y rewards
* Product bundle rewards

=== Loyalty Tiers and Gamification ===

* Unlimited loyalty tiers
* Tier progress tracking
* Points multipliers for higher tiers
* Tier achievement notifications

=== Points Expiration ===

* Automatic expiration rules
* Reminder emails before expiration
* Expiration tracking based on activity

=== Advanced Analytics ===

* Import and export points balances via CSV
* Bulk point operations
* Redemption and ROI reports
* Identify top loyalty customers
* Email marketing integrations

[View the Pro Version Live Demo](https://demo.devdiggers.com/woocommerce-loyaltyx/)
[Upgrade to LoyaltyX Pro](https://devdiggers.com/product/woocommerce-points-and-rewards/)

== Installation ==

### Automatic Installation

1. Go to **Plugins → Add New** in WordPress admin
2. Search for **LoyaltyX – Points and Rewards for WooCommerce**
3. Click **Install Now**
4. Click **Activate**

---

### Manual Installation

1. Download the plugin zip file
2. Go to **Plugins → Add New → Upload Plugin**
3. Upload the zip file and activate

Alternatively, upload the plugin folder to `/wp-content/plugins/` via FTP and activate it from the Plugins menu.

---

== Frequently Asked Questions ==

= How do customers earn loyalty points in my WooCommerce store? =

In the free version, customers earn points automatically on every qualifying purchase. You set the conversion rate from the admin panel: for example, 10 points per $1 spent. Points are awarded when an order reaches the status or statuses you configure, typically processing or completed. The customer's balance updates in their My Account dashboard immediately.

The Pro version adds additional earning triggers: account registration, product reviews, daily logins, birthdays, referrals, specific product and category rules, and user-role-based earning rates.

= Can customers redeem points at checkout? =

Yes. The free version adds a redemption option to both the cart page and the checkout page. Customers see their available balance and can choose how many points to redeem. The plugin generates a discount coupon code automatically and applies it to the order. You control the minimum and maximum redemption limits, and partial redemption is fully supported.

= Is LoyaltyX compatible with WooCommerce HPOS? =

Yes. LoyaltyX has declared full compatibility with WooCommerce High-Performance Order Storage. The plugin has been tested with HPOS enabled on standard and block-based checkout configurations. There's no additional configuration needed on your end.

= Does this plugin work with the WooCommerce block checkout? =

Yes. The plugin is compatible with the WooCommerce block-based checkout. Points earning messages and redemption options display correctly in the block checkout environment.

= Can I rename "Points" to something else? =

Yes. From the Configuration panel you can set a singular and plural label for your points currency. Common choices are Stars, Credits, Coins, Tokens, or any custom name that fits your brand. The new label appears everywhere: on product pages, cart, checkout, the My Account dashboard, and email notifications.

= What happens to points when an order is refunded? =

Points earned on a refunded or cancelled order are automatically revoked. You configure which order statuses trigger revocation from the admin panel. The point adjustment appears in the customer's transaction log with the reason noted.

= Do points expire? =

Points expiration is a Pro feature. In Pro you set an expiration period based on days of customer inactivity. Customers receive a reminder email before their points expire, and a second confirmation email when the expiration occurs.

= How do I display the customer's points balance outside of My Account? =

Use the `[ddwcpr_available_points_value]` shortcode to show the current user's point balance anywhere on your site: sidebars, page builders, custom templates, or any widget area. Use `[ddwcpr_points_dashboard]` to display the full rewards dashboard, including transaction history and earning rules, anywhere on your site.

= What is the Floating Rewards Widget? =

The Floating Rewards Widget is a beautiful, slide-out panel that sits on the side of your storefront. It allows customers to quickly check their points balance, view earning rules, and see redemption options without leaving the page they are on. It's a great way to increase engagement and keep your loyalty program top-of-mind for your shoppers. You can enable it and customize its colors from **Configuration → Rewards Widget**.

= Is this plugin compatible with multilingual setups? =

Yes. LoyaltyX ships with a `.pot` translation file. It's compatible with WPML, Polylang, and Loco Translate. All customer-facing strings, including earning messages, redemption notices, email content, dashboard labels, and point names, are fully translatable.

= Does this plugin slow down my store? =

No. The plugin uses optimized database queries and runs on a well-structured schema with three dedicated tables for points logs, earning rules, and redemption rules. Ajax is used for real-time balance and redemption updates so the overall page load is not affected. HPOS compatibility also means order-related queries stay fast as your order volume grows.

= Can I import existing points from another WooCommerce loyalty plugin? =

Yes, it includes a CSV import tool that lets you upload customer user IDs and corresponding point balances. This allows you to migrate from another loyalty plugin without losing your customer's accumulated history.

= What's the difference between the free and Pro versions? =

The free version covers purchase-based earning, cart and checkout redemption, the customer dashboard, admin management, and all compatibility features. That's enough to run a solid entry-level loyalty program at no cost.

Pro adds advanced earning rules (referrals, reviews, signups, birthdays, daily logins), loyalty tiers with multiplier rates, points expiration with automated reminders, additional redemption types (free shipping, free products, BOGO, bundles), advanced analytics, bulk operations, and CSV import/export.

See the full breakdown at [devdiggers.com/product/woocommerce-points-and-rewards/#free-vs-pro](https://devdiggers.com/product/woocommerce-points-and-rewards/#free-vs-pro)

= Is there a demo I can try before installing? =

Yes. A live demo of the free version is available at [demo.devdiggers.com/woocommerce-loyaltyx-free/](https://demo.devdiggers.com/woocommerce-loyaltyx-free/) and the Pro version demo is at [demo.devdiggers.com/woocommerce-loyaltyx/](https://demo.devdiggers.com/woocommerce-loyaltyx/).

= Does the plugin require a developer to set up? =

No. All configuration is handled through an admin panel with labeled fields. There's no code editing required for the standard setup. Developers who want to extend the plugin will find action hooks and filters throughout the codebase.

= Where can I get support if something isn't working? =

Use the support forum here on WordPress.org for free version questions. The documentation at [docs.devdiggers.com/woocommerce-points-and-rewards/](https://docs.devdiggers.com/woocommerce-points-and-rewards/) covers all configuration options with step-by-step guides. Pro license holders have access to direct support from the DevDiggers team.

== Screenshots ==

1. Admin dashboard overview with program stats across all customers
2. Customer rewards dashboard in the My Account area, showing points balance, total earned, and total redeemed
3. Customer earning section listing all available ways to earn points and corresponding point values
4. Customer redemption section where customers choose how many points to redeem for a discount coupon
5. Customer rewards and history section showing full transaction log with dates and reasons
6. Beautiful Floating Rewards Widget
7. Shop page product cards displaying earn points messages alongside each product
8. Product page showing the points earning notice before the add-to-cart button
9. Cart page with points earning message for the current order and redemption prompt for available balance
10. Checkout page showing pending points to be earned and the active redemption option
11. Rewards popup on cart and checkout pages for increased engagement
12. New Onboarding Setup Wizard for quick configuration and instant loyalty program launch
13. Admin users list showing each customer's current points balance
14. Full transaction log in admin showing every point event across the store
15. Order confirmation page showing points earned from the completed purchase

== Changelog ==

= 1.1.0 =
* Added the plugin setup wizard for a smoother onboarding experience.
* Added floating rewards widget with all customization options.
* Updated the framework to make the plugin faster and more stable.
* General performance improvements and code cleanup.

= 1.0.3 =
* Resolved the error showing on the activation of the plugin functionality.

= 1.0.2 =
* Resolved the issue of plugin conflict with other DevDiggers plugins.

= 1.0.1 =
* Updated DevDiggers Framework code
* Confirmed compatibility with WooCommerce 10.6.1 and WordPress 6.9.4
* Resolved reward coupon generation issue

= 1.0.0 =
* Initial release