TvTagCloud - 2.1.4

 

参照ページ：TvTagCloud

テスト環境

• サーバ：さくらインターネット 　
  • PHP 4.4.4
  • MYSQL 4.0.27
• MODX：0.9.5
• TvTagCloud - 2.1.4

基本的な書式

[!TvTagCloud? &parent=`docid` &landing=`docid`!]

パラメータ

parent

タグをカウントしたいドキュメントを含む親ドキュメントを指定します。カンマで区切って複数指定可能です。

デフォルト「0」。

例：&parent=`22,54,31`

depth

どの階層まで取得するかを指定します。

デフォルト「10」。

days

何日さかのぼって取得するかを指定します？。公開日（pub_date）が基準になります。

デフォルト「0」。すべて。

min

取得するタグの最小出現回数を指定します。ここで指定した値以上出現している場合のみ、取得の対象になります。

デフォルト「0」。すべて。

sort

出力結果をどのように並べるかを指定します。

デフォルト「docID順」。

以下を指定できます。

• asc - アルファベット昇順
• dec - アルファベット降順
• numasc - 出現回数の少ない順
• numdesc - 出現回数の多い順
• random - ランダムに表示

landing

Ditto によるリストアップを表示させるドキュメントIDを指定します。

デフォルト「カレントドキュメント」

tvTags

タグを入力するテンプレート変数名を指定します。

デフォルト「repo_tags」。

tagDelim

タグ入力の際、タグ同士を区切る文字を指定します。

デフォルト「,（カンマ）」

displayType

表示タイプを指定します。

デフォルト「cloud」（クラウド状に表示）。

以下を指定できます。

• cloud ... <div>～</div>の中にタグをクラウド状に表示します。
• list ... <ul>を使ってリスト表示します。

showCount

出現回数を表示するかどうかを指定します。

デフォルト「0」（しない）

以下を選択できます。

• 0 ... 表示しない
• 1 ... 表示する

caseSensitive

大文字／小文字の区別をつけるて取得するかどうかを指定します。

デフォルト「0」（しない）。

以下を指定できます。

• 0 ... 区別しません
• 1 ... 区別します

steps

タグの出現回数によって、クラス付けを行います。その際の出現の割合を指定します。

デフォルト「14,25,34,51,100」。

「100/出現回数」の数字が基準になります。例えば、出現回数が8回の場合、100/8=12.5 となり、14より小さいことにより、s5とクラス付けされます（styles 参照）。出現回数が7の場合、100/7=14.28....となり、s4とクラス付けされます（たぶん）。

styles

出現回数によってクラス付けされるクラス名を指定します。

デフォルト「s5,s4,s3,s2,s1」。出現回数の多い順に割り当てられます（steps参照）。

tooltip

タグクラウドのリンクをマウスオーバーしたときのツールチップを指定します。

デフォルト「Click for stories about ()」。

例：&tooltip=`タグ： ()`

...で、良いと思うのですがプレースホルダの値が出力されず。。変更する場合は、スニペットの中の該当部分を変更するしかない。

dittoID

ditto側にidが指定してある場合、ここで同じidを指定します。

limit

クラウド（リスト）に表示するタグの数を指定します。

デフォルト「0」（すべて）

タグの表示先はDittoで

クラウド中のタグをクリックしたあと、一覧表示させるには、Dittoを利用します。&landing で、指定したページには以下の様にDittoコールを書きます（例です）。

[!ditto? &parents=`docid` &tagData=`repo_tags` &tagDelimiter=`,` &landing=`docid`!]

&parents の値は、TvTagCloud のparent で指定した値と同じ値にします。

サンプル

TvTagCloud のサンプルはこちらです。