Limited Time Offer

Save 25% on our plugins with this coupon:

LOVEWORDPRESS

Buy Now
Skip to content
TaxoPress
  • TaxoPress
  • Tag Groups
  • Docs
  • Blog
  • Support
  • Login
Buy Now
TaxoPress

Tag Groups: Getting Started

  • Introduction to Tag Groups
  • Installation of Tag Groups Free
  • First Steps With Tag Groups
  • Tag Groups Free vs Pro

How to Use Groups for Tags

  • Creating and Editing Groups
  • Filter Tag Groups on the Tags Screen
  • Bulk Actions for Groups on the Tags Screen
  • Organizing Groups with a Parent Level
  • Using the Tag Groups Metabox on the Post Edit Screen

Display Options for Tags

  • How To Use Gutenberg Blocks With Tag Groups
  • How to Use Shortcodes With Tag Groups
  • Tag Groups Themes: Design and Colors
  • How to Design Tag Colors in Tag Groups
  • How to Modify a Theme in Tag Groups
  • Create Your Own Accordion and Tab Themes

Tag List

  • Tag List – Overview
  • Tag List – Gutenberg Block
  • Tag List – Shortcode Parameters

Tabbed Tag Cloud

  • Tabbed Tag Cloud – Overview
  • Tabbed Tag Cloud – Gutenberg Block
  • Tabbed Tag Cloud – Shortcode Parameters
  • Tabbed Tag Cloud – Themes

Alphabetical Tag Index

  • Alphabetical Tag Index – Overview
  • Alphabetical Tag Index – Gutenberg Block
  • Alphabetical Tag Index – Shortcode Parameters

Alphabetical Tag Cloud

  • Alphabetical Tag Cloud – Overview
  • Alphabetical Tag Cloud – Gutenberg Block
  • Alphabetical Tag Cloud – Shortcode Parameters
  • Alphabetical Tag Cloud – Themes

Accordion Tag Cloud

  • Accordion Tag Cloud – Overview
  • Accordion Tag Cloud – Gutenberg Block
  • Accordion Tag Cloud – Shortcode Parameters
  • Accordion Tag Cloud – Themes

Tag Groups Info

  • Tag Groups Info – Overview
  • Tag Groups Info – Shortcode Parameters

Show Tags Under Posts (Pro)

  • How to Show Tag Groups on Posts
  • Change the Icons on Tags Under Posts

Shuffle Box (Pro)

  • Shuffle Box – Overview
  • Shuffle Box – Gutenberg Block
  • Shuffle Box – Shortcode Parameters
  • Create a Custom Color Scheme for Shuffle Box
  • Hide the “not assigned” button in the Shuffle Box

Simple Tag Cloud (Pro)

  • Simple Tag Cloud – Overview
  • Simple Tag Cloud – Gutenberg Block
  • Simple Tag Cloud – Shortcode Parameters

Table Tag Cloud (Pro)

  • Table Tag Cloud – Overview
  • Table Tag Cloud – Gutenberg Block
  • Table Tag Cloud – Shortcode Parameters

Post List (Pro)

  • Post List – Overview
  • Post List – Gutenberg Block
  • Post List – Shortcode Parameters

Dynamic Post Filter (Pro)

  • Dynamic Post Filter – Overview
  • Dynamic Post Filter – Gutenberg Block
  • Dynamic Post Filter – Shortcode Parameters
  • I Don’t See Posts In the Dynamic Post Filter

Tag Cloud Search (Pro)

  • Tag Cloud Search – Overview
  • Tag Cloud Search – Gutenberg Block
  • Tag Cloud Search – Shortcode Parameters

Tag Groups Menu (Pro)

  • Tag Groups Menu – Overview
  • Tag Groups Menu – Shortcode Parameters

Toggle Post Filter (Pro)

  • Toggle Post Filter – Overview
  • Toggle Post Filter – Shortcodes Overview
  • Toggle Post Filter, Posts – Gutenberg Block
  • Toggle Post Filter, Posts – Shortcode Parameters
  • Toggle Post Filter, Menu – Gutenberg Blocks
  • Toggle Post Filter, Menu – Shortcode Parameters
  • Toggle Post Filter, Text Search – Gutenberg Block
  • Toggle Post Filter, Text Search – Shortcode Parameters
  • Toggle Post Filter, Slider Button – Gutenberg Block
  • Toggle Post Filter, Slider Button – Shortcode Parameters
  • Toggle Post Filter, Order Menu, Gutenberg Block
  • Toggle Post Filter, Order Menu – Shortcode Parameters
  • Toggle Post Filter, Reset Button – Shortcode Parameters

Tag Groups: Settings

  • The Home Screen in Tag Groups
  • Taxonomies and the Tag Groups Plugin
  • Front End Settings
  • Back End Settings in Tag Groups
  • Tools
  • Troubleshooting
  • Control Who Can Edit the Tag Groups

Tag Groups: Frequently Asked Questions

  • Glossary of Useful Words for Tag Groups
  • How to Display Tags in a Custom Sort Order?
  • Can I Use Tag Groups Multiple Times on The Same Page?
  • Which Tag Groups Feature Do I Need?
  • Can I Use the Tag Groups Plugin with Pages?
  • Can I Use the Tag Groups plugin with Categories?
  • How to Make the Alphabetical Tag Index or the Tag List Responsive?
  • Can I Use Tag Groups with Custom Taxonomies?
  • What are the Minimum System Requirements to Install Tag Groups?
  • “The free Tag Groups plugin cannot be active together with Tag Groups Pro.”

Tag Groups: Troubleshooting

  • Tags Not Visible in the WordPress Admin After Installing Tag Groups
  • Debugging a WordPress Ajax Error
  • Shortcodes Don’t Work Inside Widgets
  • I Cannot Use Multiple Tag Clouds on the Same Page
  • I Don’t See All Tags in the Tag Meta Box
  • How To Use The Debug Log in Tag Groups
  • Instead of the Tag Cloud There’s An Empty Space
  • Can Not Save HTML in the Tag Description
  • Tag Cloud: When I Click on a Tag, the Posts Don’t Differentiate by Groups
  • “Error loading block: The response is not a valid JSON response.”

Questions About Post Filters

  • Using the Post Filter on Frontend URLs
  • How to Choose a Custom Order in the Post Filter
  • How to Change the Length of the Post Excerpts
  • Change the Size of the First Posts in the Masonry Layout
  • Limit the Size of the Menu in the Dynamic Post Filter

Tag Groups: Maintenance and Optimization

  • How to Reduce the Number of Loaded Scripts for Better Speed and SEO
  • How to Improve the Performance of the Toggle Post Filter/Dynamic Post Filter
  • Running Maintenance
  • How to Improve the Speed of Tag Groups
  • Migrating your Tags and Posts to Tag Groups

Tag Groups: For Developers

  • Tag Groups and the REST API
  • Filters and Actions in Tag Groups
  • Modifying the Post Query
  • Modifying the Term Query
  • Using Tag Groups in Theme Files
  • Useful Constants for the Tag Groups Plugin

Tag Groups Integrations

  • Integration with WooCommerce Attributes
  • Does Tag Groups Work with the Polylang Plugin?
  • Translating Tag Group Names With WPML
  • Home
  • TaxoPress Documentation
  • The Tag Groups Plugin
  • Tabbed Tag Cloud
  • Tabbed Tag Cloud – Shortcode Parameters

Tabbed Tag Cloud – Shortcode Parameters

Table of Contents
  • Shortcode
  • Example
  • Data Types
  • Parameters
    • Tags or Terms
      • taxonomy
      • smallest
      • largest
      • include_terms
      • exclude_terms
      • orderby
      • order
      • amount
      • hide_empty
      • threshold
      • tags_post_id
      • assigned_class
      • separator
      • adjust_separator_size
      • separator_size
      • prepend
      • append
      • link_append
      • link_target
      • show_tag_count
      • custom_title
      • custom_title_zero
      • custom_title_plural
      • add_premium_filter
    • Groups and Tabs
      • include
      • exclude
      • groups_post_id
      • show_tabs
      • hide_empty_tabs
      • show_all_groups
      • show_not_assigned
      • not_assigned_name
      • collapsible
      • mouseover
      • active
      • delay
      • group_in_class
  • Advanced Styling
    • div_id
    • div_class
    • ul_class

This guide shows you how to use and customize the shortcode for the Tabbed Tag Cloud feature in the Tag Groups plugin.


Shortcode #

[tag_groups_cloud]

Example #

[tag_groups_cloud collapsible=1]

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 #

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

include_terms #

Here you can specify tags/terms by their IDs that alone should be included.

accepted valuesdefaultexample shortcode
comma-separated list of integersempty (= no restriction)include_terms=4,5,212
Available only in the shortcode!

exclude_terms #

Here you can specify a list of tag/term IDs that should be excluded. exclude_terms is ignored if you use include_terms.

accepted valuesdefaultexample shortcode
comma-separated list of integersempty (= no restriction)exclude_terms=3,2,11
Available only in the shortcode!

orderby #

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

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
string (“ASC” or “DESC”)ASCorder=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

threshold #

Set a minimum count of published posts that use a tag for this tag to appear. Posts are counted across all groups. Please also pay attention to the value of hide_empty.

DefaultPossible ValuesExample
0integerthreshold=2

tags_post_id #

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.

accepted valuesdefaultexample shortcode
integer-1 (all tags displayed)tags_post_id=0

assigned_class #

A modification of the tags_post_id parameter: Rather than hiding tags that are not assigned to the post (or page), they can be styled differently. Tags will receive this class name with appended _1 or _0. (If you output the tags as an array, a new element with the key “assigned” will be true or false.)

accepted valuesdefaultexample shortcode
stringempty (off)assigned_class=“color-for-assigned-tag”

separator #

A separator between the tags.

accepted valuesdefaultexample shortcode
stringemptyseparator=“•”

adjust_separator_size #

Whether to adjust the separator’s size to the size of the following tag.

accepted valuesdefaultexample shortcode
0 or 11adjust_separator_size=1

separator_size #

The size of the separator, if not automatically adjusted to the size of the following tag.

accepted valuesdefaultexample shortcode
integer12separator_size=12

prepend #

Prepend to each tag label. Can obtain the placeholder {count} that will be replaced with the post count for that tag.

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.

accepted valuesdefaultexample shortcode
stringemptyappend=“{count}”

link_append #

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

accepted valuesdefaultexample shortcode
stringemptylink_append=“track=this”
Available only in the shortcode!

link_target #

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.

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

custom_title #

tooltip when hovering the mouse over a tag; placeholders: {count} for post count, {description} for tag description, {name} for tag name

If you also use custom_title_plural then the text of custom_title will be used for a post count of 1 and you can use here the singular form

DefaultPossible ValuesExample
depends on show_tag_countstringcustom_title="One post uses {name}"

custom_title_zero #

tooltip when hovering the mouse over a tag; placeholders: {count} for post count, {description} for tag description, {name} for tag name

This text will be used for tags that have a post count of 0 (i.e. they are not used with any published post).

DefaultPossible ValuesExample
not usedstringcustom_title_zero="No post uses {name}"

custom_title_plural #

tooltip when hovering the mouse over a tag; placeholders: {count} for post count, {description} for tag description, {name} for tag name

This text will be used for tags that have a post count of >1. You can use here plural forms.

DefaultPossible ValuesExample
not usedstringcustom_title_plural="{count} posts use {name}"

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.

accepted valuesdefaultexample shortcode
0 or 10 (no filter)add_premium_filter=1

Groups and Tabs #

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”

exclude #

groups to exclude

DefaultPossible ValuesExample
nonecomma-separated list of group IDsexclude=2,3,5

groups_post_id #

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

accepted valuesdefaultexample shortcode
integer-1 (all groups displayed).groups_post_id=14

show_tabs #

Whether to show the tabs. This option is useful if you want to show only one group – see include.

accepted valuesdefaultexample shortcode
0 or 11show_tabs=0

hide_empty_tabs #

Whether to hide tabs without tags.

accepted valuesdefaultexample shortcode
0 or 10 (Not implemented for PHP function with second parameter set to ‘true’. Not effective with groups_post_idhide_empty_tabs=1

show_all_groups #

Whether to force showing all groups. Useful with the parameters tags_post_id and assigned_class.

accepted valuesdefaultexample shortcode
0 or 10show_all_groups=1
Available only in the shortcode!

show_not_assigned #

Whether to show all not-assigned tags as an own group.

accepted valuesdefaultexample shortcode
0 or 10show_not_assigned=1

not_assigned_name #

The name used in the tab of not-assigned tags, if you activated show_not_assigned.

accepted valuesdefaultexample shortcode
string“not assigned”not_assigned_name=“Other”

collapsible #

Whether tabs are collapsible (toggle open/close).

accepted valuesdefaultexample shortcode
0 or 1Settings in the back end.collapsible=1

mouseover #

Whether tabs can be selected by hovering over with the mouse pointer (without clicking).

accepted valuesdefaultexample shortcode
0 or 1Settings in the back end.mouseover=1

active #

Whether tabs are initially expanded or collapsed. Useful in connection with the parameter collapsible.

accepted valuesdefaultexample shortcode
0 or 11active=1

delay #

Since version 1.29.0, we reveal the tag cloud only after the tabs have finished rendering. This prevents that visitors of your site first see tags in a list (often with bullets) before the software is able to kick in. If for any reason you need to restore the previous behavior, you can turn it off here.

accepted valuesdefaultexample shortcode
integer1 (on)delay=0

group_in_class #

Add class names to each tag that indicates its group ID (tg_tag_group_id_1) and group label (tg_tag_group_label_first_group).

accepted valuesdefaultexample shortcode
0 or 10group_in_class=1

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

  1. If you display more than one tag cloud on the same page, each shortcode needs a different value. The safest solution is to leave it empty so that div_id automatically receives a random value.
  2. 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>.

accepted valuesdefaultexample shortcode
stringtag-groups-cloud-tabsdiv_class=“make-it-dark”

ul_class #

Define a class for the <ul> that generates the tabs with the group labels.

accepted valuesdefaultexample shortcode
stringemptyul_class=“change-pointer”
Tabbed Tag Cloud – Gutenberg BlockTabbed Tag Cloud – Themes
Table of Contents
  • Shortcode
  • Example
  • Data Types
  • Parameters
    • Tags or Terms
      • taxonomy
      • smallest
      • largest
      • include_terms
      • exclude_terms
      • orderby
      • order
      • amount
      • hide_empty
      • threshold
      • tags_post_id
      • assigned_class
      • separator
      • adjust_separator_size
      • separator_size
      • prepend
      • append
      • link_append
      • link_target
      • show_tag_count
      • custom_title
      • custom_title_zero
      • custom_title_plural
      • add_premium_filter
    • Groups and Tabs
      • include
      • exclude
      • groups_post_id
      • show_tabs
      • hide_empty_tabs
      • show_all_groups
      • show_not_assigned
      • not_assigned_name
      • collapsible
      • mouseover
      • active
      • delay
      • group_in_class
  • Advanced Styling
    • div_id
    • div_class
    • ul_class

Recent Posts

  • How to Find the IDs of WordPress Tags, Posts or Categories May 24, 2023
  • How to Change the Design of Accordions and Tabbed Tag Clouds May 16, 2023
  • How to Add Custom Designs to Terms in Tag Groups May 15, 2023
  • Find The Most Used Tags On Your WordPress Site May 14, 2023
  • What is a Tag Slug in WordPress? May 11, 2023

Testimonials

Does the job and easy to use. Lots of features in the free version and even better ones in the professional version.

espertus

The plugin has great features even in the free version. I had a minor issue and the plugin author replied within hours even on Sunday! Highly recommended.

Sanchit Goyal

Important Links

  • TaxoPress Demos
  • Frequently Asked Questions
  • About the TaxoPress Team
  • Terms of Service
  • TaxoPress Affiliates
  • Logo and Brand Materials

Our Projects

  • PublishPress
  • MetaSlider
  • KinshiPress
  • Ramble Ventures
  • Logtivity

© 2023 TaxoPress

Facebook Twitter
Scroll to top
  • TaxoPress
  • Tag Groups
  • Docs
  • Blog
  • Support
Search