=== Filter Gallery ===
Contributors: awordpresslife, razipathhan, hanif0991, muhammadshahid, fkfaisalkhan007, sharikkhan007, zishlife, FARAZFRANK
Donate link: https://wpfrank.com/
Tags: responsive, filter gallery, portfolio, image gallery, masonry
Requires at least: 4.0
Tested up to: 6.9
Stable tag: 0.2.3
Requires PHP: 5.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Build a responsive filter gallery for your portfolio. Organize images with filters in a stunning grid or masonry layout easily.

== Description ==

The **Responsive Filter Gallery** plugin makes it simple to create beautiful, organized image displays on your WordPress site. Whether you need a professional portfolio showcase, a product catalog, or a creative photography album, this tool lets you sort content dynamically without page reloads.

**Check Free Version Demo:** [Filter Gallery](https://wpfrank.com/demo/filter-gallery-free-wordpress-pluign/)
**Check Pro Version Demo:** [Filter Gallery Pro](https://wpfrank.com/demo/filter-gallery-pro/)
**More About Pro:** [Filter Gallery Pro Features](https://wpfrank.com/wordpress-plugins/filter-gallery-pro/)
**Where To Buy:** [Buy Filter Gallery Pro](https://wpfrank.com/account/signup/filter-gallery-pro)

= Video Tutorials =

https://www.youtube.com/watch?v=tV4AvFGgC2U

We designed this plugin to be intuitive and lightweight. You can upload images, assign them to categories (filters), and let your visitors browse your work seamlessly. The gallery automatically adapts to desktops, tablets, and mobile screens, ensuring a perfect viewing experience everywhere.

= Key Features =

*   **Responsive Design:** Automatically adapts to any screen size.
*   **Filterable Categories:** meaningful tags to organize your projects or products.
*   **Bootstrap Integrated:** Built on the solid foundation of Bootstrap for reliability.
*   **Easy Management:** Simple drag-and-drop interface for ordering images.
*   **Unlimited Galleries:** Create as many distinctive galleries as you need.
*   **Lightbox Support:** Includes a built-in lightbox for viewing full-size images.
*   **Shortcode System:** precise placement of galleries anywhere on your site.

= Pro Version Features =

Unlock the full potential of your portfolios with the Pro Version:

*   **Unlimited Filters:** Create deep folder structures with parent and child filters.
*   **Advanced Layouts:** Choose from Masonry, multi-column (2, 3, 4), and more.
*   **Custom Styling:** Full control over colors for buttons, titles, and active states.
*   **SEO Optimization:** Add "Alt" text to images for better search engine visibility.
*   **External Linking:** Link gallery images to custom URLs.
*   **Hover Effects:** Choose from multiple distinct hover animations.
*   **Premium Support:** Get priority assistance for any questions.

== Installation ==

1.  Upload the `filter-gallery` folder to the `/wp-content/plugins/` directory.
2.  Activate the plugin through the 'Plugins' menu in WordPress.
3.  Navigate to the "Filter Gallery" menu to create your first gallery.
4.  Add filters (categories) and upload your images.
5.  Copy the generated shortcode and paste it into any Post or Page.

== Frequently Asked Questions ==

= How do I create a new filter? =
Go to the gallery edit page. You will see a "Filters" section where you can add new filter names. Once added, you can assign these filters to your uploaded images.

= Is the gallery responsive? =
Yes, the gallery grid is fully responsive and will adjust the number of columns based on the viewing device (mobile, tablet, or desktop).

= Can I link images to other pages? =
In the free version, images open in a lightbox. The Pro version allows you to link images to custom external or internal URLs.

= Does this modify my theme files? =
No, this plugin works independently of your theme. It uses its own styles and scripts which are loaded only when the shortcode is used.

= Can I place multiple galleries on one page? =
No, you can add only one gallery to a single page or post.

= Does this plugin work with page builders like Elementor, Divi, or Beaver Builder? =
Absolutely! Since the gallery uses shortcodes, you can easily paste the shortcode into any "Shortcode" or "Text" widget within your favorite page builder.

= How do I reorder my images? =
The plugin features a simple drag-and-drop interface. Just drag your images into your preferred order in the admin panel and save.

= How do I upgrade to the Pro version? =
You can visit our website at [wpfrank.com](https://wpfrank.com/) to purchase the Pro version.

== Screenshots ==

1.  Animal Gallery: A sample of how the filterable gallery looks on the frontend.
2.  Art Gallery
3.  Portrait Gallery
4.  Sports Gallery Preview
5.  How to create a filter gallery?**

== Changelog ==

= 0.2.3 =
* Fixed Requires PHP header mismatch between readme and plugin file
* Added proper input sanitization for POST data
* Added object caching for database queries
* Code improvements to meet WordPress coding standards

= 0.2.2 =
* Security patches implemented
* Updated plugin guidelines compliance

= 0.2.1 =
* Renamed plugin to comply with trademark policy
* Tested with WordPress 6.8.1

= 0.2.0 =
* New translations added:
    * Arabic (ar)
    * Chinese (zh_CN)
    * Finnish (fi)
    * French (fr_FR)
    * German (de_DE)
    * Hindi (hi_IN)
    * Hungarian (hu_HU)

= 0.1.9 =
* Fixed: Filters not showing on front end
* Fixed: WP Debug issue

= 0.1.8 =
* Fixed: Lightbox functionality issues

== Upgrade Notice ==

= 0.2.3 =
* Fixed Requires PHP header mismatch between readme and plugin file