Portfolio Filter Gallery

Portfolio Filter Gallery is a WordPress plugin built to help you organize and display your creative work. It provides a structured way to present images and videos, allowing visitors to filter content by category.

Demo Links

• Plugin Features
• Gallery Demo Pro

Support Links

• Documentation
• Support Forum

What This Plugin Does

The core function of Portfolio Filter Gallery is to let you build galleries where users can click filter buttons to view specific categories of work. Instead of scrolling through an entire page of images, a visitor can select “Web Design” or “Photography” and see only those items.

The plugin includes a dedicated page for managing filter categories. You create your filters once, then assign them to individual images or videos as you build your gallery. This separation keeps your workflow clean and organized.

Use Cases

This plugin suits a range of users and projects:

• Photographers displaying work by genre (portraits, landscapes, events)
• Web designers showcasing projects by type (e-commerce, corporate, landing pages)
• Agencies presenting client work across different industries
• Architects organizing projects by category (residential, commercial, renovations)
• Artists grouping pieces by medium or theme
• Freelancers building a professional online presence

Free Features

Gallery Filtering

• Manage filters through a separate category interface
• Assign multiple filters to each gallery item
• CSS3 animations for smooth filter transitions

Layout Options

• Masonry layout that adapts to varying image dimensions
• Grid layout for uniform presentation
• Column options: 2, 3, or 4 columns
• Configurable spacing between items

Video Support

• Embed YouTube videos
• Embed Vimeo videos
• Watch videos via external links

Customization

• Show or hide image titles
• Optional image numbering
• Grayscale effect on hover
• Customizable filter button colors
• Border width and color settings

Premium Features

The premium version extends the plugin with additional capabilities:

Advanced Features

• URL-based filtering (load a page with a specific filter pre-selected)
• Default filter selection on page load
• Ascending/descending sort controls
• Shuffle button for randomized display
• Search functionality within galleries
• Watermark overlay support

Extended Customization

• Unlimited filter color schemes
• Custom thumbnail dimensions
• Responsive column control per device type (desktop, tablet, mobile)
• Dropdown-style filter menu

How to Use Portfolio Filter Gallery

1. Navigate to Portfolio Gallery > Filters in your WordPress dashboard
2. Create the filter categories you need
3. Go to Portfolio Gallery > Add New to create a gallery
4. Upload images, add video URLs, and assign filters to each item
5. Adjust settings for layout and appearance
6. Copy the generated shortcode and paste it into any page or post

The shortcode follows this format:
[Portfolio_Gallery id=”123″]

Replace “123” with your gallery’s ID.

Masonry Layout

The masonry layout arranges images in a Pinterest-style grid. Images of different sizes fit together naturally without requiring uniform dimensions. This layout includes:

• Automatic adjustment to image proportions
• CSS3 animation effects
• Full compatibility with filtering and sorting

Linking Portfolio Items

You can attach custom URLs to individual gallery items. This allows you to:

• Link images to project detail pages
• Direct users to external client websites
• Open links in the same tab or a new tab

Page Builder Compatibility

Portfolio Filter Gallery works with standard WordPress editing tools and popular page builders:

• Gutenberg block editor
• Elementor
• WPBakery Page Builder
• Divi Builder
• Beaver Builder

Simply paste the shortcode into any text block or widget.

Support

For questions or troubleshooting, visit the Support Forum. The development team typically responds within the same day.

Shortcode Usage

Copy the shortcode from your gallery and paste it into any page, post, or widget:
[Portfolio_Gallery id=”123″]
Replace “123” with your actual gallery ID.

Browser Compatibility

Portfolio Filter Gallery works on all modern browsers:
* Google Chrome
* Mozilla Firefox
* Apple Safari
* Microsoft Edge
* Opera
* iOS Safari & Android browsers

Security & Privacy

• GDPR Compliant
• No data collection
• Secure code following WordPress standards
• Regular security updates

Contact & Support

• WordPress Support Forum
• Premium Support
• Documentation
• Video Tutorials

Third-Party Libraries

This plugin uses standard WordPress libraries. No external third-party libraries are bundled.

Automatic Installation

1. Go to WordPress Dashboard → Plugins → Add New
2. Search for “Portfolio Filter Gallery”
3. Click “Install Now” and then “Activate”

Manual Installation

1. Download the plugin from WordPress.org
2. Upload the portfolio-filter-gallery folder to /wp-content/plugins/
3. Activate the plugin through the ‘Plugins’ menu in WordPress

Getting Started

1. Go to Portfolio Gallery → Filters to create your filter categories
2. Go to Portfolio Gallery → Add New to create your gallery
3. Upload images and assign filters to each image
4. Configure your gallery settings (layout, colors)
5. Copy the shortcode and paste it into any page or post

1. 

   Portfolio Filter Gallery 3 Column With Number And Title

2. 

   Portfolio Filter Gallery Without Spacing

3. 

   Portfolio Filter Gallery With 2 Column Layout

2.1.3

• Added: Enable/Disable Lightbox toggle setting in individual gallery meta boxes.
• Improved: Pro Banner design in filter and settings pages.
• Fixed: Lightbox setting mapping in schema for proper saving/retrieval.

2.1.2

• Fixed: JavaScript error on image edit modal (undefined variable).
• Fixed: escapeHtml scope issue causing save failure in modal editor.
• Security: Hardened all dynamic DOM insertions with output escaping in admin JS.
• Removed: Deprecated layout options and unused repair feature.
• Code cleanup and minor bug fixes.

2.1.1

• Compliance: Removed Pro Features admin menu page and all associated upsell/gating UI.
• Compliance: Removed built-in lightbox to conform with free-only restrictions.
• Compliance: Removed all premium WooCommerce integrations.
• Compliance: Removed documentation for features not present in this release.

2.1.0

• Removed: Custom CSS textarea (WordPress has a built-in CSS editor in the Customizer)
• Removed: Unused Bootstrap JS/CSS files (not enqueued, legacy only)
• Removed: Unused bs5-lightbox files (index.bundle.min.js, boot.css)
• Removed: Remote placeholder.com URL references
• Fixed: Inline style tag in Pro Features page moved to properly enqueued CSS file
• Added: Third-party library source documentation in readme
• Compliance: Resolved all WordPress.org Plugin Directory review issues

2.0.8

• Security: Comprehensive security audit — nonce verification, input sanitization, and output escaping across all files
• Security: Replaced deprecated unlink() with wp_delete_file(), date() with gmdate()
• Fixed: Added translators comments for all translatable strings with placeholders
• Fixed: Unordered sprintf placeholders corrected
• Removed: Pro feature indicators from free version UI (Fancybox/PhotoSwipe in settings)
• Removed: All upsell banners, cards, and marketing content from free version
• Improved: WordPress.org Plugin Check compliance
• Fixed: Gallery items with deleted media attachments no longer show broken images on frontend
• Added: Grid Aspect Ratio setting (Pro feature) – visible in admin with Pro badge

2.0.7

• Fixed: New images added to existing galleries disappearing on update

2.0.6

• Fixed: Description text color now uses caption color setting instead of hardcoded value
• Fixed: Masonry columns now display horizontally instead of vertically

2.0.5

• Fixed: Legacy migration now correctly extracts alt text, descriptions, and links
• Fixed: External link images now properly set Link Type to “Link to External URL” after migration
• Improved: Re-migration functionality to repair galleries with missing data

2.0.4

• Added: LD Lightbox is now filter-aware – lightbox only shows visible (filtered) images
• Improved: All lightbox libraries (Fancybox, PhotoSwipe, LD Lightbox) now respect active filters
• Improved: Lightbox navigation correctly shows “Image X of Y” based on filtered count

2.0.3

• Added: Comprehensive documentation page with sidebar navigation
• Added: Both free and premium versions can now be active simultaneously (premium takes priority)
• Improved: Premium detection system for seamless upgrades
• Fixed: Function conflicts when both versions active

2.0.2

• Added: Filter multiple languages support
• Added: Search Placeholder field in gallery settings
• Fixed: Show Title toggle not saving when OFF
• Fixed: Columns/Gap settings preserved on template change

2.0.1

• Bug Fixed

2.0.0

Major Update – Complete Redesign

This is a major update with a completely redesigned interface. Your existing galleries and data will be automatically migrated and preserved.

• New: Completely redesigned admin interface with modern UI
• New: Enhanced image management with drag-and-drop ordering
• New: Improved modal editor for individual image settings
• New: Bulk selection and batch operations
• New: Filter hierarchy support with parent-child relationships
• New: Multiple lightbox options (LD Lightbox, Bootstrap Lightbox)
• New: Enhanced migration system for legacy data
• New: Version tracking for future upgrade logic
• Improved: Better PHP 8.x compatibility with strict type handling
• Improved: Performance optimizations for large galleries
• Fixed: Sanitize_title error with legacy filter data stored as arrays
• Fixed: Filter count migration from legacy versions
• Fixed: Version conflict handling when both Free and Premium active

1.7.5

• Text domain error fixed.
• Tested with WordPress version 6.9

1.7.4

• Text domain error fixed.
• Tested with WordPress version 6.8.3

1.7.2

• Regular plugin check and update.
• Tested with WordPress version 6.8

1.7.1

• Linking Fixed.
• Tested with WordPress version 6.7.2

1.7.0

• Image stacking fixed.
• Tested with WordPress version 6.7

1.6.9

• Filter select box error fix.
• Tested with WordPress version 6.7

1.6.8

• Alphabetical image sorting issue fixed.
• Tested with WordPress version 6.6.2

1.6.7

• Image border issue fixed.
• Tested with WordPress version 6.6.1

1.6.6

• Lightbox error fixed.

1.6.5

• Lightbox sanitization fixed.

1.6.4

• Filter alignment fixed.
• Tested with WordPress version 6.5.5

1.6.3

• Bootstrap CSS fixed.

1.6.2

• Tested with WordPress version 6.5.4

1.6.1

• Bootstrap extra menu CSS removed.