NP_Related Ver0.3jp - Nucleusだとか

さらにアップデート。 いつまでもあのバージョンナンバーを引きずってると逆にわかりづらいと思い、メジャーバージョンを上げることにしました（中身もだいぶ変わったし）。

アイテムのタイトル（または投稿オプションの入力フィールド）を元に、関連情報をローカル内やGoogleなどから拾ってくるプラグインです。 前バージョンでの、半角カッコで無限ループになるバグ等を修正。Amazon検索（和書のみ）、FancyURLにも対応しました。

Download: NP_Related Ver0.3jp
[Nucleus2.0以降対応 文字コード:UTF-8]
※EUC-JPで使う場合はソースコードをエディタで開いて文字コードの変換をしてください。

このプラグインについて

オリジナルは本家のプラグインwikiを参照。Radek Hulanバージョンを元に改造を続けている日本語版です。

この日本語版のテーマは、アイテムタイトルで「楽ちん自動検索」です。複数キーワード検索とフレーズ検索に対応するよう改良しています。 細かく言うと、次のような規則があります。

• スペース（半角全角とも）や括弧、句点を区切りとして、キーワードを複数認識してOR検索。キーワード数は３つまで有効
• "Ver1.2"、"-1-" 等の表現、数字のみのキーワードをローカル検索時に無視
• 引用符や括弧で囲まれた文字列をフレーズ指定とみなす

バージョンアップ作業について

（はじめてこのプラグインをインストールする人には関係ありません）
プラグインオプションの数が増えてますので、一度前のバージョンをアンインストールしてからこのバージョンをインストールしてください。Google検索のキャッシュを一度クリアしておきたいときはアンインストール時にデータ消去（プラグインオプションの "Erase data on uninstall"）するようにしてください。

プラグインオプションについて

Google検索を使いたい場合は、"Google API key" を取得してセットします。Amazon検索は "API key"（デベロッパートークン）の取得が必要です。 "Associates ID" があるとさらにいいでしょう。
下から2番目の" Domain name" を自分のドメイン名に合わせるのを忘れずに。
あとは表示用のテンプレートフィールドなどの各種設定なので説明は省略。

カンタン記述例

大抵はこのへんで事足ります。テンプレート（アイテムブロック）かスキン（アイテムページ）に、次のように記述してください。

<%Related(local)%>
<%Related(google)%>
<%Related(amazon)%>
<%Related(local,5)%>
<%Related(google,5,true)%>

テンプレート／スキン用パラメータの解説

パラメータは順番に、 1. モード（local/google/amazon） 2. 表示件数 3. スニペット表示（true/false） 4. スキン用キーワード指定（スキン変数のみ指定可能） 5. ローカル検索条件（and/or） です。

1は指定必須、ほかはオプションです。 数字でパラメータの位置を示すとこうなります。テンプレートはキーワード指定が無いのに注意してください。

<%Related(1,2,3,5)%>   ... テンプレート
<%Related(1,2,3,4,5)%> ... スキン

詳しく指定する場合の例。

テンプレート変数（アイテム内）
<%Related(local,10,false,and)%>

スキン変数（アイテムページ・検索ページ内）
<%Related(local,10,false,,or)%>

スキン変数（その他のページ）
<%Related(local,5,false,キーワード,and)%>
<%Related(google,5,true,キーワード)%>

スキン変数で検索ページに置く場合、検索クエリをキーワードとして流用します。デフォルトではOR検索なので（Nucleus標準の検索フォームによるAND検索よりも）緩やかな条件でアイテムをピックアップします。

その他のページに置く場合は、スキン用キーワードを指定する必要があります。これは特定のキーワードで記事をピックアップしたいときに使います（お勧め記事など）。

フレーズ検索について

ローカル検索時、引用符で囲った文字列でフレーズ指定ができるようになりました。フレーズ内の文字列は「そのまま」キーワードとして使われます。スペースでキーワード分割されたり自動変換で文字が削除されることはありません（※）。

半角のシングルクォート、ダブルクォート、かっこ
'...' "..." (...) [...]
全角の引用符とかっこ、かぎかっこ数種類
’...’ ”...” （...） 「...」 『...』 【...】

に対応しています。 日本語だとかぎかっこが自然にフレーズ指定として書けて使い勝手よさそう。

グーグルのフレーズ検索にも同時に対応したい場合は、半角のダブルクォートでフレーズ指定すると良いです。ただこちらで試した限りでは「らくちん自動検索」を通じてだとフレーズ制約が厳しくて結果が出にくいので、キーワードを手動設定したいときに半角ダブルクォートを使うほうがいいかも。

手動でキーワード指定

手動でアイテムに対してキーワード指定も出来ます。アイテム編集時のオプション画面にフォームが出るのでそこにキーワードを打ち込んでください。 このフォームにDONOTSEARCHキーワード（半角大文字）を入れると検索を明示的にキャンセルすることができます。

その他の変更履歴

報告を寄せてくださった方々に感謝！ -キーワードに半角カッコがあるとループに陥るバグを修正 -デバッグコードが残っていたのを削除

その他

FancyURLへの対応は桜枝さんの改造を参考にさせていただきました。感謝。 EUC-JPの環境でGoogle検索のmoreリンクがうまく機能しないというバグが残っています　→桜恋唄さんのトラックバックをチェック！