WPC Shop Quiz – Product Finder for WooCommerce

Description

WPC Shop Quiz is a guided selling plugin for WooCommerce that helps shoppers find products through interactive question flows. Create quizzes that ask relevant questions, adapt to shopper selections in real time, and display matching product recommendations automatically.

From skincare routines and electronics bundles to fashion fits and gift guides, Shop Quiz provides a structured discovery flow tailored to your product catalog.

Live demo

Visit our live demo to see how this plugin works.

Overview

• Visual quiz builder — drag-and-drop interface, no coding needed.
• Two recommendation engines — Weighted Scoring for large catalogs, Direct Mapping for precise control.
• Conditional Logic — branching flows that skip irrelevant questions and create a unique path for each user.
• Built-in lead capture — Email Gate collects guest emails before revealing results.
• Smart coupons — auto-generated, deduplicated, email-restricted WooCommerce coupons as quiz incentives.
• Outbound webhooks — integrate with any CRM, email platform, or automation tool in real time.
• Performance-first — result caching and non-blocking AJAX calls.

Key Features

• Drag-and-drop quiz builder with unlimited steps and answers
• Question types: Single Choice, Multi Choice, Image Choice, Multi Image Choice
• Visual answer cards with images, icons, and custom labels
• Welcome Screen with customizable heading, description, and Start button
• Conditional Logic with show/skip rules per step
• Two result modes: Weighted Scoring & Direct Mapping
• Advanced scoring: attributes, categories, tags, price range, ratings, sale status, stock level
• Auto-generated WooCommerce coupons with abuse prevention
• Email Gate for guest lead capture
• Shareable quiz results via unique URLs
• Outbound Webhooks with HMAC-SHA256 signatures
• Result caching with configurable TTL
• Six built-in color themes + custom primary color
• Slide & fade transition effects
• Responsive design (mobile, tablet, desktop)
• Builder preview with device switcher
• Floating quiz button for global site-wide access
• Shortcode & popup modal display modes
• HPOS (High-Performance Order Storage) compatible
• Translation ready with full RTL support
• Quiz analytics & conversion tracking (Premium)
• REST API for headless integrations (Premium)

Not what you needed?

Please try other plugins from us:

• WPC Product Bundles
• WPC Composite Products
• WPC Grouped Product
• WPC Frequently Bought Together
• WPC Force Sells

🧠 Recommendation Engine

Shop Quiz offers two distinct recommendation modes, each designed for a different catalog strategy.

Weighted Scoring
Each answer assigns points to product properties — attributes, categories, tags, price ranges, stock levels, ratings, and sale status. When the quiz completes, every product in your catalog is scored and the top matches are ranked automatically.

• No manual product mapping required — suitable for catalogs with 50+ products
• Score criteria: WooCommerce attributes, product categories, product tags, price ranges, customer ratings (1-5 stars), on-sale status, stock quantity thresholds
• Products are ranked by total accumulated score across all answers
• Admin can configure weight values per answer option

Direct Mapping
For stores that need exact control, each answer option directly maps to specific products. The final recommendation is the intersection (or union) of all mapped product sets.

• Precise control over which products appear for which answer combinations
• Suitable for small catalogs or curated product lines
• Simple “if this, then that” configuration

🔀 Conditional Logic

Not every customer should answer every question. Conditional Logic creates personalized, branching quiz flows:

• Show rule: Display a step only when a condition matches (e.g., show “Skin concerns” only if user selected “Skincare” in step 1)
• Skip rule: Always skip a step when a condition matches (e.g., skip “Budget” for returning customers)
• Conditions reference any previous step’s selected answer(s)
• Multiple conditions per step with AND/OR logic
• Steps are recalculated dynamically after each answer — the progress bar and step count update in real time

How it works:

1. Admin sets rules per step in the quiz builder (e.g., “Show this step only if Step 1 answer = ‘Outdoor’”)
2. After each answer, the engine recalculates which steps are visible
3. Skipped steps are hidden from the progress bar and navigation
4. The quiz flow adapts dynamically to each user’s answers

👋 Welcome Screen

An optional branded landing screen that appears before the first question, setting context and expectations.

Configuration:
* Toggle: Enable / Disable per quiz
* Customizable heading (default: “Find Your Match”)
* Customizable description (default: “Answer a few quick questions…”)
* Customizable Start button text (default: “Start Quiz”)
* Placeholder text auto-fills when fields are left blank
* Displayed in both live quizzes and builder preview

Navigation behavior:
* Clicking “Start Quiz” fades out the welcome screen and reveals the first question
* At Step 1, a “Back” button navigates back to the Welcome Screen
* Quiz Starts are only counted when the user clicks “Start Quiz” — not on page load

🎟️ Smart Coupon Incentives

Reward quiz completions with auto-generated WooCommerce coupons. The coupon system is designed to provide incentives while preventing abuse.

Coupon features:
* Auto-generated unique codes with configurable prefix (e.g., QUIZ-A3KF9B)
* Discount type: percentage or fixed amount
* Individual use enforcement (cannot combine with other coupons)
* 30-day expiration
* Usage limit: 1 per coupon

Anti-abuse deduplication:
The system checks three identity layers before generating a new coupon:

1. User ID — for logged-in customers, checks if they already have an active coupon for this quiz
2. Email — for guests with Email Gate, checks by email address
3. Session key — for anonymous guests, checks by browser session

If an active (unused, unexpired) coupon is found → the existing code is returned instead of creating a new one.

Cart validation:
Quiz coupons only work when the cart contains at least one product from the quiz’s recommended results. This prevents coupon sharing and off-quiz usage.

📧 Email Gate

Capture guest emails as a lead generation tool before showing quiz results.

Behavior:
* Only appears for non-logged-in visitors — logged-in users bypass automatically
* Always visible in admin Preview mode for testing
* Validates email format before allowing submission
* Captured emails are stored and associated with the quiz session

Integration with coupons:
When both Email Gate and coupons are active, the coupon is automatically restricted to the captured email address — preventing coupon sharing.

🔗 Shareable Results

Users can share their quiz results with friends via a unique URL.

How it works:
* After completing a quiz, a “Share Results” button generates a unique link
* The shared page shows the same product recommendations
* Each share records: quiz ID, answers, recommended products, user email (if captured), and timestamp
* Admin can view all shared pages in a dedicated management table

Guest tracking:
When a guest with Email Gate shares results, their email is displayed alongside the share record for reference.

🔌 Webhooks & REST API

Integrate Shop Quiz with any external system through real-time webhooks and a RESTful API.

Outbound Webhooks
Configure a single webhook URL to receive POST requests with structured JSON payloads for three events:

• quiz.completed — fires when a user finishes a quiz (includes quiz ID, answers, recommended products, user data)
• quiz.conversion — fires when a recommended product is added to cart (includes product details, session)
• quiz.coupon_used — fires when a quiz-generated coupon is redeemed (includes coupon details, discount amount)

Security:
* HMAC-SHA256 signature in X-WPCSQ-Signature header for payload verification
* Unique delivery ID in X-WPCSQ-Delivery header
* Plugin version in X-WPCSQ-Plugin-Version header
* Async dispatch via WP-Cron — webhooks never block the user’s request

REST API:
Full CRUD endpoints under wpcsq/v1/ for quizzes, submissions, and results — suitable for headless WooCommerce implementations.

🎨 Themes & Customization

Six built-in color themes with a custom color override:

• Default — Indigo (#6366f1)
• Emerald — Green (#10b981)
• Rose — Pink (#f43f5e)
• Amber — Orange (#f59e0b)
• Cyan — Blue (#06b6d4)
• Slate — Gray (#64748b)
• Custom — any hex color via color picker

Transitions:
* Slide — horizontal slide with direction awareness (left/right)
* Fade — smooth opacity transition

Display modes:
* Inline shortcode: [wpcsq_quiz id="123"] — renders directly on the page
* Popup modal: [wpcsq_btn id="123"] — click-to-open modal overlay
* Floating button: global quiz accessible from any page

📋 Shortcodes

[wpcsq_quiz]

Render a quiz inline on any page or post.

[wpcsq_quiz id="123"]

[wpcsq_btn]

Render a clickable button that opens the quiz in a modal overlay.

[wpcsq_btn id="123"]

Supports text attribute for custom button label:
[wpcsq_btn id=”123″ text=”Find your match →”]

[wpcsq_share]

Render shared quiz results on a designated share page.

[wpcsq_share]

Place this shortcode on the page selected as “Share Results Page” in Global Settings.