=== Advanced Filterable Gallery ===
Contributors: bharatnaik
Tags: gallery, filterable gallery, lightbox, masonry, portfolio
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A premium, lightweight filterable gallery with 10 layouts, animated category filters, a built-in lightbox, Elementor widget, Gutenberg block and shortcode.

== Description ==

Advanced Filterable Gallery is a modern, professional gallery plugin built with performance and security in mind. It ships with 10 layout styles, 10 hover effects, smooth CSS filter animations, and a beautiful dependency-free lightbox — no jQuery, no Bootstrap.

= Features =

* **10 layout styles** — Basic Grid, Masonry, Modern Cards, Metro Grid, Portfolio, Minimal, Hover Zoom, Image Overlay, Rounded Cards and Premium Animated Grid
* **Category filtering** — automatic animated filter buttons with per-category counters and an "All" tab
* **Built-in lightbox** — zoom, next/previous, keyboard navigation, mobile swipe, captions, 1/20 counter, fullscreen, optional download and copy-link buttons, ESC to close, blurred background
* **10 hover effects** — Zoom, Rotate, Fade, Overlay, Slide, Blur, Icon, Title Overlay, Border Animation
* **Elementor widget** — full live-preview widget with layout, columns, gap, radius, filter, hover, typography, colors and responsive controls (works with Elementor Free and Pro)
* **Gutenberg block** — server-rendered live preview with inspector controls
* **Shortcode** — `[advanced_gallery id="1" layout="masonry" columns="4"]`
* **Gallery manager** — Media Library integration, drag & drop sorting, per-image title, description, alt text, categories, link, featured flag, status and date, plus bulk delete and bulk category assignment
* **Load More & infinite scroll** — AJAX pagination with a nonce-protected endpoint
* **Live search** — filter images by title, description or category as you type
* **Import / Export** — back up or copy galleries as JSON, plus one-click gallery duplication
* **Performance** — conditional asset loading, native lazy loading, responsive `srcset`, no framework dependencies
* **Accessibility** — ARIA labels, keyboard navigation, visible focus states, screen-reader text, reduced-motion support
* **Translation ready** — full i18n support with a bundled POT file
* **Dark mode compatible** and fully responsive from 6 columns on desktop down to 1 on mobile

= Security =

All input is sanitized, all output is escaped, every form and AJAX request is nonce-verified, capabilities are checked, and no file can be accessed directly.

== Installation ==

1. Upload the `advanced-filterable-gallery` folder to `/wp-content/plugins/`, or install the ZIP via Plugins → Add New → Upload Plugin.
2. Activate the plugin through the Plugins screen.
3. Go to **AFG Gallery → Categories** and create your categories (e.g. Nature, Industrial, Events).
4. Go to **AFG Gallery → Add New**, add images from the Media Library, assign categories, and publish.
5. Embed the gallery with the shortcode `[advanced_gallery id="123"]`, the "Advanced Filterable Gallery" Elementor widget, or the Gutenberg block.

== Frequently Asked Questions ==

= Does it require jQuery or Bootstrap? =

No. The frontend is 100% vanilla JavaScript and framework-free CSS.

= Does it work with Elementor Free? =

Yes — the widget works with both Elementor Free and Elementor Pro, including live preview in the editor.

= Can one image belong to multiple categories? =

Yes. Each image can be assigned to any number of categories, and the filter bar is generated automatically.

= Which shortcode parameters are supported? =

`id` (required), `layout`, `columns`, `gap`, `filter`, `popup`, `hover`, `category`, `limit`, `orderby` (menu/date/title/rand), `animation`, `per_page`, `load_mode` (button/infinite) and `search`.

= Will uninstalling delete my galleries? =

No, unless you enable "Delete all data on uninstall" in AFG Gallery → Settings.

== Screenshots ==

1. Frontend gallery with animated category filters
2. Built-in lightbox with counter, captions and fullscreen
3. Gallery image manager with drag & drop sorting and bulk actions
4. Elementor widget controls
5. Plugin dashboard with statistics

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
