Metadata-Version: 2.1
Name: odoo-addon-product_variant_configurator
Version: 19.0.1.0.0.2
Requires-Dist: odoo==19.0.*
Summary: Provides an abstract model for product variant configuration.
Home-page: https://github.com/OCA/product-variant
License: AGPL-3
Author: AvanzOSC, Tecnativa, ACSONE SA/NV, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 19.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Development Status :: 5 - Production/Stable
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

============================
Product Variant Configurator
============================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:e917d3de89c639e55571db1c77af24fd790ba22de90ddd4bdc8cf574da082631
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |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/license-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/19.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-19-0/product-variant-19-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=19.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 "Attributes
   and Variants (Set product attributes (e.g. color, size) to sell
   variants)" on "Product Catalog" section.
2. Go to ``Sales > Catalog > Products``, and select a product.
3. On the 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 > Catalog > Product Variants``.
2. Click on "Create" 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:%2019.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 <oihanecrucelaegi@avanzosc.es>
- Pedro M. Baeza <pedro.baeza@tecnativa.com>
- Ana Juaristi <ajuaristio@gmail.com>
- Thomas Binsfeld <thomas.binsfeld@acsone.eu>
- Zakaria Makrelouf (acsone) <z.makrelouf@gmail.com>
- Stéphane Bidoul <stephane.bidoul@acsone.eu>
- Laurent Mignon <laurent.mignon@acsone.eu>
- David Vidal <david.vidal@tecnativa.com>
- Simone Versienti <s.versienti@apuliasoftware.it>
- Adria Gil Sorribes <adria.gil@forgeflow.com>
- Héctor Villarreal Ortega <hector.villarreal@forgeflow.com>
- `Heliconia Solutions Pvt. Ltd. <https://www.heliconia.io>`__

  - Bhavesh Heliconia

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/19.0/product_variant_configurator>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
