広島、晴れのち晴れ

Product Advertising API (旧 Amazon Web Service) を利用して音楽のレビューを投稿できるプラグインを作成してみました。

初期設定画面	レビュー一覧画面	ＣＤ情報取得	レビュー投稿画面
記事への差込

このプラグインはAmazon Web サービスからデータを取得する事を前提に作成しています。 必ずAmazonのAccessKeyIDを取得してください。
AccessKeyIDの取得方法について詳しい説明をされているサイト

アフィリエイトも同時に！という方はアソシエイトタグも取得しておいてください。（これは取得してもしなくても良いです）。
アソシエイトタグの取得方法について詳しい説明をされているサイト

下をクリックしてダウンロードします

tico-review-post.zip

1. ダウンロードしたファイルを解凍します。
2. WordPressのプラグインディレクトリにフォルダごとアップロードします。
3. 管理画面で有効化します。

1. 管理画面の左メニュー「Review Post」→「設定」をクリック
2. 上部にお使いのPHPのバージョンが表示されますので対応しているか確認した上で、次に進みます。
3. レビュー用テーブルを作成します。「ここをクリック」でテーブルを作成します。
4. 「AWS AccessKeyID」にAmazonのAccessKeyIDを入力します。
5. 「Amazon Secret Access Key」にSecret Access Keyを入力します。
6. 「Amazon AssociateTag」にアソシエイトタグを入力します（任意）。
7. 「更新」をクリックして保存します。

[2009-08-17 追記]
Amazon の AccessKeyIDやSecretAccessKeyの確認は以下のように。
「Product Advertising API」のサイトにログインします。
ログイン後、「Manage Your Account」をクリック→「アクセスキー情報」の「こちらのリンク」をクリックして確認します。

「出力テンプレートファイル」は出力するデザインファイルです。
詳しくはコチラを確認してください。

1. 「Review Post」→「登録」をクリックします。
2. 「新規作成」をクリックします。
3. 「タイトル」「アーティスト」を入力して「Amazonデータの読み込み」をクリックします。
4. 該当する作品の検索結果一覧が表示されますので、該当する作品の「選択」をクリックします。
5. 自動で一覧画面に戻りますので、もう一度リストから選んで「編集」をクリックします。
6. アーティスト名　カナを入力します。
7. レビュー内容に思う存分レビューを書いて「変更を保存」をクリックして更新します。

1. リストから「編集」をクリックします。
2. Amazonのデータを読み込み直す事が出来ます。
3. レビュー内容を変更できます。
4. 変更後は「変更を保存」をクリックして更新します。

基本的に作品名、アーティスト名、曲目リスト等は変更できません！
どうしても変更したい場合は「Amazonから取得したデータ」をクリックして、表示された内容を変更して保存してください。

1. リストの「埋め込みタグ」をコピーします（[review-post id="○"]）。
2. 記事の差込みたい場所に貼り付けます。

このプラグインを使用する際、新たに「wp_tico_review_post」というテーブルを作成します。
完全に削除したい場合は先にReview Post設定画面の一番下「レビュー用テーブルの削除」というボタンをクリックしてレビュー用テーブルを削除してください。
※残しておいても別に構わないと思いますが気になる人は削除してください。その場合、全てのレビュー内容が削除されます。

Amazonからの検索結果を10件しか取得しない

正直、調べるのが面倒だったので複数ページの処理をしていません…。とりあえずピンポイントで検索しているので自分が困っていないというのが大きな理由です。

２枚組アルバムの場合の曲目リストの処理をしていない

現段階で私が２枚組アルバムのレビューをする予定が無いので何もしていません。必要に迫られたらやろうかと思っています。

レビュー数が増えてもそのまま一覧がズラーっと並んでしまう

リスト一覧は何も処理をせずにそのまま並べているだけなので、レビュー数が増えたら凄い事になるかも…。ただこれに関しても現時点で私が困っていないので何もしていません。
対応しました。２５件ずつ表示するようにしています。

差込内容のデザインが画一化されている

仕方ないといえば仕方ないのですが…
自分でHTMLを書ける人であれば「include/review-post-ui.php」の271行目以降を変更すれば出来たりします。
対応しました。詳しくはコチラを確認してください。

どうしてもこれはやっておいた方が良いかなと思い、（自分の為にも）デザインのテンプレートファイルを読み込むようにしました。

まずテンプレートファイルの作成については「/tico-review-post/include」のoutput.phpファイルを参考にしてください。
ファイル名は「output.php」ですが、書いてあるのはhtmlファイルです。
このファイルを参考にご自身のホームページに合ったデザインに変更、作成してもらえれば良いかと思います。 ちなみにオリジナルのデザインファイル名はoutput.phpから変更しておいた方が良いです。

作る際にデータに変換される独自タグを以下に列挙しておきますので参考にしてください。

タグ名	変換されるデータ
{:author:}	アーティスト名
{:title:}	作品名
{:release:}	リリース日
{:price:}	価格
{:label:}	所属レーベル
{:asin:}	ASIN
{:url:}	AmazonへのリンクURL
{:review:}	レビュー内容
{:img-s-url:}	画像(小)のURL
{:img-s-width:}	画像(小)の幅
{:img-s-height:}	画像(小)の高さ
{:img-m-url:}	画像(中)のURL
{:img-m-width:}	画像(中)の幅
{:img-m-height:}	画像(中)の高さ
{:img-l-url:}	画像(大)のURL
{:img-l-width:}	画像(大)の幅
{:img-l-height:}	画像(大)の高さ
{:[number-list]:} ～ {:[/number-list]:}	二つのタグの間に曲目タグを入れます（後述参考）
{:trackno:}	曲目No. ※これは曲目リストです。後述を参考にしてください。
{:track:}	曲名※これは曲目リストです。後述を参考にしてください。

曲目リストは以下のタグの間に記述します。
以下のタグの間でないと変換しません。

{:[number-list]:}

ここに記述({:trackno:}、{:track:}タグ)

{:[/number-list]:}

作成したテンプレートファイルは「/tico-review-post/include」の中にアップロードします。

デザインテンプレートの選択についてですが、WordPress管理画面の左メニュー「Review Post」→「設定」をクリックします。
「出力テンプレートファイル」項目のファイル名で該当するファイルを選択して「更新」します。

これで作成、変更したテンプレートファイルが反映されます。

もし「よく分からない」という方はそのままデフォルトのテンプレートファイルを使用するのが無難です。

「AmazonWebServiceを利用して音楽のプレビューを投稿するプラグインです」とつぶやいてる私の為に、クリックしてー！

amazon web service, Product Advertising API, wordpress, プラグイン, レビュー投稿