=== PDF Gallery – Turn Files into Clean Galleries ===
Contributors: kindpixels
Plugin URI: https://kindpixels.com/plugins/pdf-gallery/
Donate link: https://kindpixels.com/donate
Tags: PDF Gallery, lightbox, Document Gallery, PDF Showcase, File Gallery
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 2.6.3
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.6.3 =
* New: Redesigned placeholder image settings with side-by-side card selection
* New: Custom placeholder supports drag & drop upload
* New: Engagement notice for active free users encouraging ratings and feedback
* Improved: Token Map hover highlights for grouped elements (titles, subtitles, thumbnails)
* Fix: Transparent background checkbox now properly toggleable

= 2.6.2 =
* New: YouTube uploads via link now include a Subtitle field, auto-populated with channel name
* New: WP Media Library title and description now auto-populate Title and Subtitle fields
* Fix: Enhanced keyboard scrolling inside lightbox
* Fix: Analytics chart correctly aggregates data monthly for 365-day view
* Improved upload form UX with subtitle support across all methods

= 2.6.0 =
* New: Comprehensive Color Settings with preset themes (Default, Dark, Warm, Forest, Ocean)
* New: Interactive Token Map — click any gallery element to edit its color visually
* New: Transparent gallery background option (default for Default preset)
* New: Custom preset — any manual change is saved as a Custom preset
* Fix: Gradient Zoom style now centers both title and subtitle under thumbnail
* Improved color picker alignment and usability

= 2.5.5 =
* Fix: Update button now triggers in-page update instead of redirecting away
* Fix: Fallback redirect now scrolls to and highlights the plugin row
* Improved iframe-to-parent communication for WordPress AJAX updates

= 2.5.4 =
* Fix: Frontend gallery loading issue on certain themes (changed iframe to eager loading)
* Fix: Update button no longer hangs indefinitely — falls back to plugins page after 10 seconds
* Improvement: Vertical alignment of accent color preview in Settings

= 2.5.3 =
* Fix: Accent color now properly updates on frontend shortcode after saving
* Improvement: Frontend settings fetch now includes gallery context for per-gallery settings

= 2.5.2 =
* Fix: Lightbox scroll onboarding now correctly resets when navigating between documents
* Minor stability improvements

= 2.5.1 =
* New saturation-based color picker for accent color settings
* Redesigned accent color section with full-width card preview

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

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

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

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

= 2.4.7 =
* Added gap size setting for gallery spacing customization

= 2.4.6 =
* Added upload via link feature

= 2.4.2 =
* Added File Analytics with views and clicks tracking (Pro)
* Cross-gallery navigation in analytics modal

= 2.3.0 =
* Added YouTube video support — paste YouTube URLs directly
* YouTube thumbnails and titles fetched automatically

= 2.2.0 =
* Added multi-select with Shift+click for bulk operations
* Added bulk delete functionality

= 2.1.0 =
* Added section dividers for document organization
* Added masonry layout option

= 2.0.0 =
* Complete redesign with modern React-based interface
* Added lightbox document viewer with zoom and navigation
* Added multiple thumbnail styles and hover animations

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 2.6.3 =
Redesigned placeholder settings. Engagement notice for free users. Token Map hover improvements.

= 2.6.2 =
Lightbox keyboard scrolling fix. Analytics date range filtering and chart aggregation improvements.

= 2.6.1 =

= 2.6.0 =
New Color Settings with preset themes, interactive visual editor, and transparent background support.

= 2.5.4 =
Bug fixes for frontend rendering and accent color sync. Improved lightbox onboarding.

= 2.5.0 =
Redesigned Gradient Zoom style and Accent Color settings.

= 2.4.11 =
Scroll onboarding for multi-page PDFs. Enter key saves edits.

= 2.4.2 =
File Analytics now available for Pro users.

= 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.
