Description
Selfscovery turns a short survey into a ranked recommendation: a product finder for a store, a menu guide for a restaurant, a “which plan is right for you” page for a service.
Quizzes are designed in the Selfscovery app on your computer, tablet, or phone, where its AI tools can use your device and your own AI account. This plugin is the WordPress side:
- Publish from the app. The app connects to your site with a WordPress Application Password. Publishing a quiz again updates it everywhere it appears.
- Drag quizzes into pages. Every published quiz appears in the block inserter under its own name. Drag it into place like any other block.
- Shortcode for everything else. Classic themes and page builders can use
[selfscovery_quiz id="123"]. - Built for WooCommerce stores. When WooCommerce is active, the app can read your products, with your permission, to build quizzes that recommend them.
- Analytics on your own site. See how many visitors start and finish each quiz, where they drop off, which results they get and click, which attributes they lean toward or pass on, and, with WooCommerce, the orders and sales that followed. Everything is stored in your own database as anonymous daily counts.
- Live rankings from your store. A quiz built from your WooCommerce store ranks every product each time a visitor finishes, so new and changed products count straight away; there’s nothing to set up. Visitors only send their answers and see the top results.
- Its own quiz player. Quizzes play in the player included in this plugin. The app sends only each quiz’s content (questions, answers, results, images, colours), never code.
- Isolated and fast. Each quiz runs in a sandboxed frame with its own styles, so it cannot read visitor cookies or clash with your theme. It loads only where it is placed.
How it works
- Install and activate the plugin.
- Open Selfscovery in wp-admin and choose Open Selfscovery (or open the app and choose WordPress).
- Approve the connection when WordPress asks. The app receives its own Application Password, which you can revoke at any time under Users → Profile.
- Publish a quiz from the app, then add it to a page from the block inserter.
Privacy
This plugin does not store personal data and does not contact outside services.
Quiz statistics are anonymous daily counts kept in your site’s database: how many visitors started and finished a quiz, which questions they reached, which answers and results were chosen or shown, and which result links were clicked. Typed answers are never sent. To limit abuse, the visitor’s IP address is used, as a salted hash held for ten minutes, to cap how many events one address can send; it is not stored with the statistics.
With WooCommerce active, following a quiz result link into the store adds the quiz (and result) to WooCommerce’s shopping session, which uses WooCommerce’s session cookie, and a resulting order records which quiz it came from. Statistics can be turned off under Selfscovery → Analytics.
Deleting the plugin removes its statistics table and settings.
FAQ
Do I need the Selfscovery app?
Yes. Quizzes are built in the Selfscovery app, which is free to download and free to build with; publishing from it to WordPress is part of the app’s Selfscovery Pro subscription, which starts with a free month. Everything in this plugin is free and stays on: quizzes already published keep working, with live rankings and analytics, whether or not anyone has a subscription.
Does the plugin send data anywhere?
No. Quizzes, any images inside them, and quiz statistics are stored on your own site, and the plugin makes no outside requests. The Selfscovery app talks to your site through the WordPress REST API using the Application Password you approve.
How do live rankings stay safe?
A visitor’s request carries only attribute names and weights; names the quiz doesn’t use are dropped, and the plugin writes its own queries against WooCommerce’s product tables, reading only published products that are visible in the catalogue. Only administrators can publish quizzes that rank live, and only pages on your own site can ask for a ranking. Requests are rate limited, at most four rankings run at once, answers are cached for five minutes, and if anything fails the quiz shows its saved results. Turn live rankings off at any time under Selfscovery → Live rankings.
Does a live store quiz need any setup?
No. A quiz built from this site’s WooCommerce store in the app ranks the store directly, using WooCommerce’s own product tables, as soon as it is published here with Live results on. It only reads published products that are visible in the catalogue, and any product you leave out in the app never appears.
Can a quiz rank a database table live?
Quizzes built in the app from a MySQL, MariaDB, Postgres or Snowflake table show their saved results here. To rank the whole table live, install the separate, free Selfscovery Live Databases plugin from selfscovery.com, which adds read-only database logins to Selfscovery → Live rankings.
What do quiz statistics record?
Daily counts per quiz: starts, questions seen and answered, answers chosen, attributes offered and chosen, results shown, and result links clicked. Nothing identifies a visitor, what visitors type is never sent, and the plugin sets no cookies of its own. With WooCommerce, a visitor who follows a quiz result into your store is noted in WooCommerce’s shopping session, so their add to carts and a paid order can be credited to that quiz. Turn statistics off under Selfscovery → Analytics, or with the adlegiant_collect_stats filter; adlegiant_attribute_sales turns off only the order crediting.
Who can publish quizzes?
Users who can publish unfiltered HTML (administrators on most sites), because a published quiz appears on the site’s pages as it was built. Developers can change this with the adlegiant_publish_capability filter. Anyone who can edit posts can place published quizzes on pages.
Why are Application Passwords unavailable on my site?
WordPress offers Application Passwords on sites served over HTTPS, and on local development sites. Some security plugins also turn them off.
Can a quiz be embedded on another website?
By default quizzes can only be framed by your own site. Developers can allow other origins with the adlegiant_frame_ancestors filter.
What happens to quizzes if I delete the plugin?
Deleting the plugin removes its published quizzes and their files. Pages that showed a quiz keep their other content.
Screenshots
Changelog
0.9.0
- Quizzes play in the player included in the plugin. The app now sends only each quiz’s content, never code; quizzes published earlier play in the new player too, with nothing to do.
- Live rankings from database tables (MySQL, MariaDB, Postgres and Snowflake) moved to the separate, free Selfscovery Live Databases plugin. This plugin makes no outside requests.
0.8.0
- Live rankings and the analytics screen are always on. They no longer depend on the Selfscovery app’s subscription, so the plugin works fully on every site.
0.7.0
- Live rankings and analytics followed the Selfscovery app’s subscription (removed in 0.8.0).
0.6.0
- Live rankings from this site’s own WooCommerce store, with no login to set up. A quiz built from the store in the app ranks every published product when a visitor finishes it: categories (with the categories below them), tags, global attributes, Featured, On sale, In stock, Lower price, Highly rated and Best sellers. New products count straight away.
- Budget answers: a quiz can ask for a price range, and live store rankings leave out products outside it.
0.5.0
- Live rankings from Snowflake. Add a Snowflake login under Selfscovery → Live rankings: the site makes its own key and writes the SQL to run once in Snowsight, which creates a read-only role and a service user that can sign in only with that key. No passwords or tokens are stored.
0.4.1
- Live rankings: the Live rankings screen shows what happened the last time each live quiz was finished, a live quiz shows at most its Top N database rows even when it falls back to saved results, and sites reached over both http and https are recognized as the same site.
0.4.0
- Live rankings: quizzes built from a MySQL, MariaDB or Postgres table can rank the whole table when a visitor finishes, through a read-only login added under Selfscovery → Live rankings. Quizzes fall back to their saved results whenever the database can’t answer.
- A warning for administrators when the server’s PHP version may have the critical flaws reported in October 2026 (CVE-2026-109618 and CVE-2026-109619).
0.3.1
- Analytics count add to carts by shoppers who came from a quiz, alongside store visits and orders.
0.3.0
- Analytics (Selfscovery → Analytics, and in the app): starts, completions, drop-off by question, results shown and clicked, attributes visitors lean toward or pass on, and WooCommerce orders and sales from quiz visitors, for all quizzes or one.
- Statistics are anonymous daily counts in your own database, with a setting to turn them off and a button to clear them.
- Quizzes published from earlier app versions are flagged so you can publish them again to start counting.
0.2.0
- Start in the app straight from WordPress: build a quiz from your WooCommerce products, build a new quiz, or publish one.
- Quiz blocks stop growing at 720px by default (and never pass 90% of the screen); longer quizzes scroll inside the block. Turn off “Limit height” or set
max_height="0"on the shortcode to let a quiz grow to fit. - Moving to the next question starts it at the top, and brings the quiz back into view if the page had scrolled past it.
- A quiz published from the app is highlighted on the Selfscovery screen, with a button to place it on a new page.
- The block editor picks up newly published quizzes without reloading, and the quiz block can open the Selfscovery app.
- The app learns the admin address from the site, so sites with WordPress in a subdirectory open the right page.
0.1.0
- First release: publishing from the Selfscovery app, quiz block with one inserter entry per quiz, shortcode, and draft page creation.



