Webcasata Filter Gallery
| 开发者 | webcasata |
|---|---|
| 更新时间 | 2026年6月27日 14:34 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPL-2.0+ |
| 版权网址: | 版权信息 |
详情介绍:
Webcasata Filter Gallery lets you build stunning, responsive image galleries where visitors can instantly filter images using custom dropdown menus — all without any page reload.
Key Features
- Multi-group dropdown filtering — Create filter groups (e.g. "Country", "Room Type"). Each becomes a styled dropdown on the front end.
- AND logic across groups, OR within a group — Country=India AND Room=Kitchen; image can belong to multiple countries.
- Custom styled dropdowns — Single-select, closes on pick, with active pill indicators.
- Real-time title search — Search box with 220ms debounce filters images as you type.
- Equal Grid & Masonry layouts — Choose your preferred display style.
- Configurable columns — 1 to 6 columns with automatic responsive breakpoints.
- Slide / Fade / None animations — Smooth transitions when switching filters.
- Load More pagination — Shows a configurable number of images on load; load more on click. Set to -1 to show all.
- Built-in Lightbox — Full-screen image viewer with prev/next, keyboard support, and optional Visit Link button.
- Image URL link — Assign an external URL to any image, with optional new tab.
- Image Title & Caption — Display below each image. Title hideable via shortcode.
- Filter labels on image cards — Show assigned filter values as badge labels or ribbons.
- Template override system — WooCommerce-style. Copy templates to your theme to customise layout completely.
- Shortcode —
[wbfg_gallery id="X"]with full inline attribute overrides. - Gutenberg Block — Live preview block with full sidebar controls.
- Per-gallery custom CSS — Fine-tune each gallery independently.
- Global settings — Control defaults for all galleries from one Settings page.
- Accessibility — ARIA roles, keyboard-navigable dropdowns, focus management.
- Fully responsive — Mobile-first CSS with sensible breakpoints.
your-theme/webcasata-filter-gallery/image-card.php
your-theme/webcasata-filter-gallery/gallery-template.php
All image variables are available in image-card.php: $image, $title, $caption, $link_url, $link_new_tab, $filters, $lightbox, $show_title, $index, $gallery_id.
Shortcode Parameters
[wbfg_gallery id="X" columns="3" show_all="yes" per_page="6" loadmore="6" layout="grid" lightbox="yes" animation="slide" title="show"]
| Parameter | Values | Default |
|-------------|-----------------------|--------------|
| id | Gallery post ID | (required) |
| columns | 1–6 | 3 |
| show_all | yes / no | yes |
| per_page | number or -1 | 6 |
| loadmore | number | 6 |
| layout | grid / masonry | grid |
| lightbox | yes / no | yes |
| animation | slide / fade / none | slide |
| title | show / hide | show |
Credits
Developed by Vishal Singh at Webcasata.
安装:
- Upload the
webcasata-filter-galleryfolder to/wp-content/plugins/. - Activate the plugin through Plugins › Installed Plugins.
- Go to Filter Galleries › Add New to create your first gallery.
- Add filter groups and values, upload images, assign filter values, and publish.
- Copy the shortcode from the sidebar and paste it into any page or post.
屏幕截图:
常见问题:
Can one image belong to multiple filter values?
Yes. Each image has a multi-select box per filter group. Hold Ctrl/Cmd to select multiple values — e.g. a cuisine image can be tagged as both India and USA.
How does the filtering logic work?
AND logic across groups, OR within a group. If you select Country=India and Room=Kitchen, only images assigned to India (or both India and USA) AND Kitchen are shown.
Can I customise the image card layout?
Yes — copy image-card.php from the plugin's templates/ folder to your-theme/webcasata-filter-gallery/image-card.php and edit freely. All image data is available as PHP variables.
How do I show all images without a Load More button?
Set per_page="-1" in the shortcode, or set "Images on Page Load" to -1 in the Settings page.
Does this plugin slow down my site?
CSS and JavaScript are only enqueued on pages that contain a gallery shortcode or block. Images use native loading="lazy".
更新日志:
2.1.0
- New: WooCommerce-style template override system (image-card.php, gallery-template.php).
- New: Filter value labels displayed on each image card (badge and ribbon styles).
- New:
FIG_Templateclass withlocate(),load(),is_overridden()methods. - New: Admin notice showing theme override path and active overrides.
- Improved:
render_item()now delegates to template system; fallback inline renderer kept. - Fix: Per-gallery custom CSS now uses
wp_add_inline_style()instead of inline<style>tag. - Fix: Settings page styles moved to
wp_add_inline_style().
- New: Multi-group dropdown filtering with AND logic across groups, OR within a group.
- New: Custom styled single-select dropdowns replace flat filter tabs.
- New: Images support multiple filter values per group via multi-select admin UI.
- New: Image title displayed below each image (hideable via shortcode title="hide").
- New: Image URL link field with open-in-new-tab option.
- New: Visit Link button inside lightbox when image has a URL.
- New: Real-time title search box with debounce and clear button.
- New: Filter group collapse/expand in admin edit screen.
- New: Active filter pill tags shown above gallery with individual remove buttons.
- New: Initial count supports -1 to show all images (no Load More button).
- Improved: Filter assignment uses scrollable multi-select box (handles 50+ values).
- Improved: All filtering is client-side — instant, no AJAX round-trips.
- Improved: Backward compatible with v1 flat-tag galleries.
- Initial release.