Shuffle Box Parameters

Shortcode

[tag_groups_shuffle_box]

 

Example

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

 

Data Types

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

 

Parameters

Tags or Terms

layout_mode

Determines how the tags are arranged.

accepted valuesdefaultexample shortcode
stringfitRowslayout_mode=vertical

 

optiondescription
fitRowsin horizontal rows
masonryforming columns
verticala vertical list

taxonomy

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

accepted valuesdefaultexample shortcode
comma-separated list of taxonomy namesTaxonomies selected in the settings under “Basics”.taxonomy=post_tag,product_tag

smallest

Font-size in pt of the smallest tags.

accepted valuesdefaultexample shortcode
integer12smallest=12

largest

Font-size in pt of the largest tags.

accepted valuesdefaultexample shortcode
integer22largest=20

orderby

Which field to use for sorting.

optiondescription
namedisplay name of the tag
naturalnatural sort order (See note below.)
countpost count
slugtag slug
term_idID of the tag
descriptiontag description

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

accepted valuesdefaultexample shortcode
stringnameorderby=natural

order

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

accepted valuesdefaultexample shortcode
stringASCorder=desc

amount

Maximum amount of tags in one cloud (per group).

accepted valuesdefaultexample shortcode
integer0 (unlimited)amount=30

hide_empty

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

accepted valuesdefaultexample shortcode
0 or 11 (hide empty)hide_empty=1

prepend

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.

accepted valuesdefaultexample shortcode
stringemptyprepend=“#”

append

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.

accepted valuesdefaultexample shortcode
stringemptyappend=“{count}”

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

accepted valuesdefaultexample shortcode
stringemptylink_append=“track=this”

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.

accepted valuesdefaultexample shortcode
string: “_blank”, “_self”, “_parent”, “_top”, or the name of a frameempty (= opens in the same window, same as using _self)link_target=“_blank”

show_tag_count

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.

accepted valuesdefaultexample shortcode
0 or 11 (show)show_tag_count=0

custom_title

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.

accepted valuesdefaultexample shortcode
stringempty (using the description, see also show_tag_count)custom_title=“Used for {count} posts.”

add_premium_filter

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.

accepted valuesdefaultexample shortcode
0 or 11 (use the filter)add_premium_filter=0

Groups

include

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.

accepted valuesdefaultexample shortcode
comma-separated list of integersallinclude=“1,5,9”

 

Filters

show_group_filter

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

accepted valuesdefaultexample shortcode
0 or 11show_group_filter=0

show_text_filter

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

accepted valuesdefaultexample shortcode
0 or 11show_text_filter=0

 

Labels and Messages

placeholder

Placeholder for the input field of the text filter.

accepted valuesdefaultexample shortcode
string“search”placeholder="type here"

not_assigned_name

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

accepted valuesdefaultexample shortcode
string“not assigned”not_assigned_name="all the rest"

show_all_name

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

accepted valuesdefaultexample shortcode
string“show all”show_all_name="no filter"

Advanced Styling

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

div_id

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.

accepted valuesdefaultexample shortcode
stringempty (random value)div_id=“sidebar_01”

div_class

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

accepted valuesdefaultexample shortcode
stringcm-shufflebox-theme-defaultdiv_class=“make-it-dark”