Home › Docs › Addons › Smart Configurator
Smart Configurator
$19 Product options with their own prices and design rules, without opening the full designer.
Platforms: WooCommerce, OpenCart, PrestaShop & Shopware 6. Version: 2.1.6.
Every purchase is a single signed, install-ready ZIP with a license key from Polar: one-time payment, free updates for life and 6 months of email support. Installs through the Veyo Apps screen.
What Smart Configurator does
Smart Configurator lets you sell personalization as a set of simple choices: size, ink color, names, extras such as a back print or rush production. Shoppers pick options and see the preview update live, without needing to open the full designer.
Every choice can carry its own price, and design rules turn choices into design changes, for example “When Size is XXL, set the text of Name using option Name”. Prices are always computed on the server, so the browser can never change what a shopper pays.
Features
- Six option types. Buttons, color swatches, image choices, dropdown, checkbox and short text. Options can be shown only when another option has a given value.
- Per-choice pricing. Each choice can add a price per item or once per order line, and can be flagged as rush production. Surcharges appear as their own lines in the designer, cart and checkout and are re-priced when the cart quantity changes.
- Design rules. Sentence-style rules with actions to set text, color or font, replace an image, show or hide a layer, or switch the product color. Layers are picked from the linked design template.
- Where shoppers see it. Inside the Quick Personalizer on the product page (Design Templates addon) and in an Options tab in the designer sidebar. Choices are remembered for the browsing session.
- Generate from template. One click creates a starter set from a template: a text field per text layer, a text-color swatch and show/hide switches for images. Then edit and price it, and use Try it to preview the panel, charges and layer changes.
- Server-side pricing. The browser only sends the chosen values. Unknown or hidden choices cost nothing, and chosen options are shown in the cart and checkout and stored on the order.
- Production-ready. With the Print Queue addon, options are printed on the production ticket and a rush choice raises the job to at least Rush priority.
How to set up Smart Configurator
-
Buy and install
Download the addon ZIP from your Polar purchase email or customer portal and upload it in Veyo → Extensions.
-
Open Smart Configurator
Go to Veyo Personalizer → Catalog → Configurators. There is one configurator per catalog product; a new one stays off until you switch on Live on the storefront.
-
Add options and prices
Create options, add choices, set per-item or once-per-line prices, and mark rush choices. Use Generate from template for a quick start.
-
Add design rules and test
Write rules that change text, colors, images or layers, then use Try it to check the panel, extra charges for a quantity and layer changes before going live.
At a glance
| Version | 2.1.6 |
|---|---|
| Platforms | WordPress + WooCommerce, OpenCart 3 & 4, PrestaShop 8 & 9, and Shopware 6.6 / 6.7 |
| Requires | Veyo Product Personalizer 1.1.0 or later (1.2.0 or later on OpenCart and PrestaShop). No addon is required. Optional: Design Templates (Quick Personalizer on the product page and the layer picker) and Print Queue (options on the production ticket). |
| Where settings live | Veyo Personalizer → Catalog → Configurators, one configurator per catalog product. The catalog product editor also has a Smart Configurator card in its Options tab (shows Live or Off, with Create / Edit), and the Catalog list shows a badge. |
| Server tools / outside services | None. |
What shoppers see
- In the designer: an Options tab in the left sidebar ("Choose product options") with the note that choices update the design and the price.
- On the product page: inside the Quick Personalizer, which comes from the Design Templates addon (products with an assigned template and quick personalization switched on).
- The panel shows the title you set (default "Product options") and one control per option: buttons, color swatches, image choices, a dropdown, a checkbox or a short text field. Choices with a price show it as, for example,
+$2.50, or+$2.50 oncewhen charged once per order line. Required options without an answer show "Please make a choice." - The preview updates live, and choices are remembered for the browsing session (per product, in the browser's session storage).
- In the cart and checkout each chosen option appears as its own row, and each surcharge as its own price line.
Settings
Open Catalog → Configurators, click Create the first configurator (or + New configurator), and click Save (Ctrl/Cmd+S). A new configurator is not live until you switch on Live on the storefront, and it only goes live with at least one option. The list also has a Turn on / Turn off switch per configurator.
Top bar
| Setting | Default | Range / options | What it does |
|---|---|---|---|
| Product | None | One catalog product; locked once saved | Each product has one configurator. To reuse options on another product, create a new configurator. |
| Design template | No template | A template from Design Templates | Lets rules pick layers from a list. Without it you type layer IDs by hand; if Design Templates is not active the box says so. |
| Generate | n/a | Button | Replaces the current options and rules (after a confirmation) with a starter set built from the template. |
| Title shown to shoppers (optional) | Empty (shows "Product options") | Text | Heading of the shopper panel. |
| Live on the storefront | Off | On / off | Shows the options to shoppers and enables their pricing. |
Options tab
| Setting | Default | Range / options | What it does |
|---|---|---|---|
| Type | Chosen when you add it | Buttons, Color swatches, Image choices, Dropdown, Checkbox, Short text | Up to 40 options per configurator. |
| Label shoppers see / Help text / Required | Required off | Text | The question, an optional line under it, and whether an answer is expected. |
| ID (used by rules) (under Advanced) | Generated | Letters, numbers, - and _ | How rules refer to this option. |
| Choices: Label, Value, Color (swatches), Image URL (image choices) | None | Up to 60 choices per option; image URLs must be http or https | The things shoppers pick. Add several… takes one choice per line, optionally Large | 2.50. |
| Extra price | 0 | 0 to 100,000, steps of 0.01 | Added to the price when the choice (or the checked box) is selected. |
| Charged | per item | per item, once (once per order line) | Per item is multiplied by the quantity; once is charged one time per line. |
| Rush production | Off | On / off, per choice or checkbox | Flags the order line as rush (shown with a lightning bolt in the editor). |
| Preselected choice (star) / Checked by default | None | One choice, or the checkbox | The value used until the shopper picks something. |
| Max characters (short text) | 40 | 1 to 500 | Text is trimmed to this length on the server. |
| Placeholder / Letter case (short text) | Empty / As typed | As typed, UPPERCASE, lowercase | Hint inside the field and forced letter case. Short text has no price. |
| Show only when | always shown | An earlier option is set to a value | Hides the option until the condition is met. Hidden options cost nothing. |
Design rules tab
| Setting | Default | Range / options | What it does |
|---|---|---|---|
| When | Always (every selection) | An option "is set to" or "is not set to" a value; add several conditions joined with "and" | Decides when the rule applies. Up to 100 rules. |
| Then (actions) | None | Set the text of, Set the color of, Set the font of, Replace the image of, Show / hide, Switch the product color | Up to 20 actions per rule. Each acts on a layer (picked from the template, or by layer ID) "using" an option or a fixed value. Colors come from the chosen swatch, images from the chosen choice's Image URL, fonts and product color from the choice's Value (product color 0 is the first color). |
The Shopper preview panel on the right (Try it) lets you pick choices and a quantity, and shows Extra charges and Design changes before you go live.
What you get in orders and production
- Server-side prices. Prices are rebuilt on the server from the saved configurator; the browser sends only the chosen values. Unknown choices and hidden options cost nothing. Text options never carry a price.
- Cart, checkout and order. Chosen options are shown as rows and stored with the order line. Deleting a configurator does not change orders already placed.
- Print Queue. With Print Queue, the options are listed on the production ticket and traveler, and a rush choice raises the job to at least Rush priority. See Orders & production.
Data and privacy
- Database: one table,
{prefix}veyop_configurator_profiles(options, rules, title, template link, live flag) and the optionveyop_smart_configurator_db_version. - Outside services: none.
- Shopper data: the chosen options (including any text typed) are saved with the order line. The browser keeps the current choices in session storage for the browsing session only.
- Uninstalling the addon keeps the table and your configurators. Uninstalling the whole of Veyo with Keep data when uninstalling off deletes the table and options. See Uninstalling & your data.
Troubleshooting
- "This product already has a configurator. Edit that one instead." One configurator per product. Open the existing one from the list.
- "Choose a product for this configurator." Pick the product in the top bar before saving.
- Shoppers do not see the options. The configurator must be Live on the storefront and have at least one option. The Quick Personalizer on the product page also needs the Design Templates addon; the designer Options tab does not.
- A rule does nothing, or its layer shows "(missing)". The layer no longer exists in the linked template, or you typed a wrong layer ID. Pick a layer again. The tabs show a warning icon with "things to check" when something needs attention.
- A price looks wrong in the cart. "per item" charges are multiplied by the quantity and "once" charges are not. Use Try it with the same quantity to compare.
FAQ
Do I need Design Templates?
It is optional but recommended: the Quick Personalizer on the product page and the layer picker come from the Design Templates addon. The designer Options tab works without it.
Can customers tamper with prices?
No. Prices are always computed on the server from the saved configurator. The browser sends only the chosen values.
Does it work on OpenCart, PrestaShop or Shopware?
Yes. On Shopware 6.6 / 6.7 it runs from version 2.1.5 with Veyo 1.8.0. On OpenCart and PrestaShop, since version 2.1.0 with Veyo 1.2.0 or later: the designer Options tab, the Quick Personalizer on the product page, server-side prices in the cart and the admin pickers all work the same. Since Veyo 1.6.1, Print Queue also runs on OpenCart and PrestaShop, and its job tickets list the chosen options there too.
Will my 1.x profiles survive the upgrade?
Yes. Existing profiles are converted on read, and legacy color options become swatches.
Installing, updating and removing
- Install: upload the ZIP in Extensions, then enable it. See Install addons.
- Update: upload the newer ZIP over the old one. Settings and data are kept. See Upgrading.
- Remove: Uninstall on the addon card removes its files and keeps its data, so reinstalling restores everything. See Uninstalling & your data.