Shuffle Box – Shortcode Parameters

This is a feature of the premium plugin.

Note: This shortcode is also available as Gutenberg block. You can configure the block without using any code or parameters. Read more about the block options.

If you don’t know what is a shortcode and how to use it, you first may want to read this article.

[tag_groups_shuffle_box]

[tag_groups_shuffle_box taxonomy=product_tag smallest=16 largest=16 placeholder="type here"]

• string: A text. For identifiers that won’t be visible to visitors you often have to replace spaces with _ or -. If the string contains spaces, you need to wrap it in quotes.

• integer: A number without decimal places.

• 0 or 1: 0 turns the feature off and 1 on.

Gutenberg Block

If you are using Gutenberg, most of the parameters below will also be available in the corresponding block. You can always convert a block to a shortcode while preserving your settings.

Determines how the tags are arranged.

Restrict the tags only to these taxonomies. Available are only taxonomies that have been activated in the Settings.

Font-size in pt of the smallest tags.

Font-size in pt of the largest tags.

Which field to use for sorting.

Since WordPress doesn’t natively offer natural sort order, we have to first order them by name and then by natural sort order. If you limit the number of tags with amount, the amount of tags is therefore determined by cutting off with “name” sorting and then sorting them with “natural”.

Whether to sort the tags in ascending or descending order. Ascending order also means from oldest to newest.

Maximum amount of tags. This is the total number for the case when all filters are off (“show all”). Buttons and text search reduce this number.

Note: High numbers of tags will affect performance.

Whether to hide or show tags that are not assigned to any post.

Prepend to each tag label. Can obtain the placeholder {count} that will be replaced with the post count for that tag. Please note that {count} is the total number – not per selected group.

Append to each tag label. Can obtain the placeholder {count} that will be replaced with the post count for that tag. Please note that {count} is the total number – not per selected group.

Append something to each tag’s link, for example a query.

Available only in the shortcode!

Set the “target” attribute for the links of the tags. Possible values are: _blank, _self, _parent or _top. In the shortcode you can also set the name of a frame.

Whether to show the number of posts as tooltip (behind the tag description) when hovering the mouse over the tag. Please note that the value is the total number – not per selected group.

Custom title shown as tooltip. No HTML, but you can use {count} and {description} as placeholders. Please note that {count} is the total number – not per selected group.

When you use the premium plugin, additional query parameters in the links make sure that we can distinguish between the same tag that is used in different groups. If the resulting posts are not complete and troubleshooting doesn’t help, you can disable it here.

Display only tags that are assigned to the post (or page) with a specified ID. If the value is set to 0, the plugin will try to retrieve the current post ID. Turn it off with -1.

Tag groups that will be considered in the tag cloud. In the short code you use the IDs, which you find in the left column in the list of groups. Empty or not used means that all tag groups will be used.

Display only groups of which at least one assigned tag is also assigned to the post (or page) with the ID x. If set to 0, it will try to retrieve the current post ID. Matching groups will be added to the list specified by the parameter include

Whether to show the names of the groups (included with “include”) as filter buttons.

Whether to show a text input field where visitors can filter tags by their names.

Whether to a button where visitors can reset all filters by groups and show all tags.

Which group to use for filtering when the Shuffle Box is loaded. By default it shows all available tags of all groups. Use the ID of a group that you don’t display to start without showing any tags.

Placeholder for the input field of the text filter.

Label of the button for the “not assigned” group.

Label of the button to show all groups (turn off the filter by groups).

You can set here IDs and classes to be referred to in CSS. You need some knowledge of CSS to use these options.

Define an ID for the enclosing <div>.

Avoid words that are used by WordPress such as “content” or “main”. Each ID must be unique for the entire page.

Define a class for the enclosing <div>. You can use here themes.