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.
The text filter can be used together with a group filter, or applied to all tags in all displayed groups:
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.((We have seen performance issues for 300+ tags particularly in the Safari browser.))
If you have more tags and need a fast text filter, you can try the Tag Cloud Search, which doesn’t offer animation.
Settings and Parameters
For all available options, see
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.