=== PuntoWoo Mobile App & Loyalty Wallet API ===
Contributors: caesychaos
Donate link: https://renenovelo.com/
Tags: woocommerce, loyalty, mobile app, digital wallet, points, qr code, pos
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce, caesychaos-loyalty-wallet-for-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

Official Mobile API and Digital Wallet extension for WooCommerce and PuntoWoo Loyalty. Exposes secure REST endpoints for the PuntoWoo Mobile App.

== Description ==

**PuntoWoo Mobile App & Loyalty Wallet API** connects your WooCommerce store and the [PuntoWoo Loyalty Wallet for WooCommerce](https://wordpress.org/plugins/caesychaos-loyalty-wallet-for-woocommerce/) plugin to the **PuntoWoo Digital Wallet** Android and iOS mobile app.

Allow your customers to carry their digital membership card directly on their phones, check real-time loyalty points and gift card cash balances, upload profile selfies, and scan Code 128 barcodes at physical retail checkout counters.

### 🌟 Key Features

* **Store Discovery REST API**: Public endpoint (`/wp-json/loyalty-app/v1/store/config`) enabling the mobile app to automatically detect store name, logo, currency, points exchange rate, and branding colors.
* **Token-Based Mobile Authentication**: Safe Bearer token session authentication allowing customers to log in using their existing WooCommerce account email and password.
* **Real-Time Loyalty Wallet Sync**: Synchronizes 10-digit digital card numbers, live points balance, and gift card store credit with zero database bloat.
* **Customer Profile & Photo Uploader**: Mobile camera and gallery photo upload endpoint with automatic avatar integration.
* **Transaction History Ledger**: Real-time chronological audit trail of orders, points earned, points redeemed, and wallet balance adjustments.
* **Printable In-Store QR Stand Flyer**: Generates high-resolution vector QR counter flyers from wp-admin to help physical store customers download and connect the app in seconds.
* **Customer My Account App Widget**: Configurable onboarding card and direct APK / Google Play download buttons inside the WooCommerce My Account area.
* **HPOS & WooCommerce Blocks Compatible**: Fully declared and tested with High-Performance Order Storage (Custom Order Tables) and WooCommerce Cart & Checkout Blocks.

== Installation ==

1. Upload the `puntowoo-mobile-app-loyalty-wallet-api` folder to the `/wp-content/plugins/` directory, or install the ZIP through the WordPress admin (**Plugins > Add New > Upload Plugin**).
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Navigate to **Lealtad > 📱 Mobile App** to configure download links, generate printable counter flyers, and test your REST API endpoints.
4. Your endpoints are immediately accessible at `/wp-json/loyalty-app/v1/`.

== Frequently Asked Questions ==

= Does this require the PuntoWoo Loyalty core plugin? =
Yes. This extension works alongside the PuntoWoo Loyalty & Digital Wallet for WooCommerce plugin to synchronize points, barcodes, and wallet balances.

= Does this modify my database structure? =
No. This extension reads existing user metadata non-destructively and introduces zero core schema alterations or database bloat.

= Where can customers download the companion mobile app? =
You can provide the direct APK download link or Google Play Store URL under **Lealtad > 📱 Mobile App**. Download buttons will automatically appear on the customer's *My Account* page.

= Is High-Performance Order Storage (HPOS) supported? =
Yes, HPOS (Custom Order Tables) and Block Checkout compatibility are declared and verified.

== Screenshots ==

1. **Mobile App Admin Hub**: Live QR code generator, counter flyer printing, and customer announcement kit.
2. **REST API Discovery**: Public store discovery and authenticated customer wallet endpoints.
3. **Customer My Account Widget**: Digital pass onboarding card and direct mobile download links.
4. **Mobile Wallet Pass**: Scannable Code 128 barcode, live points, and gift card balance on smartphone screens.
5. **Customer Profile & Selfie Camera**: Mobile avatar uploader integrated with WordPress user profile.
6. **Live Transaction Ledger**: Real-time chronological audit log of rewards and redemptions.

== Changelog ==

= 1.0.1 =
* Fix: Transition flyer styles and scripts to native wp_enqueue_style/wp_enqueue_script APIs with deferred strategy attributes.
* WordPress.org initial review compliance update.

= 1.0.0 =
* Initial public release on WordPress.org.
* Store discovery, customer profile, and transactions REST API endpoints.
* Bearer token mobile authentication handler.
* Printable in-store vector QR stand flyer generator.
* WooCommerce HPOS and Block Checkout compatibility.

== Upgrade Notice ==

= 1.0.1 =
Asset loading and enqueue compliance update following WordPress.org directory review guidelines.

= 1.0.0 =
Initial release. Ready for production deployment with WooCommerce.

