TvTagCloud
This is a user-contributed Extra. If you find issues or would like more info or help, please contact the author.
Usage
[!TvTagCloud? &parent=`1` &landing=`22` &tvTags=`docTags` &showCount=`1` !]
Required Parameters
Parameter | Description |
---|---|
parent | folder that contains the documents which are to be counted. Can take a comma separated list of parents, like Ditto does. |
tvTags | the template variable that has the tags |
Optional Parameters
Parameter | Description |
---|---|
depth | the number of levels down we should search for child documents |
days | the number of days to look back over to find tags. Leave as 0 for all time |
min | minimum number of tag occurances for tag to show, 0 for all |
sort | How should the results be ordered? By default they will be sorted by document ID. Values can be: asc - tag alphabeticaldesc - tag reverse alphabetical numasc - tag count ascending numdesc - tag count descending random - random order |
landing | id of document to display ditto listings |
tagDelim | delimiter between tags in TV |
displayType | [cloud | list | custom] output as a tag cloud, unordered list, or custom output. If custom output, specify a chunk name via customDisplayChunk |
customDisplayChunk | chunk name containing HTML when displayType custom. Uses the following placeholders: [+class+] [+landing+] [+qs_seperator+] [+url_param+] [+tag+] [+urlencoded_tag+] [+tooltip+] [+count+] [+bracketed_count+] |
showCount | if you want the number of occurances to be displayed set to 1 |
caseSensitive | if you want tag duplicate removal to be case sensitive set to 1 |
steps | comma separated list of the numeric intervals to determine the size of the tag class |
styles | comma separated list of class names that will be applied to each of the size intervals in "steps" |
dittoID | Id of the Ditto instance which should display the selected tag (if there is more than one Ditto call on landing page) |
limit | restrict the number of tags to display |
exclude | list of tags you don't want to appear in the output (separated by tagDelim - a comma by default) |
promote | list of tags you want to appear first in the output (separated by tagDelim - a comma by default) |
demote | list of tags you want to appear last in the output (separated by tagDelim - a comma by default) |
extraTags | list of extra tags you want to appear, even if they're not detected in the pages (separated by tagDelim - a comma by default) |
currentClass | class name to apply to the tag which is currently being filtered on |
urlParam | name of the URL parameter used when generating URLs or detecting filtering |
Landing Page setup:
The landing page should have a call to ditto (v2+) with at minimum of the following tagging parameters set:
[!Ditto? &parents=`1` &extenders=`tagging` &tagData=`docTags` &tagDelimiter=`,` !]
Suggest an edit to this page.