=== PuntoWoo Loyalty & Digital Wallet for WooCommerce ===
Contributors: caesychaos
Tags: loyalty, points, gift card, store credit, digital wallet
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
WC requires at least: 6.0
WC tested up to: 11.1
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Digital loyalty cards, points & rewards engine, store credit wallet, and gift cards for WooCommerce and POS.

== Description ==

**PuntoWoo Loyalty & Digital Wallet for WooCommerce** is a complete, self-contained customer loyalty and digital wallet platform built specifically for modern WooCommerce stores and physical retail businesses.

### 📱 Official Mobile App Now Available!

Give your customers an instant smartphone digital pass. Pair PuntoWoo Loyalty with our newly approved companion extension:  
👉 **[PuntoWoo Mobile App & Loyalty Wallet API](https://wordpress.org/plugins/puntowoo-mobile-app-loyalty-wallet-api/)**

* 📲 **Android Mobile Wallet Pass**: Customers carry their VIP pass directly on their phones with live points, gift card cash, and scannable Code 128 barcode & QR.
* ⚡ **Automatic Store Discovery**: The mobile app instantly detects your store branding, logo, points exchange rates, and currency via fast REST API.
* 📸 **Customer Profile & Camera Uploader**: Shoppers can upload their profile selfie or photo from their phone camera directly into WordPress.
* 🧾 **Live Transaction Ledger**: Complete chronological audit log of all orders, points earned, and store credit balance redemptions.

---

Turn one-time shoppers into lifelong brand advocates. PuntoWoo provides your customers with an elegant digital membership pass right in their **WooCommerce My Account** page—complete with a unique 10-digit card number, real-time points balance, gift card store credit, and a scannable **Code 128 SVG barcode** ready for any retail Point of Sale (POS) scanner.

Unlike bulky SaaS-based loyalty platforms that charge expensive monthly subscriptions and slow down your store with external API calls, PuntoWoo runs 100% natively on your WordPress database. It is ultra-fast, privacy-friendly, fully compatible with **HPOS (High-Performance Order Storage)**, and works out-of-the-box with both classic WooCommerce checkout and modern **WooCommerce Checkout Blocks**.

---

### 🌟 Why Store Owners Choose PuntoWoo

* 🚀 **Zero Monthly Fees & 100% Self-Contained**: No external SaaS lock-in, no per-transaction charges, and no third-party data tracking. All customer points and wallet balances stay securely in your own database.
* 💳 **Virtual Membership Card in "My Account"**: Customers receive an instant digital card pass showing live loyalty points and gift card balances on mobile and desktop.
* 📲 **POS & In-Store Barcode Integration**: Cashiers can scan the customer's SVG barcode directly from their smartphone screen at physical retail checkouts.
* ⚡ **Seamless Checkout Redemption**: Customers can apply their wallet balance or gift card credits as an instant discount during WooCommerce checkout with one click.
* 🎯 **Automated Points & Rewards Engine**: Reward points automatically whenever orders transition to completed, with custom conversion ratios (e.g., $1 spent = 1 point; 100 points = $5 discount).
* 🔒 **HPOS & Custom Order Tables Ready**: Declared and battle-tested for High-Performance Order Storage in WooCommerce 8.0+ and 9.0+.
* 📊 **Admin CRM & Customer Management**: View, search, and manually adjust member points, card balances, and audit history directly inside your WordPress admin dashboard.
* 📁 **AJAX Bulk CSV Importer**: Migrate existing loyalty cards or import bulk gift card codes effortlessly in batches.

---

### 🚀 Key Features

#### 1. Digital Customer Wallet & Membership Pass
* Automatically generates a unique 10-digit digital loyalty card number upon customer registration.
* Displays a sleek, modern membership card in `My Account > Loyalty & Gift Card`.
* Live counters for both **Loyalty Points** and **Gift Card / Store Credit Balance**.
* High-contrast vector **Code 128 SVG Barcode** that renders sharply on all mobile screens for optical POS scanning.

#### 2. Dynamic Points & Rewards Engine
* Flexible earning rates: Set custom point rewards per currency unit spent.
* Adjustable redemption ratios: Define how many points equal $1 in store credit or discount.
* Automatically credits points when orders are marked `Processing` or `Completed`.
* Safe refund handling to maintain accurate points ledgers.

#### 3. Checkout & Cart Discounts
* Seamless discount redemption box on the WooCommerce checkout page.
* Fully compatible with both standard shortcode checkouts and new **WooCommerce Checkout Blocks**.
* Instant balance validation and AJAX cart recalculation.

#### 4. Complete Audit Ledger & Transaction History
* Detailed transaction history table in the customer account with 10-per-page pagination.
* Filter by activity type: Earned Points, Wallet Redemptions, Admin Adjustments, Order Payments.
* Full transparency reduces customer support inquiries regarding points and balances.

#### 5. Merchant Admin CRM & Tools
* Searchable members list with real-time balance overviews.
* Direct manual balance adjustments (+ or -) with mandatory notes for internal accounting.
* AJAX-powered bulk CSV importer with progress bars and error checking.
* Clean, responsive dashboard designed to match native WordPress UX standards.

---

### 🏬 Perfect For:
* **E-Commerce Brands**: Increase customer lifetime value (LTV) and encourage repeat purchases.
* **Retail Stores & Cafés**: Scan customer barcodes at the cashier counter to connect online and in-person shopping.
* **Omnichannel Businesses**: Unify customer rewards across your website and physical point of sale.
* **Agencies & Developers**: Clean, extensible code with standard WordPress hooks and filters.

---

### 🌐 Translations & Localization
PuntoWoo is fully internationalized (`caesychaos-loyalty-wallet-for-woocommerce`) and ready for translation into any language via GlotPress and standard `.mo`/`.po` files.

== Installation ==

1. Go to **Plugins > Add New** in your WordPress dashboard.
2. Search for `PuntoWoo Loyalty` or upload the `loyalty.zip` file.
3. Click **Install Now** and then **Activate**.
4. Navigate to **Loyalty Program > Settings** in your WordPress admin menu to configure your points conversion rates and store currency options.
5. (Optional) Check your customer account page at `My Account > Loyalty & Gift Card` to view your live digital membership pass.

== Frequently Asked Questions ==

= Does PuntoWoo support WooCommerce High-Performance Order Storage (HPOS)? =
Yes! PuntoWoo officially declares full compatibility with HPOS (Custom Order Tables) and legacy post storage.

= How do physical retail cashiers scan the customer card? =
Customers simply open **My Account > Loyalty & Gift Card** on their smartphone. The plugin generates a clean, high-resolution SVG Code 128 barcode that standard 1D and 2D barcode scanners (USB, Bluetooth, and POS built-in scanners) can read immediately.

= Does this work with WooCommerce Checkout Blocks? =
Yes. PuntoWoo is built to work smoothly with standard WooCommerce checkout pages as well as the new block-based Cart and Checkout blocks.

= Can I import my existing customer cards or gift cards from CSV? =
Yes! Navigate to **Loyalty Program > Import Cards** in your admin dashboard. You can upload a CSV file with customer card numbers, point balances, and gift card credits. The built-in AJAX batch importer handles large files seamlessly.

= Can administrators manually grant or deduct points? =
Yes. In **Loyalty Program > Members**, administrators can search for any member and adjust their points or gift card balance with a custom note for accounting audit records.

= Are there any external API dependencies or monthly subscriptions? =
No. PuntoWoo is 100% open-source and runs directly inside your WordPress database. There are no third-party cloud servers, no recurring fees, and no external tracking.

= Is there a companion mobile app for customers? =
Yes! The official companion extension is approved on WordPress.org: [PuntoWoo Mobile App & Loyalty Wallet API](https://wordpress.org/plugins/puntowoo-mobile-app-loyalty-wallet-api/). Install it alongside PuntoWoo Loyalty to enable mobile REST endpoints and allow your customers to use the PuntoWoo Digital Wallet mobile app.

== Screenshots ==

1. Digital Customer Loyalty Card & Virtual Wallet in WooCommerce My Account.
2. Mobile In-Store Pass with Scannable SVG Barcode for POS Cashier Checkout.
3. Merchant Analytics Dashboard with Active Member & Point Liability Overview.
4. Customer Directory & Loyalty CRM with Member Cards and Quick Actions.
5. Gift Card & Points Transactions Audit Log with Activity Filters.
6. Loyalty Engine Conversion Rates & Rule Settings.
7. Customer & Gift Card CSV Batch Importer Tool.

== Changelog ==

= 1.0.1 =
* Feature: Official announcement and companion support for the PuntoWoo Mobile App & Loyalty Wallet API extension on WordPress.org.
* Enhancement: In-admin merchant dashboard guidance for mobile app connectivity and QR stand flyers.
* Tweak: Minor performance optimizations and compatibility verifications.

= 1.0.0 =
* Initial public release on WordPress.org.
* Digital wallet & member pass in WooCommerce My Account.
* Scannable Code 128 SVG barcode for POS integration.
* Automated points earning engine for completed orders.
* Checkout redemption for points and gift cards.
* Complete customer transaction audit log with pagination.
* Merchant admin CRM and AJAX bulk CSV importer.
* HPOS and WooCommerce Blocks compatibility.
