=== KindPixels PDF Gallery – Turn Files into Clean Galleries ===
Contributors: kindpixels
Plugin URI: https://kindpixels.com/plugins/pdf-gallery/
Tags: pdf, gallery, showcase, viewer, lightbox
Requires at least: 5.8
Tested up to: 7.0
Stable tag: 2.7.1
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 ==

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 PDF Gallery 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.7.1 =
* Improved: Enhancements to the updating process.
* Minor stability improvements

= 2.7.0 =
* New: Gallery toolbar makeover, enhanced with collapsible options panel with live search (shows matching file count), sorting, and normal / compact list view
* Compatibility: Tested with WordPress 7.0
* Minor stability improvements

= 2.6.8 =
* Fix: Lightbox thumbnails no longer overlap with the document content
* Improvements for the update UX
* Other bug fixes

= 2.6.6 =
* Improved: Zoom controls now always visible in lightbox top bar
* Improved: Click-to-zoom now doubles current zoom level instead of fixed 200%
* Minor stability improvements

= 2.6.5 =
* Fix: Keyboard navigation (arrow keys, Page Up/Down) now works immediately in fullscreen mode
* Fix: Analytics summary cards now display correct totals from backend data
* Minor stability improvements

= 2.6.4 =
* New: Fullscreen mode in lightbox with immersive document viewing
* Minor stability improvements

= 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.7.1 =
One-click updates straight from the plugin's update notice.

= 2.7.0 =
Redesigned Galleries toolbar with search, sorting and compact view. Tested with the latest WordPress.

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