Home  Extras  MODx Add-Ons  TvTagCloud

Product:

TvTagCloud


Forums Support Thread Votes: 12
Tags: Navigation, Blogging, snippet, taxonomy
Submitted: Aug 2, 2010
Released: Aug 2, 2010
Downloads: 77
License: GPLv2

Works with:
Evolution-1.0.5
Evolution-1.0.4
Evolution-1.0.3
Evolution-1.0.2
Evolution-1.0.1
Evolution-1.0.0
0.9.6.3
0.9.6.2
0.9.6.1
0.9.6
0.9.5

TvTagCloud 2.2-release | Author: ncrossland

Displays the tags from set of documents in a "tag cloud" or list.

REQUIRED PARAMETERS

    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   

    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 alphabetical
            dec - tag reverse alpgabetical
            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"
   
    tooltip: Template for the tooltip that will appear as the title attribute for each tag link. Takes placeholders [+count+] and
                  [+tag+] which will be replaced with appropriate values

    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


Download


Description

TvTagCloud allows you to display your doument tags in a tag cloud or as an unordered list. When a user clicks on a tag it links them to a page displaying all documents containing the clicked tag.

This snippet requires the latest version of Ditto to function correctly.

Parameters:

  • parent - folder that contains the documents which are to be counted (can take multiple parents, separate with commas)
  • depth - the number of levels we should search for child documents (like Ditto)
  • days - the number of days to look back over to find tags (based on pub_date), 0 for all
  • 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 alphabetical
    dec - tag reverse alpgabetical
    numasc - tag count ascending
    numdesc - tag count descending
    random - random order
  • landing - id of document to display ditto listings
  • tvTags - the template variable that has the tags
  • tagDelim - delimiter between tags in tvar
  • displayType - [cloud | list] output as a tag cloud or an unordered list
  • 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 (i.e. how many times must a tag appear before it increases in size)
  • styles - comma separated list of class names that will be applied to each of the size intervals in "steps"
  • tooltip - Template for the tooltip that will appear as the title attribute for each tag link. Takes placeholders +count+ and +tag+ which will be replaced with appropriate values
  • dittoID - Id of the Ditto instance which should display the selected tag
  • limit - restrict the number of tags to display

Instructions

First thing you need to do is add a new template variable to the template you use for your documents. For this example I named mine docTags. Then go into each document and add some tags i.e. modx,snippet,ajax.

Next you need to setup the snippet call. Add the following snippet call to your page where you want to display the tag cloud:

[!TvTagCloud? &parent=`1` &landing=`22` &tvTags=`docTags` &showCount=`1`!]

To create the landing page that will display the pages when a tag is clicked create a new document with the following Ditto call:

 [!Ditto? &parents=`1` &extenders=`tagging` &tagData=`docTags` &tagDelimiter=`,`!]




Released Versions

Releases that are grayed out are deprecated.

Version Released Author Downloads
Total Versions: 6 Total Downloads: 6,598
2.2-release Aug 02, 2010 ncrossland 77
2.1.4 May 09, 2008 Mark / Ncrossland 2,354
2.1.3 Apr 09, 2008 Mark / Ncrossland 479
2.1.1 Jul 27, 2007 Mark / Ncrossland 1,221
2.0 May 10, 2007 Mark 829
1.0 Jul 16, 2006 kylej 1,638

Download Statistics

Package downloads per day since tracking began on June 27th, 2010. Weekends are colored. Plot below shows an overview.


Top Countries

This is a list of the countries most downloading this Extra.

Country Downloads
Russian Federation 65
United States 60
Germany 18
United Kingdom 12
Japan 10
Ukraine 10
France 6
Netherlands 5
Italy 4
Belarus 4
 
 
 

Contact Us | Advertise | Team Blog | FAQ | Credits

© 2005-2010 MODx, LLC. All rights reserved. Privacy Policy | Terms of Service