Shuffle Box – Overview

This is a feature of the premium plugin. Tag Groups Premium

The Shuffle Box is a tag cloud where you can search tags by groups and by their names. Tags are filtered live after you clicked a button or while you type, and they re-arrange with a nifty animation.

This tag cloud can be inserted alternatively with a shortcode or a Gutenberg block. Several parameters let you customize labels, included groups, sort order, amount of tags and much more.

In sidebar widgets you can currently use only the shortcode. Simply past it in a text widget.

The Shuffle Box is responsive and even adjusts dynamically when you change the size of the window.

How it works

Initially the Shuffle Box loads all applicable tags (according to your block options or shortcode parameters, for example the maximum amount) on the page. The filtering then works on that sample by hiding tags that don’t match the filter.

That means that the filter won’t load any news tags dynamically from the database. When you press a button or enter a text, all displayed tags are taken from the initially loaded sample that you see when the filter is off.

The maximum amount of tags that you can set in the options is therefore the total amount of tags that appear when the filter is off (that means set to “all groups”, with no search text entered). It is not the amount of tags per group.

Examples

The following screenshot shows a tag cloud that has been filtered by the group “Places”. We are using the parameter “append” to display the post count for each tag and we use the default theme.

Shuffle Box - tag cloud filter - WordPress

The text filter can be used together with a group filter, or applied to all tags in all displayed groups:

Shuffle Box - tag cloud text search - WordPress

The options allow you to use only the group filter, only the text filter, or both in combination.

Performance

Please note that recalculating the new tag positions after each change unavoidably affects the performance for huge numbers of tags.

Try to keep the total (that is when the filter is off and shows all tags) number of tags below 200-300. You can do so by displaying only selected groups or setting a max. amount (consider a tag order by post count). If you need to display hundreds of tags, test the Shuffle Box in all common browsers.1

If you have more tags and need a fast text filter, you can try the Tag Cloud Search, which doesn’t offer an animation.

Settings and Parameters

For all available options, see

Shuffle Box - searchable tag cloud - Gutenberg - WordPress plugin

Tags with multiple groups

If you use the same tag with various groups and want to make sure, that the tag links only to those posts that use this tag with a particular group, you need to activate an additional option.

Use the toggle switch in the Gutenberg block or in the shortcode the parameter:

add_premium_filter=1

If the resulting list is unexpectedly empty or misses posts, please try to run Maintenance.

If “all groups” is selected, the posts won’t be filtered by tag group.

Please note that the placeholder {count} (used with “prepend”, “append” and “custom_title”) always shows the total number of posts for each tag – not per group.

Demos

Demos are available on this page.

Show 1 footnote
  1. We have seen performance issues for 300+ tags particularly in the Safari browser.

How do you rate this article?