Release v1.0.3

WPQuickAttributes — v1.0.3

WPQuickAttributes is a lightweight WooCommerce plugin that displays selected product attribute terms as clickable filter links in a responsive column card layout.

It’s built for stores where you want customers to quickly answer questions like:

• “What is this for?”
• “Which system does it use?”
• “Which type is it?”

Instead of listing products, it lists the available attribute terms and links users straight to the shop (or a category page) with the corresponding WooCommerce filter already applied.

---

What it does

• Shows attribute columns (you choose which WooCommerce attributes)
• Prints each attribute’s terms as links
• Each link points to:
  • the Shop page (default), or
  • a specific Product Category page
• Optional display controls:
  • show term product counts (n)
  • hide empty terms
  • order terms by Name, Menu Order, or Count
• Term label overrides (change what the user sees without changing the underlying term slug)
• Polylang support (optional): per-language label overrides and language-aware URLs
• Caching via WordPress transients (default TTL: 1 hour) with automatic cache flush on:
  • settings save
  • attribute term create/edit/delete

---

How it works (under the hood)

1. In the admin settings, you select up to 6 WooCommerce attribute taxonomies (e.g. pa_color, pa_size, pa_what-for).

2. The plugin fetches all terms for each selected taxonomy (respecting your “hide empty” / ordering options).

3. It renders a responsive grid of columns/cards with:

   • a column heading (custom text or the attribute label)
   • a list of term links

4. Each link uses WooCommerce’s layered nav query vars:

   https://example.com/shop/?filter_color=blue

   Where:

   • filter_{attribute} = attribute name (without the pa_ prefix)
   • value = the term slug

---

How to use it

Option A: Shortcode

Add this anywhere (page/post/widget):

[wpquickattributes]

Option B: Gutenberg Block

1. Edit a page/post with the block editor
2. Click +
3. Search for WPQuickAttributes
4. Insert the block (server-side rendered preview)

---

Installation

Manual install (ZIP / folder)

1. Download the plugin and ensure the folder is named wpquickattributes

2. Upload/copy it to:

   wp-content/plugins/wpquickattributes/

3. In WordPress: Plugins → Installed Plugins → Activate “WPQuickAttributes”

4. Make sure WooCommerce is active (the plugin disables itself and shows a notice otherwise)

---

Configuration

Go to: WooCommerce → WPQuickAttributes

1. General

   • Optional Container Title
   • Desktop Columns (1–6)

2. Attribute Columns

   • Select the WooCommerce attribute taxonomy for each of the 3 columns
   • Optional custom heading per column (defaults to attribute label)

3. Link Target

   • Shop page (default) or a specific product category page as base URL

4. Display Options

   • Show Term Counts
   • Hide Empty Terms
   • Order Terms By: Name / Menu Order / Count

5. Term Label Overrides

   • After the first save, you’ll see all terms for the chosen taxonomies
   • Override labels without changing the slug used for filtering
   • If Polylang is active, overrides can be set per language

---

Requirements

• WordPress 5.8+
• PHP 7.4+
• WooCommerce 6.0+
• Polylang (optional, for multilingual features)

---

Notes

• Built to be theme-friendly and fast (term lists are cached with transients).
• Polylang integration is guarded (plugin works normally without Polylang).