https://mediawiki.comfac.net/index.php?action=history&feed=atom&title=Webshop-05-Variant-Selector Webshop-05-Variant-Selector - Revision history 2026-06-05T11:02:48Z Revision history for this page on the wiki MediaWiki 1.45.1 https://mediawiki.comfac.net/index.php?title=Webshop-05-Variant-Selector&diff=163&oldid=prev Justinaquino: "Add all 14 Frappe ERPNext Webshop chapter pages from wikitext-upload" 2026-03-06T13:00:41Z <p>&quot;Add all 14 Frappe ERPNext Webshop chapter pages from wikitext-upload&quot;</p> <p><b>New page</b></p><div>= 05 - Variant Selector =<br /> <br /> &#039;&#039;&#039;Parent:&#039;&#039;&#039; [Webshop-Index Webshop Index] <br /> &#039;&#039;&#039;Previous:&#039;&#039;&#039; [Webshop-04-Product-Pages-and-Browsing 04 - Product Pages &amp; Browsing] <br /> &#039;&#039;&#039;Next:&#039;&#039;&#039; [Webshop-06-Pricing-and-Discounts 06 - Pricing &amp; Discounts] <br /> &#039;&#039;&#039;Source:&#039;&#039;&#039; [https://github.com/Comfac-Global-Group/comfac-webshop/wiki/05-Variant-Selector Comfac Webshop Wiki - Chapter 05]<br /> <br /> ----<br /> <br /> == How Variants Work in ERPNext + Webshop ==<br /> <br /> ERPNext has a built-in &#039;&#039;&#039;Item Variant&#039;&#039;&#039; system:<br /> <br /> - &#039;&#039;&#039;Template Item&#039;&#039;&#039;: defines attributes (e.g., Color, Size, RAM, Storage)<br /> - &#039;&#039;&#039;Variant Items&#039;&#039;&#039;: concrete products with specific attribute values (e.g., &quot;Laptop - 16GB RAM - 512GB SSD&quot;)<br /> <br /> The webshop uses this to create a step-by-step configurator on product pages.<br /> <br /> == Key Files ==<br /> <br /> - &lt;code&gt;webshop/variant_selector/utils.py&lt;/code&gt; - Core variant logic<br /> - &lt;code&gt;webshop/variant_selector/item_variants_cache.py&lt;/code&gt; - Redis caching layer<br /> - &lt;code&gt;templates/generators/item/item_configure.html&lt;/code&gt; - Configurator UI<br /> - &lt;code&gt;templates/generators/item/item_configure.js&lt;/code&gt; - Configurator JS<br /> <br /> == Variant Selection Flow ==<br /> <br /> 1. User visits a Template Item page (has_variants=True)<br /> 2. &lt;code&gt;item_configure.html&lt;/code&gt; renders attribute dropdowns<br /> 3. &lt;code&gt;item_configure.js&lt;/code&gt; calls &lt;code&gt;get_next_attribute_and_values&lt;/code&gt; API on each selection<br /> 4. Backend filters valid combinations, returns:<br /> - &lt;code&gt;next_attribute&lt;/code&gt; - which attribute to select next<br /> - &lt;code&gt;valid_options_for_attributes&lt;/code&gt; - valid values given current selections<br /> - &lt;code&gt;filtered_items_count&lt;/code&gt; - how many variants match<br /> - &lt;code&gt;exact_match&lt;/code&gt; - if one variant is fully selected<br /> - &lt;code&gt;product_info&lt;/code&gt; - price for the matched variant<br /> - &lt;code&gt;available_qty&lt;/code&gt; - stock quantity<br /> 5. When exact match found, &quot;Add to Cart&quot; button appears with variant item_code<br /> <br /> == Cache System (&lt;code&gt;ItemVariantsCacheManager&lt;/code&gt;) ==<br /> <br /> Uses Redis to cache:<br /> <br /> - &lt;code&gt;item_variants_data&lt;/code&gt; - all variant attribute values<br /> - &lt;code&gt;item_attribute_value_map&lt;/code&gt; - attribute -&gt; variant mapping<br /> - &lt;code&gt;optional_attributes&lt;/code&gt; - which attributes are optional<br /> <br /> Cache is invalidated on Item save/rename via crud_events hooks.<br /> <br /> == API Endpoints ==<br /> <br /> === &lt;code&gt;get_attributes_and_values(item_code)&lt;/code&gt; ===<br /> <br /> Returns all attributes and their possible values for a template item.<br /> <br /> === &lt;code&gt;get_next_attribute_and_values(item_code, selected_attributes)&lt;/code&gt; ===<br /> <br /> Progressive filtering - returns valid options given current selections.<br /> <br /> === &lt;code&gt;get_item_variant_price_dict(item_code, cart_settings)&lt;/code&gt; ===<br /> <br /> Gets price for a specific variant item.<br /> <br /> == Relevance to System Builder ==<br /> <br /> The existing variant selector is a &#039;&#039;&#039;single-item configurator&#039;&#039;&#039;. The planned System Builder would need:<br /> <br /> - &#039;&#039;&#039;Multi-item configuration&#039;&#039;&#039; (CPU + RAM + Storage + etc.)<br /> - &#039;&#039;&#039;Cross-item compatibility rules&#039;&#039;&#039; (not just attribute filtering within one template)<br /> - &#039;&#039;&#039;Template/preset system&#039;&#039;&#039; (save configurations)<br /> - &#039;&#039;&#039;Aggregated pricing&#039;&#039;&#039; (total system price with combined discounts)<br /> <br /> The variant_selector&#039;s caching and attribute filtering logic could be extended, but the System Builder is fundamentally a different scope.<br /> <br /> ----<br /> <br /> &#039;&#039;&#039;See Also:&#039;&#039;&#039; [Webshop-11-Feature-Plan-System-Builder Feature Plan: System Builder]<br /> <br /> &#039;&#039;&#039;Navigation:&#039;&#039;&#039; [Webshop-Index Webshop Index] | [Webshop-04-Product-Pages-and-Browsing Previous: 04 - Product Pages] | [Webshop-06-Pricing-and-Discounts Next: 06 - Pricing &amp; Discounts]</div> Justinaquino