Search 1.9 billion lines of Odoo code on GitHub
product_variant_default_code
<a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.svg">
</a>
<a name="product-variant-default-code"></a>
<h2>Product Variant Default Code</h2>
<p>This module automatically generate <em>Internal Reference</em> (<cite>default_code</cite>)
according to attributes, with a configurable behavior.</p>
<p>It defines a reference mask on the product templates, based on some
attributes code you set before. Then variants internal references are
automatically set. For example:</p>
<p>Creating a product named "Jacket" 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: M (M), L (L)</code>
</pre>
<p>The automatically generated variant reference mask will be <cite>[Color]-[Size]</cite>
and so the <em>Internal Reference</em> on the variants will contain:</p>
<pre>
<code>'Bl-M', 'Wh-M', 'Bl-L' and 'Wh-L'.</code>
</pre>
<a name="configuration"></a>
<h3>Configuration</h3>
<p>Of course, activate <em>Attributes and Variants</em> under <strong>Sales / Product Catalogue</strong>
settings (or <strong>Inventory / Products</strong>).</p>
<p>Fill <em>Attributes Value Code</em> to each attribute's value.</p>
<a name="usage"></a>
<h3>Usage</h3>
<p>When creating a new product template, once you have added attributes and values,
fill the new <em>Reference Prefix</em> field that appear under <em>Internal Reference</em>.</p>
<p>A default value for <em>Variant reference mask</em> will be automatically generated
according to the attribute line settings on the product template. This mask will
then be used as an instruction to generate <em>Internal Reference</em> of each product
variant with the corresponding <em>Attribute Value Code</em> inserted. For example:</p>
<pre>
<code>- Product template: Jacket
- Reference prefix: JKT
- Attributes:
- Color: Black, White,
- Size: M, L
- Reference mask: `JKT01-[Color]-[Size]`
- Variants Internal Reference:
- 'JKT01-Bl-M'
- 'JKT01-Wh-M'
- 'JKT01-Bl-L'
- 'JKT01-Wh-L'</code>
</pre>
<p>Additionally, an <em>Attribute Code</em> can be set. It will be appended to the
variant <em>Internal Reference</em>. In the first example, setting a 'Color' code
to "CO" would give <em>Internal Reference</em> (<cite>default_code</cite>) like this:</p>
<pre>
<code>'JKT01-COBl-M', 'JKT01-COWh-M', 'JKT01-COBl-L' and 'JKT01-COWh-L'.</code>
</pre>
<p>When an attribute or value code is changed, the reference on all variants
affected is regenerated.</p>
<a name="advanced"></a>
<h3>Advanced</h3>
<p>To manualy define the reference mask on each product, switch <em>Product Default
Code</em> behaviour to "Manual Mask" in <strong>General Settings</strong>. Then, fill the
"Variant Reference Mask" field on any product template.</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 'Jacket/L~Wh~L' (for variant with Color "White" and Size "L").</p>
<p><strong>Note:</strong> In mask value, make sure putting the <em>Attribute Name</em> inside <cite>[ ]</cite>
marks (it is case sensitive) and of course, make sure characters "[,]"
do not appear in your attribute's name.</p>
<a name="avoiding-mask-in-variants"></a>
<h4>Avoiding mask in variants</h4>
<p>You can avoid this behavior or force a manual reference on variant. To do
so, go to <strong>Product Variants > [any variant you want to set up]</strong> and set
manually its reference code. The field <em>Manual Reference</em> (<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 <em>Manual Reference</em> on a variant and the reference code will be
unlocked again.</p>
<a class="reference external image-reference" href="https://runbot.odoo-community.org/runbot/137/10.0"><img alt="Try me on Runbot" src="https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas" /></a>
<a name="known-issues-roadmap"></a>
<h3>Known issues / Roadmap</h3>
<p>In case of attribute name update, related mask are not updated.</p>
<a name="bug-tracker"></a>
<h3>Bug Tracker</h3>
<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 smash it by providing detailed and welcomed feedback.</p>
<a name="credits"></a>
<h3>Credits</h3>
<a name="images"></a>
<h4>Images</h4>
<ul class="simple">
<li>Odoo Community Association: <a class="reference external" href="https://github.com/OCA/maintainer-tools/blob/master/template/module/static/description/icon.svg">Icon</a>.</li>
</ul>
<a name="contributors"></a>
<h4>Contributors</h4>
<ul class="simple">
<li>Alfredo de la Fuente <<a class="reference external" href="mailto:alfredodelafuente@avanzosc.es">alfredodelafuente@avanzosc.es</a>></li>
<li>Pedro M. Baeza <<a class="reference external" href="mailto:pedro.baeza@tecnativa.com">pedro.baeza@tecnativa.com</a>></li>
<li>Tony Gu <<a class="reference external" href="mailto:tony@openerp.cn">tony@openerp.cn</a>></li>
<li>David Vidal <<a class="reference external" href="mailto:david.vidal@tecnativa.com">david.vidal@tecnativa.com</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>
</ul>
<a name="maintainer"></a>
<h4>Maintainer</h4>
<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>This module is maintained by the OCA.</p>
<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>To contribute to this module, please visit <a class="reference external" href="https://odoo-community.org">https://odoo-community.org</a>.</p>