日記/2008-6-13

CardNavi プラグイン

　例えば、洋楽オルタナティヴ・ミュージック・ベスト100のリストの各ページを見ていくとき、まず洋楽オルタナ・ベスト/1を表示させると、次のページを見るためには、いったんCardList プラグインが記載されている洋楽オルタナティヴ・ミュージック・ベスト100のページに戻ってから、洋楽オルタナ・ベスト/2を表示させる、という手順を踏む必要がありました。
　これは面倒なので、CardForm プラグインの「basename/数字」という書式の名前の各ページ（この例の場合、洋楽オルタナ・ベスト/2のようなページに相当）に、数字が隣り合うページへのリンク（この場合、洋楽オルタナ・ベスト/1、洋楽オルタナ・ベスト/3に相当）、およびCardList プラグインを記載してあるページ（この場合、洋楽オルタナティヴ・ミュージック・ベスト100に相当）へのリンクを表示させるためのプラグインを作ってみました。

インストール

• FreeStyleWikiの本家のサイトのBugTrack-plugin/215の、CardForm プラグインをインストールする。
• 以下のファイルをダウンロードし、plugin/cardform以下にコピーする。
  • CardNavi.pm(446)
• plugin/cardform/Install.pmに以下の行を追加する。

$wiki->add_paragraph_plugin(
 "cardnavi","plugin::cardform::CardNavi","WIKI");

使い方

{{cardnavi 洋楽オルタナティヴ・ミュージック・ベスト100}}

　「洋楽オルタナティヴ・ミュージック・ベスト100」は、リストを表示しているCardList プラグインが記載されているページで、このページへのリンクが表示されます。省略すると、このページへのリンクは表示されません（前後のページへのリンクのみ表示）。
　上記の記載で、以下のような表示になります（下の例はリンクになってないが、本当はリンク）。
　
<-前のページ ^ 次のページ->
　
　真ん中の「^」が、引数として与えるページへのリンク（引数が省略されるとこのリンクが無くなる）、左右がそれぞれ前後のページへのリンクになります。
　前のページや次のページが無い場合には、リンクも表示されません。
　また、ページ名の「basename/数字」の数字が、連番でなく、とびとびになっていても、きちんと前後のページへのリンクになるはずです。
　ここでいう「前後のページ」とは、あくまで「basename/数字」の数字の前後です。cardlistでのソートの順の前後ではないことに注意してください。

参考

• BugTrack-plugin/215 CardForm:カード型データベースのためのプラグイン群
  • このプラグイン群に追加する形になります。ありがとうございます。
• BugTrack-plugin/308 日記用ナビゲーションプラグイン
  • diary_navi プラグインのCardForm版が、このプラグインです。
• FreeStyleWikiの本家のサイトに、こんなようなプラグインが投稿されていたような気がするのですが、見つけられませんでした……。
• さっそく、上記でも例として挙げた「洋楽オルタナティヴ・ミュージック・ベスト100」のリストの各ページに、本プラグインの記載を追記してみました。

追記

• FreeStyleWikiの本家のサイトのBugTrack-plugin/215に追加で投稿しました。