Skip to content

Commit

Permalink
Merge PR #181 into 16.0
Browse files Browse the repository at this point in the history
Signed-off-by pedrobaeza
  • Loading branch information
OCA-git-bot committed Jul 11, 2024
2 parents 9aefa10 + 20b91be commit d52e74c
Show file tree
Hide file tree
Showing 22 changed files with 1,337 additions and 0 deletions.
140 changes: 140 additions & 0 deletions loyalty_multi_gift/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,140 @@
==================
Loyalty multi gift
==================

..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:f3338dddec7e1ca070ed8a53fe498a1ebbdd1be1578d88d2bd3b72be437188f8
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fsale--promotion-lightgray.png?logo=github
:target: https://github.com/OCA/sale-promotion/tree/16.0/loyalty_multi_gift
:alt: OCA/sale-promotion
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/sale-promotion-16-0/sale-promotion-16-0-loyalty_multi_gift
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
:target: https://runboat.odoo-community.org/builds?repo=OCA/sale-promotion&target_branch=16.0
:alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module allows to define multiple reward products on promotions.

**Table of contents**

.. contents::
:local:

Use Cases / Context
===================

For the 'buy_x_get_y' type promotion, the 'Reward_type' field is restricted to the 'Product'
option only and the possibility to select 'Multigift' is disabled. This restriction is implemented
because, in this scenario, the 'reward_type' field becomes 'readonly'.

It is crucial to note that modifying the values displayed in this field to set different
values according to the type of promotion may generate conflicts with other modules that
contribute to the configuration of this same field. Therefore, it is recommended not to
alter these values directly, as this may affect the consistency and functionality of other
components of the system.

To configure similar promotions, it is suggested to modify another type of promotion by
adapting its rules and rewards according to specific needs. This provides a more secure
and consistent way to manage custom configurations without compromising the integrity of
the system.

Configuration
=============

To configure multiple product rewards:

#. Go to *Sales > Products > Discount & Loyalty* and select or create a new one.
#. Choose the criteria of appliance you want to use and the minimum quantities, that
will be used to calculate the times the rewards can be applied.
#. On the *Program Type* field choose *Multi Gift*.
#. You'll see a now the *Gift list* on which you can add the products you want to give
away and the quantities for each of them.

An example:

===== ================
Qty Products
===== ================
3 Prod A
2 Prod B
===== ================

With a minimum quantity of 3, for every 3 units of products that fulfill the domain
we'd get 3 units of A and 2 of B. So if the valid products quantities are 11, we'd
get 3 of product A and 2 of product B.

Usage
=====

This module is a base to be used by extra modules that use it in sale orders, PoS
orders, etc.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/sale-promotion/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/sale-promotion/issues/new?body=module:%20loyalty_multi_gift%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
~~~~~~~

* Tecnativa

Contributors
~~~~~~~~~~~~

* `Tecnativa <https://www.tecnativa.com>`_:

* David Vidal
* Pilar Vargas

* `Domatix <https://www.domatix.com>`_:

* Carolina Ferrer

Maintainers
~~~~~~~~~~~

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

.. |maintainer-chienandalu| image:: https://github.com/chienandalu.png?size=40px
:target: https://github.com/chienandalu
:alt: chienandalu

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-chienandalu|

This module is part of the `OCA/sale-promotion <https://github.com/OCA/sale-promotion/tree/16.0/loyalty_multi_gift>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
1 change: 1 addition & 0 deletions loyalty_multi_gift/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
from . import models
15 changes: 15 additions & 0 deletions loyalty_multi_gift/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Copyright 2021 Tecnativa - David Vidal
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
{
"name": "Loyalty multi gift",
"summary": "Allows to configure multiple gift rewards per promotion",
"version": "16.0.1.0.0",
"development_status": "Beta",
"category": "Sale",
"website": "https://github.com/OCA/sale-promotion",
"author": "Tecnativa, Odoo Community Association (OCA)",
"maintainers": ["chienandalu"],
"license": "AGPL-3",
"depends": ["loyalty"],
"data": ["views/loyalty_reward_views.xml", "security/ir.model.access.csv"],
}
140 changes: 140 additions & 0 deletions loyalty_multi_gift/i18n/es.po
Original file line number Diff line number Diff line change
@@ -0,0 +1,140 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * loyalty_multi_gift
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 15.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-02-17 09:58+0000\n"
"PO-Revision-Date: 2023-02-17 11:01+0100\n"
"Last-Translator: \n"
"Language-Team: \n"
"Language: es\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: \n"
"X-Generator: Poedit 3.1.1\n"

#. module: loyalty_multi_gift
#: model:ir.model,name:loyalty_multi_gift.model_coupon_reward_product_line
msgid "Coupon Multi Gift"
msgstr "Promociones multi regalo"

#. module: loyalty_multi_gift
#: model:ir.model,name:loyalty_multi_gift.model_coupon_reward
msgid "Coupon Reward"
msgstr "Cupón de recompensa"

#. module: loyalty_multi_gift
#: model:ir.model.fields,field_description:loyalty_multi_gift.field_coupon_reward_product_line__create_uid
msgid "Created by"
msgstr "Creado por"

#. module: loyalty_multi_gift
#: model:ir.model.fields,field_description:loyalty_multi_gift.field_coupon_reward_product_line__create_date
msgid "Created on"
msgstr "Creado en"

#. module: loyalty_multi_gift
#: model_terms:ir.ui.view,arch_db:loyalty_multi_gift.coupon_program_view_form_common
msgid "Default gift"
msgstr "Regalo por defecto"

#. module: loyalty_multi_gift
#: model:ir.model.fields,help:loyalty_multi_gift.field_coupon_program__reward_type
#: model:ir.model.fields,help:loyalty_multi_gift.field_coupon_reward__reward_type
msgid ""
"Discount - Reward will be provided as discount.\n"
"Free Product - Free product will be provide as reward \n"
"Free Shipping - Free shipping will be provided as reward (Need delivery "
"module)"
msgstr ""
"Descuento: La recompensa se otorgará en forma de descuento.\n"
"Producto gratis: Se otorgará un producto gratuito a modo de recompensa\n"
"Envío gratis: Se ofrecerá envío gratuito a modo de recompensa (módulo de "
"entrega requerido)"

#. module: loyalty_multi_gift
#: model:ir.model.fields,field_description:loyalty_multi_gift.field_coupon_reward_product_line__display_name
msgid "Display Name"
msgstr "Nombre mostrado"

#. module: loyalty_multi_gift
#: code:addons/loyalty_multi_gift/models/coupon_reward.py:0
#, python-format
msgid "Free Products - %(name)s"
msgstr "Productos gratuítos - %(name)s"

#. module: loyalty_multi_gift
#: model:ir.model.fields,field_description:loyalty_multi_gift.field_coupon_reward_product_line__reward_product_ids
msgid "Gift Options"
msgstr "Opciones de regalo"

#. module: loyalty_multi_gift
#: model:ir.model.fields,field_description:loyalty_multi_gift.field_coupon_program__loyalty_multi_gift_ids
#: model:ir.model.fields,field_description:loyalty_multi_gift.field_coupon_reward__loyalty_multi_gift_ids
msgid "Gift list"
msgstr "Lista de regalos"

#. module: loyalty_multi_gift
#: model:ir.model.fields,field_description:loyalty_multi_gift.field_coupon_reward_product_line__id
msgid "ID"
msgstr "ID (identificación)"

#. module: loyalty_multi_gift
#: model:ir.model.fields,field_description:loyalty_multi_gift.field_coupon_reward_product_line____last_update
msgid "Last Modified on"
msgstr "Última modificación en"

#. module: loyalty_multi_gift
#: model:ir.model.fields,field_description:loyalty_multi_gift.field_coupon_reward_product_line__write_uid
msgid "Last Updated by"
msgstr "Última actualización de"

#. module: loyalty_multi_gift
#: model:ir.model.fields,field_description:loyalty_multi_gift.field_coupon_reward_product_line__write_date
msgid "Last Updated on"
msgstr "Última actualización en"

#. module: loyalty_multi_gift
#: model:ir.model.fields.selection,name:loyalty_multi_gift.selection__coupon_reward__reward_type__multi_gift
msgid "Multi Gift"
msgstr "Múltiples regalos"

#. module: loyalty_multi_gift
#: model_terms:ir.ui.view,arch_db:loyalty_multi_gift.coupon_program_view_form_common
msgid "Qty"
msgstr "Cant."

#. module: loyalty_multi_gift
#: model:ir.model.fields,field_description:loyalty_multi_gift.field_coupon_reward_product_line__reward_product_quantity
msgid "Quantity"
msgstr "Cantidad"

#. module: loyalty_multi_gift
#: model:ir.model.fields,field_description:loyalty_multi_gift.field_coupon_reward_product_line__reward_id
msgid "Reward"
msgstr "Recompensa"

#. module: loyalty_multi_gift
#: model:ir.model.fields,field_description:loyalty_multi_gift.field_coupon_reward_product_line__reward_default_product_id
msgid "Reward Default Product"
msgstr "Producto de recompensa por defecto"

#. module: loyalty_multi_gift
#: model:ir.model.fields,help:loyalty_multi_gift.field_coupon_reward_product_line__reward_product_ids
msgid "Reward Product"
msgstr "Producto de recompensa"

#. module: loyalty_multi_gift
#: model:ir.model.fields,field_description:loyalty_multi_gift.field_coupon_program__reward_type
#: model:ir.model.fields,field_description:loyalty_multi_gift.field_coupon_reward__reward_type
msgid "Reward Type"
msgstr "Tipo de recompensa"

#. module: loyalty_multi_gift
#: model:ir.model.fields,help:loyalty_multi_gift.field_coupon_reward_product_line__reward_product_quantity
msgid "Reward product quantity"
msgstr "Cantidad de productos de recompensa"
Loading

0 comments on commit d52e74c

Please sign in to comment.