=== Flyerimage ===

Contributors: thousand31
Tags: popup, campaign, email capture, shopify popup, marketing
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 8.0
Stable tag: 3.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

One campaign builder for all your websites. Design popups in WordPress, run them on WordPress, Shopify, Webflow, Wix, or any HTML site.

== Description ==

**Flyerimage — One campaign builder for all your websites.**

Design popup campaigns once in your WordPress dashboard and run them everywhere: your WordPress site, your Shopify store, your Webflow landing pages, or any plain HTML site. One editor, one analytics dashboard, every website you own.

= Run campaigns on any website =

Add an external site, copy a one-line embed tag, and paste it into that site's `<head>`. That's it. Your campaigns now appear there too, with the same targeting rules and analytics.

* Works on Shopify, Webflow, Wix, Squarespace, Framer, Carrd, and static HTML
* No WordPress needed on the external site
* Pick per campaign: WordPress only, external sites only, or both
* Switch a site to Inactive any time without removing the tag

Built for agencies managing client sites, store owners running a blog and a shop, and SaaS teams with a marketing site and an app on different platforms.

= Everything you need to build the popup =

Flyerimage uses a free-position drag-and-drop canvas editor, so no coding is required.

Design beautiful popups from scratch or start with one of 6 ready-made templates. Place any element exactly where you want it: headings, text, badges, buttons, form fields, images, shapes, link buttons, and inline text links. Set your targeting rules in plain English — trigger, pages, audience, and frequency — then watch results roll in through per-campaign and site-wide analytics dashboards.

It’s the complete popup toolkit for marketers, store owners, bloggers, and site builders who want professional results without the complexity.

== Key Features ==

- Run the same campaign on WordPress and external websites (Shopify, Webflow, Wix, HTML)
- One-line embed tag per external site, with Active/Inactive control
- Free-position drag-and-drop v3 canvas editor
- 9 element types: Heading, Text, Badge, Button, Field, Image, Shape, Link Button, Link Label
- 13+ shape variants for flexible design accents
- 6 starter templates: Email Capture, Discount Offer, Announcement, Exit Intent, Lead Magnet, Newsletter Sign-up
- Link Button element — styled button that opens any URL in a new tab
- Link Label element — inline underlined text link; use # to close the popup
- Form submission capture with anti-spam protection (honeypot + IP rate limiting)
- Submissions log with campaign filter and CSV export
- Per-campaign analytics: views, visitors, clicks, closes, submissions, conversion rate, engagement funnel, device split
- Site-wide analytics dashboard: 7-day KPI highlights, views vs visitors chart, campaign performance comparison
- 5 trigger types: Time on page, Scroll depth, Exit intent, Click on element, Inactivity
- Page targeting: All pages, Homepage only, or specific pages
- Audience filter: First-time, Returning, or Everyone
- Device targeting: Desktop, Tablet, Mobile
- Frequency control: once per visitor or repeat
- Auto-close countdown with configurable delay
- Multiple close icon styles (Standard, Circle, Boxed, Corner)
- Desktop and Mobile canvas layouts
- Clean, beginner-friendly admin dashboard

== How It Helps You ==

- Launch popups and promotions without writing a single line of code
- Start in seconds with 6 professionally designed starter templates
- Capture leads and emails directly from your popup with built-in form fields
- Keep spam out with honeypot detection and IP rate limiting
- Know what’s working with per-campaign analytics and conversion tracking
- Show the right popup to the right audience with flexible targeting rules
- Manage every campaign from one clean dashboard

== Frequently Asked Questions ==

= Is Flyerimage free? =
Yes, Flyerimage is completely free. Install it directly from the WordPress plugin directory and start creating campaigns immediately — no account or licence key required.

= Can I show Flyerimage popups on a site that isn't WordPress? =
Yes. Go to Flyerimage → External Sites, add the website, and copy its embed tag. Paste the tag into the site's `<head>` and any campaign targeting that site will appear there.

= Do I need WordPress installed on the external site? =
No. The external site only needs the one-line script tag. Campaigns are designed and managed from your WordPress dashboard and served to the external site.

= How do I add Flyerimage to Shopify? =
In Shopify admin go to Online Store → Themes → Edit code, open `theme.liquid`, and paste the embed tag just before `</head>`. Save, then enable the site in your campaign's rules.

= How do I add Flyerimage to Webflow? =
Open Site settings → Custom code, paste the embed tag into the Head code box, save, and publish the site.

= How do I add Flyerimage to Wix or Squarespace? =
Wix: Settings → Custom code → Add code, place it in Head on all pages. Squarespace: Settings → Advanced → Code injection → Header. Paste the embed tag and save.

= Can one campaign run on WordPress and an external site at the same time? =
Yes. In the campaign's Rules tab, keep WordPress checked and select the external sites you want. You can also target external sites only.

= What happens if I set an external site to Inactive? =
Popups stop showing on that site straight away. The site stays in your list and keeps its embed tag, so you can turn it back on later without touching the external site's code.

= Do I need to know how to code? =
No. The v3 canvas editor is fully drag-and-drop. You can design, target, and launch a popup campaign entirely from the admin dashboard without touching a single line of code.

= How do I create my first popup campaign? =
Go to Flyerimage in your WordPress admin, click Add Campaign, choose a starter template or start from a blank canvas, design your popup, set your targeting rules on the Rules tab, then click Publish. Your popup will go live immediately.

= What starter templates are available? =
Flyerimage ships with 6 ready-made templates: Email Capture, Discount Offer, Announcement, Exit Intent, Lead Magnet, and Newsletter Sign-up. Each template is fully editable.

= What types of elements can I add to my popup? =
You can add 9 element types: Heading, Text, Badge, Button, Form Field, Image, Shape, Link Button, and Link Label. Shapes come in 13+ variants for decorative accents.

= Can I capture email addresses and form submissions? =
Yes. Add a Field element to your popup and Flyerimage will capture submissions automatically. All submissions are stored in the Submissions log where you can filter by campaign and export to CSV.

= How is spam prevented in form submissions? =
Flyerimage uses a honeypot hidden field and IP rate limiting (maximum 10 submissions per IP per hour) to block spam without requiring a CAPTCHA.

= What trigger options are available? =
You can trigger a popup by: Time on page, Scroll depth, Exit intent, Click on a specific element, or Inactivity. Each trigger is configured in plain English on the Rules tab.

= Can I show a popup only on specific pages? =
Yes. The Pages rule lets you show a popup on All pages, the Homepage only, or specific pages you select individually.

= Can I target specific audiences or devices? =
Yes. Set the Audience filter to First-time visitors, Returning visitors, or Everyone. Device targeting lets you restrict the popup to Desktop, Tablet, Mobile, or any combination.

= How do I control how often the popup appears? =
Use the Frequency setting to show the popup once per visitor or on every visit.

= Can a popup close itself automatically? =
Yes. Enable Auto-close in the popup style settings and set a delay in seconds. A countdown pill is shown to visitors, and the popup closes itself when the timer reaches zero.

= What close icon styles are available? =
Four styles: Standard, Circle, Boxed, and Corner. Choose the one that fits your popup design.

= Can I see how my campaigns are performing? =
Yes. Each campaign has its own analytics page showing Views, Unique Visitors, Clicks, Closes, Submissions, Conversion Rate, an Engagement Funnel, device split, and a Views Over Time chart. There is also a site-wide analytics dashboard with 7-day KPI highlights and a Campaign Performance comparison chart.

= Can I duplicate an existing campaign? =
Yes. Open the action menu on any campaign in the list and choose Duplicate. The new campaign is created as a draft copy you can edit freely.

= Does Flyerimage work with caching plugins? =
Yes. Flyerimage is compatible with popular caching plugins. The popup script loads asynchronously and does not interfere with page caching.

= What are the minimum requirements? =
WordPress 5.0 or higher and PHP 8.0 or higher.

== External services ==

= Lemon Squeezy (licence activation) =
Flyerimage connects to the Lemon Squeezy API (https://api.lemonsqueezy.com) only when a site administrator activates or deactivates a licence key. It sends the licence key and the site name (on activation) or the licence key and instance ID (on deactivation). No other data is sent, and nothing is sent unless an administrator takes that action.
Terms of service: https://www.lemonsqueezy.com/terms
Privacy policy: https://www.lemonsqueezy.com/privacy

= Your own WordPress site (external-site embed tag) =
When you add the embed tag to an external website, that website's visitors load the Flyerimage script and campaign data from your own WordPress site, not from a third party. The request includes the site's app key and the visitor's time zone. Popup views, clicks, and closes are recorded on your WordPress site with the visitor's IP address, device, browser, and page URL. Country is looked up locally from a bundled database; no geolocation service is contacted.

== Screenshots ==

1. Live popup on the front-end — Announcement template with a call-to-action button, link label, and auto-close countdown.
2. Campaign list dashboard showing all campaigns with trigger, pages, audience, frequency, closes, 10-day sparkline views, and status.
3. Campaign row actions menu — Edit, Submissions, Analytics, Preview, Duplicate, Deactivate, and Delete.
4. Template selector — choose from Blank canvas, Email Capture, Discount Offer, Announcement, Exit Intent, Lead Magnet, and Newsletter Sign-up.
5. v3 canvas editor (Design tab) — free-position drag-and-drop with element toolbar, layers panel, and popup style sidebar.
6. Rules tab — Trigger, Pages, and Audience settings with a plain-English summary and sanity checks.
7. Submissions log — all form entries across campaigns with date, page URL, field values, and CSV export.
8. Per-campaign analytics — Views, Unique Visitors, Clicks, Closes, Submissions, and Conversion Rate KPIs with a Views Over Time chart and Engagement Funnel.
9. Site-wide analytics dashboard — 7-day highlight KPIs with trend indicators, Engagement Funnel, and Action Breakdown.
10. Site-wide analytics continued — Views vs Visitors line chart and Campaign Performance comparison bar chart.

== Upgrade Notice ==

= 3.0.2 =
Security fix for the external-site endpoint, plus run campaigns on Shopify, Webflow, Wix, and any HTML site. Recommended update for all users.

= 3.0.0 =
Major release. Introduces a fully rebuilt v3 canvas editor with free-position drag-and-drop elements, link button and link label elements, per-campaign analytics dashboard, anti-spam form submission protection, and 6 new starter templates.

= 2.3.2 =
Adds image and shape shadow customization, duplicate campaign, size editing per component, improved editing controls, and mobile layout fallback. Fixes Activate label showing as @@Activate in campaign list row actions.

= 2.3.1 =
Fixes modal size issue in edit mode. Recommended update for all users.

= 2.3.0 =
Adds starter templates, new shapes, and improved customization options for a better campaign creation experience.

= 2.2.0 =
Added new rectangle tool and display targeting options.
Redesigned toolbar and improved editor layout.
Fixed caching and saving issues.
General UI and performance improvements.

= 2.1.0 =
Improved mobile responsiveness, added background color option, and fixed page-saving issues.

= 2.0.0 =
This release updates core terminology from "Flyers" to "Campaigns" and requires PHP 8.0 or higher. Please ensure your server meets the PHP requirement before upgrading.

== Changelog ==

= 3.0.2 =
**Added**
* External sites — run the same campaigns on Shopify, Webflow, Wix, Squarespace, Framer, or any HTML site with a one-line embed tag
* Per-campaign platform targeting: WordPress only, external sites only, or both
* Active/Inactive switch for each external site
* Install guide with step-by-step instructions for each platform, shown right after adding a site
* Platform column in the campaign list (WP / External)

**Fixed**
* Security: external-site lookup now uses a parameterised query
* A WordPress campaign no longer gets hidden by an external-only campaign
* "Closing in N seconds" countdown now disappears when the popup is closed with the ✕ button
* Campaign action menu now closes when clicking outside it
* Action menu column no longer cut off in the campaign list
* Caching issue with campaign updates

**Changed**
* Removed the Audience column from the campaign list

= 3.0.0 =
**Added**
* v3 canvas editor — free-position drag-and-drop popup designer with heading, text, badge, button, field, image, shape, link button, and link label elements
* Link Button element — styled button that opens a URL in a new tab
* Link Label element — inline text link with optional underline; setting href to # closes the popup
* Per-campaign analytics page — views over time chart, funnel, device split, top pages, and submission log
* Views (10d) column in campaign list now links directly to campaign analytics
* Anti-spam protection for form submissions — honeypot field and IP rate limiting (10/hour)
* 6 starter templates: Email Capture, Discount Offer, Announcement, Exit Intent, Lead Magnet, Newsletter Sign-up
* Auto-close countdown pill now clears immediately when popup is closed via any action

**Improved**
* Analytics page: submissions KPI card, conversion rate card, submissions funnel step, and per-campaign submission counts in the campaign table
* Views vs Visitors chart changed to smooth line chart
* Real-time canvas updates — content field now updates on every keystroke

= 2.3.2 =
**Added**
* Image shadow customization support
* Shape shadow customization support
* Duplicate campaign functionality
* Size editing support for individual components
* Improved component editing controls
* Responsive mobile layout fallback (desktop design copied to mobile automatically)

**Fixed**
* Activate label displaying as @@Activate in campaign list row actions

= 2.3.1 =
* Fixed modal size issue in edit mode

= 2.3.0 =
* Added 2 starter templates (Announcement, Event)
* Added 13 shape elements
* Added multiple close icon styles
* Improved campaign builder UX and element controls
* General UI improvements

= 2.2.0 =
**Added**
- Rectangle element added to toolbox
- Display target options (All Pages / Homepage Only)
- Move element forward and backward controls
- Background color support for canvas
- Tip modal and contextual canvas guidance

**Improved**
- Toolbar redesigned for better usability
- Left panel layout and sizing improvements
- Canvas spacing and placement refinements
- Hover shadow effects on components
- Background image options with scroll support
- Text component styling enhancements

**Fixed**
- Caching-related rendering issue resolved
- Saving issue fixed
- Duplicate item removal bug fixed
- Minor UI inconsistencies and spacing corrections

= 2.1.0 =
* Automatically copy desktop layout to mobile by default
* Fixed issue when saving multiple selected pages
* Added background color option for campaigns
* Improved Preview button placement
* Minor i18n improvements

= 2.0.0 =
* Updated minimum PHP requirement to PHP 8.0
* Renamed “Flyers” to “Campaigns” across the plugin UI
* Improved campaign list and empty-state experience
* Enhanced onboarding clarity for first-time users
* General UI and stability improvements


== License ==

Flyerimage is free software, licensed under the GPLv2 or later.

== License URI ==

https://www.gnu.org/licenses/gpl-2.0.html
