[17.0][MIG] product_variant_default_code

product_variant_default_code/README.rst

@@ -0,0 +1,176 @@
+============================
+Product Variant Default Code
+============================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:42f13ad70dacb35beedc51c40bf0a16dd9edba56fab52c09515d91aea0303275
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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%2Fproduct--variant-lightgray.png?logo=github
+    :target: https://github.com/OCA/product-variant/tree/17.0/product_variant_default_code
+    :alt: OCA/product-variant
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/product-variant-17-0/product-variant-17-0-product_variant_default_code
+    :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/product-variant&target_branch=17.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module automatically generate Product Reference (default_code)
+according to attributes data with a configurable behavior.
+
+It defines a reference mask on the product templates so the variants
+references are automatically set. For example:
+
+-  Product template: Jacket
+-  Attributes:
+
+   -  Color: White, Black
+   -  Size: M, L
+
+-  Reference mask: JKT01-[Color]-[Size]
+-  Reference on variants:
+
+   -  JKT01-Wh-M Jacket White M
+   -  JKT01-Bl-M Jacket Black M
+   -  JKT01-Wh-L Jacket White L
+   -  JKT01-Bl-L Jacket Black L
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Usage
+=====
+
+To set the reference mask up on any product template 'Variant reference
+mask' new field.
+
+When creating a new product template without specifying the *Variant
+reference mask*, a default value for *Variant reference mask* will be
+automatically generated according to the attribute line settings on the
+product template (if any). The mask will then be used as an instruction
+to generate default code of each product variant of the product template
+with the corresponding *Attribute Code* (of the attribute value)
+inserted. Besides the default value, *Variant reference mask* can be
+configured to your liking, make sure putting the *Attribute Name* inside
+[] marks (it is case sensitive).
+
+Example:
+
+Creating a product named *Jacket* with two attributes, *Size* and
+*Color*:
+
+::
+
+   Product: Jacket
+   Color: Black(Bl), White(Wh) # Black and White are the attribute values;
+                                 'Bl' and 'Wh' are the corresponding codes
+   Size: L (L), XL(XL)
+
+The automatically generated default value for the Variant reference mask
+will be [Color]-[Size] and so the 'default code' on the variants will be
+Bl-L, Wh-L, Bl-XL and Wh-XL.
+
+The mask value can be fully customized whatever you like. You can even
+have the attribute name appear more than once in the mask such as,
+Jacket/[Size]~[Color]~[Size], and the generated code on variants will be
+something like Jacket/L~Bl~L (for variant with Color "Black" and Size
+"L").
+
+When the code attribute is changed, it automatically regenerates the
+'default code' on all variants affected.
+
+Aditionally, a product attribute can be set and so it will be appended
+to the product default_code. In the first example, setting a Color code
+to CO would give default_code like this: COBl-L, COWh-L, COBl-XL and
+COWh-XL.
+
+Avoiding mask in variants
+-------------------------
+
+You can avoid this behavior or force a manual default_code on variant.
+To do so, go to *Product Variants > [any variant you want to set up]*
+and set manually its reference code. The field manual code will be set
+to on and the variant internal reference will no longer be changed by
+this module.
+
+Unset manual code and the reference code will be unlocked again.
+
+Known issues / Roadmap
+======================
+
+-  In case of attribute name update, related mask are not updated.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/product-variant/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/product-variant/issues/new?body=module:%20product_variant_default_code%0Aversion:%2017.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
+-------
+
+* AvancOSC
+* Shine IT
+* Tecnativa
+* Akretion
+
+Contributors
+------------
+
+-  Alfredo de la Fuente <[email protected]>
+-  Tony Gu <[email protected]>
+-  David Beal <[email protected]>
+-  Daniel Campos <[email protected]>
+-  Kévin Roche <[email protected]>
+-  Tecnativa <tecnativa.com>:
+
+   -  David Vidal
+   -  Pedro M. Baeza
+   -  João Marques
+
+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-Kev-Roche| image:: https://github.com/Kev-Roche.png?size=40px
+    :target: https://github.com/Kev-Roche
+    :alt: Kev-Roche
+
+Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
+
+|maintainer-Kev-Roche| 
+
+This module is part of the `OCA/product-variant <https://github.com/OCA/product-variant/tree/17.0/product_variant_default_code>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

product_variant_default_code/__init__.py

@@ -0,0 +1 @@
+from . import models

product_variant_default_code/__manifest__.py

@@ -0,0 +1,28 @@
+# Copyright 2014 AvancOSC - Alfredo de la Fuente
+# Copyright 2014 Tecnativa - Pedro M. Baeza
+# Copyright 2014 Shine IT - Tony Gu
+# Copyright 2017 Tecnativa - David Vidal
+# Copyright 2017 Akretion - David Beal
+# Copyright 2018 AvancOSC - Daniel Campos
+# Copyright 2020 Tecnativa - João Marques
+# Copyright 2021 Akretion - Kévin Roche
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+{
+    "name": "Product Variant Default Code",
+    "version": "17.0.1.0.0",
+    "author": "AvancOSC, Shine IT, Tecnativa, Akretion, Odoo Community Association (OCA)",
+    "website": "https://github.com/OCA/product-variant",
+    "license": "AGPL-3",
+    "category": "Product",
+    "maintainers": ["Kev-Roche"],
+    "depends": ["product"],
+    "data": [
+        "security/product_security.xml",
+        "data/ir_config_parameter.xml",
+        "views/product_attribute_view.xml",
+        "views/product_view.xml",
+        "views/config_settings_view.xml",
+    ],
+    "demo": ["demo/attribute_demo.xml"],
+    "installable": True,
+}

product_variant_default_code/data/ir_config_parameter.xml

@@ -0,0 +1,11 @@
+<?xml version='1.0' encoding='UTF-8' ?>
+<odoo noupdate="1">
+    <record id="default_reference_separator" model="ir.config_parameter">
+        <field name="key">default_reference_separator</field>
+        <field name="value">-</field>
+    </record>
+    <record id="default_reference_missing_placeholder" model="ir.config_parameter">
+        <field name="key">default_reference_missing_placeholder</field>
+        <field name="value">/</field>
+    </record>
+</odoo>

product_variant_default_code/demo/attribute_demo.xml

@@ -0,0 +1,15 @@
+<?xml version='1.0' encoding='UTF-8' ?>
+<odoo noupdate="1">
+    <record id="product.product_attribute_1" model="product.attribute">
+        <!-- Memory -->
+        <field name="code">M</field>
+    </record>
+    <record id="product.product_attribute_2" model="product.attribute">
+        <!-- Color -->
+        <field name="code">C</field>
+    </record>
+    <record id="product.product_attribute_3" model="product.attribute">
+        <!-- Wifi -->
+        <field name="code">W</field>
+    </record>
+</odoo>