First Step: Tag Your Trees!
If you haven’t done so already, you should tag your trees. A tag is like a category – any tree can have multiple tags. This is the first step to being better organized.
To tag a tree:
- Start at My Trees, and select a tree.
- Go to the Settings tool.
- Click the Tags tab.
- Enter a tag, or pick from a list of existing tags:
- Click Update All Settings to save.
Locating Trees by Tag
Once you’ve tagged your trees, Zingtree has a few different ways to make it easy to stay organized:
- For Authors: Filter your list of trees by tag in the My Trees tool.
- For Authors: Use Tree Tag Integration to enter a list of tags to find trees that have any or all of the desired tags.
- For Agents or End-Users: Authors can use Tag Lists to present a list of trees to an end-user that contain any or all tags in a list.
Authors: Filter by Tag in the My Trees Tool
From the My Trees page, click on the Filters button. From here you can filter your list of trees by Tree Name, Author or Tags.
Select a tag, and you’ll see all the trees that have that tag.
Authors: Use Tree Search
For more powerful searching using tags, use the Tree Tag Integration button in My Trees. You have different search options:
- Match Tree Tags (any): Enter a comma separated list of tags. The results return a list of trees that include any of the tags in the list.
- Match Tree Tags (all): Enter a comma separated list of tags. The results return a list of trees that include all of the tags in the list.
Using Macros to Present Lists of Trees by Tag
Inside the content area of any tree, you can insert a special macro to show all the trees in your organization that match any or all tags in a list. You can examine the Tree Tag Demo in the Zingtree Gallery to see how this is done.
The two macros you can insert into the content area are:
- ##treetaglist-any: tags##
- ##treetaglist-all: tags##
In the examples above, replace tags with a comma separated list of tags. treetaglist-any will return a list of trees that match any of the tags in the list. treetaglist-all returns only those trees that contain all the tags in the list.
#treetaglist-any: demo,gallery## – matches trees that are tagged with either demo or gallery.
#treetaglist-all: demo,gallery## – matches trees that are tagged with both demo and gallery.
Shortcut: When editing a node, you can insert these macros from the Templates editing tool in the Content editor:
Bonus: Dynamic Lists
When publishing a tree, if you add a tags= parameter to the tree URL, you can dynamically import the list of tags used by the tree macros. Be sure to separate the tags with | characters. Example:
Inside the tree, this macro will list trees that have tags that match ALL the tags in the passed-in tags= parameter:
This macro will list trees that have tags that match ANY tags in the passed-in tags= parameter: