AQM Popup WP Registry grade A. No security issues foundWP RegistryNo security issues foundOpen the reportA

A lightweight site-wide popup plugin. Build popups right in the settings — image, headline, text, button, colors, and fonts — keep a library of designs, schedule them by date, and switch which one is live at any time. Live preview included. No page builder required.

Requirements

• WordPress 5.2+
• PHP 7.2+

Install

1. Zip the aqm-popup folder.
2. WordPress admin → Plugins → Add New → Upload Plugin → choose the zip → Install Now → Activate.

Configure

WP Admin → AQM Popup. The page has a Designs manager, a per-design editor with a sticky section nav, and a live preview that mirrors the design you're editing.

Designs

• A library of popup designs. Each design is a full preset — its own content, style, typography, triggers, frequency, behavior, and close-icon.
• Activate sets which one design is live. Archive sets one aside. Duplicate copies one. Add makes a new one. Edit loads a design into the editor below.
• The master Popup enabled site-wide switch turns the whole popup on/off. When off, no frontend assets are enqueued.
• Adding / activating / switching designs reloads the page, so save your edits first.

This design (name + schedule)

• Design name — for your reference in the Designs list.
• Start date / End date — optional. The active design only shows within this window (your site's timezone). Leave empty for no limit. Outside the window, no popup shows.

Content

Any field left empty is skipped — an image-only, text-only, or background-image-only popup all work.

Styling is organized by the element it affects, so a thing's controls (including its color) are all in one place:

Headline

Color, font (override the base, or a Google Font), size, weight, alignment, letter case (uppercase / lowercase / capitalize), italic, line height, letter spacing, and space below.

Body & button

The base font — Theme default (your site's font, no extra request) or a Google Font (Inter, Poppins, Montserrat, Roboto, Lato, Open Sans, Playfair Display, Merriweather) — plus the text color, size, weight, and alignment (left / center / right), and the button's color + text color. Google Fonts load automatically on the front end.

Popup box

Background color, background image (with an optional overlay tint for legibility), max width, minimum height, inner padding, vertical alignment (top / center / bottom — needs a minimum height or background image to have room), and the border (width / style / color / radius, or an advanced CSS override).

Backdrop

The screen behind the popup: its color and opacity (e.g. black at 0.7, or a brand color at 0.5), and the gap between the popup and the screen edges.

All of the above use a native color picker where relevant and update live in the preview.

Triggers

Enable any combination. The popup appears as soon as the first enabled trigger fires.

• Time delay — show after N seconds on the page.
• Scroll depth — show after the visitor has scrolled N% of the page.
• Exit intent — show when the cursor moves toward the top of the viewport (desktop only — automatically skipped on touch devices).
• Click selector — show when the visitor clicks an element matching a CSS selector (e.g. .open-popup, #cta-button). If the matched element is an <a>, its navigation is suppressed.

Frequency

• Max shows per session — how many times the popup can appear in a single browser session. Resets when the tab closes.
• Cooldown after dismissal (days) — once dismissed, the popup is suppressed for this many days. Stored in localStorage, so it persists across sessions. Set to 0 to disable the cooldown.

Close button

Style the X button: size, distance from the corner (negative values place it outside the popup), background, icon color, and border radius.

Behavior

• Close on click outside — clicking the dark backdrop dismisses the popup (and starts the cooldown).
• Close on ESC key — pressing ESC dismisses.

(Backdrop opacity/edge gap live in Backdrop; the popup border lives in Popup box.)

Test mode

For previewing the popup without going live to your visitors:

• Enable test mode — when on, the popup shows only on the selected test page below, and ignores all frequency caps. It does not show on any other page.
• Test page — pick a page. The dropdown includes drafts (so you can test on a private page that only logged-in editors can see).

Test mode is independent of the master Enable popup toggle, so you can preview before going live or test new triggers without affecting your production popup.

How it works

The plugin renders a hidden overlay in the page footer containing the popup you built (image, headline, text, button). All output is escaped: the image via wp_get_attachment_image(), text via esc_html(), the link via esc_url(); colors are validated as hex and sizes are clamped. A small vanilla-JS script (no jQuery on the frontend) wires up the triggers and storage-based frequency caps.

Storage keys

To reset for a single visitor (e.g. during QA), open DevTools → Application → Storage and delete those two keys.

Limitations

• One active design shows at a time, site-wide (you can keep many designs in the library and switch between them). No per-page targeting — every enabled page shows the active design.
• Exit intent is desktop-only.

Updates

The plugin checks the latest tag on https://github.com/AQ-Marketing/aqm-popup every 6 hours and surfaces available updates on the WP Plugins screen. Tag names like v1.1.0 and 1.1.0 are both accepted.

License

GPL-2.0-or-later.