=== Interactive Funnel Engine ===
Contributors: jrosro4
Tags: interactive, funnel, storytelling, shortcode, marketing
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.1.24
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create simple interactive funnels and decision-based experiences inside WordPress using nodes, buttons, backgrounds and shortcodes.

== Description ==

Interactive Funnel Engine lets you build lightweight interactive experiences directly inside WordPress.

You can create a Funnel, define nodes, connect them with buttons and place the experience anywhere with a shortcode. It is designed for early interactive funnels, guided landing pages, simple game-like flows, product selectors, lead journeys, demos and narrative experiments.

Current MVP features:

* Custom post type for Funnels.
* Node-based flow editor.
* Start node configuration.
* Button-based navigation between nodes.
* Button actions for internal nodes or external URLs.
* Optional new-tab external links for CTAs.
* Speaker name and avatar.
* Featured image as funnel background.
* Basic frontend analytics: views, starts, node views, button clicks and conversions.
* Conversion nodes.
* Fullscreen-style mode via shortcode.
* Browser fullscreen toggle button.

== Installation ==

1. Upload the plugin folder to /wp-content/plugins/ or install the ZIP from Plugins > Add New > Upload Plugin.
2. Activate Interactive Funnel Engine.
3. Go to Interactive Funnel Engine in the WordPress admin menu.
4. Create your first Funnel.
5. Add the shortcode to any page or post.

== Usage ==

Basic shortcode:

`[intfuen_funnel id="123"]`

Fullscreen-style shortcode:

`[intfuen_funnel id="123" fullscreen="true"]`

Replace 123 with the real ID of your Funnel.

Buttons can either go to another node or open an external URL.

For internal navigation, choose "Go to node" and enter the target node ID, for example:

`pricing`

For CTAs, choose "Open URL" and enter the destination URL, for example:

`https://example.com/contact`

You can also choose whether the URL opens in the same tab or in a new tab.

== Frequently Asked Questions ==

= Can I use this for marketing funnels? =

Yes. The MVP is designed around decision-based flows that can end in different calls to action, such as a product page, contact page, download or signup.

= Can I track conversions? =

Yes. Mark any node as a conversion node. When a visitor reaches it, Interactive Funnel Engine records a conversion in the Analytics screen.

= Can it open in real browser fullscreen automatically? =

Modern browsers require a user gesture before entering true browser fullscreen. The shortcode fullscreen="true" creates a viewport-filling experience, and the frontend button lets the visitor enter browser fullscreen manually.

= Does it remove data when uninstalled? =

Yes. The uninstall routine removes the analytics tables created by the plugin.

== Screenshots ==

1. Funnel editor with nodes and buttons.
2. Frontend interactive funnel.
3. Fullscreen-style funnel layout.
4. Analytics overview.

== Changelog ==

= 0.1.17 =
* Refined fullscreen button position and icon.
* Removed frontend attribution and updated plugin branding for WordPress.org review.

= 0.1.12 =
* Added GPL-compatible license declaration to the plugin header.
* Improved input unslashing and sanitization for funnel flow and tracking data.
* Improved escaping for shortcode inline background styles.
* Escaped custom analytics table names before direct database operations.

= 0.1.11 =
* Added button action selector: Go to node or Open URL.
* Added external URL field for CTA buttons.
* Added optional new-tab behavior for external CTAs.
* Improved frontend handling for CTA destination buttons.

= 0.1.10 =
* Fixed shortcode fullscreen mode so it behaves as a real fixed immersive overlay.
* Improved manual fullscreen button with CSS overlay fallback.
* Added shortcode fullscreen mode: [intfuen_funnel id="123" fullscreen="true"].
* Added browser fullscreen toggle button.
* Improved frontend rendering to avoid injecting speaker/avatar markup through innerHTML.
* Frontend assets are now registered globally and only enqueued when the shortcode renders.
* Activation now registers the custom post type before flushing rewrite rules.
* Added uninstall cleanup for analytics tables.
* Improved WordPress.org-style README.
* Updated plugin author metadata.

= 0.1.7 =
* Landing-style frontend refinements.
* Basic progress indicator.
* Speaker avatar and name.
* Basic analytics tables and events.

