From f9ebeb16c77e1e51f07f8f964051339085856f39 Mon Sep 17 00:00:00 2001 From: "KC (ksc)" Date: Fri, 5 Jul 2024 10:36:21 -0700 Subject: [PATCH] [IMP] sales: add loyalty card button 17 closes odoo/documentation#10098 Signed-off-by: Kevin Scannell (ksc) --- .../sales/products_prices/loyalty_discount.rst | 10 ++++++++++ .../loyalty-cards-smart-button.png | Bin 0 -> 36635 bytes 2 files changed, 10 insertions(+) create mode 100644 content/applications/sales/sales/products_prices/loyalty_discount/loyalty-cards-smart-button.png diff --git a/content/applications/sales/sales/products_prices/loyalty_discount.rst b/content/applications/sales/sales/products_prices/loyalty_discount.rst index 12507d34d..74198a62a 100644 --- a/content/applications/sales/sales/products_prices/loyalty_discount.rst +++ b/content/applications/sales/sales/products_prices/loyalty_discount.rst @@ -82,6 +82,16 @@ accessible through the smart button located at the top of the form. :align: center :alt: Program items smart button on the loyalty program form. +.. note:: + In Odoo 17 (and later), when a loyalty card or coupon is associated with a contact in the + database, a :guilabel:`Loyalty Cards` smart button conditionally appears on the contact form. + + .. image:: loyalty_discount/loyalty-cards-smart-button.png + :align: center + :alt: The Loyalty Card smart button as it appears on a contact form in Odoo 17. + + This smart button **only** appears if a loyalty card or coupon is associated with the contact. + .. _sales/pricing_management/program-types: Program types diff --git a/content/applications/sales/sales/products_prices/loyalty_discount/loyalty-cards-smart-button.png b/content/applications/sales/sales/products_prices/loyalty_discount/loyalty-cards-smart-button.png new file mode 100644 index 0000000000000000000000000000000000000000..628abbea158f90ac3ea591e0680693743d6ed981 GIT binary patch literal 36635 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�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