=== Threshold Filterable Portfolio ===
Contributors: spencertaylor
Tags: portfolio, gallery, filter, lightbox, shortcode
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A filterable photo portfolio with configurable filter groups, six filter-bar layouts, shareable filter links, and a built-in lightbox. No page builder required.

== Description ==

Threshold Filterable Portfolio adds a Portfolio post type whose items are photos tagged with the filter groups you define (Treatment, Room, Town, Brand out of the box). One shortcode renders the grid and a filter bar; filters are OR within a group and AND across groups, and they live in the page address so a filtered view can be linked, bookmarked, or sent to a client.

* **Configurable filter groups** – add, rename, reorder, and nest them (regions hold towns). Each is a checkbox box on the item screen, never free typing.
* **Six filter-bar layouts** – stacked groups, single scrolling row, dropdowns, first group + Refine, sidebar, and drawer. Pick a site default and override per shortcode; `layout="all"` puts a switcher on a test page so a client can compare them.
* **Pre-filtered slices** – `[tfp_portfolio town="avalon" limit="6" filters="no"]` drops six photos on a town or service page.
* **Appearance tab** – accent, text, border, and chip colors, chip and photo corner radius, thumbnail shape, grid gap, hover zoom, and a custom CSS box, all written as CSS variables so the theme stays untouched.
* **Lightbox** – keyboard and swipe navigation, captions from the item excerpt; switch it off per shortcode or site-wide.
* **Usage tab** – every shortcode attribute, copy buttons, and examples filled in with the site's own term slugs.
* **WP-CLI import and export** – `wp tfp import photos.csv` creates or updates items from a spreadsheet, downloads or attaches photos, and tags them.
* **Self-hosted updates** – the plugin updates itself from the Threshold update server and enrols in WordPress auto-updates.

== Installation ==

1. Upload the plugin ZIP on Plugins → Add New → Upload Plugin and activate it.
2. Portfolio → Settings → Filter Groups: keep the defaults or define your own.
3. Portfolio → Add New: title, photo, tick the groups.
4. Paste `[tfp_portfolio]` into a page. Portfolio → Settings → Usage lists every attribute.

== Frequently Asked Questions ==

= Can I change a group's key later? =

Rename the labels freely. Changing the key disconnects items from their existing terms because the key is part of the taxonomy name; re-tag or re-import afterwards.

= Does it work inside Divi, Elementor, or Kadence? =

Yes. Any block or module that runs shortcodes works: a Shortcode block, a Divi Code module, an Elementor Shortcode widget, or a Kadence Advanced Text block.

= What does uninstall remove? =

Settings and caches always. Items and terms only when "Delete data" is ticked on the General tab.

== Changelog ==

= 1.0.0 — 2026-11-06 =
* Initial release: Portfolio post type, configurable filter groups, six filter-bar layouts with URL-synced filtering, lightbox, Appearance tab with CSS variables and custom CSS, Usage tab with live examples, WP-CLI import/export, Threshold updater and auto-update enrolment, uninstall with optional data removal.
