Tag List – Shortcode Parameters

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

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