=== Popup Box – Easily Create WordPress Popups ===
Contributors: Wpcalc, lobov
Donate link: https://wow-estore.com/item/popup-box-pro/
Tags: popup, modal window, alert, overlay, banner
Requires at least: 5.5
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 3.2.15
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Popup Box lets you create responsive, customizable WordPress popups with live preview, flexible triggers, and smart targeting to boost engagement and conversions.

== Description ==

[📚 Documentation](https://wow-estore.com/documentations/popup-box-documentation/) | [🚀 Try Pro Demo](https://demo.wow-estore.com/popup-box-pro/)

**Popup Box** is a lightweight yet powerful **WordPress popup plugin** that helps you create, customize, and manage stunning popups without coding. Perfect for **email subscription popups**, **promotional popups**, **special offers**, **announcement popups**, and **interactive content popups**.

Design your popup with a **live preview builder** and choose placements. Use flexible triggers like on **load**, **scroll**, or **click**, and control exactly where your popups appear with advanced targeting rules.

**Popup Box** is a powerful yet lightweight WordPress plugin that lets you easily create, customize, and manage popups with a real-time live preview. Perfect for special offers, email signups, promotions, or boosting user interaction.

### 🌟 Key Benefits
- Effortlessly create stunning popups with live preview.
- Improve engagement and grow conversions.
- Lightweight and optimized for speed.
- Simple setup – works with any theme.

✅ **Engage visitors and increase conversions with Popup Box — the ultimate WordPress popup solution!**

= Main Features =

### 🎨 **Customization & Design**
- **Live Preview Editor**: Instantly see changes as you build.
- **Unlimited Popups**: No limits—create as many popups as you need.
- **Customizable Styles**: Fonts, colors, backgrounds, borders, shadows, and more.
- **9 Placement Options**: Position your popups exactly where you want.
- **Advanced Close Button**: Customize look and behavior.

### 🔥 **Triggers & Behavior**
- **Flexible Triggers**: Show popups on page load, scroll, click, or delay.
- **Display Targeting**: Show popups on specific posts, pages, or across your site.
- **Popup Frequency Control**: Limit popups to appear once per session.
- **Overlay & Shadow Effects**: Make your popups more attractive.
- **Custom Backgrounds**: Use images or solid colors.

### 📦 **Content & Shortcode Support**
- **Video Support**: Embed YouTube or Vimeo videos using the `[videoBox]` shortcode.
- **Custom Buttons**: Add styled buttons or close triggers with the `[buttonBox]` shortcode.
- **Iframe Support**: Insert maps, documents, or external sites via the `[iframeBox]` shortcode.
- **Third-Party Integration**: Works perfectly with **Contact Form 7**, **WPForms**, and other shortcode-based content.

### ⚡ **Performance & Compliance**
- No jQuery dependencies – lightweight and fast.
- GDPR compliant – cookie-free tracking using local storage.

--

= Ideal Uses for Popup Box =
- Email subscription forms.
- Special offers and promotions.
- YouTube or Vimeo video showcases.
- Lead generation.
- Announcement popups.
- Interactive content popups.

--

== Pro Version ==

Unlock advanced popup features with **Popup Box Pro**:

### 🎨 **More Design Flexibility**
- **Hover Trigger**: Show popups on hover.
- **Right-Click Trigger**: Open popups on right-click.
- **Text Selection Trigger**: Trigger popups when text is highlighted.
- **Exit Intent**: Capture visitors as they are about to leave.
- **Loop Popups**: Repeatedly show popups at random intervals.
- **Auto Close**: Set a timer for automatic popup closure.
- **Page Redirect**: Redirect users after popup close.

### 🔥 **Advanced Display Rules**
- **URL Parameters Activation**: Show popups based on URL query strings.
- **Referrer URL Targeting**: Target users coming from specific sources.
- **Geotargeting**: Show popups based on user location.
- **User Role Targeting**: Different popups for different user roles.
- **Device-Based Visibility**: Different popups for desktop or mobile.
- **Browser-Specific Control**: Enable or disable popups for specific browsers.
- **Multi-Language Targeting**: Display popups based on language preference.
- **Scheduling**: Schedule popups for specific dates or times.

### ✨ **Animation & Effects**
- **28 Entrance Animations**: Choose beautiful transition effects.
- **Forced Interaction**: Temporarily disable popup close button for critical actions (use carefully).

✅ [Upgrade to Popup Box Pro](https://wow-estore.com/item/popup-box-pro/) and unlock full potential!

--

== 🚀 Maximize Results with Complementary Plugins ==

Expand your site's functionality with these companion plugins:

- [Flexi Menu](https://wordpress.org/plugins/flexi-menu/) – Create Floating, Sticky, Dropdown & Icon Menus Easily.
- [Buttons](https://wordpress.org/plugins/buttons/) – Create powerful call-to-action buttons.
- [Counter Box](https://wordpress.org/plugins/counter-box/) – Add dynamic counters and timers.
- [Calculator Builder](https://wordpress.org/plugins/calculator-builder/) – Insert interactive calculators inside popups.

✅ **Boost engagement and conversions by combining Popup Box with these free tools!**

== Support ==
Need help? Ask questions and get quick answers in our [support center](https://wordpress.org/support/plugin/popup-box/).

== Frequently Asked Questions ==

= The popup does not appear on my website. How can I fix this? =
If your popup is not showing, it is often related to **caching** issues. To resolve this:

1. **Clear your browser cache** — Press `Ctrl + Shift + R` (Windows) or `Cmd + Shift + R` (Mac) to reload without cache.
2. **Clear your WordPress cache** — If you are using caching plugins (like WP Rocket, W3 Total Cache, LiteSpeed Cache), clear the cache from plugin settings.
3. **Purge server-side cache** — If your hosting provider uses additional caching (e.g., Cloudflare, SiteGround, Nginx cache), purge the cache from your hosting panel.
4. **Disable caching temporarily** — If the popup still does not appear, temporarily disable your caching plugin and test again.

= The popup is visible only to administrators, not regular visitors. Why? =
Check if **"Test Mode"** is enabled. When Test Mode is active, popups are visible only to administrators for testing purposes and hidden from public users.

= Can I change the position of the popup? =
Yes! You can easily choose between **9 placement options** to position your popup exactly where you want it to appear on the screen.

= Can I display popups only on specific pages or posts? =
Yes! Popup Box allows you to:
- **Show popups sitewide** (on all pages).
- **Assign popups** to specific pages, posts, or custom post types via the popup settings.

In the **Pro version**, you can also create **advanced display rules** based on post types, categories, tags, user roles, referrer URLs, and more.

= Can I use multiple popups at the same time? =
Absolutely! You can create and display **multiple popups** across your website. Each popup has its own settings and triggers.

= How do I use Popup Box on a multisite network? =
If you are running a WordPress multisite, **activate Popup Box individually** on each site where you want to use it. Do not activate it network-wide.

= Will Popup Box slow down my website? =
No. **Popup Box is lightweight and optimized for performance**, with no jQuery dependency, ensuring minimal impact on your site's speed.

== Installation ==

### 📌 Option 1: Install via WordPress Dashboard

1. Go to your WordPress admin dashboard (`wp-admin`).
2. Navigate to `Plugins → Add New`.
3. Search for **"Popup Box"** and click **Install Now**.
4. After installation, click **Activate**.

### 📌 Option 2: Manual Installation (Upload)

1. Download the Popup Box plugin ZIP file.
2. In your WordPress admin dashboard, go to `Plugins → Add New → Upload Plugin`.
3. Choose the downloaded ZIP file and click **Install Now**.
4. After installation, click **Activate**.

### 📌 Option 3: Install via FTP

1. Download and unzip the Popup Box plugin ZIP file.
2. Upload the extracted `popup-box` folder to your server’s `/wp-content/plugins/` directory via FTP.
3. Go to `Plugins` in your WordPress dashboard and click **Activate**.

### 🚀 Getting Started

1. Once activated, you will see a new **Popup Box** section in your WordPress admin menu.
2. Click **"Add New"** to create your first popup.
3. Customize your popup appearance, content, and trigger settings.
4. Click **Save** and your popup will be live on your site.
== Screenshots ==

1. Frontend example of a popup in action.
2. Popup content editor for customization.
3. Popup style customization options.
4. Settings page for popup controls.
5. Advanced display rules and targeting options.

== Changelog ==
= 3.2.15 =
* Fixed a minor bug with output tags
* Fixed: a minor bug with code quality

= 3.2.14 =
* Fixed: issue with method `Settings::option()`.
* Fixed: grammar issue in ListTable.php

= 3.2.13 =
* Fixed: All iframe attributes are now properly escaped using `esc_attr()`

= 3.2.12 =
* Updated: `wp-color-picker-alpha` to version **3.0.4**.
* Fixed: minor bug fixes

= 3.2.11 =
* Improved: Refactored AdminActions class for better performance and readability
* Improved: Reordered condition checks for better execution performance
* Updated: Added strict type hinting for method arguments in AdminActions

= 3.2.10 =
* Improved: Reorganized method order in DBManager class for better readability and maintenance
* Improved: Minor SQL formatting for consistency
* Cleaned: Minor code style improvements according to WordPress Coding Standards (WPCS)

= 3.2.9 =
* Added: admin RTL support
* Fixed: opening popup by selector for dynamically added elements

= 3.2.8 =
* Fixed: made the "days" option more flexible for option 'Show once'

= 3.2.7 =
* Fixed: Issue with `CreateFields` class.
* Updated: Language file for translations.

= 3.2.6 =
* Fixed: Minor database update logic.

= 3.2.5 =
* Fixed: Nonce verification logic for improved security.

= 3.2.4 =
* Fixed: Accessibility issue with the close button.

= 3.2.3 =
* Fixed: Structure of columns when creating database tables.

= 3.2.2 =
* Fixed: Function `block page` behavior.
* Changed: Dashboard menu icon.
* Updated: UI elements for better usability.

= 3.2.1 =
* Fixed: Admin menu icon display issue.
* Fixed: Minor bugs.
* Updated: Translation file.

= 3.2 =
* Added: Control dashboard display based on user roles.
* Fixed: Minor bug fixes for enhanced stability.

= 3.1 =
* Added: Shortcode support.
* Improved: Plugin script optimization.

= 3.0.1 =
* Changed: Default width and height values for popup properties.
* Fixed: Issue with `iframeBox` shortcode insertion using percentage widths.

= 3.0 =
* Added: New functions in Popup Content Editor.
* Added: Dynamic Content option.
* Added: New shortcodes:
    - `videoBox`: Embed YouTube or Vimeo videos inside popups.
    - `buttonBox`: Add a customizable button or close popup button.
    - `iframeBox`: Insert iframe content (e.g., PDF, map).
* Added: Tag and link options for better organization.
* Improved: Refreshed dashboard interface for a more user-friendly experience.
* Fixed: Various minor bugs.

= 2.2.7 =
* Fixed: Minor nonce validation bug.

= 2.2.6 =
* Fixed: Minor bug during database creation.

= 2.2.5 =
* Fixed: Compatibility with dynamic properties for PHP 8.2.

= 2.2.4 =
* Fixed: Test Mode showing popups sitewide despite display rule settings.

= 2.2.3 =
* Fixed: Minor bug with `current_screen` detection.

= 2.2.2 =
* Fixed: Minor bug in page list functionality.

= 2.2.1 =
* Fixed: Security improvements.

= 2.2 =
* Fixed: Minor bugs.
* Fixed: Security vulnerabilities.
* Updated: Support page layout.

= 2.1.2 =
* Fixed: Database update bug.

= 2.1.1 =
* Fixed: Popup Activate/Deactivate function.

= 2.1 =
* Added: Import/Export popup settings.
* Changed: Support page update.

= 2.0 =
* Added: New placement options for popups.
* Changed: Removed dependency on jQuery.

= 1.1.2 =
* Fixed: Close popup class issue.

= 1.1.1 =
* Fixed: Correct placement of the close button outside the popup content.

= 1.1 =
* Fixed: Display popup on selected pages.

= 1.0.2 =
* Added: `document ready` wrapper for script loading.

= 1.0.1 =
* Fixed: Compatibility with page builder plugins.

= 1.0 =
* Initial release.