=== Tag Groups is the Advanced Way to Display Your Taxonomy Terms===
Contributors: stevejburge, andergmartins, olatechpro, ojopaul
Tags: tags, tag cloud, tabs, accordion, taxonomy, tag, woocommerce tags, Woocommerce categories, Tabbed Tag Cloud, Tag List, Accordion Tag Cloud, Alphabetical Tags, Alphabetical Tag Cloud, Alphabetical Tag Index, Post List, Post Filter
Requires at least: 4.9
Tested up to: 6.7
Stable tag: 2.1.2
Requires PHP: 7.2
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl.html

Tag Groups allows you to organize your WordPress taxonomy terms and show them in clouds, tabs, accordions, tables, lists and much more.

== Description ==

The Tag Groups plugin allows you to organize your WordPress taxonomy terms and show them in clouds, tabs, accordions, tables, lists and much more. You can customize your term displays with a huge number of options and use them in posts, pages, blocks, or shortcodes.

== All the Features in Tag Groups ==

The Free version of the Tag Groups plugin comes with the following features. All of these features are available as both shortcodes and also Gutenberg blocks.

* **Tag List:** Tags appear in columns, sorted into groups. [View demos](https://demo.taxopress.com/tag-list/).
* **Tabbed Tag Cloud:** A tag cloud where tags are sorted into groups that appear in tabs. [View demos](https://demo.taxopress.com/tabbed-tag-cloud/).
* **Accordion Tag Cloud:** A tag cloud where tags are sorted into vertically stacked accordion groups. [View demos](https://demo.taxopress.com/accordion-tab-cloud/).
* **Alphabetical Tag Cloud:** Tags are sorted alphabetically by first letter under tabs. [View demos](https://demo.taxopress.com/alphabetical-tabs/).
* **Alphabetical Tag Index:** Tag appear in columns, sorted alphabetically by first letter. [View demos](https://demo.taxopress.com/alphabetical-index/).
* **Post List:** Display posts with a specific tag or in a particular tag group. [View demos](https://demo.taxopress.com/post-list/).

The Pro version of the Tag Groups plugin also has these extra features:

* **Tag Cloud:** This is an advanced version of a traditional Tag Cloud, with many customization options. [View demos](https://demo.taxopress.com/cloud/).
* **Table Tag Cloud:** This feature organizes tags in a table, with groups as headers. [View demos](https://demo.taxopress.com/table-tag-cloud/).
* **Shuffle Box:** This is a tag cloud that allows you to filter the tags by their names or by their tag groups. [View demos](https://demo.taxopress.com/shuffle-box/).
* **Tag Cloud Search**: Add a search box to any of our static tag displays: Cloud, Tabs, Accordion, or Table. [View demos](https://demo.taxopress.com/tag-cloud-search/).
* **Toggle Post Filter**: This allows users to dynamically search for posts that have tags they choose. [View demos](https://demo.taxopress.com/post-filter-tags-menu/).
* **Dynamic Post Filter**: This aallows users to dynamically search for posts via a dropdown menu showing tags. [View demos](https://demo.taxopress.com/post-filter-dropdown-menu/).

## Tag Groups Pro ##

> <strong>Upgrade to Tag Groups Pro</strong><br />
> This plugin is the free version of TaxoPress. The Pro version of Tag Groups has extra features and expert support. [Click here to organize your terms with the Tag Groups Pro plugin now!](https://taxopress.com/tag-groups)

== Why Organize Terms Into Groups? ==

Most WordPress sites mix up terms into one big messy group. In most cases, terms should actually be separated by topics: places, people, features, years and more.

Your term however, will become much more useful if you organize them in groups. Imagine a tag cloud where all places appear in a "Places" group, all names under "Names" and all years under "Years". The Tag Groups plugin lets you do exactly that.

The plugin gives you many term displays. You can also customize them, append or prepend something to each tag. You can add separators, choose the link target, set the smallest and the largest font size, display the post count and much more.

== Does Tag Groups Only Work With Tags? ==

No. Tag Groups works also great with most other (flat) taxonomies, such as WooCommerce product tags.

The plugin does not support hierarchical taxonomies like categories.

== Does Tag Groups Work with Multilingual Websites? ==

Yes, this plugin is officially compatible with **WPML**, the WordPress Multilingual plugin. This means you can use a different tag group name for each language.

## Tag Groups Pro ##

> <strong>Upgrade to Tag Groups Pro</strong><br />
> This plugin is the free version of TaxoPress. The Pro version of TaxoPress has extra features and expert support. [Click here to organize, optimize and showcase your content with TaxoPress now!](https://taxopress.com/tag-groups)

## The TaxoPress and Tag Groups plugins ##

TaxoPress is developed by the same team that support the popular [TaxoPress plugin](https://wordpress.org/plugins/simple-tags/). Together Tag Groups and TaxoPress are an excellent solution for organizing and displaying your site’s content.

## Tag Groups Bug Reports ##

Bug reports for Tag Groups are welcomed in our [repository on GitHub](https://github.com/taxopress/tag-groups). Please note that GitHub is not a support forum, but a place to report bugs in the plugn that can be replicated outside of a single site.

## Follow the TaxoPress team ##

Follow TaxoPress on [Facebook](https://www.facebook.com/taxopress), [Twitter](https://www.twitter.com/taxopress) and [YouTube](https://www.youtube.com/@taxopress).

== Installation ==

1. Find the plugin in the list at the backend and click to install it. Or, upload the ZIP file through the admin backend. Or, upload the unzipped tag-groups folder to the /wp-content/plugins/ directory.

2. Activate the plugin through the ‘Plugins’ menu in WordPress.

The plugin will create a new menu "Tag Groups" and a submenu "Tag Group Admin" in the Post section (depending on the chosen taxonomy) where you find the tag groups. After you have created some groups, you can edit your tags (or other terms) and assign them to one of these groups. A filter and a bulk action menu are available on the Tags page and you also find a filter on the Posts pages.

The tabbed tag cloud (or an accordion containing the tags) can be inserted with a shortcode or a Gutenberg block. Options are listed under the "Tag Groups" main menu.


== Frequently Asked Questions ==

= How Can I Start Using Tag Groups? =

After activating the plugin, you will be guided by an optional **setup wizard**.

First you create groups that will contain your tags. Then you sort your tags into these groups. You can later always come back and modify the groups or change the tags. You don't even need any groups if you prefer to show your tags sorted by alphabet.

Filters and bulk actions make your work with tags much easier, and you can even filter the list of posts in your backend by the groups that their tags belong to.

= What are Possible Applications of Tag Groups? =

* Display your tags grouped by language or by topic.
* Create an alphabetical index of your tags - think of a phone book for your tags.
* Display only tags of selected groups in a tag cloud.
* Choose which tags to display in different sections of your blog.
* Change the sorting order in your tag cloud.
* Customize the links, the text, the font size or the separator of your tag cloud items.
* Prepend or append to each tag a custom character or the post count.
* Insert into each post a tag cloud using only the tags of this post.
* Easily manage huge amounts of tags or posts in the backend by dividing them into groups.
* Add a parent level to tags and make them hierarchical.

= How Can I Show the Tags of Each Post Sorted into Groups? =

Please use one of the shortcodes or Gutenberg blocks that come with the Tag Groups plugin. Since we cannot change the code of templates or other plugins, there is no possibility to make them aware of the new structure where tags are organized in groups.

== Screenshots ==

1. This is an advanced version of a traditional Tag Cloud, with many customization options.
2. The Alphabetical Tag Index shows tag in columns, sorted alphabetically by first letter. 
3. The Accordion Tag Cloud is tag cloud where tags are sorted into vertically stacked accordion groups.
4. The Tabbed Tag Cloud is tag cloud where tags are sorted into groups that appear in tabs.
5. The Tag Groups plugin allows you to organize terms in groups.
6. The Toggle Post Filter allows users to dynamically search for posts that have tags they choose.
7. The Tag List allows you to show Tags in columns, sorted into groups.
8. Tag Groups has a custom metabox so you can add terms into specific groups.


== Changelog ==

= [2.1.2] - 21 April 2026 =
* Fixed: call_user_func_array(): Argument #1 ($callback) must be a valid callback #241
* Fixed: Caching issue with meta box #240

= [2.1.1] - 21 Oct 2025 =
* Fixed: Broken dropdowns in Gutenberg, #234
* Update: Tag Groups PRO 2.1.0 Translation Updates ES-FR-IT #229

= [2.1.0] - 27 Aug 2025 =
* Fixed: "Add New Tag Group" button not working in pro #222
* Update: Tag Groups FREE v2.0.9 Translation Updates-ES-FR-IT #219
* Update: Tag Groups PRO 2.0.9 Translation Updates ES-FR-IT #220

= [2.0.9] - 12 Feb 2025 =
* Removed: Remove the metabox setting link, #206
* Fixed: Behavior when adding Tag Groups, #205
* Update: Update the shortcode screenshots, #203
* Update: Update text for "Filters" tab, #202
* Update: Move the order of the tabs, #201
* Update: Update the "Permisisons" tab, #200
* Update: Update the "Tag Meta Box" tab, #199
* Update: Update the experience when adding new tags, #198
* Update: Update translation to modernize locale data retrieval, #111
* Update: Tag Groups FREE v2.0.8 Translation Updates-ES-FR-IT, #207

= [2.0.8] - 03 Feb 2025 =
* Improved: Improve the save icon, #188
* Improved: Improve "Theme and Appearance" tab, #176
* Removed: Remove the "Home" screen, #187
* Fixed: Missing translation strings in Pro, #123
* Fixed: Tooltips not working with the shortcodes, #102
* Update: Text update for "Taxonomies" screen, #186
* Update: New text for Tag Colors tab, #177
* Update: Update "Shortcodes" tab, #175
* Update: Combine settings screen: Tools & License, #174
* Removed: Remove the "Home" link, #173
* Update: Move the Group ID column, #172
* Update: Translation Updates for Tag Groups FREE v2.0.7 ES-FR-IT, #180
* Update: Translation Updates for Tag Groups PRO v2.0.7 ES-FR-IT, #179

= [2.0.7] - 22 Jan 2025 =
* Improved: Improve handling of Parent Groups, #120
* Update: New text for Tag Group admin, #157
* Fixed: Missing translation strings in Free, #122
* Fixed: Remove orange pop-ups on Tag Group Admin screen #156
* Fixed: Add back reset tag filter button, #165
* Update: Translation Updates for Tag-Groups FREE v2.0.5 ES-FR-IT, #145
* Update: Translation Updates for Tag Groups FREE v2.0.6 ES-FR-IT, #163
* Update: Translation Updates for Tag Groups PRO v2.0.6 ES-FR-IT, #164

= [2.0.6] - 16 Jan 2025 =
* Improved: Added Filter Button to the Tags screen, #138 
* Improved: Allow users to disable large modal from metabox, #100
* Update: Update buttons on Tags Groups Admin screen, #133
* Update: Replace X icon in metabox screen, #104
* Feature: Add a "Remove all from group", #105
* Fixed: Deprecated shortcode error with shuffle box shortcode, #150
* Fixed: Possible issue with Tag Groups shortcode, #140

= [2.0.5] - 18 Dec 2024 =
* Update: Update the Migrate and Maintenace feature in Tag Groups form to $_POST and sanitize url, #134
* Removed: Remove the Tools area, #96
* Fixed: PHP Error in class.transients.php, #125
* Update: Disable filters by default, #121
* Fixed: "Tag Colors" screen is broken in 2.0.4, #119
* Fixed: Deprecated shortcode error, #126
* Update: New plugin description, #67

= [2.0.4] - 29 Aug 2024 =
* Update: Add settings to enable Tag Groups and Terms endpoint for public access, #114

= [2.0.3] - 24 May 2023 =
* Fixed: [tag_groups_post_list] shortcode tag parameter not working with custom taxonomy tags, #86
* Fixed: Fatal error with post count, #69
* Fixed: Tag groups shortcode causing fatal error, #85
* Fixed: Remove Broken documentation links in Gutenberg blocks, #88
* Fixed: Remove "Try Premium" link, #76
* Updated: TAG GROUPS Spanish translation April 2023 update, #70
* Updated: TAG GROUPS French translation April 2023 update, #74

= [2.0.2] - 12 Apr 2023 =
* Update: Update Tag group admin sorting method, #52
* Update: Move "search for settings" on settings screens, #47
* Update: Update footer credit, #50
* Update: Update tag group admin "Add New button", #51
* Update: Remove large blank area on Admin screen, #53
* Update: Change top banner to blue color, #46
* Update: Change Upgrade to Pro links, #49

= [2.0.1] - 20 Mar 2023 =
* Update: Accessibility Improvements for settings area, #35
* Update: Update title icons, #31
* Update: Include an "Add New" button for taxonomy groups #34
* Fixed: Small " issue with sidebar promos, #30
* Update: Remove Beta Tester Feedback, #37

= [2.0.0] - 28 Feb 2023 =
* Update: TaxoPress Move and General cleanup
* Update: Added Pro sidebar, #24
* Update: Documentation link updates, #22
* Update: Remove the icons in Gutenberg blocks, #15
* Update: Merge the Tools and Troubleshooting tabs, #12
* Update: Remove 3 tabs from Troubleshooting, #11
* Update: Remove the "About" menu, #10
* Update: Remove freemius dependency, #8


### 1.44.3 ###

= Other =

* Updated Freemius SDK to version 2.4.5

### 1.44.1 ###

= Other =

* Improved performance by different caching of tag counts.

### 1.44.0 ###

= Features =

(premium version only)

= Bug Fixes =

* Fixing parameter "header_class" of Alphabetical Tag Index.

== Upgrade Notice ==

none
