DestinX Product Configurator for WooCommerce

1. Requirements

• WordPress 6.2 or newer
• WooCommerce active
• PHP 8.0 or newer
• An administrator or shop manager account with WooCommerce management permissions

2. What this package includes

3. Quick Start

Visual reference

These screenshots show the current interface referenced by this guide. They are bundled with the plugin under documentation/screenshots so the guide also works offline.

4. Template library and Starter Kits

• Open loads the customer-facing preview.
• Edit template opens the Template Builder and shows a loading indicator while the configuration is prepared.
• The actions menu contains duplication and template status actions.
• The library summarizes assigned products, setup, status, and structural validation.
• A Starter Kit is imported only once. Later imports open the template already associated with that kit without overwriting your edits.

5. Template Builder

Steps and fields

• Use steps to divide the configuration into clear customer decisions.
• Use field cards as accordions. The header contains field order and delete controls.
• Enable Required only when a choice must block completion.
• Supported fields: Select, Radio, Swatch, and Checkbox. A Checkbox can also represent one independent boolean choice.
• Field and option images use the WordPress Media Library.

Options

• Every option has a customer label and a stored value.
• Price delta adds or subtracts a simple amount from the WooCommerce product price.
• Option information can display explanatory customer content.
• Use the arrow controls or drag handles to keep options in the intended order.

6. Quantity, pricing, shipping, and delivery

7. Template completeness and validation

These two indicators help with the configuration itself; they are not a replacement for WordPress Plugin Check.

• Template completeness is a five-point editor checklist covering steps, fields, options, required choices, and valid quantity values.
• Configuration validation reports structural errors or warnings, such as empty steps, fields without options, invalid values, or inconsistent configuration data.
• WordPress Plugin Check separately evaluates directory coding and compliance rules for the plugin package.

8. Assign the template to a WooCommerce product

Edit a product and open the Product Configurator panel.

• Select the template. With no template selected, the product remains a normal WooCommerce product.
• Set minimum quantity, optional shipping surcharge, lead time, and delivery note.
• Enable artwork uploads only when the customer must provide production-ready files.
• Choose single-file or front/back upload mode, maximum size, required status, and allowed source files.
• Attach a guidelines PDF, artwork template, or die-cut/outline file.
• Customize product hero features and description feature boxes when using the plugin layout overrides.

Shortcode

For a custom product template or landing page, use:

[destinxpc_configurator product_id="123"]

9. Storefront behavior

• The customer completes the template step by step.
• Required selections and required uploads prevent an incomplete add-to-cart action.
• The live recap shows completion, selected options, quantity, delivery context, and the configured total.
• On mobile, the bottom action bar opens the cart-details sheet. Information dialogs remain above the sheet and inside the viewport.
• The completed configuration is stored with the WooCommerce cart item, checkout item, and order item.

10. Options, layout, and style

• General: automatic rendering or Shortcode only, WooCommerce visibility, product-page integration, and compatibility behavior.
• Starter Kits: import the bundled ready-to-customize example.
• Layout: product hero, configurator composition, recap, and Description/Reviews presentation.
• Pricing: quantity behavior, WooCommerce tax inheritance, and pricing workspace visibility.
• Style: colors, typography, radius, field image size, option image size, and interface appearance.

11. Artwork files, downloads, and saved configurations

Artwork and customer downloads

Products can provide customer-facing guidelines and artwork templates. Optional upload fields accept the formats allowed in the product settings and respect the configured size limit.

Saved configurations

The customer can save the current setup and, when available in the active flow, copy a share link. Saved data remains attached to the same configuration so it can be reopened without rebuilding every selection.

12. WordPress.org package boundaries

This plugin is complete for the guided configurator workflow documented above. It does not contain locked or disabled built-in features.

The following implementations are not part of this package:

• Matrix pricing and CSV price imports
• Conditional field filters or advanced conditional product logic
• Quote requests, customer quote PDFs, or quote-to-order workflows
• Production worksheets and post-order production workflows

The Add-ons tab contains informational links to separately distributed commercial plugins. No external page is requested until a link is clicked, and no add-on is installed automatically.

13. The two video tutorials

The Getting Started screen links to two official video tutorials. The written documentation remains available as the complete reference.

14. Troubleshooting

Getting Started did not open automatically.

The automatic redirect is intended for the first activation. If the same site or user previously used the plugin, open Product Configurator > Getting Started manually.

A Starter Kit appears to import twice.

Version 0.9.27.6 and newer reopen the existing template. If duplicates were created by an older version, review their product assignments and delete the unused copy manually.

The product page is slow or conflicts with a page builder.

Use Shortcode only mode, disable plugin page-layout overrides, insert the shortcode in the builder template, clear caches, and retest with browser extensions disabled.

The total is not what I expected.

Check the WooCommerce product price, each selected option's Price delta, quantity, taxes, and the selected shipping source.

Add to cart is disabled.

Complete every required field and provide all required artwork files. The completion indicator shows which step still needs attention.

15. FAQ

Does the plugin require WooCommerce?

Yes. It extends WooCommerce products and requires WooCommerce to be active.

Does the plugin require a license or DestinX account?

No. All code and functionality included in this package are available immediately after activation.

Does the plugin contact an external service?

No. It does not send store data for licensing, updates, telemetry, or remote font loading.

What is the price formula?

WooCommerce base product price plus or minus the selected simple option adjustments, multiplied according to the selected quantity.

Can I use it with a custom product template?

Yes. Select Shortcode only mode and place [destinxpc_configurator product_id="123"] in the custom template.

16. Go-live checklist

1. Confirm WooCommerce and DestinX Product Configurator are active.
2. Confirm at least one template is active and structurally valid.
3. Assign the intended template to the correct product.
4. Verify product base price, option price adjustments, quantity, shipping, and delivery.
5. Complete every possible field type and required path.
6. Test artwork uploads and support-file downloads if enabled.
7. Save a configuration and reopen it.
8. Add the configured product to cart and verify cart, checkout, and order item data.
9. Test desktop and mobile layouts in Chrome and Safari.
10. Confirm the browser console has no plugin errors and run WordPress Plugin Check on the final ZIP.