PluginAmazon14
出典: GeeklogJpWiki
［３］管理方法 > 管理者が導入後すぐ試せる簡単カスタマイズ > プラグインをインストールする > アマゾン
以下の文書は，アマゾンプラグインに添付されているreadme.htmlの一部をmystral-kkが和訳したものです。
Geeklogアマゾンプラグイン
| 作者 | アンディ・マロニー（Andy Maloney） -- Eメールを送る |
| バージョン | 1.4.0 |
| Geeklogバージョン | 1.4.0 |
| リリース日 | 2006年 4月 1日 |
目次 |
アマゾンプラグインとは
このプラグインは，任意のアマゾンのサーバを検索し，製品へのリンクを張った結果ページを出力するアマゾン検索ブロックを提供します。
アマゾンのサーバ毎にあなたのアソシエイトIDと，あなたのサイトで使用するデフォルトのサーバを設定できます。
このプラグインはアマゾンのサーバがアクセスするためのXSLTファイルを提供します。アマゾンのサーバはこのファイルを使って検索の結果を返すXMLファイルを処理し，HTMLを返します。こうすることであなたが使用しているサーバがXMLファイルを処理しなくてもよくなります。
開発に使用したツール
- Geeklog 1.4.0
- CURLをサポートするPHP 5.0.4 [PHP 4.1.0以上でも動作するはず]
- MySQL 4.1.16
- Firefox 1.5.0.1
- MacOS X 10.4.5
制限
アマゾンプラグインには現在のところ，次のような制限があります。
- ソートする順序を選択できない
- （あなたがXSLTを知っているのでなければ）結果に表示されるデータを選択できない
フィードバックがあって，皆さんがこのプラグインを使ってくださっているようなら，私は改良を続けます。
プラグインのインストール
パスについて：
- ./ で始まるパスは，このプラグインのconfig.phpがあるところ
- <public_html>はlib-common.phpがあるところ
- <geeklog_dir>はGeeklogのconfig.phpがあるところ
- アマゾンプラグインはテーブルの追加・変更を行うので，データベースのバックアップを取ってください。管理者メニューの「データベースのバックアップ」から行えます。
- アマゾンプラグインのアーカイブを<geeklog_dir>/pluginsディレクトリに展開します。amzという名前のディレクトリが作成されます。
- <public_html>ディレクトリの下に，amzという名前のディレクトリを作成します。
- <public_html>/admin/plugins/ディレクトリの下にamzという名前のディレクトリを作成します。
- <geeklog_dir>/plugins/amz/ディレクトリに移動します。
- adminディレクトリ内のファイルを 3.で作成したadmin/plugins/amz/にコピーします。
- public_htmlディレクトリ内のファイルとディレクトリを 4.で作成したpublic_html/amz/にコピーします。
- プラグインの管理ページを開きます。アマゾンプラグインがインストール用のリンクと共に表示されているので，クリックします。インストールに成功したかどうかが表示されます。失敗した場合は，<geeklog_dir>/logsディレクトリ内のエラーログ（error.log）を確認し，問題点を修正してからインストールし直してください。
アマゾンプラグインはこれでインストールされたはずです。管理ページから設定してください。プラグインの設定管理者メニューからアマゾンプラグインの管理ページを開きます。次の項目を設定できます。
アソシエイトID
この項目では，お手持ちのアソシエイトIDを入力してください。ユーザに表示する際の既定のサーバを選択することもできます。たとえば，フランスに住んでいる人なら，amazon.frサーバを選択すればよいでしょう。アソシエイトIDを入力していない場合は，私（Andy）のIDが使用されます。
開発協力
ああ，ここにトラップがありました。検索をN回するごとに私のアソシエイトIDを使用するリンクを生成するよう設定しています。開発を支援したくない場合は，ハックする必要はありません。0回に設定すれば，私のIDを使用しなくなります。
検索
既定のカテゴリは，ユーザがこのブロックから検索を行う場合に使用されます。結果が表示されると，検索ページからこのカテゴリを変えることができます。「全て」を選択すると，全ての製品が検索の対象になります。「全て（Blended）」はアマゾン特有の用語です。
既定の検索語は，ユーザが検索語を入力しないで検索したときに使用されます。現時点では私の兄の本の題名になっています（日本語化したものは'Geeklog'になっています）。たぶん，この設定も変更したいでしょう。
アマゾンのサーバに送って処理してほしいXSLTファイルを指定することもできます。このファイルはWebに公開され，アクセス可能でなければなりません。アマゾンのサーバがフォーマットを取得するためにこのファイルを読み出すからです。この意味がわからないなら，この項目には手を着けない方がよいでしょう。検索結果に基づいて生成されるページをカスタマイズしたいなら，XSLTファイルを編集することもできます。私はXSLTの専門家ではないので，もしよりよいご提案があるなら，私に連絡してください。
検索結果に含まれる画像のサイズや画像なしに設定することもできます。これを「大」に設定する場合には，注意してください。
このプラグインはまた，前回の検索で使用したサーバと検索語をユーザのPCに保存するようクッキーを設定することもできます。ユーザが次回，あなたのサーバを閲覧したときにデータは更新されます。クッキーを使用しないなら，チェックを外してください。
プラグインの更新
更新によりデータベースのテーブルが追加・更新される可能性があるので，データベースのバックアップを取ってください。管理者メニューの「データベースのバックアップ」から行えます。
- プラグインエディタからアマゾンプラグインを無効にします。
- 新規インストール時と同様にアマゾンプラグインのアーカイブを展開し，ファイル・ディレクトリをコピーします。
- プラグインエディタからアマゾンプラグインを有効にします。
- プラグインエディタに戻り，アマゾンプラグインの「更新」をクリックします。
- 管理者メニューへ行き，新たな設定を行います。これでおしまいです。
プラグインのアンインストール
- rootユーザとしてGeeklogにログインし，プラグインエディタを開きます。アマゾンプラグインをクリックして，「削除」をクリックします。確認後に削除してください。
- インストール時に作成した3つのディレクトリを削除します。
- <geeklog-dir>plugins/amz/
- <public_html>/amz/
- <public_html>/admin/plugins/amz/
- これでおしまいです。
みなさんにできること
- 私が書いたPHPとXSLTを見て，改善点があれば教えてください。Eメールを送る
- 使用しているか，提案があるか教えてください。Eメールを送る
- 私のサイト向けにリンクを張ってください。http://imol.gotdns.com
- 開発を支援するために寄付をお願いします。
あるいは，次のリンクを使ってアマゾンで買い物をしてください。
あるいは，私のサイトへ行き，面白そうなGoogleの広告を1，2つクリックしてください。[最も簡単な方法です。1分しかかりません！]
ライセンスアマゾンプラグインはGPLライセンスで公開されていますが，私はよくわかってはいません。 難解な法律用語なんていらないですよね。
