=== Tag Groups ===
Contributors: camthor
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=FD5ZU4EEBGSC8
Tags: alphabet, tags, tag cloud, tabs, accordion, taxonomy, tag, woocommerce, first letter
Requires at least: 4.9
Tested up to: 5.7
Stable tag: 1.39.8
Requires PHP: 7.2
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl.html

== Description ==

This plugin lets you organize your WordPress tags in groups or by alphabet and display them in tag clouds (tabs or accordion) or tag lists. You can customize them with a huge number of options and use them in posts, pages or widgets.

## <a href="https://demo.chattymango.com/tag-groups-free-demo-page/?pk_campaign=tg&pk_kwd=readme" target="_blank">★ Try The Demo ★</a> ##

<a href="https://chattymango.com/tag-groups/?pk_campaign=tg&pk_kwd=readme" target="_blank">Features</a> | <a href="https://documentation.chattymango.com/documentation/tag-groups/?pk_campaign=tg&pk_kwd=readme" target="_blank">Documentation</a> | <a href="https://chattymango.com/?redirect_to=latest&cat=3&pk_campaign=tg&pk_kwd=readme" target="_blank">Latest Development Blog Post</a> | <a href="https://chattymango.com/tag-groups-plans-and-pricing/?pk_campaign=tg&pk_kwd=readme" target="_blank">Compare</a>

== Finally, the end of messy tags ==

This plugin comes with the following features:

* **Tabbed Tag Cloud:** A tag cloud where tags are sorted into groups that appear in tabs.
* **Accordion Tag Cloud:** A tag cloud where tags are sorted into vertically stacked groups.
* **Tag List:** Tags are appear in columns, sorted into groups.
* **Alphabetical Tag Cloud:** Tag are sorted alphabetically by first letter under tabs.
* **Alphabetical Tag Index:** Tag appear in columns, sorted alphabetically by first letter.

All features are available as **shortcodes** and as **Gutenberg blocks**. Choose whatever suits you best!

Tag clouds and lists work out of the box, but you can also customize them, append or prepend something to each tag, set a separator, set the link target, set the smallest and the largest font size, display the post count and much more.

== Why your web site will benefit from organizing your tags into groups ==

Most WordPress sites mix up tags that should actually be separated by topics: places, people, features, years and more.

Your tags, 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.

== How to use 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.

== Not only tags ==

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

The plugin does not support hierarchical taxonomies like categories.


== Possible applications ==

* 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.


== Multilingual websites ==

This plugin is officially compatible with **WPML** (WordPress Multilingual). That means you can use a different tag group name for each language.

Please find more information on the [plugin website](https://chattymango.com/tag-groups/?pk_campaign=tg&pk_kwd=readme "plugin website").

== Video: Installation and first steps ==

https://www.youtube.com/watch?v=iHaWq6Gi0cA


**If you find this plugin useful, please give it a [5-star rating](https://wordpress.org/support/plugin/tag-groups/reviews/?filter=5 "reviews"). Thank you!**

### Extra Features

> Sorting tags into groups is just the beginning! The [premium version](https://chattymango.com/tag-groups-premium/?pk_campaign=tg&pk_kwd=readme "plugin website") extends tag groups to posts. This opens an amazing variety of new opportunities.
>
> Premium features include:
>
> ✔ an animated and searchable tag cloud: Click a group or type a tag name and see only matching tags
> ✔ a live post filter for the frontend: Let your visitors search for posts by tags or by text in real time;
> ✔ a search field to filter tag clouds by tag name;
> ✔ a meta box for the post edit screen so that you can enter and edit post tags segmented by groups;
> ✔ the option to bulk-add all tags of a group to a post with one click;
> ✔ add the same tag to multiple groups;
> ✔ custom permissions who can edit tag groups;
> ✔ show tags in groups under your posts;
> ✔ a new tag cloud where you can combine the tags of specific groups into one cloud;
> ✔ and more.

## Searchable and animated tag cloud

https://www.youtube.com/watch?v=W5qZkCizPSw

## Filter posts in real time by tags

https://www.youtube.com/watch?v=3tScXOvxw1A

## Add tags to posts sorted into groups

https://www.youtube.com/watch?v=xonGSR9VswQ

> See the difference between the free and the premium plugin [in the feature comparison table](https://chattymango.com/tag-groups-base-premium-comparison/?pk_campaign=tg&pk_kwd=readme "feature comparison table").
>
> You can test the plugin in a 7-day free trial.


Follow us on [Facebook](https://www.facebook.com/chattymango/) or [Twitter](https://twitter.com/ChattyMango).

= Other Notes =

Find the licenses of 3rd party software in the About section.

= Check out my other plugins =

* [Redirect URL to Post](https://wordpress.org/plugins/redirect-url-to-post/)

== 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.

Extensive information, examples and help for troubleshooting are listed [here](https://chattymango.com/tag-groups/?pk_campaign=tg&pk_kwd=readme "plugin website").


== Frequently Asked Questions ==

= 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.

= Do I need to opt-in to Freemius? =

No. You can safely skip it and it doesn't affect the features of the free plugin version.

= How can I use one of these tag clouds in a widget? =

Please use a text widget and insert the shortcode.

= Does this plugin support tags for pages? =

No. Although it might work (with additional 3rd-party plugins), it is not an officially supported feature.

= Does this plugin work with categories? =

No. Hierarchical taxonomies such as categories are not officially supported.

= Does this plugin work with my special custom taxonomy XY? =

They only way to find out is to install the plugin and try.

= I need the plugin for a very special purpose - can you help? =

Please check first if the [premium plugin](https://chattymango.com/tag-groups-premium/?pk_campaign=tg&pk_kwd=readme "Tag Groups Premium") can help. If not, you can ask for [support here](https://wordpress.org/support/plugin/tag-groups).

= I am desperately missing my language. But, wait.. is this actually a "frequently asked question"? =

No, unfortunately it isn't. But, nevertheless, I'm glad you asked! You are warmly invited to [help us translate](https://translate.wordpress.org/projects/wp-plugins/tag-groups).

== Screenshots ==

1. Tag cloud ("Blitzer" theme)
2. Accordion ("Blitzer" theme)
3. Alphabetical tag cloud with first letters of tags as tabs
4. Tag list
5. Alphabetical tag index
6. Group administration
7. Assigning tags to groups
8. Settings
9. Configuring a tag cloud in Gutenberg

== Privacy ==

This plugin does not collect or process any personal user data unless you expressively opt-in.

== Changelog ==


### 1.39.8 ###

= Bug Fixes =

* Fixed bug in random sorting.

= Other =

* Tag clouds/lists: Added parameter `exclude` to blocks.
* Tag clouds/lists: Trying to ignore wrong (formatted) quotes used with parameters.
* Improved layout of Tag Groups Admin page when filters are off.

### 1.39.5 ###

= Bug Fixes =

* Fixed bug in transient management.

= Other =

* Smaller cache chunks to avoid database issues.
* Tag cloud shortcodes: experimental parameter `exclude` to exclude groups.

### 1.39.4 ###

= Other =

* Tag Groups admin page: Improved compatibilty with other plugins that read `$_REQUEST['taxonomy']`.
* Make sure that no other plugin adds output after AJAX response.
* Freemius SDK updated to version 2.4.2, bringing clearer information and more links for help.
* Back end post filter: Improved compatibility with custom post types that don't use categories.

### 1.39.1 - 1.39.3 ###

Premium version only

### 1.39.0 ###

= Features =

* Developers: New filters [tag_groups_cloud_tag_prepend and tag_groups_cloud_tag_append](https://documentation.chattymango.com/documentation/tag-groups/for-developers-tag-groups/filters-and-actions-hooks/)

### 1.38.1 ###

= Other =

* Improved compatibility with plugins that collect JavaScript and move it to the end of the page.

### 1.38.0 ###

= Other =

* Groups Info shortcode: more combination of parameters are now possible; default for `group_id` was changed to 'all'
* Fixed deprecation messages in JavaScript.

### 1.37.1 ###

= Other =

* Performance improvement for import routine.
* Logging to debug.log (if activated) is now less verbose. To log more information enable it in the new "debugging" settings, Troubleshooting menu, or use `define( 'CM_DEBUG', 'verbose' );` in wp-config.php.
* Fixed deprecation notices in PHP 8.

### 1.37.0 ###

= Features =

* Developers: experimental methods POST, PUT and DELETE for the REST API. See the [documentation](https://documentation.chattymango.com/documentation/tag-groups-premium/for-developers/rest-api/) for more details.

= Other =

* Required minimum PHP version is now 7.2. The plugin may work with lower versions but they are not supported.


= Older Versions =

The complete changelog is available [here](https://chattymango.com/changelog/tag-groups-free/?pk_campaign=tg&pk_kwd=readme).



== Upgrade Notice ==

none
