Title: Tlloancy Step Configurator for WooCommerce Author: Thomas Lloancy Published: 7, Xunetu de 2026 Last modified: 11, Ochobre de 2026 --- Guetar plugins ![](https://ps.w.org/tlloancy-step-configurator-for-woocommerce/assets/banner-772x250. png?rev=3599031) ![](https://ps.w.org/tlloancy-step-configurator-for-woocommerce/assets/icon-256x256. png?rev=3599031) # Tlloancy Step Configurator for WooCommerce By [Thomas Lloancy](https://profiles.wordpress.org/tlloancy/) [Download](https://downloads.wordpress.org/plugin/tlloancy-step-configurator-for-woocommerce.1.7.1.zip) * [Details](https://ast.wordpress.org/plugins/tlloancy-step-configurator-for-woocommerce/#description) * [Reviews](https://ast.wordpress.org/plugins/tlloancy-step-configurator-for-woocommerce/#reviews) * [Installation](https://ast.wordpress.org/plugins/tlloancy-step-configurator-for-woocommerce/#installation) * [Development](https://ast.wordpress.org/plugins/tlloancy-step-configurator-for-woocommerce/#developers) [Support](https://wordpress.org/support/plugin/tlloancy-step-configurator-for-woocommerce/) ## Description Tlloancy Step Configurator for WooCommerce lets customers assemble a customizable product through a mobile-first wizard, with live pricing and WooCommerce cart integration. * Several configurators per shop, each attached to its own WooCommerce product ( blinds on one, salads on another) * The wizard sits on the product page by itself, or anywhere with the block or the shortcode * Quantity field on the wizard; the cart line carries the quantity and the unit price * Weight per variant and per option: the cart line weighs what the customer chose, so weight-based shipping rates apply * Block cart and block checkout show the variant and the full list of choices, with the card photo * Reusable generic engine (steps, options, variants) * Data-driven flows (config.flow, step.applies_to, option.unlock_flow, limit_rules) * CSV / XML nomenclature import and export * Sequential wizard with slide-in menu, progress bar, and photos on cards when you attach them * Optional accordion layout (Settings) — all sections on one page, product-page style * Unavailable options: hide the card, or keep it greyed out and not selectable * In-admin Guide: one made-to-measure walkthrough, both layouts, with a glossary * Variant card order: an Order field, then price when two variants share the same number * Numeric steps (min / max / unit) and an optional base-price formula on the variant. A card step’s slug in that formula is the selected supplement * Base price plus supplements, with mandatory server-side revalidation * WooCommerce integration via cart_item_data * Gutenberg block `tlsc/wizard`, with a configurator picker in the block sidebar * Shortcode `[tlsc_wizard configurator="slug"]` * Demo catalog (salad bar) loaded on demand from Import / Export * Optional data removal when the plugin is deleted (Settings Plugin removal) ## Screenshots [⌊Demo of the step-by-step configurator wizard with live pricing.⌉⌊Demo of the step- by-step configurator wizard with live pricing.⌉[ Demo of the step-by-step configurator wizard with live pricing. ## Blocks This plugin provides 1 block. * Tlloancy Step Configurator Wizard Interactive step-by-step product configurator. ## Installation 1. Copy the `tlloancy-step-configurator-for-woocommerce` folder to `wp-content/plugins/` 2. Activate the plugin. WooCommerce must be installed and active 3. Open **Tlloancy Configurator Configurators**. Create a configurator: name it, attach one of your simple products or let the plugin create a hidden one, pick the first-step label and the layout 4. Fill its catalog from **Variants & Pricing**, **Steps** and **Options**, or load the demo from **Import / Export** (the Guide walks through one product click by click) 5. The wizard is already on the attached product page. To show it elsewhere, insert the **Tlloancy Step Configurator Wizard** block and pick the configurator in the sidebar, or use `[tlsc_wizard configurator="slug"]` 6. On the WooCommerce product, set the shipping class and tax status. Weights go on the variants and options ## FAQ ### How do I customize the steps? Use **Tlloancy Configurator > Variants & Pricing**, **Steps** and **Options** in the WordPress admin. The Steps list shows how many options each step has; the Options list can be filtered by step. ### Is there demo data? Yes. **Tlloancy Configurator > Import / Export > Load the demo** installs a complete salad bar. It replaces the current catalog after a confirmation; export first if you want to keep what you have. ### Does the configurable product ship? Yes, unless the attached WooCommerce product is marked Virtual. Each variant and each option has a Weight field in the shop weight unit. The cart line weighs the variant plus the chosen options, times the quantity; when all of them are 0 the product weight is used. Weight-based shipping rates and the shipping class set on the product apply. Tick Virtual on the product if nothing is shipped: the Weight fields then stay out of the admin forms. ### Can I run several configurators on one shop? Yes. **Tlloancy Configurator Configurators** lists them. Each one has its own name, slug, first-step label, layout, WooCommerce product and catalog. The bar under the title of Variants & Pricing, Steps, Options and Import / Export says which configurator you are editing and switches to another one. ### Which product does the wizard sell? The one attached to the configurator. Attach any simple product you already sell, or let the plugin create a hidden product named after the configurator. A product belongs to one configurator at a time. Deleting a configurator keeps its product. ### Can the customer choose a quantity? Yes, when **Let the customer choose a quantity** is ticked on the configurator and the product is not sold individually. The wizard shows a quantity field next to Add to cart, the total follows it, and the cart line carries the quantity. Stock on the product is checked. ### What happens when I delete the plugin? Deactivating keeps everything. Deleting the plugin removes its tables, settings and the hidden products it created only when **Settings Plugin removal** is ticked. Products you attached yourself are detached, not deleted. ### How do I import a BOM / nomenclature? BOM means Bill of Materials. Use **Tlloancy Configurator > Import CSV / XML**, or see `docs/USER-GUIDE.md` (English), `docs/MODE-DEMPLOI.md` (French), and `seed-data/ examples/`. ### Which currency is used? The currency and symbol position from WooCommerce Settings General. The wizard, the cart and the order use that format. ### Where is the documentation? * English: `docs/USER-GUIDE.md` * French: `docs/MODE-DEMPLOI.md` ### Can customers buy the configurable product from the product page? Only through the wizard. With **Show the wizard on the product page** ticked, the wizard replaces the native Add to cart under the product summary, and the shop grid button reads Configure. Native Add to cart and express-pay buttons on that product are blocked. Untick it to sell only through pages that carry the block or the shortcode. ### How do photos work in the wizard? Configurations with an image show a full-width photo on the card. Options with an image show a small rounded thumbnail. No image means a pictogram only. Next, Back and the steps menu scroll the page back to the top of the wizard. In the accordion, OK and the steps menu scroll the opened section up under the price bar. ### Does an import rename the product? No. Import replaces the catalog of the configurator shown in the bar, and leaves the product name already set in WooCommerce. The demo name is used only when the configurator has no product yet. ### Do photos and weights survive an import? Export first, then import that file. CSV and XML keep the photo URL on variants and options, the weight, extra info, whether an option can be ordered, and whether a variant is visible. A file without the image_url column clears the photos; without the weight column, weights are set to 0. The picture files stay in the Media Library. ### Where does the customer see the configuration? Cart, checkout, the thank-you page, My Account Orders, and the customer order emails. The merchant “New order” email stays short; the full breakdown is on the WooCommerce order screen. ### Do I need numeric steps or a formula? Only for measured products. Card steps alone give a base price plus supplements. Numeric steps add typed values (width, height…) and a formula on the variant can price from them. ### How do I price a product from width × height? Add numeric steps whose slugs are the formula variables (e.g. largeur, hauteur). On the variant, set an optional base-price formula such as max({base}, {largeur}*{ hauteur} / 10000 * 89). The slug of a card step is the sum of the selected options’ supplements, or 0 when none is selected. When the formula names that slug, those supplements are not added again. Leave the formula empty to keep classic pricing. See docs/USER-GUIDE.md. ### What happens when Available for order is off? Settings Unavailable options. Hide removes the card. Show as unavailable keeps it greyed out, labelled unavailable, and not selectable. The cart still rejects that option. ### Where is the in-admin guide? Tlloancy Configurator Guide. It walks through one made-to-measure blind, from the page to the cart, in both layouts. The screen is on the left, the clicks on the right. A glossary at the bottom defines the field names. ### What is the accordion layout? Configurators edit the configurator Wizard layout. Step by step shows one screen at a time with Next / Back. Accordion lists every section on one page — better for measured products on a product page. Only one section stays open; click the open heading to fold it. A folded heading shows a small photo of the selected card next to its name, when that card has one. A choice without a photo, and a numeric step, stay text only. OK opens the next section and scrolls it up under the price bar. The steps menu does the same. Switching layout does not change saved data. ### How do I change the order of the variant cards? Variants & Pricing Order on each variant. Cards follow that number. Variants with the same number stay in price order. In a CSV or XML config row the same value is` sort_order` / `sort`. ### Can the customer unselect a variant? Yes. Click the selected configuration card again to clear it. Later steps hide until they pick another. Add to cart stays disabled until a variant is chosen. Rename the first step on the configurator, under First-step label (e.g. Type de confection, Model). ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Tlloancy Step Configurator for WooCommerce” is open source software. The following people have contributed to this plugin. Contributors * [ Thomas Lloancy ](https://profiles.wordpress.org/tlloancy/) [Translate “Tlloancy Step Configurator for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/tlloancy-step-configurator-for-woocommerce) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/tlloancy-step-configurator-for-woocommerce/), check out the [SVN repository](https://plugins.svn.wordpress.org/tlloancy-step-configurator-for-woocommerce/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/tlloancy-step-configurator-for-woocommerce/) by [RSS](https://plugins.trac.wordpress.org/log/tlloancy-step-configurator-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.7.1 * Wizard: the quantity stepper is an inline element. When the page runs wpautop on the rendered wizard, Back and Add to cart keep equal widths instead of Back taking the whole bar. #### 1.7.0 * Configurators: a shop runs several, each with its own name, slug, first-step label, layout, WooCommerce product and catalog. New Configurators screen; a bar on every catalog screen switches between them. First-step label and Wizard layout move from Settings to the configurator. * Product attachment: pick any simple product or let the plugin create a hidden one. The wizard renders on the attached product page under the summary; the shop grid button reads Configure. * Quantity: a stepper on the wizard, the total follows it, the cart line carries the quantity; stock and Sold individually are honoured. * Weight: a Weight field on variants and options; the cart line weighs the variant plus the chosen options, so weight-based shipping rates apply. The field is hidden while the product is Virtual. * Block cart and block checkout: the line name carries the variant, the choices list and the card photo come through the Store API. * Block sidebar picks the configurator; shortcode accepts `configurator="slug"`. * CSV / XML keep a `weight` column / attribute. Import and export work on the configurator shown in the bar. The `tlsc_import_payload` filter receives the configurator ID as second argument. * Database: new `tlsc_configurators` table, `configurator_id` on variants and steps,` weight` on variants and options. Existing catalogs are gathered into one configurator attached to the existing product. Step slugs are unique per configurator. * Uninstall removes only hidden products the plugin created; attached products are detached. * Guide, docs (USER-GUIDE / MODE-DEMPLOI) and the readme FAQ cover configurators, quantity and weight. #### 1.6.0 * A variant can hide its price: no price on the card, and no total at the top while it is 0. Useful for a variant that only leads to a choice. * A step can hide “Included” on options at 0. Options with a price still show it. * CSV and XML import/export keep both settings (hide_price). An older file without it still imports; nothing is hidden. * Database tables get the new columns on update. * Card grids (variants and step options): the last, incomplete row is centered and its cards keep the width of the full rows. The accordion layout is unchanged. #### 1.5.9 * Activation leaves the store currency, the symbol position and the default country as set in WooCommerce. Prices in the wizard, the cart and the order use that format. * The configurable product is created after WooCommerce has registered the product post type. * The plugin header declares the WooCommerce versions it requires and has been tested with, and High-Performance Order Storage. * CSV import passes the escape argument to str_getcsv. * Database tables are updated once per schema version. * Docs (USER-GUIDE / MODE-DEMPLOI) and the readme FAQ cover the store currency. #### 1.5.8 * Accordion: a folded section shows a small photo of the selected card next to its name, when that card has one. A choice without a photo, and a numeric step, stay text only. * Docs (USER-GUIDE / MODE-DEMPLOI) and the readme FAQ cover it. #### 1.5.7 * A card step’s slug in a variant formula is the sum of the selected options’ price supplements, or 0 when none is selected. When the formula names that slug, those supplements are not added again. The step overage still is. An empty formula still adds every supplement once. * Accordion: OK opens the next section and scrolls it up under the price bar. The steps menu does the same. * Docs (USER-GUIDE / MODE-DEMPLOI) and the readme FAQ cover both. #### 1.5.6 * Variants have an Order field. Cards follow that number, then the price when two variants share it. * CSV and XML config rows store that number (`sort_order` / `sort`). * Docs (USER-GUIDE / MODE-DEMPLOI) and the readme FAQ cover the variant order. #### 1.5.5 * Settings: Unavailable options. Hide removes the card. Show as unavailable keeps it greyed out and not selectable. The cart still rejects an unavailable option. * Admin menu Guide: a walkthrough of one made-to-measure blind, in both layouts, with a contents list and a glossary. * Docs (USER-GUIDE / MODE-DEMPLOI) and the readme FAQ cover unavailable options and the Guide. #### 1.5.4 * Import and reactivation leave an existing shell product name alone. The demo seed name is used only when that product is created. * Docs (USER-GUIDE / MODE-DEMPLOI) and the readme FAQ state that. #### 1.5.3 * CSV and XML import/export keep variant and option photos, option extra info, option availability, and whether a variant is visible in the wizard. An older file without those columns still imports; photos stay empty. * Docs (USER-GUIDE / MODE-DEMPLOI) and the Import / Export screen explain what a round trip keeps, and that a pre-1.5.3 file clears photos. * Steps list: numeric min/max uses a prefixed view variable (Plugin Check). #### 1.5.2 * Variant cards: click the selected configuration again to deselect it. Dependent steps leave the wizard until another variant is chosen. * fr_FR catalogue for 1.5 wizard/admin strings (Personalize your product, Done, formulas, numeric fields) plus a compiled .mo so the front end is no longer mixed EN/FR. * Docs (USER-GUIDE / MODE-DEMPLOI) cover deselecting a variant and the first-step label. #### 1.5.1 * Accordion: only one section open at a time; click the open heading (including the first variant step) to fold it. Choosing a variant no longer jumps to the next section by itself. * Accordion Add to cart: full-width control on a quiet bar — no coral strip under a faded button. * Settings: layout and palette cards deselect immediately when you pick another( no leftover highlight before Save). * Demo seed and steel palette renamed Maison Thomas (`seed-data/maison-thomas.php`). An existing `muka` palette option still loads that steel theme. * Docs (USER-GUIDE / MODE-DEMPLOI) cover accordion folding, the cart button, and the Maison Thomas seed. #### 1.5.0 * Numeric step type (min / max / increment / unit / default). The step slug is the formula variable. Existing single/multiple steps are unchanged. * Optional variant base-price formula ({slug} tokens, + − × ÷, min/max/round/ceil/ floor). Empty formula = previous pricing (base + supplements + overage). * Optional option effect: add a delta to a numeric step before the formula (e.g. a breaking hem adds 2 cm to height). * Settings: wizard layout — Step by step (default) or Accordion. Missing option keeps the original wizard. * Admin screens stacked full-width (form then list) so fields no longer overflow the list. Step type toggles choice limits vs numeric bounds. * Sample import seed-data/examples/nomenclature-dimensions-sample.xml. Docs (USER- GUIDE / MODE-DEMPLOI) cover dimensions, formulas and layout. * CSV/XML import/export: extra optional columns/attributes (backward compatible). #### 1.4.1 * Wizard: a configuration with an image uses a full-width photo band; an option with an image uses a 72×72 rounded thumbnail; no image still shows a pictogram( never an empty band) * Next / Back / the steps menu scroll the page back to the top of the wizard; the page itself still scrolls with the mouse * Admin: variant/option image previews use the same rounded rectangle crop as the wizard, not a circle * Docs and FAQ updated for card photos and step-change scroll #### 1.4.0 * Steps admin: per-variant min/max/included/required is a table (tick a variant to override) instead of a JSON textarea — limit_rules is built from that POST array, not from typed JSON * Fixed: ticking a variant did not enable the Min/Max/Included/Required inputs ( the row stayed greyed out) * Max on a step shows how many options currently exist for that step * tlsc_configs.image_url (dbDelta); image picker on Variants (media enqueued on configurator admin screens); URL stored on the cart config payload; wizard formula cards, cart / order / admin thumbnails and customer-email images use it; XML import/export adds an image attribute (CSV schema unchanged) * Native add-to-cart validation, Store API add-to-cart/cart-item, and cart check reject or remove the shell product without tlsc_selections; product-page add- to-cart (classic + blocks CSS) and the loop add-to-cart link are hidden; Stripe/ PayPal / WooPayments product express buttons are disabled * Order-item recap (formula + steps) on the thank-you page, My Account and customer emails; merchant “New order” emails skip it * Plugin Check: recap thumbnail output goes through wp_kses; Store API exception messages are escaped * Fixed: with overage_price set, the wizard hint used max (e.g. 2/13) instead of included (2/2); option cards kept saying Included after the included quota was full * Last wizard step shows “Adding…” while the cart request runs * Gutenberg block editor strings go through wp.i18n (wp_set_script_translations); admin Error / Network error alerts are translated * Docs (USER-GUIDE / MODE-DEMPLOI) and readme FAQ updated for wizard-only purchase, customer recap, and the included-quota counter * fr_FR .po/.mo and .pot updated for the new strings #### 1.3.0 * Steps can now define an “included” selection count (per variant, in limit_rules) plus a flat overage_price — selections beyond the included count are charged instead of being blocked outright, up to the (now separately raised) max * Wizard: live price and selection hint reflect the overage as soon as the client crosses the included threshold, not just at checkout * Fixed: the front-end wizard didn’t split a multi-value unlock_flow (added in 1.2.7) on comma, so a combo option unlocking two flows at once showed neither of them client-side despite the server accepting it * Maison Thomas seed: Ingrédients bruts/nobles now allow selecting beyond the included amount (2 for Petite, 3 for Grande) at +1,50€ each #### 1.2.7 * Option unlock_flow now accepts several comma-separated flows (e.g. dessert,boisson), so one option (e.g. a combo) can unlock more than one extra sub-flow at once * Fixed: CSV/XML import used to sanitize unlock_flow as a single slug directly at insert time, silently mangling multi-value input — now shares the same sanitizer as the admin form #### 1.2.6 * Order admin screen: configurator selections now shown as a formatted breakdown( grouped by step) instead of raw JSON meta * CSV / XML nomenclature export (Import / Export screen), mirroring the existing import format — usable as a backup or as a template for another install #### 1.2.5 * Wizard palette setting: Default (coral), Salade (herb green), Maison Thomas ( concrete & steel) * Presets inject CSS variables on the wizard only; factory coral remains the default #### 1.2.4 * Same screen: group steps that share a same_screen code on one wizard screen * Optional steps: clearer hints + Next becomes Skip when nothing is selected * Safer required casting from DB (string “0” no longer treated as true) * Optional single-select: re-click to deselect * Updated fr_FR translations; wizard CSS cache-bust via filemtime #### 1.2.3 * Plugin Check: drop load_plugin_textdomain, WP 6.0-safe list check, prefixed view variables * Import notices via user transient (no unsanitized error query args) #### 1.2.2 * Extensibility hooks for addons: tlsc_cart_item_data, tlsc_pre_add_to_cart, tlsc_add_to_cart_request * JS events tlsc:beforeAddToCart and tlsc:stepShown #### 1.2.1 * Configurable first-step label (Settings Formula / Pack / Configuration…) * Dynamic step hints from effective min/max/required (including limit_rules) #### 1.2.0 * Data-driven flows: config.flow, step.applies_to (comma-separated), option.unlock_flow * Per-config limit_rules JSON on steps * CSV / XML nomenclature import (admin + TLSC_Importer + tlsc_import_payload filter) * Generic demo seed (no client branding) * English UI source strings + languages/*.pot and fr_FR translation * Bilingual docs: USER-GUIDE.md (EN) + MODE-DEMPLOI.md (FR) * Sample industrial-style CSV/XML under seed-data/examples/ #### 1.1.0 * Step scope applies_to * Wizard + pricing filter applicable steps * TLSC_Activator::reseed() #### 1.0.0 * Initial release ## Meta * Version **1.7.1** * Last updated **6 díes ago** * Active installations **Fewer than 10** * WordPress version ** 6.0 or higher ** * Tested up to **7.1.3** * PHP version ** 8.1 or higher ** * Language * [English (US)](https://wordpress.org/plugins/tlloancy-step-configurator-for-woocommerce/) * Tags * [builder](https://ast.wordpress.org/plugins/tags/builder/)[configurator](https://ast.wordpress.org/plugins/tags/configurator/) [wizard](https://ast.wordpress.org/plugins/tags/wizard/)[woocommerce](https://ast.wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://ast.wordpress.org/plugins/tlloancy-step-configurator-for-woocommerce/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/tlloancy-step-configurator-for-woocommerce/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/tlloancy-step-configurator-for-woocommerce/reviews/) ## Contributors * [ Thomas Lloancy ](https://profiles.wordpress.org/tlloancy/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/tlloancy-step-configurator-for-woocommerce/)