=== Quizanta — quiz funnels that qualify your leads ===
Contributors: quizanta
Tags: quiz, funnel, lead generation, calculator, survey
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Put a Quizanta quiz funnel on any page with a block or a shortcode, or as a button in the corner of the whole site.

== Description ==

Quizanta turns a page of visitors into enquiries you can act on: a few tapped questions, a price on screen, and the answers arriving with the contact details attached. This plugin is how the funnel gets onto a WordPress site.

* A **Quizanta quiz** block for the editor, with your published funnels in a menu.
* A `[quizanta]` shortcode for classic editors, page builders and theme templates.
* A **button in the corner** of every page, if you would rather not give the funnel a page of its own.
* Nothing to keep in step: the questions, the theme and the calculator live in Quizanta, so a funnel you edit there changes on the site without touching WordPress.

You need a Quizanta account with at least one published funnel. The plugin loads one small script from quizanta.com and shows the funnel in a frame; the funnel reports its own height, so it does not leave a gap on the page.

= The API key is optional =

Without it the plugin works: type the funnel's slug and it appears. With it, the settings screen and the block show your published funnels in a menu instead. Note that the same key can read that account's leads, so only add it on a site whose administrators are allowed to see them.

== External services ==

This plugin connects to Quizanta, the service that hosts and runs your quiz funnels. The connection is required for the plugin to do anything: the funnel is served from Quizanta, not from your site.

What is sent, and when:

1. On every page where you place a funnel, the visitor's browser loads `https://quizanta.com/widget.js` and then the funnel itself in a frame from `https://quizanta.com/embed/<your-funnel>`. The address of the page carrying the funnel is sent with that request, so the enquiry can record where it came from. This happens in the visitor's browser, the same way an embedded video or map does.
2. The answers a visitor gives inside the funnel, and the contact details they choose to submit, go to Quizanta — that is what the funnel is for — and appear in your Quizanta account. None of it is stored in WordPress.
3. Only if you enter an API key on Settings → Quizanta: your site's server asks `https://quizanta.com/api/v1/quizzes` for the list of your own published funnels, so the settings screen and the block can show them in a menu. The key travels in the request header. Without a key, your server sends nothing at all.

Service: Quizanta — https://quizanta.com
Terms of Service: https://quizanta.com/terms
Privacy Policy: https://quizanta.com/privacy

== Installation ==

1. Install and activate the plugin.
2. Open **Settings → Quizanta**.
3. Optional: paste the API key from Quizanta → Integrations, to pick funnels from a menu.
4. Add the **Quizanta quiz** block to a page, or the `[quizanta slug="your-funnel"]` shortcode.

== Frequently Asked Questions ==

= Where do the enquiries arrive? =

In Quizanta, and wherever you have pointed them: WhatsApp, email, a webhook, your CRM. The plugin does not store leads in WordPress, so deleting it never takes anybody's enquiry with it.

= Can I show different funnels on different pages? =

Yes. Every block and every shortcode names its own funnel; the one in the settings is only the fallback for those that do not.

= Does it work with a page builder? =

Use the shortcode. Elementor, Beaver Builder, WPBakery and Divi all run shortcodes in a text or HTML widget.

= Does it slow the page down? =

The script is loaded asynchronously and only on pages that actually show a funnel; the funnel itself is in a lazily loaded frame.

== Shortcode ==

`[quizanta slug="my-funnel" mode="inline" height="520" class="my-class"]`

* `slug` — which funnel. Falls back to the default in settings.
* `mode` — `inline` (default) or `popup` for the button in the corner.
* `height` — minimum height in pixels for the inline frame, before it reports its own.
* `class` — one extra CSS class on the container.

== Screenshots ==

1. The block, with the account's published funnels in a menu.
2. The settings screen.
3. A funnel on the page.

== Upgrade Notice ==

= 1.0.0 =
First release.

== Changelog ==

= 1.0.0 =
* First release: block, shortcode, site-wide button, and an optional API key for the funnel picker.
