PukiWiki/1.4/自作プラグイン

アマゾン商品の表紙写真などを出力するプラグイン 2.2 by 閑舎

2004-05-20 (木) 00:00:00

概要
 アマゾン が提供する商品の表紙写真と、商品名を表示する。 書籍のみならず、音楽 CD、ビデオ、エレクトロニクス商品等も扱っている。 アマゾンのアソシエイトID(紹介文を書くことで副収入がもらえるかもしれない仕組み)に対応している。
環境
PukiWiki1.4 以降。
引数(通常のプラグイン)
引数説明省略時
1ASIN番号clearとレビュー作成の場合以外省略不可
2left,center,right,clearインラインプラグイン以外right
3image,content,nocontent,subscript,delimage,
deltitle,delete,タイトルなど
タイトル自動取得
4アマゾン以外の写影のURI必要ならプラグインによる写影
注意
  • clear は画像の回り込みを終了させる。
  • 第 3 引数を image にするとタイトルを表示しない。
  • 第 3 引数の content は写影・著者・価格等・紹介文、nocontent は写影・著者・価格等、subscript は著者・価格等、を表示する。いずれも contentc のように c を伴うと買物かごを表示する
  • 第 3 引数を delimage にすると対応するキャッシュ画像を削除、deltitle、delete だと、キャッシュタイトル、両方をそれぞれ削除する。
  • 全ての引数を省略すると、ブックレビュー作成フォームが現れる。「書評」というページにこれを置くと「書評/ASIN番号」という子ページを作るよう動作する。
  • レビューページの一覧は、ls2, tracker などのプラグインを使用のこと。
  • キャッシュ機能により、タイトル自動取得の表示遅延を軽減する(./cache に ASINxxx 形式で作られ、半恒久的なので注意)。
  • ASIN は書籍の場合 ISBN と全く同じである。それ以外では、アマゾンで調べ、ジャケット写真を右クリックし、プロパティを見てみ判断する。例えば、下のような場合だと、この最後の 01 を含め、B000002G6J.01 とすること。B000002G6J とすると、ディフォルトの 09 が適用されてしまい、画像はない(0.9 以降の改良では、画像だけでなくタイトルも呼ぶのであれば 10 桁で Ok)。
    http://images-jp.amazon.com/images/P/B000002G6J.01.MZZZZZZZ.jpg
サンプル
#amazon(B00005Y6Q2,right,image)
#amazon(B00005Y6Q2,right,subscript)
#amazon(,clear)
|BGCOLOR(white):#amazon(B00005Y6Q2,left,image)||
|foo|BGCOLOR(pink):COLOR(black){bar}|
 上から順番に、写影のみ右寄せで表示、 著者、出版社、価格、在庫状況を表示、 写影の場合の文章の回り込みを終了させる、 最後は表形式の出力例、となる(詳しくはamazonプラグイン一覧をご覧ください)。
引数(インラインプラグイン)
引数説明省略時
1ASIN番号または英数字からなるID省略不可
2title,author,manufact,media,pricel,price,
avail,content,image,link,lib,lib0
タイトル自動取得
注意
  • title(タイトル)、author(作者)、manufact(製造元)、media(メディアの種類)、pricel(定価)、price(アマゾンの売価)、avail(在庫・発送状況)、content(紹介文)、image(写影)、を表示する。
  • link は事前にキャッシュディレクトリに AZsearchbox.link などというファイルを作り、そこに、 アマゾンアソシエイトの「リンク作成」で作ったHTMLのコピーを貼り付ける(必要なら、イメージファイルも適切な位置に置く)。そうして &amazon(searchbox,link); として呼び出せば使える。
  • lib はアマゾンアソシエイトの「ライブラリ」で作ったHTMLのコピーを見て、path=tg/browse/-/489986 となっている部分の番号を第一引数にする。また price_all_120x90.gif などとなっているイメージファイルを AZ489986.gif としてキャッシュディレクトリに保存する。そうして &amazon(489986,lib); とすれば使える。
  • lib0 は lib で番号がない場合に使用する。イメージを AZ01.gif として保存したら、&amazon(01,lib0); で呼び出す(とにかく人為的にキャッシュディレクトリに置くものは AZ で始める)。
インストール
  1. amazon22.tgz をダウンロードし、どこかに解凍する(tar xzvf amazon22.tgz 等)。
  2. amazon.inc.php を plugin ディレクトリに置く。
  3. noimage.gif を必ず image ディレクトリに置く。 買物かごを使う場合、remote-buy-jp.gif も image ディレクトリに置く。
  4. amazon.inc.php の文字コードは各自の PukiWiki の文字コードと一致するよう変更のこと。
  5. amazon.inc.php の最初のあたりの定数をコメントを参考にして書き換えること。
  6. レビューの定型文も場合によって書き換える。
  7. amazon.inc.txt に書かれた CSS の部分を skin/default.ja.css の最後に加える(場合によっては直す)。
  8. この段階で動作するので、サンプルに書かれた使用例を参考に試してみる。
  9. アマゾンのアソシエイト ID を取ってセット。
  10. 著作権に関わるプラグインなので、詳しくはアマゾンのアソシエイトプログラムを確認の上、使用のこと。 例えば次のようなサイトには amazon プラグインを使用することはできない。
    1. 露骨な性描写、暴力、違法行為を奨励している。
    2. 人種、性別、宗教、国籍、身体障害、性的嗜好、又は年齢による差別を奨励している。
    3. 知的財産権を侵害している。
履歴
  • 2.2
  1. 微妙な写影の配置などを除き、1.1 の上位互換。
  2. 2.2 1.4rc4 などで http_request() がうまく作用しない場合の対策。
  3. ちょっとしたバグフィックス、最適化。
  4. 買物かごの実装。
  5. 可能なかぎりアマゾンの規約・指示に従う(以前はアソシエイトIDをセットせず画像を使用していたりするケースがあったが抵触する可能性があるので現在の状態に変更)。
  6. 写影等の配置は CSS による微調整可能。
  7. A...link, A...gif をセキュリティ等を考慮し、AZ...link, AZ...gif に変更する。
  8. そろそろファイルロックを用いないと問題が起こるかもしれないので組み込む。
  9. 取扱説明書が長く、プラグインに影響を与えるので、別文書にする。
  • 2.1
  1. proxy の扱いを修正する(Thanks to upk)。
  • 2.0
  1. class を使って全面改訂。
  2. コマンド引数の大幅拡張。
  3. PukiWiki 1.4.x の編集制限に対応(Thanks to Ynak)。
  • 1.1
  1. 編集制限をかけている場合、部外者がレビューを作ろうとして、ページはできないが ASIN4774110655.tit などのキャッシュができるのを解決。
  2. 画像の最後が 01 の場合、image を削除すると noimage.jpg となってしまうバグを修正。
  3. 1.0 で導入した XML アクセスは高速だが、返す画像情報がウソなので、09 がだめなら 01 をトライする、で暫定的に解決。
  • 1.0
  1. 画像のキャッシュを削除する期限を設ける。
  2. タイトル、写影を Web Services の XML アクセスの方法によって get することで時間を短縮する。
  • 0.9
  1. RedHat9+php4.3.2+apache2.0.46 で画像が途中までしか読み込まれない問題に対処(Thanks to t)。
  2. 日本語ページの下にブックレビューを作ろうとすると文字化けして作れない問題の解決(Thanks to WikiRoom)。
  3. 指定 ASIN のキャッシュ削除機能。
  • 0.8
  1. amazon 全商品の画像を表示。
  2. アソシエイト ID に対応。
  • 0.7
  1. ブックレビュー生成のデバッグ、認証問題の一応のクリア。
  • 0.6
  1. URL が存在しない場合、No image を表示、画像配置など修正。
  2. インラインプラグインの呼び出し方を修正。
  3. 画像、タイトルのキャッシュによる速度の大幅アップ。
ダウンロード

コメント

1.4.4におけるamazonプラグインの質問

と両方試してみました。画像はOKとなりました。でも文字化けが解決しません。amazonにリンクもされてはいますが・・・・。 -- tyura3san 2005-02-07 (月) 04:04:47

1.4.7におけるamazonプラグインの質問



添付ファイル: fileamazon22.tgz 2939件 [詳細]

トップ   編集 凍結 差分 履歴 添付 複製 名前変更 リロード   新規 一覧 検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2014-05-22 (木) 11:23:34
Site admin: PukiWiki Development Team

PukiWiki 1.5.4+ © 2001-2022 PukiWiki Development Team. Powered by PHP 8.2.12. HTML convert time: 0.429 sec.

SourceForge