=== Lifter Image Popups ===
Contributors: muhammadalisilat
Tags: popup, notice, announcement, alert, image popup
Requires at least: 5.9
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightweight WordPress plugin for showing simple image notices, announcements, and important popups without a heavy popup builder.

== Description ==

Lifter Image Popups is a lightweight WordPress plugin for showing simple image notices, announcements, and important popups without a heavy popup builder.

It is built for site owners who need to display a regulatory notice, a finance or IPO announcement, or any important image-based message to their visitors — with no bloat and no unnecessary dependencies.

**Features:**

* Create multiple popups using a simple Custom Post Type
* Attach any image from your Media Library as the popup content
* Optional click-through URL (opens in same tab or new tab)
* Target by page rule: all pages, home only, or custom URL match
* Show to all visitors or admin-only (for testing)
* Delay popup appearance by a configurable number of seconds
* Show-once option with cookie-based suppression
* Configurable cookie duration
* Priority system — when multiple popups match a page, the one with the lowest priority number wins
* Accessible: focus-trapped dialog with keyboard (Escape) and overlay-click close
* Zero jQuery on the frontend — vanilla ES5 JavaScript
* No external dependencies

== Installation ==

1. Upload the `lifter-image-popups` folder to `/wp-content/plugins/`
2. Activate the plugin through the **Plugins** menu in WordPress
3. Navigate to **Lifter Image Popups** in the admin menu
4. Click **Add New Popup**, give it a title, select an image, configure settings, and publish

== Frequently Asked Questions ==

= Does this plugin support text or HTML popups? =

Not currently. Lifter Image Popups is focused on image-based popups. Text/HTML support may be added in a future release.

= How does the priority system work? =

Each popup has a priority number (default 10). When multiple published popups are eligible for the same page, only the one with the lowest priority number is shown. Lower number = higher priority.

= Can I show a popup only to logged-in admins? =

Yes. Set the Audience option to "Admin only" to restrict the popup to users with the `manage_options` capability. Useful for testing before showing to all visitors.

= Will the popup show again after a visitor closes it? =

If "Show once per visitor" is enabled, a cookie is set when the popup opens. The popup will not show again until the cookie expires (configurable via "Cookie duration"). Admins always bypass the cookie check.

= Where is the popup inserted in the page? =

The popup is output at `wp_body_open` (with a `wp_footer` fallback), then moved to the `<body>` root via JavaScript to avoid stacking context issues with theme containers.

== Screenshots ==

No screenshots included in this release.

== Changelog ==

= 1.0.0 =
* Initial public release as Lifter Image Popups
* Image popup with click-through URL support
* Page targeting: all pages, home only, custom URL contains
* Audience targeting: all users or admin only
* Delay, show-once, and cookie duration controls
* Priority-based popup selection
