Elektilo - Product Finder Quiz for WooCommerce

Elektilo adds a guided "help me choose" quiz to any page with the [elektilo] shortcode. Shoppers answer a short series of single-choice questions and are shown one recommended product, with its image, price and a button straight to the product page. A simple product also gets WooCommerce's own add-to-cart button on the card. Elektilo is developed in the open. The code, and a place to report bugs or request features, live at github.com/wppoland/plogins-finder. You define the questions and options, then map every answer combination to a product. A "Generate combinations" button builds the map for you from your steps, so you only pick a product for each path. Set a step to "Any" in a row and that one row covers every answer to it, so a quiz where only some answers matter needs far fewer rows. Documentation and links

• Documentation: plogins.com/plogins-finder/docs/
• Plugin page: plogins.com/plogins-finder/
• Source code: github.com/wppoland/plogins-finder
• Bug reports and feature requests: github.com/wppoland/plogins-finder/issues

Built for speed and accessibility

• No jQuery in the plugin's own front-end code, the script is vanilla JS, deferred and loaded in the footer.
• No layout shift (CLS). Space is reserved for each step and the result card, so advancing never reflows the page. The recommendation image is prioritised for a fast LCP.
• REST-powered result. The recommendation is fetched from a lightweight REST endpoint (not admin-ajax), read live so price and stock are always current, and never cached.
• Keyboard friendly. Real radio groups, a live progress bar, visible focus styles, a Back button and full keyboard operability.
• Resumable and shareable. The current step and answers are kept in the URL and per-tab storage, so a refresh keeps your place and a fully-answered link opens straight on the result.

Settings A WooCommerce-capability settings page (Elektilo menu) lets you:

• Enable or disable the quiz, set the heading, sub-heading and accent colour, and choose whether the price shows on the result card.
• Build the steps: each step is one question with single-choice options; the option "value" is a short slug used to identify the answer.
• Map results: generate one row per answer combination from your steps, then pick the recommended product for each, with an optional headline, description and button label. Set any step in a row to "Any" to cover all of its answers: an exact row wins, then the row with the fewest "Any" steps, then the row higher in the list. An at-a-glance callout shows how many combinations still need a product.
• Set a fallback product shown when no combination matches or a mapped product is unavailable.

Translation ready All strings are translatable through the elektilo text domain, and a elektilo.pot template ships in /languages. Deleting the plugin removes its options. How it works The quiz is rendered server-side (so it can be cached with the page) and advanced entirely client-side, no round-trip between steps. Only the final recommendation is fetched, from a same-origin REST request to your own site, and rendered fresh so price and stock are current. The CSS and JavaScript are enqueued only on pages that contain the [elektilo] shortcode.

1.2.0

• Results map: each step in a row can be set to "Any", so one row covers every answer to that step. An exact row wins, then the row with the fewest "Any" steps, then the row higher in the list; the fallback comes last. Rows can be removed, and "Generate / refresh combinations" keeps rows that use "Any". Existing maps work as before.
• The result card shows WooCommerce's add-to-cart button next to "View product" for a simple product in stock, using AJAX add-to-cart where it is enabled. Variable and other product types keep the link only.

1.1.5

• The settings screen showed the shortcode as [finder], which prints as plain text. It now shows [elektilo].
• An answer value with a space or punctuation, such as "home gym", was saved as "homegym" on the step but "home-gym" in the results map, so shoppers who picked it always got the fallback product. Both now use the same value; re-save the settings and regenerate the combinations to repair a quiz built before this version.
• Arrow keys now move between answers without submitting the step, so every answer can be reached by keyboard. Space, Enter or a click picks the answer, including the one already selected.
• After Back, clicking the answer you already chose moves on again instead of doing nothing.
• Backslashes in the title, questions and result texts are kept on save.
• Removed the unused finder_compare_items table that earlier versions created; uninstall drops it too.

1.1.4

• The product picker listed only the first 200 products, so larger stores could not choose the rest. It now searches the whole catalogue as you type, using the same search box as WooCommerce.

1.1.3

• The Plugin URI in the header answered 404. The page it names is now published, and the same check was run across every plugin in the family.

1.1.2

• Named Elektilo. The WordPress.org review team asks a plugin name to lead with a distinctive, coined identifier rather than a generic descriptive word. Elektilo is Esperanto for a tool that chooses, which is what the quiz does. The text domain follows the name; the stored data, the settings and every hook are unchanged.
• The shortcode is now [elektilo]. It used to be [finder], a tag generic enough that any other plugin could claim it first. This is the last release in which it could change without breaking existing pages, because the plugin has not been published yet.
• The admin menu reads Elektilo rather than Product Finder, and the places the documentation still said Finder were updated.

1.0.10

• Fixed: arrow glyphs in the admin menu paths, and in the strings handed to translators. An arrow inside a translatable string makes the glyph every translator's problem and changes the layout in any locale that drops it.

1.0.9

• The short description was 151 characters, one over the limit WordPress.org allows, so the plugin directory cut it off mid-sentence. Shortened by one word; the meaning is unchanged.

1.0.8

• The translation template was regenerated. It still named an older version of the plugin and pointed at source lines that had since moved, which is what translation tools read to show a string in context.

1.0.7

• Renamed to Plogins Finder - Product Finder Quiz for WooCommerce so the name leads with the brand rather than a generic word, which is what the WordPress.org plugin review team asks for. The plugin slug is unchanged.

1.0.6

• Tested against WordPress 7.1. Verified by activating this build on a clean 7.1 install with WooCommerce 11.1, not by editing the header.

1.0.5

• Accessibility improvements to the admin and storefront markup.

1.0.4

• Fixed: on desktop the page no longer scrolls down to the finder on load (focus now uses preventScroll).
• Fixed: the URL stays clean on first visit, quiz state (?fa=&fs=) is only written after the visitor answers.

1.0.3

• Added an "Open in new tab" option so the recommended product opens in a new browser tab.

1.0.2

• First stable release: guided step-by-step product finder quiz with a friendly steps/results admin, REST-powered live recommendation, accessible vanilla-JS front end and zero layout shift. Radio-style option indicators, subtle motion (reduced-motion aware) and a Polish translation.