RC Taxonomy Grid

By robercrea

0+ active installationsVersion 1.2.0

Show categories, tags and WooCommerce product categories in a responsive grid, circles, list or cards, with a block and a shortcode.

Description

RC Taxonomy Grid is a lightweight plugin that lets you show the terms of any public taxonomy (post categories and tags, WooCommerce product categories, tags and brands, or your own custom taxonomies) in a clean grid layout.

Each item can include a name, link, and an optional image assigned through the plugin interface.
It’s ideal for creating visual category indexes or tag pages without needing a page builder.

Main features
* Works with any public taxonomy: post categories and tags, WooCommerce product categories, tags and brands, and custom taxonomies.
* Pick the terms by hand, or let the group fill itself: all terms, top-level terms, the children of a term or the subcategories of the archive being viewed (great for shop navigation). New terms appear automatically.
* Hide empty terms, limit the number of terms and choose the order, or drag and drop them.
* Seven styles: Grid, Circles, List, Cards, Overlay, Classic and Minimalist Text.
* Layout options per group: columns on mobile, tablet and desktop, gap, image size and proportion, and the term description.
* Assign an image to any term, bulk edit images, or show the featured image of the latest post or product of terms without one.
* Show a group with the Taxonomy Grid block (with live preview) or a shortcode.
* Multiple groups for multiple uses, which you can duplicate, export and import.
* Optional schema.org ItemList structured data.
* Lightweight and themeable: colors, spacing and radius are CSS custom properties.

Shortcode

Create a group under Taxonomy Grid → Groups and paste its shortcode, e.g. [rctagr id=”1″], or use the Taxonomy Grid block.

Documentation and examples:
👉 https://robercrea.com/plugins/taxonomy-grid/

Installation

  1. Upload the plugin files to the /wp-content/plugins/rc-taxonomy-grid directory, or install the plugin through the WordPress plugin repository.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Go to Taxonomy Grid → Groups, create a group and choose its terms (or an automatic source) and style.
  4. Show the group with the Taxonomy Grid block or its shortcode, e.g. [rctagr id="1"], in any post or page.

FAQ

How do I change the colors, spacing or number of columns?

Columns per device, gap, image size and proportion, and the term description are options of each group (Edit Group → Layout). For everything else, every style reads CSS custom properties with its current look as the default. Add them in Appearance → Customize → Additional CSS (or your theme), for all groups or for one group with its rctagr-group-{id} class:

.rctagr-group-3 { --rctagr-columns-desktop: 6; --rctagr-gap: 12px; --rctagr-bg: #0a3d62; }

Available: --rctagr-gap, --rctagr-columns (and --rctagr-columns-mobile, --rctagr-columns-tablet, --rctagr-columns-desktop for the Grid and Cards styles), --rctagr-text, --rctagr-bg, --rctagr-bg-hover, --rctagr-accent, --rctagr-accent-text, --rctagr-border and --rctagr-radius. Theme colors work too: --rctagr-accent: var(--wp--preset--color--primary);.

Where do the term images come from?

WooCommerce product categories and brands use the image you set in WooCommerce. Every other taxonomy (post categories and tags, custom taxonomies) has an image field added by this plugin on the term’s edit screen, and the bulk image editor lets you change many at once.

Does it work with WooCommerce?

Yes. Product categories, tags and brands work like any other taxonomy. A group set to “children of the term being viewed” shows the subcategories on a shop category page.

Can I move my groups to another site?

Yes. Groups → Export and import: export every group as a JSON file and import it on the other site. Terms are matched by their slug, so create the same categories or tags there first. Importing adds new groups and never changes the existing ones.

Is there a WP-CLI command?

Yes: wp rctagr list, wp rctagr export --file=groups.json, wp rctagr import groups.json --user=admin and wp rctagr duplicate <id> --user=admin.

Screenshots

Changelog

1.2.0

  • New: groups can use any public taxonomy (custom taxonomies, WooCommerce brands…).
  • New: automatic groups: all terms, top-level terms, children of a term or children of the term being viewed, with “hide empty”, a maximum number of terms and order options.
  • Fix: the block was not registered on the server, so it was missing from the inserter and saved blocks rendered nothing.
  • Fix: the “Grid” style labels lost their design when the group used a heading tag other than h2.
  • New: colors, spacing, corner radius and columns are CSS custom properties (--rctagr-*), and every group has a rctagr-group-{id} class, so a theme can restyle one group or all of them.
  • New: a quick start guide on the empty groups page; a new group opens straight in its edit screen.
  • New: layout options per group, free: columns on mobile, tablet and desktop, gap, image size, image proportion and the term description.
  • New: terms without an image can show the featured image of their latest post or product (option per group).
  • New: optional schema.org ItemList structured data per group.
  • New: duplicate a group, and export/import every group as JSON (terms are matched by slug on the new site). Also with WP-CLI: wp rctagr list|export|import|duplicate.
  • Performance: the group edit screen loads the terms 100 at a time, with a search box (taxonomies with thousands of tags).
  • Deprecated shortcodes [rctagr_cats] and [rctagr_tags]: a button converts them into editable groups and the shortcodes keep working. Their old settings stop being read in 2.0.0. The notice only shows on sites that still use them.
  • The block editor texts are translated.
  • Security: capability checks on every group action (create, edit, delete) and on term image saving; group types and styles are now validated against the registered lists.
  • Fix: groups with many categories were silently truncated (the term list was stored in a 255 character column). The column is now text; the table is upgraded automatically.
  • Fix: the groups table is now created on activation through WP-CLI, network activation and any non-admin request.
  • Performance: the block editor group list is no longer queried on every front-end request; the shortcode no longer loads every term of the taxonomy.
  • Added a complete uninstall routine (table, options and term images created by the plugin; WooCommerce thumbnails are never touched).
  • Fix: editing a group and the bulk image editor did nothing on sites whose language translates the “Taxonomy Grid” menu.
  • Fix: the bulk image editor lost every change on taxonomies with several hundred terms (PHP max_input_vars); only changed rows are sent now.
  • Diagnostic messages (“No category found”…) are no longer shown to visitors; they are HTML comments when WP_DEBUG is on.
  • Performance: term images have width, height and srcset (no layout shift).
  • RoberCrea cross-sell module 1.3.0: with several RoberCrea plugins active, the newest bundled copy runs.
  • Admin notices are now translatable (English source strings, Spanish included).
  • Plugin header completed (Requires at least 6.0, Requires PHP 7.4, Tested up to 7.1) and readme.txt aligned with it.

1.1.0

  • Added support for product categories and product tags.
  • Added support for create groups of taxonomies.
  • Added bulk edit for images.
  • Added multiple styles.
  • Added support links.

    • Removed basic shortcode use, use groups instead. Shortcodes will work until next version.
  • ! Please report any bug or error.

1.0.0

  • Initial release.