hallowebsite Filter Gallery

Overview

hallowebsite Filter Gallery builds filterable image galleries straight from your Media Library. You put images together in a gallery, sort them by drag & drop, and output them as masonry, a fixed grid or justified rows. Visitors can filter by any taxonomy attached to your media (colour, style, project type …). It uses the Kadence lightbox when available and has its own lightbox as a fallback.

Features

• Gallery post type Galleries with a drag & drop image picker.
• Three layouts: Masonry, Fixed grid (with aspect ratio and cover/contain), Justified rows (mosaic).
• Multi-taxonomy filter: OR within a group, AND across groups (or pure OR / pure AND).
• Filter buttons can show a background image from term meta (JetEngine, ACF or any term meta field).
• Captions from title, caption, description and/or alt text, shown on hover or always.
• Global defaults on the settings page. Every value can be overridden per shortcode.
• Choose images by ID without a gallery post, and include, exclude or preselect terms.

Requirements

• For filters: at least one taxonomy registered for attachment (e.g. created with JetEngine, ACF or CPT UI).
• Optional: Kadence Blocks for the native lightbox.

Quick start

1. Go to Galleries → Add New, click Add / Choose Images and sort the images.
2. Assign your media taxonomy terms to the images in the Media Library.
3. Set the defaults in Settings → Hallo Filter Gallery (layout, columns, filters).
4. Place the shortcode [hfg_gallery id="123"] on any page.

Shortcode examples

[hfg_gallery id="123"]
[hfg_gallery images="55,12,99,101"]                  (order is respected)
[hfg_gallery id="123" only_images="99,101,12"]       (subset + reorder)
[hfg_gallery id="123" add_images="55,12"]            (append images)
[hfg_gallery id="123" only_terms="farbe:rot,blau;stil:minimal"]
[hfg_gallery id="123" exclude_terms="farbe:gruen"]
[hfg_gallery id="123" preselect_terms="farbe:rot,blau"]
[hfg_gallery id="123" display_mode="justified" row_height_desktop="260"]
[hfg_gallery id="123" filter_btn_bg_enabled="1" filter_btn_bg_meta_key="image" filter_btn_bg_size="large"]

Shortcode attributes

Attribute	Values	Description
id	Gallery ID	The gallery post to output.
images / only_images / add_images	Attachment IDs	Use your own image list, a subset of the gallery, or append images.
only_terms / exclude_terms	tax:term,term;tax2:term	Hard include/exclude by taxonomy terms.
preselect_terms	same syntax	Filter buttons that are active on page load.
display_mode	masonry, fixed_grid, justified	Layout.
gap	px	Space between images (default 16).
columns_desktop/tablet/mobile	number	Columns per breakpoint (default 4/3/2).
grid_ratio, grid_ratio_custom, grid_fit	1:1, 4:3, 3:2, 16:9, custom · cover/contain	Fixed grid options.
row_height_desktop/tablet/mobile, justify_last_row	px · left/center/justify	Justified rows options (default 220/200/160).
image_size	WP image size	Default large.
filters_enabled, taxonomies	1/0, taxonomy slugs	Show filters and choose the taxonomy groups.
filter_mode	and_groups_or_within, or_everything, and_everything	Filter logic.
reset_position, reset_end	beginning/end, 1/0	Position of the reset button, optional extra reset button below the gallery.
captions_display	hover/always	When captions are visible.
filter_btn_bg_enabled, filter_btn_bg_meta_key, filter_btn_bg_size	1, meta key, image size	Background images for filter buttons from term meta.

Notes

• Shortcode attributes always override the global settings.
• Images are never copied. The gallery only references Media Library items.

Changed:
- Rebranding: neuer Name „hallowebsite Filter Gallery“, Autor hallowebsite, Plugin-URI https://hallowebsite.de/plugins/filter-gallery/
- Keine funktionalen Änderungen.