admin.suherdy/pos_loyalty_extend
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: clean up README formatting and add comprehensive module description to manifest

Browse Source
This commit is contained in:
Suherdy Yacob 2026-05-28 16:00:19 +07:00
parent 203d3035d1
commit 6d5ebdd621
2 changed files with 18 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
README.md
View File

@ -11,7 +11,7 @@
The primary feature added is **"Cheapest Product on Order"** applicability for **Buy X Get Y** loyalty rewards — allowing merchants to automatically discount or give away the cheapest item(s) in a customer's cart based on the number of products purchased.
---
## Features
@ -41,7 +41,7 @@ When multiple free items are awarded, each one targets a **different cheapest pr
### ⚡ Auto-Claim in POS
Cheapest product rewards are automatically discovered and claimed in the POS UI without requiring manual product configuration on the reward.
---
## Dependencies
@ -51,7 +51,7 @@ Cheapest product rewards are automatically discovered and claimed in the POS UI
| `pos_loyalty` | Loyalty program UI and logic in POS |
| `sale_loyalty` | Backend loyalty program models |
---
## Configuration
@ -71,7 +71,7 @@ Cheapest product rewards are automatically discovered and claimed in the POS UI
> **Important:** Set "In Exchange of" to `2` (not `1`) to get the correct `buy 2 → 1 free` ratio.
> The formula is `floor(total_credits / credits_required) = free_items`.
---
## Technical Details
@ -102,7 +102,7 @@ Cheapest product rewards are automatically discovered and claimed in the POS UI
- **`_computeUnclaimedFreeProductQtyForCheapest(...)`** — Calculates how many free items are still unclaimed based on remaining loyalty points
- **`getClaimableRewards(...)`** — Extended to include cheapest-type rewards that the core skips (due to null `reward_product_id`)
---
## Installation
@ -119,7 +119,7 @@ Or via Odoo UI:
2. Go to **Apps → Update Apps List**
3. Search for `POS Loyalty Extend` and install
---
## Changelog

12
__manifest__.py
View File

@ -4,6 +4,18 @@
'version': '1.0',
'category': 'Sales/Point of Sale',
'summary': 'Extends loyalty rewards to support cheapest product applicability and cleaner variant selection in POS.',
'description': """
POS Loyalty Extend
===================
Extends the Odoo 19 Point of Sale loyalty rewards logic.
Key Features:
-------------
* Cheapest Product Applicability: Adds support for "Cheapest Product on Order" applicability for "Buy X Get Y" loyalty rewards.
* Proportional Free Item Calculation: Dynamically scales free product quantities based on earned/required points.
* Multi-Product Reward Lines: Applies discounts across the N cheapest unique products in the cart, instead of multiplying discounts on the single cheapest product.
* Auto-Claim in POS: Simplifies the customer flow by automatically applying cheapest-product rewards without manual selection.
""",
'author': 'Suherdy Yacob',
'depends': ['point_of_sale', 'pos_loyalty', 'sale_loyalty'],
'data': [