=== Easiest Popup Image/PDF ===
Contributors: softwaregutachten
Donate link: https://softwaregutachten.at/wp-plugin-forge/
Tags: popup, image, pdf, overlay, responsive
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.0
Stable tag: 1.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A simple and responsive popup plugin for WordPress pages. Display an image or PDF in a modal window with per-page activation, cookie support, and an optional call-to-action button.

== Description ==

**Easiest Popup Image/PDF** is a lightweight and responsive WordPress plugin that displays a popup (modal overlay) with an image or PDF file. You can activate the popup on individual pages, show it only on the user's first visit (with cookie logic), add a heading (H1), and optionally include a customizable call-to-action button.

**Features:**
- Show image or PDF files in a modern popup overlay
- Activate the popup only on selected pages (no posts)
- Select files directly from the WordPress Media Library
- Optional heading (H1) above the content
- Optional call-to-action button (custom text and link)
- Responsive design, with PDF mobile fallback (download link)
- Optionally show only on the first visit (cookie, 30 days)
- Admin settings page with live file preview
- No shortcodes needed – simply use the admin interface

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/easiest-popup-image-pdf` directory, or install via the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to the new menu entry "Easy JPG/PDF Popup" in the WordPress admin sidebar.
4. Configure the popup:  
   - Activate/deactivate the popup  
   - Select an image or PDF from the Media Library  
   - Optionally add a heading, button text, and button link  
   - Choose on which pages the popup should be displayed  
   - Optionally set PDF height and first-visit-only logic  
   - Save your changes  
5. Visit the selected page(s) on your site – the popup will appear.

== Frequently Asked Questions ==

= Does the popup work on posts or custom post types? =
No, currently the popup only supports classic pages (no posts or custom types).

= Can I use both an image and a PDF at the same time? =
No, you can only choose one file per popup.

= Does the plugin support translations? =
Yes! Please use the provided .pot file to create your own translation.

== Screenshots ==

1. Admin settings page: Select image or PDF, customize heading and button.
2. Example of a popup with image.
3. Example of a popup with PDF and download button (on mobile).

== Changelog ==

= 1.6 =
* Unique prefix "easipoim_" for all settings, functions, classes and options.
* Improved WordPress.org repository compliance.
* Version and sanitization best practices added.

= 1.5 =
* Added optional button with custom label and link.
* Code review for best practices.

= 1.4 =
* Improved settings page.
* Security improvements and escaping.

= 1.0 =
* Initial release.

== Upgrade Notice ==

= 1.6 =
Update required for repository acceptance and improved compatibility.

== License ==

This plugin is free software, released under the GPLv2 (or later).

== Credits ==

Developed by Horst A. Kandutsch | [www.softwaregutachten.at](https://www.softwaregutachten.at)