MTAws Plugin: aws.pl - Movable Type Plugin for Amazon Web Services Copyright 2003 Daiji Hirata, All Rights Reserved. 1. aws.pl とは Movable Type で動く、Amazon Web Services のプラグインです。 Daiji Hirata 氏が AWS ECS 3.0 及び日本語対応した aws.pl を Hagy が改造して、 AWS 4.0 対応しました。 ECS 3.0 と ECS 4.0 では使用するパラメータが異なりますが、aws.pl の内部で変換 しています。 使い勝手や使用する MTAws タグに変更が無いよう互換性を重視して改造しています。 MT3.34 で動作確認をしています。MT4 では動かないかもしれません。 2. できること このプラグインでできるのは、Amazon Web Services を使った情報の取得です。 キーワードや、ASIN/ISBN コードでの検索が可能です。 例えば「Movable Typeで今すぐできるウェブログ入門」をlSBNコードで検索する場合 は、Index Template に下記のように入力します。 そうすると、本のサムネイル画像と書名が表示されます。 (この例のデベロッパー・トークンとアソシエイトIDはダミーです。) 2.1. 既存のスタイルの例
<$MTAwsProductName$> 2.2. 新しいスタイルの例
<$MTAwsProductName$> ECS 4.0 では、デベロッパー・トークンは使用できなくなりました。代わりに、 アクセスキーIDを使用します。 アクセスキーIDの取得については、下記URLや Amazon Web Services のサイトをご覧下 さい。 http://aws.amazon.com MTAws でアクセスキーIDを設定していれば、既存のスタイルのままでも Amazon Web Services を利用できます。 設定は、MovableTypeのプラグイン設定画面で行います。 プラグイン設定画面では、アクセスキーIDの他にAmazonアソシエイトIDも設定します。 AmazonアソシエイトIDの取得については、下記URLや Amazonアソシエイト・プログラム のサイトをご覧下さい。 http://www.amazon.co.jp/associates ECS 3.0 と ECS 4.0 の違いの詳細については、Amazon Web Services ホームページや Amazon が配布しているサービス移行ガイドをご覧下さい。 3. 下準備とインストール方法 このパッケージを使うためには、Amazon から、Amazon Web Services のアクセスクー IDを入手しなければなりません。Amazon のページ ( http://aws.amazon.com ) から 申し込んで、自分の ID を入手しましょう。また、紹介料が欲しいときは、Amazon アソ シエイト ( http://www.amazon.co.jp/associates/ ) にも登録して、アソシエイトIDも 入手してください。 インストールは、このパッケージに入っている aws.pl を Movable Type がインスト ールされているディレクトリにある plugins ディレクトリにコピーするだけです。 このプラグインは、LWP::UserAgent, XML::Simple の各モジュールを利用しています。 もしインストールされていない場合はインストールしてください。 インストール後に、Movable Type にログインして環境設定の設定、プラグインの画面 を開いて MTAWS の設定を表示し、AWS アクセスキーIDとアソシエイトIDを入力して保存 してください。 4. 使い方 プラグインをインストールすると、 ... というコンテナ・タグが使 えます。このコンテナ・タグの中では、<$MTAws...$> というタグがいくつか利用できる ようになり、検索結果を表示するために利用されます。 タグで利用できるアト リビュートには、次のようなものがあります。 - search (必須) Amazon へ検索するときの方法を指定します。現在、aws.pl で対応しているのは、 次の通りです。 「ActorSearch」「ArtistSearch」「AsinSearch」「AuthorSearch」 「DirectorSearch」「KeywordSearch」「ListManiaSearch」 「ManifacturerSearch」「PowerSearch」「SimilaritiesSearch」 「UpcSearch」「WishListSearch」 aws.pl で対応していても、Amazon Web Services で正しい結果を得られるかどう かは、Amazon 側にも依存します。 - query (必須) アトリビュート search で指定した検索方法に対応した検索ワードを指定します。 例えば、AsinSearch の場合であれば、query="4844318128" のようにします。 KeywordSearch の場合であれば、query="ウェブログ" のように指定にします。 - mode (場合によっては必須) KeywordSearch など検索方法によっては、どの商品を検索したいのか指定しなけ ればなりません。商品の指定方法は Amazon Web Services ECS 3.0 と ECS 4.0 の両方の形式が使用できます。 ECS 3.0 ECS 4.0 商品 -------------- ------------------ --------------------- all-jp Blended すべての商品 books-jp Books 和書 music-jp Music 音楽 track-jp MusicTracks 曲名から調べる classic-jp Classical クラシック音楽 video-jp Video DVD&VHS dvd-jp DVD DVD vhs-jp VHS VHS videogame-jp VideoGames ゲーム electronics-jp Electronics 家電 エレクトロニクス kitchen-jp Kitchen ホーム＆キッチン toys-jp Toys おもちゃ＆ホビー software-jp Software PC ソフトウェア watches-jp Watches 時計 baby-jp Baby ベビー＆マタニティ apparel-jp Apparel アパレル＆シューズ forignbooks-jp ForeignBooks 洋書 health-jp HealthPersonalCare ヘルス＆ビューティー hobbies-jp Hobbies goods-jp SportingGoods スポーツ＆アウトドア それぞれの検索方法によって、mode に指定できるものに制限があります。 詳しくは、Amazon Web Services の SDK を読んでみてください。 - type (未使用) ECS 3.0 では lite か heavy を指定していましたが、改造後は固定にしました。 aws.pl の中で ResponseGroup として Medium,Offers,Reviews,Tracks を指定し ています。 - page (指定しないときは 1 ) 検索結果が多くなったとき、Amazon からはページ単位で情報を入手することに なります。 何ページ目の情報が欲しいのか、を指定します。 - lastn, offset lastn には、検索結果(一ページの中に)が複数得られたとき、何件表示するか、 を指定します。offset は検索結果の何件目から表示するかを指定します。指定 しないときは、得られたすべての結果を表示します。 以下は、MTAws コンテナ・タグで利用可能なタグです。 ■ MTAwsurl Amazon の個別商品へのリンクです。アフィリエートIDを含んでいます。 ■ MTAwsImageUrlSmall, MTAwsImageUrlMedium, MTAwsImageUrlLarge 商品のイメージです。それぞれサイズが異なります。URL が設定されていても、 該当するイメージは表示されないこともあります。 ■ MTAwsProductName 商品の名前を表示します。 ■ MTAwsAuthors, MTAwsArtists 商品の著者(Authors)、アーチストを表示します。mode によって使い分けます。 ■ MTAwsAuctors 商品に出演している俳優を表示します。mode によって使い分けます。 改造で新規に追加したタグです。 ■ MTAwsAsin Amazon での商品コードである、ASIN コードを表示します。本の場合は、ISBN コード と ISBN は同一のコードとなります。 ■ MTAwsManufacturer 商品の製造者名を表示します。本の場合は出版社になります。 ■ MTAwsAvailability 商品の在庫状況を表示します。 ■ MTAwsListPrice, MTAwsOurPrice, MTAwsUsedPrice 商品の価格を表示します。ListPrice は定価、OurPrice は Amazon での販売価格、 UsedPrice は中古価格です。 ■ MTAwsCatalog 商品の種類を表示します。 ■ MTAwsMedia 商品のメディア (DVD, VHS など) を表示します。 ■ MTAwsIsbn 商品の ISBN コードを表示します。 ■ MTAwsEAN 商品の EAN コードを表示します。 改造で新規に追加したタグです。 ■ MTAwsReleaseDate 商品の発売日を表示します。 ■ MTAwsPublicationDate 商品の出版日を表示します。 改造で新規に追加したタグです。 ■ MTAwsSalesRank 商品のランキングを表示します。 ■ MTAwsUpc 商品の UPCコード (JANコード) を表示します。 ■ MTAwsTracks 商品が CD のとき、トラックごとの名前を表示します。 ■ MTAwsTotalResults 検索結果の総数を表示します。 ■ MTAwsTotalPages 検索結果のページ数を表示します。 ■ MTAwsAvgCustomerRating その商品に対するレビューのレイティングの平均点を表示します。 ■ MTAwsTotalCustomerReviews その商品に対するレビューの総数を表示します。 ■ MTAwsAddCart その商品を Amazon のカートに追加するためのボタンを表示します。アトリビュートに label を指定すると、ボタンの文字列を変更することができます。現在のところ、日本 語を設定すると文字化けします...。 また、デバッグ用に以下のようなタグを利用することもできます。検索結果が複数ある ときはその回数だけ表示されてしまうので、lastn などを併用されることをおすすめしま す。 ■ MTAwsRequestUrl Amazon Web Services に問合せするときに利用した URL を表示します。 ■ MTAwsXML Amazon からの検索結果(XML)をそのまま表示します。 5. サンプル 以下の例では、KeywordSearch を使って「ウェブログ」を検索し、結果を表示します。 サイドに組みこみやすいようにしてみましょう。
ウェブログの本

<$MTAwsProductName$> <$MTAwsAddCart label="Buy from Amazon"$>
6. ちょっとしたおことわり このプラグインは、現在のところ、日本語に特化した機能を持っています。 - 自動コード変換 (UTF-8, EUC-JP など) また aws.pl は UTF-8 で記述しています。 MT4 では動作確認をしておりません。 検索結果のキャッシュ機能は有していません。毎回 amazon へ問い合わせを行います。 BlendedSearch と <$MTAwsAddCart$>タグの動作確認は取っていません。 7. ライセンス aws.pl プラグインの著作権はひらたにあります。個人かつ非営利での利用(もちろん、 Amazon アソシエイトはOK!) に限り、プログラムの一部、もしくは全部を自由に利用、 改造していただいて構いません。利用して得られる利益/損失について、わたしは一切 関知せず、また責任をとりません。 Daiji Hirata, 2003-8-15 And Hagy, 2008-2-18, 2008-2-24