=== Quiz Builder for WooCommerce - Product Recommendations ===
Contributors: revenuehunt
Donate link: https://revenuehunt.com/
Tags: quiz, product recommendation, woocommerce, ecommerce, personalization
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.5.6
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Turn WooCommerce shoppers into leads and buyers with an interactive product recommendation quiz builder.

== Description ==

Build beautiful, high-converting product recommendation quizzes — no coding needed.  
RevenueHunt helps you guide every shopper to their perfect product, collect valuable data, and drive measurable results across your WooCommerce store and marketing channels.

[youtube https://www.youtube.com/watch?v=a3KnrwSooao]

Create quizzes with our **AI-powered quiz builder**, gain insights into your customers’ preferences, and sync results with your mailing list or CRM to launch high-ROI marketing campaigns.  
Start creating personalized shopping experiences that boost engagement, conversions, and loyalty.

**WHAT YOU'LL ACHIEVE**

1. **Boost sales** by guiding customers to their perfect products on the first visit.  
2. **Recover abandoned carts** by sending personalized quiz results straight to their inbox.  
3. **Grow your audience** by capturing and syncing leads with your mailing list or CRM.  
4. **Save time on support** by helping shoppers understand your products before they buy.
5. **Reduce returns** by helping customers choose the products that truly fit their needs.  

**HOW IT WORKS**

Think of it as having a **digital personal shopper** in your WooCommerce store. The quiz asks customers a few tailored questions, analyzes their responses, and recommends the best products — complete with personalized explanations that build trust and increase conversions.

Our top-performing merchants use the quiz as the **first step of their automated sales funnel**. It helps them capture leads, segment their audience, and send targeted campaigns that drive repeat purchases. (Highly segmented campaigns can deliver over [3x more revenue per recipient](https://www.klaviyo.com/marketing-resources/segmentation-benchmark-report "Klaviyo Segmentation Benchmark Report") than unsegmented ones!)

**EASY TO SET UP AND CUSTOMIZE**

With our visual quiz builder, you can:

* Define your own questions and answers  
* Personalize product recommendations and messages  
* Style your quiz to match your brand  
* Display it as a popup, inline block, or automatic embed  

**FEATURES THAT DRIVE RESULTS**

* **Plug & Play** – Install and start converting more visitors in minutes.  
* **Conditional Logic** – Ask only the most relevant questions to each customer.  
* **Lead Capture** – Collect emails and sync them automatically with your CRM.  
* **Integrations** – Connect to Klaviyo, HubSpot, Mailchimp, Google Analytics, Zapier, and more.  
* **Mobile Ready** – Works perfectly across all devices and browsers.  

**PERFECT FOR**

* Skincare, Beauty & Cosmetics  
* Nutrition, Vitamins & Supplements  
* Apparel, Jewelry & Accessories  
* Sports, Outdoor & Lifestyle Brands  
* Gifts, Specialty & Subscription Products  

**INTEGRATIONS**

Easily connect with your favorite tools like Google Analytics, Klaviyo, HubSpot, Mailchimp, and hundreds more via [Zapier](https://zapier.com/ "Connect your apps and automate workflows").

== See the plugin in action ==

See how your customers will experience it in our [product recommendation quiz demo store](https://productrecommendationquiz.com/ "Demo Product Recommendation Quiz Store").  
Or try building your own quiz for free on a [test site](https://tastewp.com/template/d2pbbNMPvZg "Demo WooCommerce Dashboard").

== Installation ==

**MINIMUM REQUIREMENTS**

* The [WooCommerce](https://wordpress.org/plugins/woocommerce/ "Open-source eCommerce for WordPress") plugin must be installed and activated.  
* Works with WooCommerce version 3.5 or higher.  
* Your site must have a valid HTTPS/SSL certificate.  
* Not compatible with local/development environments.  

**WALKTHROUGH**

1. Install and activate WooCommerce.  
2. Install and activate this plugin through the “Plugins” screen in WordPress.  
3. In your dashboard, open the **Product Quiz** tab.  
4. Grant permissions to connect with your WooCommerce store.  
5. Follow the **Success Checklist** to create and publish your quiz.  
6. Share your quiz and start turning visitors into customers.  

**MANUAL INSTALLATION**

Download the latest version [here](https://revenuehunt.com/product-recommendation-quiz-woocommerce/ "Product Recommendation Quiz for eCommerce").  
Upload the ZIP file via **Plugins → Add New → Upload Plugin → Install Now** in your WordPress dashboard.  

== Frequently Asked Questions ==

Visit our [FAQs page](https://revenuehunt.com/faqs/ "Frequently Asked Questions") for setup guidance and troubleshooting.

== Screenshots ==

1. Quiz Builder – Create questions that guide your customers to the right products.  
2. Design – Match your quiz to your store’s look and feel.  
3. Publish – Embed the quiz as a popup, inline, or automatic display.  
4. Integrate – Connect your quiz to CRMs, mailing lists, or Zapier.  
5. Analytics – Review responses and export results as CSV.  
6. Mobile friendly – Looks great on all devices and browsers.  
7. Lead capture – Collect emails and grow your audience.  
8. Cart integration – Link recommendations directly to your WooCommerce cart.

== External services ==

This plugin connects to RevenueHunt to build and serve your product recommendation quiz. It relies on these external services:

1. Quiz widget — On your storefront the plugin loads the quiz script from https://admin.revenuehunt.com/embed.js. When a shopper interacts with the quiz, their answers are sent to RevenueHunt to compute and display product recommendations. The script is not loaded on cart or checkout pages.
2. Connection check — From the plugin's admin page only, your store domain is sent to https://api.revenuehunt.com/api/v1/woocommerce/check to verify that your store's REST API is reachable during setup.
3. Account connection — During setup, your store's WooCommerce API credentials and connection identifiers are exchanged with RevenueHunt's servers to link your store to your RevenueHunt account.

Data is sent to RevenueHunt only as needed to provide the quiz. For details, see RevenueHunt's Privacy Policy (https://revenuehunt.com/privacy/), Terms of Service (https://revenuehunt.com/tos/), and Security overview (https://revenuehunt.com/security/).

== Changelog ==

= 2.5.6 =
* Dev - Marked the quiz block and shortcode rendering as reviewed for the security scanner; attributes are sanitized and output-escaped (no functional change).

= 2.5.1 =
* Fix - Sanitize quiz block and shortcode attributes at render time to harden against potential cross-site scripting.

= 2.5.0 =
* New - Capture the connecting store operator (the logged-in WordPress admin) as a contact, in addition to the store email.

= 2.4.0 =
* New - Place the quiz inline anywhere with the [product_recommendation_quiz] shortcode or the new "Product Recommendation Quiz" block in the block editor.
* New - "Full width quiz" option on the inline block/shortcode makes a placed quiz break out of the content column and span the full width of the screen.
* New - WordPress Site Health now reports the plugin's prerequisites (permalink structure, HTTPS, WPML compatibility and REST API reachability), so issues are easy to spot in the standard place.
* Dev - Declared compatibility with the WooCommerce Cart and Checkout Blocks, so the plugin shows as compatible and is not flagged.
* Dev - Placement is built on a delivery-agnostic seam and a pluggable connection layer that future editions reuse.

= 2.3.10 =
* New - The plugin's admin screens, setup flow and error notices are now fully translatable, so they display in your WordPress language wherever a translation exists (community translations via translate.wordpress.org).
* Dev - Internationalization pass: admin sentences are now single, whole translatable strings (no fragments), the translation template regenerates from source in the build, and CI guards translation freshness.

= 2.3.9 =
* Fix - Hardened rate limiting on the connection endpoints (throttle by server-verified IP; ignore the spoofable X-Forwarded-For header unless a proxy is explicitly trusted; no fail-open when the IP is unknown)
* Fix - Deactivating the plugin no longer deletes your connection credentials; only uninstalling does
* Fix - Connection credentials are now format-validated, and the plugin sends a fixed user-agent to its API instead of forwarding the visitor's
* Dev - The WordPress and WooCommerce editions now build from a single shared source; external services are now documented in the readme

= 2.3.7 =
* Dev - Refreshed plugin intro video on the WordPress.org listing

= 2.3.6 =
* Dev - Tested up to WooCommerce 10.7.0

= 2.3.5 =
* Dev - Replace raw cURL with WordPress HTTP API (wp_remote_post) for better hosting compatibility
* Dev - Use wp_parse_url() for cross-PHP-version URL parsing consistency
* Dev - Prefix REST API callback functions to align with WordPress.org naming conventions

= 2.3.4 =
* Dev - tested up to WP 7.0
* Dev - PHP 8.5 compatibility (avoid redundant curl_close on PHP 8.5+)

= 2.3.3 =
* Fix - Skip loading embed.js on WooCommerce checkout and cart pages to prevent connection timeouts from blocking critical shopping pages
* Fix - Load embed.js with async attribute so a slow or failed connection to RevenueHunt servers never blocks page rendering

= 2.3.2 =
* Fix - Exclude .dev TLD from local development detection patterns (.dev is a legitimate production domain owned by Google)

= 2.3.1 =
* Fix - OAuth authorization showing localhost.run URL on production sites when WP_ENVIRONMENT_TYPE is set to 'development' or 'local'

= 2.3.0 =
* Refactor - Code refactoring, security improvements, and enhanced maintainability

= 2.2.14 =
* Dev - tested up to WP 6.8.3 and WooCommerce up to Version 10.2.2

= 2.2.13 =
* Dev - tested up to WP 6.8.1 and WooCommerce up to Version 9.8.5

= 2.2.12 =
* Dev - improve compatibility

= 2.2.11 =
* Dev - tested up to WP 6.7.2 and WooCommerce up to Version 9.7.1

= 2.2.10 =
* Dev - tested up to WP 6.7.1

= 2.2.9 =
* Fix - page level auth

= 2.2.8 =
* Dev - tested up to WP 6.6.1

= 2.2.7 =
* Dev - tested up to WP 6.5.2

= 2.2.6 =
* Fix - http_build_query bug

= 2.2.5 =
* Dev - Check WPML version

= 2.2.4 =
* Dev - Plain permalinks warning

= 2.2.3 =
* Dev - link to FAQs article

= 2.2.2 =
* Fix - vulnerability issue

= 2.1.2 =
* Fix - vulnerability issue

== Upgrade Notice ==

= 2.3.0 =
Major refactor release with code refactoring, security improvements, and enhanced maintainability. Recommended for all users.

= 2.2.14 =
Tested up to WP 6.8.3 and WooCommerce up to Version 10.2.2. Recommended update for compatibility.