power source*

カテゴリリストからカテゴリを選ぶと、該当する記事が列挙されるので便利なのだけど、「全体像」なんてのはカテゴリというよりキーワードなんだよなあ。「カテゴリA and カテゴリB」みたいな記事抽出方法もまだ見つかっていないし・・・。そんなぼのの元に、救世主現る！

その名は Ultimate Tag Warrior。

うーむ、頼もしいお名前。ちゅーか、試しに使うには恐ろしげな名前だったので今まで手を出していなかったのだけれど、実は私の欲しかった機能が含まれたプラグインだったのです。

徐々に使いながらこの記事に書き込んでいきます。
まずは設置・基本機能についてメモ。

現在このプラグインは無効化してあります。

Ultimate Tag Warrior 3

機能概要	記事にキーワード（タグ）を付け、同じタグを付けた記事やTechnorati のような外部サイトの記事とリンクさせることが出来る。関連記事のリスト表示も可能。記事を and 条件で引っ張れるのは得がたい機能。
バージョン	3.1 for Wordpress 2.0
作者（web)	Christine Davis さま
配布元	Neato » Ultimate Tag Warrior 3
ドキュメント	同上 Ultimate Tag Warrior 3: Help （同じものが同梱されている） 同梱の readme.txt themes, extensions and other hackery — 対応テーマ、拡張機能
「ページ」対応	△？： 下記参照
適用したWP	WordPress ME 2.0.3 [UTF-8] WordPress ME 2.0.4 [UTF-8]

特徴

参照： Ultimate Tag Warrior 3: Help

• 記事に複数のキーワード（俗に「タグ」という）を付けられる。
• 記事に表示したタグ等から、「タグ・アーカイブページ」へリンク（同じタグを付けられた記事のアーカイブページ）できる。カテゴリアーカイブと違って、複数のタグを条件にできる。「Aタグ and Bタグ and Cタグ ・・・」。もちろん or も OK。
• タグを記事に表示し、外部サービスの同じタグを持つ記事へリンクを張れる。タグ付けを行っている del.icio.us, Flickr, Technorati, Wikipedia 等。
• 追記 記事本文中にタグを埋め込める（記事中の語句をマークアップ）。そこから自動的にタグアーカイブページへのリンクが張られる。
• 関連記事の表示もできる。
• タグの表示フォーマットは、用意されているフォーマットのほか、自由にカスタマイズもできる。
• 各タグアーカイブの RSS/atom フィードを提供。これも複数タグ条件可能。
  （例） 「plugin」 and 「検索」タグのRSSフィード2
• 続きは追々。

導入手順

cf. Ultimate Tag Warrior 3: Help > Installation

1. DB バックアップ
   • 新しいテーブルが作られたり、設定によっては既存テーブルにも変更が加わりそうなので。
   • XREA管理画面での DB保存 と、phpMyAdmin でエクスポートをしておいた。ついでにエクスポート前に最適化も。
2. 配布元の「3.1 for Wordpress 2.0」からダウンロード。
3. UTW3-1WP2.zip を解凍すると、次のファイルができる。
   • readme.txt
   • plugins/ フォルダ — プラグイン一式とヘルプファイル。ヘルプファイルは管理パネルのオプション画面からリンクされる。
   • themes/ フォルダ — テーマテンプレートの編集見本。各ファイルの説明はとりあえず readme.txt 参照。後述予定あり。
4. 解凍した plugins/ フォルダ内にある UltimateTagWarrior/ フォルダごと、wp-content/plugins/ ディレクトリへアップロード。
5. 管理画面にて、下記のうちの 上の2つ 一番上の一つのみ を有効化。
   • Ultimate Tag Warrior 3.1 — UTW 本体
   • Ultimate Tag Warrior: Tag Archive 1.0 — タグによるアーカイブ表示を実現するオプションのアドオン（Add-on）・プラグイン。³
   • Ultimate Tag Warrior 1.3 Legacy — 旧バージョンのシンタックスを有効にするもの。新規インストールなら不要。
6. 有効化した時点で、自動的に次の変更がなされる。他にもあるかも？
   • DB に次の 3テーブル が追加される。
     • wp_post2tag — 記事ID と タグID との関連付け
     • wp_tags — タグID と タグ名
     • wp_tag_synonyms — まだ謎。ゆらぎの登録かな？
   • 記事投稿画面に 2欄が追加される⁴ : Tags （ここでタグ付け）, Tag Suggestions（タグ名提案）。
   • プラグイン Extended Live Archive にオプション項目が追加される。詳細は後述。

使い方・基本編

環境設定

初めに環境設定を行う。次節 環境設定画面 参照。
この記事では、用語の説明を兼ねて、実際のタグ付け・表示について先に書いていく。

記事へのタグ付け

cf. Ultimate Tag Warrior 3: Help > Using Ultimate Tag Warrior⁵

タグ付けする方法は3種類＋拡張1種類。

(1) 記事投稿画面の Tags 欄に入力

• 記事投稿画面の Tags 欄（図中(1)）にて、その記事に付けたいタグ（キーワード）を入力する。複数付けるときは「,」で区切る。
• 環境設定画面の Editing Options を設定すると、過去に付けた既存タグを選択候補として表示できる。（図中(2)は「dropdown」表示にした例）
• Tag Suggestions （図中(3)）では、Tagyu と Yahoo! からタグ名を提案してもらえるみたい。 クリックするとタグ名の候補が提示され、それをクリックすると Tags 欄に入る。この記事の場合は、「ultimate」と「tag」が表示された。
• その記事のカテゴリを自動的にタグとすることもできる。環境設定 で行なう。

(2) 記事本文にタグを埋め込む 追記

• 記事中の語句を [tag］語句[/tag］（←鍵括弧は半角。複数のときはtags）のようにマークアップすると、
  • その語句が、自動的にその記事のタグとして登録される。
  • マークアップした位置（語句）からタグアーカイブページへのリンクが張られる。
• （例） [tag］UTW[/tag］と書くと → [tag]UTW[/tag]
  
  • ↑ 「UTW」は、この記事の Tags 欄には入れなかったが、このマークアップをして記事を保存すると自動的に Tags に追加され、「Keyword(Tag):」に載る。
  • 上のリンクをクリックすると、タグ「UTW」のアーカイブページへ飛ぶ。
• 環境設定で 「Use embedded tags」 をオンにしておくこと。
  （本文内をサーチするのだろうから処理が重くなるかも。）
• 参照： Help > Using Ultimate Tag Warrior > Using Embedded Tags

(3) 既存の記事へのタグ付け - The inline tag-adder

• 上記の記事編集画面でももちろん行なえるが、
• The inline tag-adder を使うと便利。
  記事が表示されるページ（アーカイブページ、単体記事ページ等）に設置する。設置方法は「2) テーマ編集編」に書く。
  • 記事を表示しているその場で、画面遷移することなく、タグを追加していける。（ajax 使用）
  • アーカイブ等、記事が一覧表示されるページに設置すると、一画面で複数の記事に一気にタグ付けできる。
  • 「ページ」にもタグ付けできる。
  • タグの修正・削除は出来ない。adder なだけに。
  • 惜しい点： 記事投稿画面のように既存のタグから選択できるようになると、さらに便利。ただ今試行錯誤中。
  • （注） これでタグを追加すると、Ext. Live Archive に反映されない（たぶん記事を更新したときじゃないと、ELA のキャッシュが更新されないから）。 まとめて作業した後で、ELA のキャッシュをクリアすればOK。

(4) 拡張機能 ReTag Post-Extension for UTW

• 記事を一覧表示してタグ付けできる The inline tag-adder は便利だが、付けたタグの修正・削除ができない。
• 拡張プラグイン ReTag Post-Extension for UTW では、修正・削除もできるらしい。（by にるちるさん）

各記事のタグリストの表示

• タグリスト⁶ — その記事に付けられたタグの一覧。
• 自動表示：
  次節 環境設定画面にて、Primary/Secondary Content Tags を設定すると、各記事本文の上か下に タグリストが自動的に表示されるようになる。
  表示フォーマットは定義済みフォーマットから選べる。
• 手動表示：
  表示位置・表示フォーマットをさらにカスタマイズしたい場合、前項の自動表示をオフし、UTW テンプレートタグを自分でテーマテンプレートに挿入。詳細は「2) テーマ編集編」、「3) UTWテンプレートタグ編」参照。
• タグのリンク先：
  タグリストに並んだタグをクリックしたときのリンク先は、選ぶ表示フォーマットによって異なる。自サイトのタグ・アーカイブページにするか、Technorati 等の外部サイトにするか等も含めてフォーマットを選ぶ。希望のがなければカスタム。

タグ・アーカイブページの表示

• タグ・アーカイブページとは⁷：
  • タグリスト等のタグをクリックしたときに表示される、当該タグの付けられた過去記事を表示するアーカイブページ。
  • カテゴリ・アーカイブページと違い、一つのタグについてのアーカイブだけでなく、タグA and タグB、A or Bタグ のような、複数タグの and/or 条件に該当する記事のアーカイブ表示もできる。
    このタグの組を タグセット という。
  • URI 表記は、環境設定によって変えられる。
    • タグセット tagA → ～/index.php?tag=tagA, ～/tag/tagA, ～/tag/tagA/
    • タグセット tagA and tagB → ～/index.php?tag=tagA+tagB, ～/tag/tagA+tagB, ～/tag/tagA+tagB/
    • タグセット tagA or tagB → ～/index.php?tag=tagA|tagB, ～/tag/tagA|tagB, ～/tag/tagA|tagB/
• 表示レイアウト:
  • 使用テーマディレクトリ下に tag.php があればそのレイアウト。
  • なければ index.php のレイアウトで表示される。
  • 具体的なテンプレート作成については「2) テーマ編集編」参照。
• is_tag():
  • 現在表示しているページがタグ・アーカイブページか否かの判断に使える、このプラグイン独自の条件分岐タグ（コンディショナルタグ）。タグ・アーカイブページのときに true を返す。
  • is_category() と違ってパラメータは入れられない、と、思う。＝タグによってタグアーカイブの表示を変えたりできない。
• ページタイトル⁸ には、デフォルトではブログ名しか表示されない。これを「ブログ名 » タグ名」のようにするには、header.php を修正する。readme.txt or 「2) テーマ編集編」参照。

サイト中で使用している全タグの表示

• サイドバー等の既存テンプレートや全タグ表示専用ページ（tags.php）に、UTWテンプレートタグを挿入することにより表示できる。
• 表示タグ数を絞ることもできる。
• 表示形式は、タグクラウド⁹ ・グラフ・テキスト等が代表的だが、他のフォーマットも可。
• 表示方法・フォーマット・カスタマイズについては「3) UTWテンプレートタグ編」。
• 専用テンプレート tags.php の作成については「2) テーマ編集編」。
• プラグイン Extended Live Archive を入れている場合は、ELA のオプション設定により自動表示が可能。後述「Extended Live Archive との連携」参照。

タグ・サーチ 追記

• 全タグ一覧からタグを選ぶと、該当記事リストがその場に表示され、選んだタグに関連するタグも大きく表示され、条件の絞り込みとかができちゃう Ajax な機能。
• readme.txt 参照。「2)テーマ編集編」に書く予定。
• 設置例

タグ管理

• 管理画面 > オプション > Tags パネル - Manage Tags、または、管理画面 > 管理 > Tags パネル にて作業。
• 使用中のタグのリネーム・結合・削除、ゆらぎ（類義語）の設定、カテゴリ→タグ変換（使用注意！）、過去にカスタムフィールドでタグ付けしていた場合の UTW へのインポート等を行える。
• Ultimate Tag Warrior 3: Help > Manage Tags 参照。

環境設定画面 - Configuration

管理画面 > オプション > Tags パネル - Configuration にて環境設定を行う。
cf. Ultimate Tag Warrior 3: Help > Configuation

ベーシックな使い方のときに設定するとよさそうな項目

URL settings

タグ・アーカイブページの URI は、デフォルトでは ～/index.php?tag=tagname となるが、～/tag/tagname とか ～/tag/tagname/ のような URI にできる。
この設定をしたら、オプション > パーマリンク設定画面で ［パーマリンク構造を更新］ ボタンをクリックして、.htaccess を更新すること。.htaccess を書き込み可能にしておいて、このボタンをクリックするだけで OK。

Primary Content Tags
Secondary Content Tags

記事本文の上部か下部に、その記事のタグを表示する。記事にタグ付けをしてここの設定をすれば、とりあえず記事にタグが表示される。¹⁰

設定項目

• Automatically include primary/secondary tag links — No（非表示）／本文の上に表示／下に表示 の3択。¹¹
• Base format for primary/secondary tag links — タグリストの[表示フォーマット][12]を選択。¹²¹³
• Prefix for primary/secondary tag links (optional) — タグリストの前に付けるテキスト。HTMLタグもOK。
• Suffix for primary/secondary tag links (optional) — タグリストの後ろにつけるテキスト。同上。

Primary と Secondary の2つあるので、一方はブログ内の記事リンク、もう一方はテクノラティ等へのリンク、などというように使い分けてもよいのかも。私は Primary のみ使用中。現在は、両方 No にしてテーマテンプレートをカスタマイズ。

Global Formatting Settings

Most popular color ～ Font size units — タグクラウド¹⁴ 表示時の最大・最小の文字サイズと色。

Icons to display in icon formats — アイコン付きタグリスト表示時に表示するアイコン

The text to display when there are no tags (can be left blank) — タグ付けされていない記事のタグリストに何と表示するか。ブランク可。

Editing Options

記事投稿／編集画面での動作オプション

設定項目

• Show existing tags on post editing page — 過去に付けたタグを選択候補として表示するときのフォーマット。非表示／ドロップダウンメニュー／リストの3択。
• Automatically add categories as tags — 記事のカテゴリ名を自動的にタグにも入れるか。便利だけど編集が効かない。自動的にタグ欄に入った文字を修正・削除等しても、記事を保存するときにカテゴリ名が再セットされてしまう。

拡張機能

Extended Live Archive との連携

• UTW を有効化した時点で、オプション > Ext. Live Archive パネルにも次のような項目が自動的に追加されている。
  • Displayed tags:
  • The X in the selected above description:
  • By Tag Tab Text:
• これらの設定すると、Extended Live Archive の表示に、By date, By category のタブに加えて By tag が追加される。
• By tag の表示フォーマットはタグクラウド。¹⁵ タグ名をクリックすると、そのタグを持つ記事のリストが同ページ内に表示される。（UTW純正のタグクラウドでは、タグ名をクリックしたときにタグアーカイブへ飛ぶのが普通。）
  表示例

タグの付け直し - ReTag Post-Extension for UTW

• 1ページに複数記事を表示しつつタグの付け直しができる模様。
• 配布元： ReTag Post-Extension for UTW
• 追記 解説記事： にるちる » [retag][plugin][UTW]ReTag Post-Extension for UTW - flying sparks解説。(一応更新)¹⁶
• 2006.9: 使ってみようとしたが、圧縮ファイルの解凍で足踏み中。（・；）

関連記事の表示について 追記

UTW タグを利用した関連記事の表示には、次の2つの方法がある。両者の違いは、関連度の算定方法・表示順序・表示件数。

• UTW 本体のテンプレートタグ UTW_ShowRelatedPostsForCurrentPost()
• プラグイン UTW mod Related Post

「ページ」対応状況 完了

• 済 ページ作成画面： タグ付けするための「Tags」欄がない。 → 「Tags」欄追加により解決。「4) カスタマイズ編」
• 済 各ページ表示時： 設定画面で各記事にタグリストを自動表示する設定にした場合、「ページ」にもタグリストが表示されるが、
  • 作成画面に「Tags」欄がなくてタグ付けしていないため、「No Tags」と表示されるだけ。
  • The inline tag-adder を用いてタグ付けすれば、付けたタグが表示される。
  • しかし、ページを編集して保存すると、付けたタグがクリアされてしまう。
  • → 「Tags」欄追加により解決。「4) カスタマイズ編」
• OK タグセット表示： 「ページ」にのみ付けられた（記事には付けられていない）タグも、タグセットに表示される。
• 済 タグ・アーカイブページ： ページにタグ付けしても、記事のみ。 → 「4) カスタマイズ編」
• 済 Extended Live Archive 表示：
  • 「ページ」にのみ付けられたタグは、by Tag のタグクラウドに表示されない。
  • by Tag のタグクラウドのタグ名をクリックしたときに表示されるのは、（ページにタグ付けしても）記事のみ。¹⁷
  • 「ページ」も対象になるようカスタマイズ済み。ELA導入記事をアップするときに追記。 2006.12
• OK タグ・サーチ ページ（Ajax の）： 「ページ」も対象。

個人的 Wish List / To-Do

• 済 タグ・アーカイブページの表示件数を増やしたい。 → 「4) カスタマイズ編」
  • CQS で is_home() を設定している場合、タグページの表示件数もこれと同じになってしまう。うちは 3件にしてるから。。。(^-^;
  • CQS で is_tag() を設定できない。
  • → 6.29: 出来たみたい。タグページ表示時の WP-PageNavi のページ数がおかしかったのも正常になった。→でも、タグand条件のときはダメだった。
• タグ・アーカイブページのテンプレート適用順序： tag.php → archive.php → index.php にできれば、archive.php に手を入れるだけで済んで楽。
• 済 前節の「ページ」対応
• The inline tag-adder でタグ選択： Tags欄のように既存タグから選択して追加できるようにする。
• タグ・サーチの抜粋表示： タグをクリックしたときの記事表示時に「抜粋表示オプション」が表示されるが、私はほとんど入力していないので、間抜けた表示になる。当該欄が空のときに本文の冒頭を使ってくれる the_excerpt() 的なものに切り替えたい。
• 関連記事のリストアップ性能アップ： 関連性の高いものを優先して表示させたい。または、タグ指定。今は、一つでもタグが一致すれば拾われちゃうっぽい。 → タグをちゃんと付けて件数指定すればいい感じ。現在記事下にテスト表示中。
• タグアーカイブのページ数表示修正： 複数タグand条件のときのタグアーカイブページのページ数表示が多い。wp-pagenavi, pagebar とも。
• 追加 is_tag() 拡張： パラメータ指定できるようにしたい。カテゴリの代用にするにはこれが欲しい。タグ別にレイアウト等を変えられるようにしたいので。

関連リンク

• Numb. » テクノラティのタグを簡単に？ — WP を始めた頃はブログ自体に触れて間もなく、テクノラティや UTW にあまり興味はありませんでした。でも、inocco さんのこの記事で「サイト内でキーワードとしてタグをつけて、関連記事を繋ぐ、ということもできるようです。」という一文を拝見し、ナヌ！？そうなの？キラリーン！— そうして、キーワードAかつBの記事をリストアップするという、切望していた機能に出会えたのでした。そう、本当の救世主は inocco さんなのですー。大感謝！
• MMRT daily life » UltimateTagWarrior 日本語版 — ver. 3.0.1 の日本語版を配布されています。このモンスタープラグインを日本語化なさったとは。。。すばらしいの一言。
• WP Plugin DB JAPAN » Ultimate Tag Warrior 3 — 日本語化・日本語解説サイトへのリンク。¹⁸

1. 私からのアクセスで負荷がかかると申し訳ないので、配布元ではなく自分のにしてあります。[back]
2. 本当は /tag/plugin+feed/rss2 という URI 表記にできるが、うちでは現在トラブル中のためコレで。[back]
3. 「タグ・アーカイブページ」とは別物。ヘルプの ‘Optional Add-on plugin to render an archive view, based on tags.’ をこう訳した。よく使われるタグ Top x 件と、それが付けられた最近の記事 y 件をリスト表示する関数（x と y を指定可）らしい。一旦無効化して、使いたくなったら有効化することとする。[back]
4. ページ作成画面には追加されない。[back]
5. ヘルプの目次から欠落[back]
6. と、勝手に命名。定義済みフォーマット表に ‘List of tags’ と出てくることから。[back]
7. 直訳なら「タグページ」。純正 Help には "on a tag page" と出てくる。私はアーカイブの一種としたほうが理解しやすかったので、カテゴリアーカイブと同じく「アーカイブ」を補って「タグ・アーカイブ」と呼ぶ。原文では、全タグを表示する tags.php や、アドオンの Tag Archive 1.0 で "archive" という言葉が出てくるので注意。うちの記事では、それらに注釈を付けて区別する。[back]
8. ブラウザのタイトルバー、タブ、ブックマーク時のタイトルなどに表示されるもの。[back]
9. 記事数で重み付けされて、その重みが文字サイズと色で表現される。[back]
10. 「ページ」作成画面にはタグ入力欄は設置されないが、ページ表示時には no Tags のように表示されてしまう。この設定はオフにして、テーマテンプレートの必要な箇所にだけタグ表示を挿入するか、プラグインをいじるか、ページにもタグ付けするか？[back]
11. 他の位置に表示したいときは、CSS で調節するか、ここは No にしておいて、テーマテンプレートに表示関数を挿入する。[back]
12. フォーマットによって、タグのリンク先がブログ内記事だったり、テクノラティなどの外部サイトの記事だったりする。[back]
13. ’superajax’ 等、[定義済みフォーマット表][12]に載っていないものがあるが、これについては Help > Adding UTW Tags to Themes > The deprecated one 参照。まだ練りきれていないらしく、存在しないことにしている模様。[back]
14. ヘルプの目次から欠落[back]
15. 記事数で重み付けされて、その重みが文字サイズと色で表現される。[back]
16. thanks. サイト名はページ名からコピペしましたが、ほんとはロゴの「oo8oo.net*NilCil」だったらごめんなさい。＞oo8ooさん[back]
17. ELA のページ対応が To-Do に入っているので、それ待ちにしておこうかな。[back]
18. ご紹介ありがとうございますー。（感涙） 書き途中の記事ですみませぬ。。。[back]

関連ページ

• WP plugin: UTWテンプレートタグを WP2.3 で使う - UTW Theme Compatibility Thing
• WP2.3: Ultimate Tag Warrior データのインポート
• WP plugin: UTWタグを利用した関連記事表示 - UTW mod Related Post
• WP plugin: 記事にタグ付け - Ultimate Tag Warrior 4) 本体のカスタマイズ
• WP plugin[up]: ページ番号ナビ - WP-PageNavi をアップグレード 2.02
• WP plugin: 記事にタグ付け - Ultimate Tag Warrior 3) UTWテンプレートタグ編
• WP plugin: 記事にタグ付け - Ultimate Tag Warrior 2) テーマ編集編
• WP[TB]: ぼののお勧めプラグイン10選
• WP: 使っているプラグイン 逆引き（機能別）リスト
• WP plugin: ページ毎に記事表示数・順序を変える - Custom Query String Plugin
• WP： 逆引き（したいこと別）リスト