=== FooConvert - AI Popup Builder for Flyouts, Overlays & Bars ===
Contributors: fooplugins, bradvin, steveush
Tags: ai-popup, popup-builder, popups, flyout, announcement-bar
Requires at least: 6.5
Requires PHP: 7.4
Tested up to: 7.0
Stable tag: 2.1.6
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Use AI to build popups, flyouts, and announcement bars that match your brand. Free popup templates, triggers, targeting rules, and lead capture.

== Description ==

FooConvert lets you build stunning popups using natural language with our AI Popup Builder. 
It uses your brand colors and styling as context, so popups match your website look and feel.
Alternatively, you can create bars, flyouts, and overlay popups from one of our templates. Or from scratch.
Don't like the templates? Ask AI to edit it to your liking.
All popups are block-based and you edit them directly in the WordPress block editor. 
FooConvert also includes built-in popup blocks, display rules, open triggers, lead capture, popup analytics and styling controls.

[Read the FooConvert documentation](https://fooplugins.com/documentation/fooconvert/)

[Try the FooConvert backend demo](https://app.instawp.io/launch?t=fooconvert-free-demo&d=v2)

= What FooConvert Includes =

- Create bars, flyouts, and overlay popups with the block editor.
- AI Popup Builder and Brand Context tools for WordPress 7+ sites.
- 15 bundled popup templates.
- Sign Up, Countdown, and Coupon blocks.
- Support for WordPress core blocks, embeds, and shortcodes inside popup content.
- Display rules for locations, exclusions, and user targeting.
- Triggers for page load, timers, scroll depth, exit intent, and element interactions.
- Leads capture with CSV export.
- Popup stats with daily activity charts.
- Google Fonts support and popup styling controls.

= Popup Types =

- `Bar`: top or bottom bar announcements, promo strips, newsletter bars, and sticky calls to action.
- `Flyout`: slide-in messages and sidebar-style flyouts that stay visible without taking over the whole screen.
- `Overlay`: centered modal popups for forms, announcements, coupon offers, and embedded content.

= AI Popup Builder =

Start with a simple prompt and let FooConvert's AI Popup Builder create a high converting popup that matches your website brand. 
It can help with campaign ideas, copy, layout, images, and brand fit, so you can launch faster without starting from a blank canvas.
The AI tools require WordPress 7 or newer and a configured WordPress AI connector.

- Create bars, flyouts, and overlays from natural-language prompts.
- Use one of our starter prompts for common campaigns to get your going faster.
- Edit existing popups using natural language to save time.
- Match popup colors, fonts, spacing, and button styles to your website brand.
- Reuse your Brand Context across all your popups.
- Generate background images for your popups.
- Built in conversion playbook to help you create high converting popups.

= Building Popup Content =

- Use WordPress core blocks and most third-party blocks inside popup content.
- Shortcodes and embedded content are supported inside popups.
- `Sign Up` block: capture name and email, or run email-only forms, with configurable labels, placeholders, button text, and success behavior.
- `Countdown` block: build evergreen or fixed countdown campaigns with editable labels and optional close-on-expire behavior.
- `Coupon` block: show a coupon code with copy-to-clipboard behavior, custom button text, copied message, and optional close-on-copy behavior.

= Templates And Design Controls =

- Start from one of the 15 bundled templates or build from scratch.
- Adjust colors, spacing, borders, radius, shadows, dimensions, and typography in the editor.
- Add background images to popup designs.
- Choose a global editor background so the editing canvas is easier to work with.
- Register Google Fonts from the settings screen and reuse fonts bundled with templates.
- Build responsive popups for desktop and mobile layouts.

= Display Rules =

- Show popups on the entire site, front page, blog index, search results, no-results pages, and 404 pages.
- Target specific posts, pages, public custom post types, public taxonomies, and post type archives.
- Add exclusions so a popup appears only where it makes sense.
- Target all users, only logged-in users, only logged-out users, or specific user roles.

= Popup Triggers =

- Open on page load.
- Open after a timer elapses.
- Open after a visitor scrolls a chosen percentage of the page.
- Open on exit intent.
- Open when an anchor is clicked.
- Open when an anchor becomes visible.
- Open when a selected element is clicked.

= Leads And Popup Stats =

- View captured leads from the built-in Leads screen in wp-admin.
- Search, sort, bulk delete, and export selected leads to CSV.
- View per-popup stats including views, unique visitors, engagements, and daily activity charts.
- Open popup stats directly from the popup list table.
- Popup analytics data is retained for 14 days by default.

= Settings And Admin Tools =

- Add demo content to see example bars, flyouts, and overlays on a real site.
- Choose the popup editor background for all popup types.
- Save reusable Brand Context details so generated campaigns can match your colors, typography, voice, and offer style.
- Enable debug mode when troubleshooting an issue.
- Hide selected dashboard panels or promo messages if you want a cleaner admin area.
- Review database stats and remove old or orphaned event data.
- Copy system information when contacting support.

= Typical Use Cases =

- Newsletter signup bar on the homepage.
- Coupon or limited-time offer overlay.
- Slide-in lead magnet or content upgrade.
- Announcement bar for site-wide notices.
- Embedded video or shortcode-based popup content.

= Pro Version =

FooConvert Pro adds tools for WooCommerce stores and marketers who want to build better campaigns, learn what works, and connect popups to real business results.

- A/B testing for popup ideas and offers.
- WooCommerce revenue attribution.
- Store-focused popup blocks.
- WooCommerce targeting rules and shopper behavior triggers.
- Lead delivery to Mailchimp, MailPoet, Brevo, and custom webhooks.
- More detailed analytics with longer data retention.

= Background Image Generator =

Create polished popup backgrounds without opening a design tool or hunting for stock images. FooConvert turns adjustable visual styles into ready-to-use background images, so every campaign can feel branded and intentional.
Image generation is available from the AI Popup Builder when your configured WordPress AI connector supports image generation.

- Generate a new background directly from the popup background image controls.
- Start with modern styles like gradients, swirls, soft noise, pattern textures, and colorful shapes.
- Match the image to your campaign with custom colors, presets, variation, and size controls.
- Use popup-friendly layouts for bars, flyouts, overlays, or a custom shape.
- Save and apply the generated background to the popup in one step.

= A/B Testing =

Test different popup ideas against each other and use real visitor behavior to decide what works best. Run experiments for offers, headlines, layouts, calls to action, and timing.

- Create an experiment from an existing published popup.
- Duplicate the control popup to make variants faster.
- Split traffic evenly or choose custom traffic weights.
- Pick the goal that matters most: clicks, conversions, or leads.
- Compare views, clicks, conversions, leads, goal rate, improvement, and confidence.
- Let FooConvert Pro automatically complete the test or apply a winner when your rules are met.

= Sales Revenue Attribution =

See which popups help drive WooCommerce orders. FooConvert Pro connects popup engagement to sales, so you can measure campaigns by revenue instead of guessing from views and clicks alone.

- Credit sales to the popup interaction that helped lead to the order.
- Choose whether to count revenue when an order is created or after payment is confirmed.
- Set how far back FooConvert should look for a matching popup interaction.
- Avoid duplicate credit for the same shopper session.
- View attributed revenue, order counts, recent sales, and top revenue popups in wp-admin.

= PRO Blocks =

FooConvert Pro includes extra popup blocks built for ecommerce offers, cart incentives, and sales campaigns.

- `Apply Coupon` block: let shoppers apply a WooCommerce coupon directly from a popup.
- Choose what happens after a coupon is applied, including closing the popup or sending shoppers to the cart or checkout.
- `Free Shipping Progress` block: show shoppers how close they are to free shipping using their live cart total.
- Customize the free shipping threshold, almost-there message, unlocked message, progress bar, and styling.
- `Confetti` block: add a celebratory effect when a coupon, offer, or sale popup opens.

= WooCommerce Display Rules =

Show store campaigns only where they make sense. WooCommerce display rules help you match the popup to the page, product, and stage of the buying journey.

- Target the shop, cart, checkout, and My Account pages.
- Show campaigns on product pages, product category pages, or product tag pages.
- Target any WooCommerce page when you want a broader store-wide campaign.
- Use exclusions to keep popups away from pages where they do not belong.
- Combine WooCommerce rules with FooConvert's standard location and user targeting.

= WooCommerce Triggers =

Open popups at the right moment in the shopping journey. WooCommerce triggers react to cart activity, coupons, checkout events, and product interest.

- Show an offer after a shopper adds or removes a product from the cart.
- Trigger campaigns when cart value is above or below a chosen amount.
- Respond when a coupon is applied or when a coupon fails.
- Rescue checkout visitors with checkout view, exit intent, error, and payment failure triggers.
- Reach high-intent shoppers based on product views, time on page, scroll depth, repeat views, or cart idle time.

= Lead Automation Integrations =

Keep leads moving after they are captured. FooConvert Pro can send new subscribers to the tools your business already uses while still saving the lead inside WordPress.

- Send leads to a selected Mailchimp audience.
- Add subscribers to a selected MailPoet list.
- Add or update contacts in Brevo.
- Send lead data to Zapier, Make, n8n, or custom systems with webhooks.
- Test connections, fetch available lists, add webhook headers, and review integration errors from the settings screen.

= Advanced Analytics + Retention =

Understand more than whether a popup was seen. FooConvert Pro gives you deeper campaign reporting so you can improve popups based on clicks, conversions, revenue, and visitor engagement.

- Track clicks, click-through rate, conversions, conversion rate, engagement rate, and overall sentiment.
- See unique visitors, unique sessions, returning visitors, closes, and attributed sales.
- Add clicks, conversions, closes, sales, and update markers to activity charts.
- Compare week-over-week changes for views, engagements, clicks, and conversions.
- Keep analytics data longer with the Pro default of 30 days and configurable retention settings.

== Installation ==

1. Upload `fooconvert` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Visit the settings page to change any of the settings
4. Enjoy the plugin!

== Frequently Asked Questions ==

= Are there any limitations? (Number of popups or views?)=

There is NO limit to the number of popups you can create.
There is NO limit to the number of views each popup can have.
The main limitation is analytics retention. Popup analytics data is stored for 14 days by default.

= Is FooConvert compatible with my theme? =

FooConvert is designed to work with most WordPress themes. If you encounter any compatibility issues, please contact our support team.

= Can I use WordPress blocks, embeds, or shortcodes inside a popup? =

Yes. FooConvert is built for the block editor and supports WordPress core blocks, most third-party blocks, embedded content, and shortcodes inside popup content.

= Why can I not use the AI Popup Builder? =

The AI Popup Builder requires WordPress 7 or newer. Generating popup drafts also requires a configured WordPress AI connector, and image generation requires connector support for images.
All standard popup building features continue to work on WordPress 6.5 or newer.

= Where are captured leads stored? =

Captured leads are stored in WordPress and can be viewed from the Leads screen in wp-admin. You can search, sort, bulk delete, and export selected leads to CSV.

= Is FooConvert compatible with Classic Editor plugin? =

Not really. The FooConvert designer is built on top of the Gutenberg block editor, which means you need to enable the block editor to create and edit popups. You will not be able to easily create or edit popups using the Classic Editor.
If you have the Classic Editor plugin installed, You will need to enable the setting "Allow users to switch editors" from Settings -> Writing, so that you can switch to the block editor when adding or editing FooConvert popups.

= Can I use FooConvert on ecommerce sites? =

Yes. FooConvert can be used on ecommerce sites for announcements, list building, coupon messaging, and timed offers.
WooCommerce-specific targeting rules and store event triggers are available in the Pro version.

= Does FooConvert slow down my website? =

No, FooConvert is optimized for performance and has minimal impact on your website's loading speed.

== Screenshots ==

1. Popup Editor - Editing an overlay popup
2. Popup Template Selector
3. AI Popup Builder
4. Popup Editor - Editing a flyout
5. AI Popup Builder - Context
6. Popup Editor - Editing a bar
7. FooConvert Dashboard
8. Popup Stats Page

== Repository ==

The source code for this plugin is available publicly on GitHub [here](https://github.com/fooplugins/fooconvert).

== Changelog ==

= 2.1.6 =
* Date Updated : 24 May 2026
* Added : AI Popup Builder settings now include Test actions for current text and image model overrides.
* Updated : Updated the bundled WP AI Client streaming adapter package to 1.0.0.
* Updated : AI Popup Builder current model detection now matches the selected blocks, schema, tools, and disabled optional parameters used by real generation requests.
* Fixed : AI Popup Builder now forces configured text and image model overrides instead of treating them as fallback preferences.
* Fixed : AI Popup Builder now keeps required schema and tool-calling parameters enabled while still allowing unsupported optional parameters to be disabled.
* Fixed : AI Popup Builder now sends multi-tool responses as provider-compatible messages for OpenAI-compatible chat providers.
* Fixed : AI Popup Builder no longer accepts shorthand popup draft responses that bypass the required response contract.

= 2.1.5 =
* Date Updated : 19 May 2026
* Updated : Popup preview notices now include a refresh action and an Edit Popup link.
* Fixed : AI Popup Builder now shows a clearer AI connector message when no model output is returned, including likely exhausted credits or quota details.
* Fixed : AI Popup Builder now retries OpenRouter connector requests when optional JSON schema or tool metadata prevents model selection.
* Fixed : AI Popup Builder now recovers from OpenRouter chat responses that fail before returning choices.
* Fixed : AI Popup Builder background image generation now avoids popup UI mockups, rejects code-like prompt responses, and keeps raw image prompts out of media attachment descriptions.
* Updated : AI Popup Builder generated media can now be applied directly as the popup background image with cover sizing.
* Updated : AI Popup Builder generated media edit links now open in a new browser tab.
* Added : AI Popup Builder now requests optimized opaque WebP background images with compression by default, with a setting to disable those image output parameters for providers that reject them.

= 2.1.4 =
* Date Updated : 19 May 2026
* Fixed : Brand Context section Save buttons now persist edits for overview, palette, typography, and controls.
* Fixed : AI Popup Builder drafts now prefer generated background images and gradient backgrounds instead of reusing template background images.

= 2.1.3 =
* Date Updated : 19 May 2026
* Fixed : Improved AI Popup Builder recovery for malformed nested JSON responses from AI models.
* Updated : Added parser context to invalid JSON retries and debug errors so malformed AI responses are easier to correct.

= 2.1.2 =
* Date Updated : 18 May 2026
* Added : Added AI Popup Builder buttons to the dashboard, popup type chooser, and popup template picker.
* Updated : Added a sparkle icon, animated rainbow border, and iframe-safe parent-page navigation to the AI Popup Builder buttons.

= 2.1.1 =
* Date Updated : 18 May 2026
* Fixed : Improved AI Popup Builder handling for missing WordPress AI Client and unconfigured AI connectors.

= 2.1.0 =
* Date Updated : 18 May 2026
* Added : AI Popup Builder, Brand Context, and background image generation for WordPress 7+ sites.
* Added : Expanded AI Popup Builder support for real trigger events in generated popup drafts.
* Updated : Improved AI Popup Builder connector warnings, page copy, starter prompts, and system prompt guidance.
* Fixed : fixed PHP fatal error when using WordPress versions earlier than 7.0.
* Fixed : Fixed bug where fonts added in settings were not showing in block editor font selector.
* Fixed : Fix for Split Layout block missing frontend styles.

= 2.0.1 =
* Date Updated : 12 May 2026
* New : Added new Split Layout block that templates will use.
* Updated : Removed the FooConvert branding header from the admin pages.

= 2.0.0 =
* Date Updated : 20 Apr 2026
* New : Launched FooConvert 2.0 with a streamlined popup builder for bars, flyouts, and overlays in one consistent workflow.
* New : Added a guided popup type chooser with richer template previews so you can launch campaigns faster.
* New : Added 15 bundled templates across bars, flyouts, and overlays for quicker campaign launches.
* New : Added the Sign Up, Countdown, and Coupon blocks for lead capture and promotional campaigns.
* New : Added the Leads screen with filtering and export.
* New : Added Google Fonts support, bundled font listings, and a global popup editor background setting for stronger on-brand design control.
* Updated : Refined display rule controls and popup list summaries so campaign targeting is easier to review at a glance.
* Updated : Polished dashboard widgets, recent activity, and popup stats previews for clearer performance reporting.
* Updated : Added a confirmation step before deleting analytics data for safer admin workflows.
* Updated : Refreshed template previews and demo content to better showcase launch-ready campaigns.

= 1.2.6 =
* Date Updated : 15 Dec 2025
* Fixed : Fixed error when creating bars and flyouts in block editor.
* Fixed : In block editor, disabled autosave for our custom post types.
* Fixed : Updated Freemius SDK to 2.12.3
* Fixed : Updated dashboard copy and reworded admin screens for clearer popup terminology.

= 1.2.5 =
* Date Updated : 28 Sep 2025
* Updated to Freemius SDK 2.12.2

= 1.2.4 =
* Date Updated : 19 Jul 2025

= 1.2.3 =
* Date Updated : 14 Jul 2025
* Fixed : fixed template selector when creating a new popup.

= 1.2.2 =
* Date Updated : 11 Jul 2025
* Fixed : multiple bugs and issues found when testing.
* Updated to Freemius SDK 2.12.1

= 1.2.1 =
* Date Updated : 8 Jun 2025

= 1.2.0 =
* Date Updated : 8 Jun 2025
* New : Added editor controls to add BG images to popups.
* New : Added new popup setting to only show once per user.
* Fixed : multiple bugs and issues found when testing.
* Updated to Freemius SDK 2.12.0

= 1.1.1 =
* Date Updated : 8 Feb 2025
* FooConvert PRO now available!
* Updated whole plugin to use PSR4 autoloading standards.
* Fixed admin path issues where assets were not loading.

= 1.0.1 =
* Date Updated : 27 Jan 2025
* Added support for embeds within popup content.
* Added new filter 'fooconvert_can_create_event' to allow for disabling event creation.
* Added setting to hide Dashboard panels.
* Updated the popup metrics update job to be faster!
* Fixed default width of popups.
* Updated to Freemius SDK 2.11.0

= 1.0.0 =
* Date Updated : 7 Jan 2025
* Fixed bug with popups closing anchors not working as expected.
* Added support for shortcodes within popup content.

= 0.0.26 =
* Date Updated : 26 Dec 2024
* Added demo content (black friday scroll flyout & black friday exit intent popup).
* Added top performer panel to the dashboard.
* Added cron job to calculate popup stats (for top performers panel).
* Added cron job to delete old events (outside of retention period).
* Added box shadow to border tools panel in block editor.
* Updated template selector popup.
* Updated to Freemius SDK 2.10.1

= 0.0.16 =
* Date Updated : 3 Dec 2024
* Added compatability mode on popups, so that blocks that generate scripts will now work.
* Events now have a conversion bool field.
* Updated to Freemius SDK 2.9.0.
* Lots of updates and bug fixes!

= 0.0.15 =
* Date Updated : 16 Nov 2024
* Added dashboard page, which includes panel for demo content and help.
* Events now support subtypes and sentiment.
* Enabled Addon Support.

= 0.0.12 =
* Date Updated : 9 Nov 2024
* Added event table to the database to store conversion events for each popup.

= 0.0.11 =
* Date Updated : 2 Nov 2024
* Fixed demo content.
* Lots of updates to the popups!

= 0.0.10 =
* Fixed wrong redirect after plugin activation.
* Added 2 demo bars that are created on activation.

= 0.0.9 =
* First public release!
