Shortcode
[tag_groups_tag_list]
Example
[tag_groups_tag_list append=" {count}"]
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
This overview assumes that you know how to use shortcodes. Shortcodes are the traditional WordPress way how to add features into posts, pages and widgets.
add_premium_filter
Modifies the URL – for the case that you use the same tag in various groups.
Default | Possible Values | Example |
0 (false) | 0 or 1 | add_premium_filter=1 |
amount
the maximum number of tags per group to display
Default | Possible Values | Example |
0 (no limit) | integer | amount=10 |
append
adds something behind the tag name; placeholder: {count} for post count
Default | Possible Values | Example |
empty | string | append= ” ({count})” |
assigned_class
adds class name to tags that shows whether the tag is assigned or not; assigned tags have “_1” appended, unassigned “_0” to the class name
Default | Possible Values | Example |
empty | string | assigned_class="colored-tags" |
column_count
number of columns
Default | Possible Values | Example |
2 | integer | column_count=3 |
column_gap
width of the gap between columns
Default | Possible Values | Example |
10px | string | column_gap=20px |
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
Default | Possible Values | Example |
depends on show_tag_count | string | custom_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).
Default | Possible Values | Example |
not used | string | custom_title_zero=" |
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.
Default | Possible Values | Example |
not used | string | custom_title_plural="{count} posts use {name}" |
div_class
class of the enclosing div for own styling
Default | Possible Values | Example |
tag-groups-tag-list | string | div_class="my-class" |
div_id
ID of the enclosing div
Default | Possible Values | Example |
random | string (must be unique on the page) | div_id="my-id" |
exclude_terms
a list of tags that should not appear
Default | Possible Values | Example |
empty | comma-separated list of tag IDs | exclude_terms= |
group_in_class
whether to add information about the groups into the class attribute; tg_tag_group_id_ + ID and tg_tag_group_label_ + tag name (spaces replaced with dashes)
Default | Possible Values | Example |
0 (off) | 0 or 1 | group_in_class=1 |
groups_post_id
ID of a post that the tags should be take from. 0 tries to get current post.
Default | Possible Values | Example |
-1 (off) | integer | groups_post_id=5634 |
h_level
<h3>/h3>, <h4></h4>, … of the headings with the group names
Default | Possible Values | Example |
3 | integer | h_level=2 |
header_class
class for the headers
Default | Possible Values | Example |
empty | string | header_class="my-class" |
hide_empty_content
hide empty groups
Default | Possible Values | Example |
0 (off) | 0 or 1 | hide_empty_content=1 |
hide_empty
hide tags with post count zero
Default | Possible Values | Example |
1 | 0 or 1 | hide_empty=0 |
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.
Default | Possible Values | Example |
0 | integer | hide_empty=0 |
include
groups to include
Default | Possible Values | Example |
all | comma-separated list of group IDs | include=2,3,5 |
exclude
groups to exclude
Default | Possible Values | Example |
none | comma-separated list of group IDs | exclude=2,3,5 |
include_terms
tags to include (see also “hide_empty”)
Default | Possible Values | Example |
all | comma-separated list of tag IDs | include_terms=12,34,255 |
keep_together
whether to keep headings and tag block together; otherwise tags lists may continue in a new column
Default | Possible Values | Example |
1 (on) | 0 or 1 | keep_together=1 |
largest
max. font size in pt
Default | Possible Values | Example |
12 | integer | largest=32 |
link_target
target attribute of the tag link (_blank, _top, _self, …)
Default | Possible Values | Example |
empty | string | link_target="_top" |
link_append
append query to the link
Default | Possible Values | Example |
empty | string | link_append= “source=cloud” |
not_assigned_name
lets you choose a custom group name for not-assigned tags
Default | Possible Values | Example |
not assigned | string | not_assigned_name="unsorted tags" |
order
ascending or descending order; use with orderby
Default | Possible Values | Example |
asc | string (asc or desc) | order=desc |
orderby
by what to order the tags
use together with order
Default | Possible Values | Example |
name | string | orderby=natural |
prepend
prepend to the tag; placeholder: {count} for post count
Default | Possible Values | Example |
empty | string | prepend="#" |
show_not_assigned
whether to show tags that are not assigned to any group
Default | Possible Values | Example |
0 | 0 or 1 | show_not_assigned=1 |
show_all_groups
whether to show also empty groups
Default | Possible Values | Example |
0 (off) | 0 or 1 | show_all_groups=1 |
show_tag_count
show the post count in the title (deprecated option, better use custom_title
Default | Possible Values | Example |
1 (on) | 0 or 1 | show_tag_count=0 |
smallest
min. font size in pt
Default | Possible Values | Example |
12 | integer | smallest=14 |
tags_div_class
class name for the divs around tags
Default | Possible Values | Example |
empty | string | tags_div_class="my-class" |
tags_post_id
Use post ID or zero for current post.
Default | Possible Values | Example |
-1 (not used) | integer | tags_post_id=0 |
taxonomy
taxonomies (tag types) to use
Default | Possible Values | Example |
all selected in the settings | comma-separated list of taxonomy names/slugs | taxonomy=product_tag |