=== WebsitesIdea Popup Ads ===
Contributors: websitesidea
Tags: popup, ads, advertisement, banner, promotion
Requires at least: 5.0
Tested up to: 6.6
Stable tag: 1.6.5
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display custom ads in a responsive popup with flexible positioning, aspect ratios, and display frequency control.

== Description ==

WebsitesIdea Popup Ads is a lightweight and user-friendly WordPress plugin designed to display custom advertisements in a responsive popup. Perfect for showcasing promotions, banners, or custom content, the plugin offers a seamless way to engage your audience without disrupting their browsing experience.

### Key Features
- **Custom Ad Content**: Display images from the WordPress media library or custom HTML content.
- **Flexible Positioning**: Choose from nine popup positions (center, top-left, top-center, top-right, bottom-left, bottom-center, bottom-right, left-center, right-center).
- **Aspect Ratio Control**: Select from fixed ratios (1:1, 16:9, 9:16) for consistent ad display.
- **Display Frequency**: Set how many times the popup appears per user using cookie-based tracking.
- **Responsive Design**: Adapts to desktop and mobile devices with max-width/height constraints.
- **User-Friendly Interface**: Easily configure settings via the WordPress admin panel with media library integration.
- **Customizable Close Button**: Square white button with a black '×' icon for intuitive popup closure.

Ideal for website owners looking to promote products, services, or announcements in a non-intrusive, customizable popup.

### Why Choose WebsitesIdea Popup Ads?
- Lightweight and optimized for performance.
- No external dependencies beyond jQuery (included with WordPress).
- Fully manual ad control for maximum flexibility.
- Compliant with WordPress coding standards.
- Translation-ready with support for multiple languages.

Visit our [plugin page](https://websitesidea.com/business-tools/product/websitesidea-popup-ads) for more details or explore our [other plugins](https://websitesidea.com/business-tools/product-category/plugins/).

== Installation ==

1. Upload the `websitesidea-popup-ads` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Navigate to **Settings > Popup Ads** to configure your ad settings.
4. Upload an image or enter HTML content, select a popup position and aspect ratio, and set the display frequency.
5. Save your settings, and the popup will appear on your site based on your configuration.

== Frequently Asked Questions ==

= Can I use both an image and HTML content in the popup? =
The plugin prioritizes the image if one is uploaded via the media library. If no image is set, it will use the HTML content provided.

= How does the display frequency work? =
The plugin uses cookies to track how many times the popup has been shown to a user. You can set the maximum number of displays per user in the settings.

= Is the popup responsive? =
Yes, the popup is designed to be responsive, with maximum width and height set to 90% of the viewport, and it adjusts sizes for mobile devices.

= Can I customize the popup position? =
Yes, you can choose from nine positions: center, top-left, top-center, top-right, bottom-left, bottom-center, bottom-right, left-center, and right-center.

= Does this plugin support AdSense or other ad networks? =
No, this plugin is designed for manual ad content (images or HTML) and does not integrate with ad networks like AdSense.

== Screenshots ==

1. Admin settings page with options for ad content, position, ratio, and display frequency.
2. Frontend popup displaying a custom image ad with a close button.
3. Responsive popup on a mobile device with adjusted sizing.

== Changelog ==

= 1.6.5 =
* Reverted to HTML-only ad support for simplicity, removing separate JavaScript field.

= 1.6.2 =
* Added plugin list sidebar in the admin settings page with a link to other plugins.

= 1.6.1 =
* Fixed close button styling to use a square white background with a black '×' icon, positioned inside the popup.

= 1.6.0 =
* Removed AdSense detection, manual ad toggle, and auto ratio detection for fully manual operation.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.6.5 =
This update reverts to HTML-only ad support, simplifying ad configuration while maintaining all other features.

== License ==
This plugin is licensed under the GPLv2 or later. You are free to use, modify, and distribute it in accordance with the license terms.