It is a TV field where we can enter values «on the go». In other words, we do not specify «Possible Values» while editing the TV but enter those values into that field on the resource edit page. It is very convenient to use such a field to create tags on a website, because, apart from adding values «on the go», we can also choose values already used from other resources.

 TVSSResources Snippet

The snippet displays tagged resources. All its parameters are usable in pdoFetch, which makes it possible to specify any pdoTools parameters… It understands Fenom and can work with pdoPage. The following example presents a selection of resources with «tag1», «tag2», and «tag3», specified in the TV with IDs 17 or 19:

<code>{$_modx->runSnippet('pdoPage', [
    'element' => 'tvssResources',
    'tv' => '17,19',
    'tag' => 'tag1||tag2||tag3',
    'parents' => 0,
    'tpl' => '@INLINE</code>

',
])}
{$_modx->getPlaceholder('page.nav')}

TVSSTickets Snippet

The snippet displays all tagged tickets of the Ticket extra. All its parameters are usable in getTickets, which makes it possible to specify any getTickets parameters. The following example presents tickets with tags «tag1», «tag2», and «tag3», specified in the TV with IDs 17 or 19:

{$_modx->runSnippet('pdoPage', [
    'element' => 'tvssTickets',
    'tv' => '17,19',
    'tag' => 'tag1||tag2||tag3',
    'parents' => 0,
])}
{$_modx->getPlaceholder('page.nav')}

TVSSTags Snippet

Displays a list of resource tags. Example of displaying all tags from TV field 17, specified in the current resource. A URL for Resource 2 (where the tvssResources snippet is) is created in a tag reference:

{$_modx->runSnippet('tvssTags', [
    'id' => $_modx->resource.id,
    'tv' => 17,
    'pageId' => 2,
])}

Tag Creation Guide for a Website

Attention! This guide is written using Fenom. If you do not use it on your website, you will have to entirely change the code in the examples to standard syntax.

1. After the extra has been installed, create a new TV using tvSuperSelect. Memirize its ID (in our case, it is 2).
2. Create the resource "Tagged Resources". Memorize its ID (in our case, it is 2). Write down the following in the longtitle:

   Tagged resources {$.get['tag'] ? ' «'~($.get['tag']|unescape:"url")~'»' : ''}

   • Content for displaying a list of resources:

     {if $.get['tag']?}
         <div id="pdopage">
             <div class="rows">
                 {$_modx->runSnippet('pdoPage', [
                     'element' => 'tvssResources',
                     'tv' => '2',
                     'parents' => 0,
                     'ajaxMode' => 'default',
                     'tpl' => '@INLINE <div>{$id} - {$pagetitle}</div>',
                 ]) ?: 'No resources for this tag found'}
             </div>
             {$_modx->getPlaceholder('page.nav')}
         </div>
     {else}
     Specify tag for documents selection
     {/if}

   • Content for displaying a list of tickets:
     

     {if $.get['tag']?}
         <div id="pdopage">
             <div class="rows">
                 {$_modx->runSnippet('pdoPage', [
                     'element' => 'tvssTickets',
                     'tv' => '2',
                     'parents' => 0,
                     'ajaxMode' => 'default',
                 ]) ?: 'No tickets for this tag found'}
             </div>
             {$_modx->getPlaceholder('page.nav')}
         </div>
     {else}
     Specify tag for documents selection
     {/if}

3. Specify tag list display in the template (or chunk) displaying a complete article or ticket:
   

   {$_modx->runSnippet('tvssTags', [
       'id' => $_modx->resource.id,
       'tv' => 2,
       'pageId' => 2,
   ])}

A Guide for Displaying Similar Articles Using Tags

• Similar Resources

  Fenom:

  {$_modx->runSnippet('tvssResources', [
      'tv' => '2',
      'tags' => $_modx->runSnippet('tvssTags', ['id' => $_modx->resource.id, 'tv' => '2', 'tpl' => '@INLINE [[+tag]]', 'outputSeparator' => '||']),
      'parents' => 0,
      'limit' => 4,
  ]) ?: 'No similar entries found'}

  Standard syntax:

  [[tvssResources:empty=`No similar entries found`?
      &tv=`2`
      &tags=`[[tvssTags?id=`[[*id]]`&tv=`2`&tpl=`@INLINE [[+tag]]`&outputSeparator=`||`]]`
      &parents=`0`
      &limit=`4`
  ]]

   

  
  

• Similar Tickets

  Fenom:

  {$_modx->runSnippet('tvssTickets', [
      'tv' => '2',
      'tags' => $_modx->runSnippet('tvssTags', ['id' => $_modx->resource.id, 'tv' => '2', 'tpl' => '@INLINE [[+tag]]', 'outputSeparator' => '||']),
      'parents' => 0,
      'limit' => 4,
  ]) ?: 'No similar entries found'}

  Standard syntax: 

  [[tvssTickets:empty=`No similar entries found`?
      &tv=`2`
      &tags=`[[tvssTags?id=`[[*id]]`&tv=`2`&tpl=`@INLINE [[+tag]]`&outputSeparator=`||`]]`
      &parents=`0`
      &limit=`4`
  ]]

A Few Details on Values Database Storage

1. This TV field has a tvss_options table of its own where data are stored as follows:
2. The data are, however, also stored in a site_tmplvar_contentvalues table, but as a JSON array:

The former is intended for convenient filtering; the latter, for simple displaying. Discuss the extra in MODX.PRO community.