{"id":366638,"date":"2026-09-14T23:51:47","date_gmt":"2026-09-14T23:51:47","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/wpc-smart-quiz\/"},"modified":"2026-09-15T02:44:58","modified_gmt":"2026-09-15T02:44:58","slug":"wpc-shop-quiz","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/wpc-shop-quiz\/","author":14634412,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.2.0","stable_tag":"1.2.0","tested":"7.1","requires":"5.9","requires_php":"7.4","requires_plugins":null,"header_name":"WPC Shop Quiz - Product Finder for WooCommerce","header_author":"WPClever","header_description":"Guided selling quiz builder \u2014 help shoppers find the right product through interactive question flows with visual choices & smart result mapping.","assets_banners_color":"b66a9c","last_updated":"2026-09-15 02:44:58","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/wpclever.net","header_plugin_uri":"https:\/\/wpclever.net\/","header_author_uri":"https:\/\/wpclever.net","rating":0,"author_block_rating":0,"active_installs":0,"downloads":42,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.2":{"tag":"1.0.2","author":"wpclever","date":"2026-09-14 23:51:22","revision":3696038},"1.2.0":{"tag":"1.2.0","author":"wpclever","date":"2026-09-15 02:44:58","revision":3696117}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3696117,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3696117,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2","1.2.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[203858,11882,12852,583,286],"plugin_category":[45,53],"plugin_contributors":[84934],"plugin_business_model":[],"class_list":["post-366638","plugin","type-plugin","status-publish","hentry","plugin_tags-guided-selling","plugin_tags-product-recommendation","plugin_tags-product-finder","plugin_tags-quiz","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_category-ratings-and-reviews","plugin_contributors-wpclever","plugin_committers-wpclever"],"banners":{"banner":"https:\/\/ps.w.org\/wpc-shop-quiz\/assets\/banner-772x250.png?rev=3696117","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/wpc-shop-quiz\/assets\/icon-128x128.png?rev=3696117","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p><strong>WPC Shop Quiz<\/strong> 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.<\/p>\n\n<p>From skincare routines and electronics bundles to fashion fits and gift guides, Shop Quiz provides a structured discovery flow tailored to your product catalog.<\/p>\n\n<h4>Live demo<\/h4>\n\n<p>Visit our <a href=\"https:\/\/demo.wpclever.net\/wpckid\/looking-for-an-ideal-gift\/\" title=\"live demo\">live demo<\/a> to see how this plugin works.<\/p>\n\n<h4>Overview<\/h4>\n\n<ul>\n<li><strong>Visual quiz builder<\/strong> \u2014 drag-and-drop interface, no coding needed.<\/li>\n<li><strong>Two recommendation engines<\/strong> \u2014 Weighted Scoring for large catalogs, Direct Mapping for precise control.<\/li>\n<li><strong>Conditional Logic<\/strong> \u2014 branching flows that skip irrelevant questions and create a unique path for each user.<\/li>\n<li><strong>Built-in lead capture<\/strong> \u2014 Email Gate collects guest emails before revealing results.<\/li>\n<li><strong>Smart coupons<\/strong> \u2014 auto-generated, deduplicated, email-restricted WooCommerce coupons as quiz incentives.<\/li>\n<li><strong>Outbound webhooks<\/strong> \u2014 integrate with any CRM, email platform, or automation tool in real time.<\/li>\n<li><strong>Performance-first<\/strong> \u2014 result caching and non-blocking AJAX calls.<\/li>\n<\/ul>\n\n<h4>Key Features<\/h4>\n\n<ul>\n<li>Drag-and-drop quiz builder with unlimited steps and answers<\/li>\n<li>Question types: Single Choice, Multi Choice, Image Choice, Multi Image Choice<\/li>\n<li>Visual answer cards with images, icons, and custom labels<\/li>\n<li>Welcome Screen with customizable heading, description, and Start button<\/li>\n<li>Conditional Logic with show\/skip rules per step<\/li>\n<li>Two result modes: Weighted Scoring &amp; Direct Mapping<\/li>\n<li>Advanced scoring: attributes, categories, tags, price range, ratings, sale status, stock level<\/li>\n<li>Auto-generated WooCommerce coupons with abuse prevention<\/li>\n<li>Email Gate for guest lead capture<\/li>\n<li>Shareable quiz results via unique URLs<\/li>\n<li>Outbound Webhooks with HMAC-SHA256 signatures<\/li>\n<li>Result caching with configurable TTL<\/li>\n<li>Six built-in color themes + custom primary color<\/li>\n<li>Slide &amp; fade transition effects<\/li>\n<li>Responsive design (mobile, tablet, desktop)<\/li>\n<li>Builder preview with device switcher<\/li>\n<li>Floating quiz button for global site-wide access<\/li>\n<li>Shortcode &amp; popup modal display modes<\/li>\n<li>HPOS (High-Performance Order Storage) compatible<\/li>\n<li>Translation ready with full RTL support<\/li>\n<li>Quiz analytics &amp; conversion tracking (Premium)<\/li>\n<li>REST API for headless integrations (Premium)<\/li>\n<\/ul>\n\n<h4>Not what you needed?<\/h4>\n\n<p>Please try other plugins from us:<\/p>\n\n<ul>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/woo-product-bundle\/\" title=\"WPC Product Bundles\">WPC Product Bundles<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wpc-composite-products\/\" title=\"WPC Composite Products\">WPC Composite Products<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wpc-grouped-product\/\" title=\"WPC Grouped Product\">WPC Grouped Product<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/woo-bought-together\/\" title=\"WPC Frequently Bought Together\">WPC Frequently Bought Together<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/wpc-force-sells\/\" title=\"WPC Force Sells\">WPC Force Sells<\/a><\/li>\n<\/ul>\n\n<h3>\ud83e\udde0 Recommendation Engine<\/h3>\n\n<p>Shop Quiz offers two distinct recommendation modes, each designed for a different catalog strategy.<\/p>\n\n<p><strong>Weighted Scoring<\/strong>\nEach answer assigns points to product properties \u2014 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.<\/p>\n\n<ul>\n<li>No manual product mapping required \u2014 suitable for catalogs with 50+ products<\/li>\n<li>Score criteria: WooCommerce attributes, product categories, product tags, price ranges, customer ratings (1-5 stars), on-sale status, stock quantity thresholds<\/li>\n<li>Products are ranked by total accumulated score across all answers<\/li>\n<li>Admin can configure weight values per answer option<\/li>\n<\/ul>\n\n<p><strong>Direct Mapping<\/strong>\nFor 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.<\/p>\n\n<ul>\n<li>Precise control over which products appear for which answer combinations<\/li>\n<li>Suitable for small catalogs or curated product lines<\/li>\n<li>Simple \"if this, then that\" configuration<\/li>\n<\/ul>\n\n<h3>\ud83d\udd00 Conditional Logic<\/h3>\n\n<p>Not every customer should answer every question. Conditional Logic creates personalized, branching quiz flows:<\/p>\n\n<ul>\n<li><strong>Show rule:<\/strong> Display a step only when a condition matches (e.g., show \"Skin concerns\" only if user selected \"Skincare\" in step 1)<\/li>\n<li><strong>Skip rule:<\/strong> Always skip a step when a condition matches (e.g., skip \"Budget\" for returning customers)<\/li>\n<li>Conditions reference any previous step's selected answer(s)<\/li>\n<li>Multiple conditions per step with AND\/OR logic<\/li>\n<li>Steps are recalculated dynamically after each answer \u2014 the progress bar and step count update in real time<\/li>\n<\/ul>\n\n<p><strong>How it works:<\/strong><\/p>\n\n<ol>\n<li>Admin sets rules per step in the quiz builder (e.g., \"Show this step only if Step 1 answer = 'Outdoor'\")<\/li>\n<li>After each answer, the engine recalculates which steps are visible<\/li>\n<li>Skipped steps are hidden from the progress bar and navigation<\/li>\n<li>The quiz flow adapts dynamically to each user's answers<\/li>\n<\/ol>\n\n<h3>\ud83d\udc4b Welcome Screen<\/h3>\n\n<p>An optional branded landing screen that appears before the first question, setting context and expectations.<\/p>\n\n<p><strong>Configuration:<\/strong>\n* Toggle: Enable \/ Disable per quiz\n* Customizable heading (default: \"Find Your Match\")\n* Customizable description (default: \"Answer a few quick questions\u2026\")\n* Customizable Start button text (default: \"Start Quiz\")\n* Placeholder text auto-fills when fields are left blank\n* Displayed in both live quizzes and builder preview<\/p>\n\n<p><strong>Navigation behavior:<\/strong>\n* Clicking \"Start Quiz\" fades out the welcome screen and reveals the first question\n* At Step 1, a \"Back\" button navigates back to the Welcome Screen\n* Quiz Starts are only counted when the user clicks \"Start Quiz\" \u2014 not on page load<\/p>\n\n<h3>\ud83c\udf9f\ufe0f Smart Coupon Incentives<\/h3>\n\n<p>Reward quiz completions with auto-generated WooCommerce coupons. The coupon system is designed to provide incentives while preventing abuse.<\/p>\n\n<p><strong>Coupon features:<\/strong>\n* Auto-generated unique codes with configurable prefix (e.g., <code>QUIZ-A3KF9B<\/code>)\n* Discount type: percentage or fixed amount\n* Individual use enforcement (cannot combine with other coupons)\n* 30-day expiration\n* Usage limit: 1 per coupon<\/p>\n\n<p><strong>Anti-abuse deduplication:<\/strong>\nThe system checks three identity layers before generating a new coupon:<\/p>\n\n<ol>\n<li><strong>User ID<\/strong> \u2014 for logged-in customers, checks if they already have an active coupon for this quiz<\/li>\n<li><strong>Email<\/strong> \u2014 for guests with Email Gate, checks by email address<\/li>\n<li><strong>Session key<\/strong> \u2014 for anonymous guests, checks by browser session<\/li>\n<\/ol>\n\n<p>If an active (unused, unexpired) coupon is found \u2192 the existing code is returned instead of creating a new one.<\/p>\n\n<p><strong>Cart validation:<\/strong>\nQuiz 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.<\/p>\n\n<h3>\ud83d\udce7 Email Gate<\/h3>\n\n<p>Capture guest emails as a lead generation tool before showing quiz results.<\/p>\n\n<p><strong>Behavior:<\/strong>\n* Only appears for <strong>non-logged-in visitors<\/strong> \u2014 logged-in users bypass automatically\n* Always visible in <strong>admin Preview mode<\/strong> for testing\n* Validates email format before allowing submission\n* Captured emails are stored and associated with the quiz session<\/p>\n\n<p><strong>Integration with coupons:<\/strong>\nWhen both Email Gate and coupons are active, the coupon is automatically restricted to the captured email address \u2014 preventing coupon sharing.<\/p>\n\n<h3>\ud83d\udd17 Shareable Results<\/h3>\n\n<p>Users can share their quiz results with friends via a unique URL.<\/p>\n\n<p><strong>How it works:<\/strong>\n* After completing a quiz, a \"Share Results\" button generates a unique link\n* The shared page shows the same product recommendations\n* Each share records: quiz ID, answers, recommended products, user email (if captured), and timestamp\n* Admin can view all shared pages in a dedicated management table<\/p>\n\n<p><strong>Guest tracking:<\/strong>\nWhen a guest with Email Gate shares results, their email is displayed alongside the share record for reference.<\/p>\n\n<h3>\ud83d\udd0c Webhooks &amp; REST API<\/h3>\n\n<p>Integrate Shop Quiz with any external system through real-time webhooks and a RESTful API.<\/p>\n\n<p><strong>Outbound Webhooks<\/strong>\nConfigure a single webhook URL to receive POST requests with structured JSON payloads for three events:<\/p>\n\n<ul>\n<li><code>quiz.completed<\/code> \u2014 fires when a user finishes a quiz (includes quiz ID, answers, recommended products, user data)<\/li>\n<li><code>quiz.conversion<\/code> \u2014 fires when a recommended product is added to cart (includes product details, session)<\/li>\n<li><code>quiz.coupon_used<\/code> \u2014 fires when a quiz-generated coupon is redeemed (includes coupon details, discount amount)<\/li>\n<\/ul>\n\n<p><strong>Security:<\/strong>\n* HMAC-SHA256 signature in <code>X-WPCSQ-Signature<\/code> header for payload verification\n* Unique delivery ID in <code>X-WPCSQ-Delivery<\/code> header\n* Plugin version in <code>X-WPCSQ-Plugin-Version<\/code> header\n* Async dispatch via WP-Cron \u2014 webhooks never block the user's request<\/p>\n\n<p><strong>REST API:<\/strong>\nFull CRUD endpoints under <code>wpcsq\/v1\/<\/code> for quizzes, submissions, and results \u2014 suitable for headless WooCommerce implementations.<\/p>\n\n<h3>\ud83c\udfa8 Themes &amp; Customization<\/h3>\n\n<p>Six built-in color themes with a custom color override:<\/p>\n\n<ul>\n<li><strong>Default<\/strong> \u2014 Indigo (#6366f1)<\/li>\n<li><strong>Emerald<\/strong> \u2014 Green (#10b981)<\/li>\n<li><strong>Rose<\/strong> \u2014 Pink (#f43f5e)<\/li>\n<li><strong>Amber<\/strong> \u2014 Orange (#f59e0b)<\/li>\n<li><strong>Cyan<\/strong> \u2014 Blue (#06b6d4)<\/li>\n<li><strong>Slate<\/strong> \u2014 Gray (#64748b)<\/li>\n<li><strong>Custom<\/strong> \u2014 any hex color via color picker<\/li>\n<\/ul>\n\n<p><strong>Transitions:<\/strong>\n* Slide \u2014 horizontal slide with direction awareness (left\/right)\n* Fade \u2014 smooth opacity transition<\/p>\n\n<p><strong>Display modes:<\/strong>\n* Inline shortcode: <code>[wpcsq_quiz id=\"123\"]<\/code> \u2014 renders directly on the page\n* Popup modal: <code>[wpcsq_btn id=\"123\"]<\/code> \u2014 click-to-open modal overlay\n* Floating button: global quiz accessible from any page<\/p>\n\n<h3>\ud83d\udccb Shortcodes<\/h3>\n\n<h4>[wpcsq_quiz]<\/h4>\n\n<p>Render a quiz inline on any page or post.<\/p>\n\n<pre><code>[wpcsq_quiz id=\"123\"]\n<\/code><\/pre>\n\n<h4>[wpcsq_btn]<\/h4>\n\n<p>Render a clickable button that opens the quiz in a modal overlay.<\/p>\n\n<pre><code>[wpcsq_btn id=\"123\"]\n<\/code><\/pre>\n\n<p>Supports <code>text<\/code> attribute for custom button label:\n    [wpcsq_btn id=\"123\" text=\"Find your match \u2192\"]<\/p>\n\n<h4>[wpcsq_share]<\/h4>\n\n<p>Render shared quiz results on a designated share page.<\/p>\n\n<pre><code>[wpcsq_share]\n<\/code><\/pre>\n\n<p>Place this shortcode on the page selected as \"Share Results Page\" in Global Settings.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Ensure WooCommerce is installed and activated.<\/li>\n<li>Upload the plugin folder to <code>\/wp-content\/plugins\/<\/code> or install via <strong>Plugins &gt; Add New<\/strong>.<\/li>\n<li>Activate the plugin through the <strong>Plugins<\/strong> menu.<\/li>\n<li>Go to <strong>WP-admin &gt; Shop Quiz<\/strong> to create your first quiz.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"how%20does%20the%20scoring%20engine%20recommend%20products%3F\"><h3>How does the scoring engine recommend products?<\/h3><\/dt>\n<dd><p>In Weighted Scoring mode, each answer assigns points to product properties (attributes, categories, tags, price range, ratings, etc.). When the quiz completes, every product in your catalog is scored and the top-scoring products are recommended. In Direct Mapping mode, each answer maps directly to specific products.<\/p><\/dd>\n<dt id=\"can%20i%20create%20branching%20quiz%20flows%3F\"><h3>Can I create branching quiz flows?<\/h3><\/dt>\n<dd><p>Yes. Conditional Logic lets you show or skip steps based on previous answers. For example, show a \"Skin concerns\" step only if the user selected \"Skincare\" in the first question. Steps are recalculated in real time after each answer.<\/p><\/dd>\n<dt id=\"how%20does%20the%20coupon%20system%20prevent%20abuse%3F\"><h3>How does the coupon system prevent abuse?<\/h3><\/dt>\n<dd><p>Coupons are deduplicated by user ID, email, and session key. Retaking the quiz returns the same active coupon instead of generating a new one. Additionally, coupons are email-restricted (when Email Gate is active) and cart-validated (only work with quiz-recommended products in the cart).<\/p><\/dd>\n<dt id=\"when%20is%20a%20%22quiz%20start%22%20counted%3F\"><h3>When is a \"Quiz Start\" counted?<\/h3><\/dt>\n<dd><p>Starts are only counted when the user takes a meaningful action \u2014 clicking \"Start Quiz\" on the Welcome Screen, or clicking \"Next\" on the first question. Simply loading the page does not count as a start.<\/p><\/dd>\n<dt id=\"can%20i%20test%20my%20quiz%20before%20publishing%3F\"><h3>Can I test my quiz before publishing?<\/h3><\/dt>\n<dd><p>Yes. The built-in Preview mode renders your quiz exactly as customers see it, with a device switcher for desktop, tablet, and mobile views. Welcome Screen and Email Gate are both visible in preview mode.<\/p><\/dd>\n<dt id=\"is%20it%20compatible%20with%20page%20builders%3F\"><h3>Is it compatible with page builders?<\/h3><\/dt>\n<dd><p>Yes. Shop Quiz works via shortcodes (<code>[wpcsq_quiz]<\/code>, <code>[wpcsq_btn]<\/code>) which are compatible with Elementor, WPBakery, Gutenberg, and any page builder that supports shortcodes.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20hpos%3F\"><h3>Does it work with HPOS?<\/h3><\/dt>\n<dd><p>Yes, the plugin is fully compatible with WooCommerce High-Performance Order Storage (HPOS).<\/p><\/dd>\n<dt id=\"how%20does%20result%20caching%20work%3F\"><h3>How does result caching work?<\/h3><\/dt>\n<dd><p>When caching is enabled, identical answer combinations return cached product results instead of recalculating scores. Cache TTL is configurable from 1 hour to 7 days. Coupons are never cached \u2014 they always run through the deduplication logic.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Updated: Optimized the code<\/li>\n<li>Updated: Compatible with WP 7.1 &amp; Woo 11.1<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Fix: Add nonce verification and quiz recommendation validation for cart items and referrals.<\/li>\n<li>Fix: Update popup shortcode to [wpcsq_btn] in documentation.<\/li>\n<li>Update: Add Requires PHP header (7.4).<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Update: Rename plugin to WPC Shop Quiz.<\/li>\n<li>Fix: Add permission callback check for REST API submit endpoint.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"Guided selling quiz builder \u2014 help shoppers find the right product through interactive question flows with visual choices &amp; smart result mapping.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/366638","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=366638"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/wpclever"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=366638"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=366638"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=366638"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=366638"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=366638"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=366638"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}