Tag Cloud Search – Shortcode Parameters

This is a feature of the Premium plan. Tag Groups Premium

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.

Shortcode

[tag_groups_cloud_search]

Example

[tag_groups_cloud_search tag_cloud_class="my-tag-cloud" label="Looking for a name?" placeholder="Type here"]

Parameters

tag_cloud_class

This parameter is a class name (selector) that creates the connection between the search field and one or more supported tag clouds. By default it connects to all supported tag clouds on the same page.

Enter the same class name that you use in the tag cloud as “div_class” (or “table_class”). Example:

[tag_groups_cloud_search tag_cloud_class="searchable-tag-cloud"]
[tag_groups_cloud div_class="searchable-tag-cloud"]

If you also need other class names in the tag cloud, you simply enter all of them in the tag cloud as “div_class”, separated by spaces. Example:

[tag_groups_cloud_search tag_cloud_class="searchable-tag-cloud"]
[tag_groups_cloud div_class="green-tags other-styling searchable-tag-cloud"]
accepted valuesdefaultexample shortcode
string (class name)tag-groups-cloudtag_cloud_class=searchable-tag-cloud-2

search_title

(available in version 1.44.0 and later)

If you activate this option, the filter will also show tags where a part of the “tag description” matches the words in the text field.

The description can be added to tags when you create a new tag or click on a tag name to edit its information. It’s not editable via “Quick Edit” in the tag list.

Filtering by description works only if you display the description in the “custom title” (aka tooltip, visible when you hold your mouse pointer over the tag). Use the placeholder {description} in the custom title field of the connected tag cloud.

accepted valuesdefaultexample shortcode
integer (0 or 1)0 (off)search_title=1

label

An optional label, displayed above or left of the input field.

accepted valuesdefaultexample shortcode
stringemptylabel="Search:"

placeholder

The text that appears in the empty input field.

accepted valuesdefaultexample shortcode
stringSearch a tagplaceholder="Start typing"

div_class

You can use this to access the input field with CSS.

accepted valuesdefaultexample shortcode
stringemptydiv_class="my-custom-styling"