Themeに挿入できるUTW(Ultimate Tag Warrior)のテンプレートタグについて

Themeに挿入できるUTWタグについていろいろ調べてみた結果、いろいろカスタマイズできることがわかったのでメモ代わりに。

基本テンプレートタグ

■LOOP内

UTW_ShowTagsForCurrentPost($formattype, $format, $limit)
記事に付けられたタグを表示
UTW_ShowRelatedTagsForCurrentPost($formattype, $format, $limit)
記事に付けられたタグの関連タグを表示
UTW_ShowRelatedPostsForCurrentPost($formattype, $format, $limit)
記事に付けられたタグの関連記事を表示

■Tagアーカイブ表示時

UTW_ShowRelatedTagsForCurrentTagSet($formattype, $format, $limit)
Tagアーカイブ表示時にそのタグの関連タグを表示
UTW_ShowCurrentTagSet($formattype, $format, $limit)
Tagアーカイブ表示時にそのタグを表示
WPタグのget_query_var("tag")と同じ

■Tag一覧

UTW_ShowWeightedTagSet($formattype, $format, $limit)
タグ一覧を利用頻度が多いタグ順に表示
UTW_ShowWeightedTagSetAlphabetical($formattype, $format, $limit)
タグ一覧をアルファベット順に表示
UTW_ShowTimeSensitiveWeightedTagSet($formattype, $format, $limit)
UTW_ShowWeightedTagSet()の拡張で
カテゴリ、日付アーカイブ表示時には、
そのアーカイブで使用されているタグ一覧を利用頻度が多いタグ順に表示
UTW_ShowTimeSensitiveWeightedTagSetAlphabetical($formattype, $format, $limit)
UTW_ShowWeightedTagSetAlphabetical()の拡張で
カテゴリ、日付アーカイブ表示時には、
そのアーカイブで使用されているタグ一覧をアルファベット順に表示

■その他

is_tag()
タグアーカイブ表示時は「true」それ以外は「false」

パラメータに関して$limitを指定しない場合は全タグが表示されるので基本的には不要。
$formattypeパラメータを指定する場合は$formatは不要。
$formattypeのパラメータ一覧はultimate-tag-warrior-help-themes.htmlにFormat Nameとしてサンプル表示付で一覧になってます。

例えば基本的なTagCloudを表示させる場合は下記のように記述します。
< ?php UTW_ShowWeightedTagSetAlphabetical("sizedtagcloud") ?>

$formatを使ってカスタマイズ

$formattypeを使わずに$formatを使って自由自在に表示することもできます。

利用頻度が高いタグを１０個とその前にfeedアイコンを表示させる場合

PLAIN TEXT

HTML:

<ul><?php UTW_ShowWeightedTagSet("", array("default"=>'
<li><a href="%tagurl%feed/" title="feed"><img src="'.get_bloginfo('template_url').'/images/feed-icon.gif" alt="feed" title="feed" /></a> <a href="%tagurl%" title="%tagdisplay% (%tagcount%)">%tagdisplay%</a>(%tagcount%)</li>
'), 10); ?></ul>

タグアーカイブ時に関連タグとその前に「＋」リンクを表示させる場合

PLAIN TEXT

HTML:

<?php
if ( is_tag() ) {
UTW_ShowRelatedTagsForCurrentTagSet("", array(
'pre' => '
<p class="relatedtags">
<h3>Related Tags</h3>
<ul>',
'post' => '</ul>
',
'default' => '
<li>%intersectionlink% <a href="%tagurl%" title="%tagdisplay% (%tagcount%)">%tagdisplay%</a>(%tagcount%)</li>
',
'single' => '
<li><a href="%tagurl%" title="%tagdisplay% (%tagcount%)">%tagdisplay%</a>(%tagcount%)</li>
'
));
}
?>