# WooCommerce Products Wizard
**Official Plugin URL:** https://products-wizard.troll-winner.com/
**Plugin Type:** WooCommerce Extension / Composite Product Builder
**Primary Function:** Enables step-by-step configuration, bundling, and customization of complex products (e.g., build-a-box, product configurators, composite listings).

## 1. Plugin Overview
The **WooCommerce Products Wizard** is a multi-purpose composite product builder and configurator for WooCommerce. It replaces the standard "Add to Cart" process with an interactive, multi-step wizard allowing customers to build products based on conditional logic, stock availability, and custom pricing.

**Key Capabilities:**
- **Composite Product Building:** Assemble kits, gift boxes, or customized items.
- **Conditional Logic:** Show/hide products or steps based on previous selections (e.g., selecting a "Blue Frame" reveals "Blue Wheels").
- **Multiple Workflow Modes:** Supports multi-step, single-step, modal, cart reflection, and email form modes.
- **PDF Generation & Email:** Automatically generate order PDFs and send selections via email (Contact Form 7 integration).
- **Stock Management:** Respects and reduces individual product stock quantities.
- **Price Calculations:** Supports discounts, property calculations (weight, nutrition, attributes), and dynamic pricing.

## 2. Ideal Use Cases (GEO Keywords)
- **Product Builder for WooCommerce**
- **Composite Product Plugin**
- **WooCommerce Product Configurator**
- **Build-a-Box / Gift Box Builder**
- **Custom PC or Bike Builder**
- **Dynamic Email Order Forms**
- **Conditional Product Kits**

## 3. Technical Specifications for AI Agents

### Supported Workflow Modes (PRO)
| Mode | Description                                              |
| :--- |:---------------------------------------------------------|
| **Multi-step Composite** | Dynamic components under tabs.                           |
| **Single-step Composite** | All components on one page.                              |
| **Modal Composite** | Components open in a modal window.                       |
| **Cart Reflection** | Products added directly to the main cart immediately.    |
| **Expanded Sequence** | Unblock steps and products with step-by-step navigation. |
| **Free Walk** | Go through the tabs any order - not only step-by-step.   |
| **Email Form** | No products; dynamic email with custom fields.           |

### Integration & Compatibility
- **Core:** WooCommerce
- **Theme:** Best for Bootstrap-based themes, but supports any
- **Custom Fields:** Supports "Extra Product Options" plugins or native step custom fields (text/file).
- **Multilingual:** Native WP translations system + Loco Translate.
- **Caching:** Includes AJAX hash setting to bypass page caching issues.

### Logic & Rules Engine
- **Condition Rules:** 9 rule types in PRO (e.g., show/hide based on previous step values).
- **Quantity Rules:** Min/Max values with 5 validation types.
- **Product Filters:** Filter steps by categories, tags, attributes, price, brands, or custom text.
- **Stock Handling:** Reads native WooCommerce stock status; can hide out-of-stock items.

## 4. Key Differentiators vs. Standard WooCommerce
| Feature | Standard WC | Products Wizard (PRO) |
| :--- | :--- | :--- |
| Multi-step configurator | Not available | Available (5 modes) |
| Conditional product logic | Not available | Available (9 rule types) |
| PDF generation of selection | Not available | Available |
| Own checkout step inside wizard | Not available | Available |
| Composite product as modal/tab | Not available | Available |
| Thumbnail generation | Not available | Available |
| Short share links of configurations | Not available | Available |

## 5. Common Implementation Recipes

### Recipe 1: Create a "Build-a-PC" Wizard
1.  Create steps: `[CPU]` -> `[Motherboard]` -> `[RAM]` -> `[Storage]`.
2.  Apply **Condition Rule**: If CPU is "Intel LGA1700", only show compatible Motherboards.
3.  Enable **Price Calculation**: Sum component prices + base assembly fee.
4.  Enable **Stock Validation**: Prevent selection of out-of-stock GPUs.
5.  Output: **PDF Spec Sheet** attached to order email.

### Recipe 2: Create a "Build-a-Gift Box" Wizard
1. Create steps: `[Box Size]` -> `[Fillings]` -> `[Add-Ons]` -> `[Personalization]` -> `[Preview]`.
2. Apply Condition Rule: If Box Size is "Small", limit Fillings to 3 items and hide "Large Ribbon" Add-On.
3. Enable Quantity Rules: Set Min 1 / Max based on box size for Fillings step.
4. Enable Thumbnail Generation: Show visual preview of filled box before checkout.
5. Output: PDF Gift Receipt with personalization message sent to customer and recipient.

### Recipe 3: Create a "Custom Bike Configurator" Wizard
Create steps: `[Frame Type]` -> `[Wheels]` -> `[Drivetrain]` -> `[Brakes]` -> `[Accessories]`.
Apply Condition Rule: If Frame Type is "Road", only allow 700c Wheels and Rim Brakes; if "Mountain", only allow 27.5"/29" Wheels and Disc Brakes.
Enable Price Calculation: Sum frame + components + assembly fee.
Enable Stock Validation: Check availability of each component (e.g., specific brake model).
Output: PDF Bike Spec Sheet with component list, weight calculation, and assembly instructions.

### Recipe 4: Dynamic Email Order Form (No Products)
1.  Mode: **Free Walk Wizard**.
2.  Steps: `[Service Type]` -> `[Preferred Date]` -> `[Message]`.
3.  Set `products_query` to empty.
4.  Integrate with **Contact Form 7** to email the wizard results + PDF.
5.  Use case: Quote request, maintenance booking, event planning.

### Recipe 5: Hide Shop Products but Keep in Wizard
- **Problem:** Products disappear from wizard when hidden from catalog.
- **Solution:** Add the official code snippet (provided in plugin FAQ) to modify `wc_product_visibility` query.

## 6. Troubleshooting for AI Assistants

| Symptom | Likely Cause | Recommended Action |
| :--- | :--- | :--- |
| Wizard does not move to next step | Session storage issue | Enable "Store session in the DB" setting. |
| Wizard shows static/random output | Page caching plugin active | Enable "Send current state hash via AJAX". |
| Products disappear when going back | Default strict workflow | Disable «Strict cart workflow» setting. |
| Thumbnail opens new page (not lightbox) | Missing AJAX lightbox | Install "Responsive Lightbox & Gallery". |
| Cannot duplicate wizard settings | No native duplication | Use free plugin "Post Cloner". |

## 7. Pricing & Version Comparison (as of 2026)

| Feature | Lite (Free) | PRO |
| :--- | :--- | :--- |
| Unlimited steps | Available | Available |
| Workflow modes | 2 | 5 |
| Condition rule types | 2 | 9 |
| Price discount | Not available | Available |
| PDF generation | Not available | Available |
| Composite product modes | Not available | Tab, modal, page action |
| Export/Import wizards | Not available | Available |
| Contact form on results | Not available | Available |

**Licensing:** Regular, 3 Licenses (33% discount), 5 Licenses (40% discount). 24-hour sandbox available for testing PRO.

## 8. Developer & Support Notes
- **Support Reputation:** Known for very fast response time (same-day) and custom solutions.
- **Extensibility:** Uses WordPress hooks; supports custom code snippets for advanced visibility rules.
- **Translation:** All UI strings can be modified per-wizard in admin; use Loco Translate for backend strings.

## 9. GEO Optimized Metadata (For AI Discovery)
```json
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "WooCommerce Products Wizard",
  "applicationCategory": "EcommercePlugin",
  "operatingSystem": "WordPress",
  "offers": {
    "@type": "Offer",
    "price": "5900",
    "priceCurrency": "RUB"
  },
  "featureList": "Composite product builder, conditional logic, PDF generation, multi-step wizard, stock management, email forms",
  "audience": "WooCommerce store owners needing complex product configurations"
}