=== KindPixels PDF Gallery ===
Contributors: kindpixels
Plugin URI: https://kindpixels.com/plugins/pdf-gallery/
Donate link: https://kindpixels.com/donate
Tags: pdf, gallery, document, viewer, lightbox
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 2.5.2
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create beautiful galleries from PDFs (and other files), with customizable layouts, lightbox viewer, and drag-and-drop management.

== Description ==

PDF Gallery is a plugin that allows you to create stunning document galleries with ease. Display PDF files, Office documents, images, videos, audio files (and even YouTube videos!) in beautiful grid or masonry layouts, with a built-in lightbox viewer. Give it a try!

= Key Features =

* **Create File Galleries** – Turn your files into clean, visual galleries.
* **Built-in Lightbox** – Full-screen document viewer with zoom and navigation.
* **Responsive Design** – Galleries look great on all devices.
* **Thumbnail Styles** – Choose from multiple thumbnail layouts.
* **Advanced Customization** – Fine-tune gallery design and behavior.
* **Section Dividers** – Organize documents into logical sections using dividers and labels.
* **Drag & Drop Ordering** – Reorder documents with simple drag and drop.
* **Shortcode Support** – Embed galleries anywhere on your website using a shortcode.

= Supported File Types =

* PDF documents
* Images (JPG, PNG, GIF, WebP)
* Videos (MP4, YouTube links)
* Audio files (MP3, WAV, OGG)
* Microsoft Office (Word, Excel, PowerPoint)
* Archives (ZIP, RAR, 7Z)
* eBooks (EPUB, MOBI)

= Free vs Pro =

**Free version includes:**
* One gallery with unlimited files
* All display settings and styling options
* Files uploaded one by one

**Pro version adds:**
* Unlimited galleries
* Batch upload for multiple files at once
* File analytics
* Priority support

For a complete comparison, see [the full feature table](https://kindpixels.com/plugins/pdf-gallery#comparison).

== Installation ==

1. In your WordPress dashboard, go to "Plugins → Add New" and search for "KindPixels PDF Gallery" then click "Install Now" and "Activate".
2. Alternatively, upload the `kindpixels-pdf-gallery` folder to the `/wp-content/plugins/` directory via FTP, then activate it from the "Plugins" menu.
3. Go to "PDF Gallery" in your admin menu to create your first gallery.
4. Each gallery has a unique shortcode starting with `[kindpdfg_gallery]` – copy and paste it into any page or post.

== Frequently Asked Questions ==

= How do I display a gallery on my page? =

Each gallery has a unique shortcode that starts with `[kindpdfg_gallery]`. Simply copy the shortcode from the Galleries tab and paste it on any page or post on your website.

= What if I have more questions? =

Once you install the plugin, head over to the Documentation tab where we have an extensive guide covering all features, settings, and customization options.

== Changelog ==

= 2.5.2 =
* Fix: Accent color now properly updates on frontend shortcode after saving in settings
* Fix: Lightbox scroll onboarding now correctly resets when navigating between documents
* Fix: Update button no longer hangs indefinitely - falls back to plugins page after 10 seconds
* Improvement: Frontend settings fetch now includes gallery context for per-gallery settings

= 2.5.1 =
* New color picker for accent color settings
* Minor improvements

= 2.5.0 =
* Polished Gradient Zoom thumbnail style with dual-tone gradient border
* Redesigned the Accent Color section of Settings
* Minor improvements

= 2.4.12 =
* Fixed analytics activity chart not updating when changing date range
* Fixed scroll onboarding not showing for existing users after update
* Minor improvements

= 2.4.11 =
* Added scroll onboarding hints for multi-page PDFs in lightbox
* Enter key now saves when editing files
* Minor UI improvements

= 2.4.10 =
* Fixed Pro welcome banner not showing after upgrade
* Bug fixes

= 2.4.9 =
* Update notifications now visible for Pro users inside the plugin dashboard
* Minor improvements
* Bug fixes

= 2.4.8 =
* Improved post-activation auto-refresh (reduces need for hard refresh)
* Bug fixes

= 2.4.7 =
* Fixed activation flow
* Added gap size setting for gallery spacing customization
* Bug fixes

= 2.4.6 =
* Added upload via link feature
* Bug fixes

= 2.4.5 =
* Added update notification when new version available
* Minor improvements

= 2.4.4 =
* Bug fixes and improvements

= 2.4.3 =
* Improved File Analytics with date range selector (24h, 7 days, 30 days, 365 days, all time)
* Enhanced analytics notification for new galleries
* Build system improvements

= 2.4.2 =
* Added File Analytics with views and clicks tracking (Pro)
* Analytics data collection starts immediately, visible after 7 days
* Cross-gallery navigation in analytics modal
* Bug fixes and improvements

= 2.4.1 =
* Improved documentation and getting started guide
* Updated shortcode examples for clarity
* Minor UI polish

= 2.4.0 =
* Added Pro upgrade path with optional addon for power users
* Improved gallery management interface
* Enhanced file type detection and display

= 2.3.0 =
* Added YouTube video support - paste YouTube URLs directly
* YouTube thumbnails and titles fetched automatically
* Videos play in embedded player within lightbox

= 2.2.0 =
* Added multi-select with Shift+click for bulk operations
* Improved drag and drop with visual feedback
* Added bulk delete functionality

= 2.1.0 =
* Added section dividers for document organization
* Added masonry layout option
* Improved admin interface design
* Enhanced responsive behavior

= 2.0.0 =
* Complete redesign with modern React-based interface
* Added lightbox document viewer with zoom and navigation
* Added multiple thumbnail styles (Flat, Shadow, Lifted, Curled, Stacked)
* Added hover animations (Lift, Grow, Tilt, Glow, Float)
* Improved responsive design for all devices

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 2.4.9 =
Update notifications now visible for Pro users inside the plugin.

= 2.4.8 =
Added update notification in admin UI.

= 2.4.7 =
Bug fixes and improvements.

= 2.4.3 =
Improved File Analytics with date range selector.

= 2.4.2 =
File Analytics now available for Pro users. Track gallery views and document clicks.

= 2.4.1 =
Documentation improvements and UI polish.

= 2.4.0 =
New Pro upgrade path for power users. Enhanced gallery management.

= 2.3.0 =
YouTube video support added. Paste YouTube URLs directly into galleries.

= 2.2.0 =
Multi-select and bulk operations. Improved drag and drop experience.

= 2.1.0 =
Section dividers and masonry layout. Better admin interface.

= 2.0.0 =
Major update with new features. Please backup before upgrading.

== Additional Information ==

= Using the Shortcode =

Each gallery has a unique shortcode. Simply copy it from the Galleries tab and paste it into any page or post:

`[kindpdfg_gallery id="your-gallery-id"]`

All display settings (columns, styles, animations) are configured in the Settings tab – no shortcode parameters needed.

= Source Code =

The full source code for this plugin is available on GitHub:
https://github.com/boshorog/pdf-gallery

= Support =

For support questions, please visit our support forum or contact us through our website.

= Privacy =

This plugin does not collect any personal data. All documents are stored on your WordPress installation.
