Search 1.9 billion lines of Odoo code on GitHub
product_variant_default_code
<h1 class="title">Product Variant Default Code</h1>
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/product-variant/tree/14.0/product_variant_default_code"><img alt="OCA/product-variant" src="https://img.shields.io/badge/github-OCA%2Fproduct--variant-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/product-variant-14-0/product-variant-14-0-product_variant_default_code"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/137/14.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<p>This module automatically generate Product Reference (default_code)
according to attributes data with a configurable behavior.</p>
<p>It defines a reference mask on the product templates so the
variants references are automatically set. For example:</p>
<ul class="simple">
<li>Product template: Jacket</li>
<li>Attributes:
- Color: White, Black
- Size: M, L</li>
<li>Reference mask: <cite>JKT01-[Color]-[Size]</cite></li>
<li>Reference on variants:<ul>
<li><cite>JKT01-Wh-M</cite> Jacket White M</li>
<li><cite>JKT01-Bl-M</cite> Jacket Black M</li>
<li><cite>JKT01-Wh-L</cite> Jacket White L</li>
<li><cite>JKT01-Bl-L</cite> Jacket Black L</li>
</ul>
</li>
</ul>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#usage" id="id1">Usage</a><ul>
<li><a class="reference internal" href="#avoiding-mask-in-variants" id="id2">Avoiding mask in variants</a></li>
</ul>
</li>
<li><a class="reference internal" href="#known-issues-roadmap" id="id3">Known issues / Roadmap</a></li>
<li><a class="reference internal" href="#bug-tracker" id="id4">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id5">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id6">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id7">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="id8">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="usage"></a>
<h2><a class="toc-backref" href="#id1">Usage</a></h2>
<p>To set the reference mask up on any product template 'Variant reference mask'
new field.</p>
<p>When creating a new product template without specifying the <em>Variant reference
mask</em>, a default value for <em>Variant reference mask</em> 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 <em>Attribute
Code</em> (of the attribute value) inserted. Besides the default value, <em>Variant
reference mask</em> can be configured to your liking, make sure putting the
<em>Attribute Name</em> inside <cite>[]</cite> marks (it is case sensitive).</p>
<p>Example:</p>
<p>Creating a product named <em>Jacket</em> with two attributes, <em>Size</em> and <em>Color</em>:</p>
<pre>
<code>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)</code>
</pre>
<p>The automatically generated default value for the Variant reference mask will
be <cite>[Color]-[Size]</cite> and so the 'default code' on the variants will be <cite>Bl-L</cite>,
<cite>Wh-L</cite>, <cite>Bl-XL</cite> and <cite>Wh-XL</cite>.</p>
<p>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,
<cite>Jacket/[Size]~[Color]~[Size]</cite>, and the generated code on variants will be
something like <cite>Jacket/L~Bl~L</cite> (for variant with Color "Black" and Size "L").</p>
<p>When the code attribute is changed, it automatically regenerates the 'default
code' on all variants affected.</p>
<p>Aditionally, a product attribute can be set and so it will be appended to the
product <cite>default_code</cite>. In the first example, setting a <cite>Color</cite> code to <cite>CO</cite>
would give <cite>default_code</cite> like this: <cite>COBl-L</cite>, <cite>COWh-L</cite>, <cite>COBl-XL</cite> and
<cite>COWh-XL</cite>.</p>
<a name="avoiding-mask-in-variants"></a>
<h3><a class="toc-backref" href="#id2">Avoiding mask in variants</a></h3>
<p>You can avoid this behavior or force a manual default_code on variant. To do
so, go to <em>Product Variants > [any variant you want to set up]</em> and set
manually its reference code. The field <cite>manual code</cite> will be set to on and the
variant internal reference will no longer be changed by this module.</p>
<p>Unset <cite>manual code</cite> and the reference code will be unlocked again.</p>
<a name="known-issues-roadmap"></a>
<h2><a class="toc-backref" href="#id3">Known issues / Roadmap</a></h2>
<ul class="simple">
<li>In case of attribute name update, related mask are not updated.</li>
</ul>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id4">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/product-variant/issues">GitHub Issues</a>.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomed
<a class="reference external" href="https://github.com/OCA/product-variant/issues/new?body=module:%20product_variant_default_code%0Aversion:%2014.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<p>Do not contact contributors directly about support or help with technical issues.</p>
<a name="credits"></a>
<h2><a class="toc-backref" href="#id5">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id6">Authors</a></h3>
<ul class="simple">
<li>AvancOSC</li>
<li>Shine IT</li>
<li>Tecnativa</li>
<li>Akretion</li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id7">Contributors</a></h3>
<ul class="simple">
<li>Alfredo de la Fuente <<a class="reference external" href="mailto:alfredodelafuente@avanzosc.es">alfredodelafuente@avanzosc.es</a>></li>
<li>Tony Gu <<a class="reference external" href="mailto:tony@openerp.cn">tony@openerp.cn</a>></li>
<li>David Beal <<a class="reference external" href="mailto:david.beal@akretion.com">david.beal@akretion.com</a>></li>
<li>Daniel Campos <<a class="reference external" href="mailto:danielcampos@avanzosc.es">danielcampos@avanzosc.es</a>></li>
<li>Kévin Roche <<a class="reference external" href="mailto:kevin.roche@akretion.com">kevin.roche@akretion.com</a>></li>
<li>Tecnativa <tecnativa.com>:
* David Vidal
* Pedro M. Baeza
* João Marques</li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id8">Maintainers</a></h3>
<p>This module is maintained by the OCA.</p>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>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.</p>
<p>Current <a class="reference external" href="https://odoo-community.org/page/maintainer-role">maintainer</a>:</p>
<p><a class="reference external" href="https://github.com/Kev-Roche"><img alt="Kev-Roche" src="https://github.com/Kev-Roche.png?size=40px" /></a></p>
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/product-variant/tree/14.0/product_variant_default_code">OCA/product-variant</a> project on GitHub.</p>
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>