Merge PR #358 into 17.0

Signed-off-by HaraldPanten

product_variant_configurator/README.rst

@@ -0,0 +1,149 @@
+============================
+Product Variant Configurator
+============================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:d2fa5418fe70ab374e81c7fb45080165ffe44bc2c46c10cbae6507957b10f721
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Production%2FStable-green.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Production/Stable
+.. |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_configurator
+    :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_configurator
+    :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|
+
+Provides an abstract model for product variant configuration. It
+provides the basic functionality for presenting a table with the
+attributes of a template and the possibility to select one of the valid
+values. You can try this functionality creating a product variant
+directly selecting a product template that has attributes.
+
+This module also prevents in a configurable way the creation of the
+product variants when defining the attributes and attribute values of
+the product template.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+(after installing sale_management application)
+
+To configure the creation of the variants behaviour, you need to:
+
+1. Go to ``Sales > Configuration > Settings``, and select "Variants
+   (Sell variants of a product using attributes (size, color, etc.))" on
+   "Product Catalog" section.
+2. Go to ``Sales > Products > Products``, and select a product.
+3. On the Attributes & Variants tab edit the value of the field
+   ``Variant Creation``.
+4. If you want to stop the automatic creation of the variant, and have
+   the same behaviour for all the products in the same category, go to
+   ``Inventory > Configuration > Product Categories``, select the
+   category and check the checkbox
+   ``Don't create variants automatically``.
+
+Usage
+=====
+
+(after installing sale_management application)
+
+1. Go to ``Sales > Products > Product Variants``.
+2. Click on "New" button for creating a new one.
+3. On the field "Product Template", select a product template that has
+   several attributes.
+4. A table with the attributes of the template will appear below.
+5. Select all the attribute values and click on "Save" button.
+6. A new product variant will be created for that attributes.
+7. An error will raise if there's another variant with the same
+   attribute values or if you haven't filled all the required values.
+
+**Developers**
+
+To use product configurator in your model, you need to:
+
+1. The product.configurator is an abstract model, hence, to be used it
+   must be inherited in your model:
+2. If the model you're inheriting has ``name`` attribute, and it uses
+   the related parameter you must override it.
+
+
+
+::
+
+   class AModel(models.Model):
+       _inherit = ['module.model', 'product.configurator']
+       name = fields.Char(related="delegated_field.related_field")
+
+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_configurator%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
+-------
+
+* AvanzOSC
+* Tecnativa
+* ACSONE SA/NV
+
+Contributors
+------------
+
+-  Oihane Crucelaegui <[email protected]>
+-  Pedro M. Baeza <[email protected]>
+-  Ana Juaristi <[email protected]>
+-  Thomas Binsfeld <[email protected]>
+-  Zakaria Makrelouf (acsone) <[email protected]>
+-  Stéphane Bidoul <[email protected]>
+-  Laurent Mignon <[email protected]>
+-  David Vidal <[email protected]>
+-  Simone Versienti <[email protected]>
+-  Adria Gil Sorribes <[email protected]>
+-  Héctor Villarreal Ortega <[email protected]>
+-  Manuel Regidor <[email protected]>
+-  Valentín Vinagre <[email protected]>
+
+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.
+
+This module is part of the `OCA/product-variant <https://github.com/OCA/product-variant/tree/17.0/product_variant_configurator>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

product_variant_configurator/__init__.py

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

product_variant_configurator/__manifest__.py

@@ -0,0 +1,26 @@
+# Copyright 2015 Oihane Crucelaegui (AvanzOSC)
+# Copyright 2016 ACSONE SA/NV
+# Copyright 2017 David Vidal <[email protected]>
+# Copyright 2015-2017 Tecnativa - Pedro M. Baeza
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+{
+    "name": "Product Variant Configurator",
+    "summary": "Provides an abstract model for product variant configuration.",
+    "version": "17.0.1.0.0",
+    "category": "Product Variant",
+    "development_status": "Production/Stable",
+    "license": "AGPL-3",
+    "author": "AvanzOSC, Tecnativa, ACSONE SA/NV, Odoo Community Association (OCA)",
+    "website": "https://github.com/OCA/product-variant",
+    "depends": ["product"],
+    "data": [
+        "security/product_configurator_security.xml",
+        "security/ir.model.access.csv",
+        "views/product_configurator_attribute.xml",
+        "views/inherited_product_template_views.xml",
+        "views/inherited_product_product_views.xml",
+        "views/inherited_product_category_views.xml",
+        "views/inherited_product_attribute_views.xml",
+    ],
+}