アメンボ for BlognPlus

アメンボ for BlognPlus」は「Amazon Advertising API」対応の Amazon 広告スクリプト「アメンボ」を BlognPlus 用に移植したモジュールです。

このモジュールを導入すると、ブログの記事内で簡単にアマゾンの商品の紹介ができるようになります。

表示例

ASIN を指定する事で、この例のように画像付きで商品を紹介できます。
値段・割引率・在庫状況などは自動的に更新されるので、一度記事を書けば常に最新情報が表示されます。

このリンクを介して Amazon.co.jp で商品が購入されると紹介料を得る事ができます。

動作例

モジュールを導入する前に、どんな風に動作しているかご覧になりたい場合は、以下のサイトを参考にして下さい。

動作環境

このモジュールの動作には「マルチバイト関数(mbstring)」が有効である必要があります。
PHP のバージョンは PHP5 推奨ですが、PHP4 でも動作します。

また「Amazon Product Advertising API」と「アマゾンアソシエイト」でアカウントを作成しておく必要があります。

ダウンロード

利用規約

当規約に同意された方のみ、この Amazon 広告スクリプト「アメンボ」(以下「当スクリプト」)を無料で使う事が出来ます。
「アメンボ」の利用規約は事前の報告がなく変更される場合があります。ご了承ください。

  1. 当スクリプトの所有権は 「nJOY」管理人 CJ にあります。
  2. 当スクリプトでは外部ライブラリを利用しています。それらのライセンスは各ライブラリのライセンスに準拠します。
  3. 当スクリプトを使用して損害が生じても、「nJOY」管理人 CJ は一切の責任を負いかねます。
  4. 利用者個人の責任において改造は自由に行えます。ただし後述の「クレジットの表記」に関わる部分についての改造は認めません。
  5. 以下の事項に該当する場合、当スクリプトはご利用いただけません。

禁止事項

クレジットの表記

当スクリプトを利用する場合、小さな「アメンボ」アイコン(16x16px)が表示されます。
アイコンを非表示にする事はやめてください。

アメンボ for BlognPlus」(amnbp.zip, 38kb)


インストール方法(主な手順)

  1. ダウンロードした圧縮ファイル(amnbo.zip)を解凍する。
  2. 「amnbo」フォルダを BlognPlus ディレクトリ下の /module/ にアップロードする。
  3. 「config.php」のパーミッションを変更する(「666」等)。
  4. /tool/ ディレクトリのパーミッションを変更する(「777」等)。
  5. モジュール管理画面で「インストール」ボタンを押す。
  6. モジュールの設定を変更する。
  7. 「PC」と「携帯」動作スイッチを「ON」にする。
  8. 「index.php」の改造をする。

モジュール構成ファイル

config.php」のファイルのパーミッションは「666」「606」等にする必要があります。
/tool/ ディレクトリのパーミッションは「777」や「707」等にする必要があります。

インストール方法

インストール

「amnbo」フォルダを /module/ ディレクトリ下にアップロード後、未登録一覧に入っている「アメンボ for BlognPlus」の [インストール] ボタンを押してください。

動作設定

PC
「PC」欄を「ON」にしてください。
携帯
「携帯」欄 を「ON」にしてください。

「index.php」の改造

「index.php」384行目あたり(ver2.6.8の場合)

  1. $blogn_skin = str_replace ("{TOKEN}", $blogn_token, $blogn_skin);
  2. if ($blogn_mod_amnbo_flag) include(BLOGN_MODDIR."/amnbo/amazon.php");
  3. //-------------------------------------------------------------------- HTML出力処理

設定画面

アメンボ for BlognPlus 設定画面

Amazon Product Advertising API 設定

公開鍵 (Access Key ID)
20桁の半角英数字からなる文字列です。
秘密鍵 (Secret Access Key)
40桁の半角英数字からなる文字列です。
アソシエイトID
アマゾンアソシエイトの紹介料を得る為に必要です。

公開鍵と秘密鍵は「Amazon Product Advertising API」のアカウントを作成して入手してください。

商品リンク設定

リンク方法
「新規ウィンドウで開く(target="_blank")」と「同じウィンドウに表示(target="_top")」のどちらかを選べます。
キャッシュ更新間隔
更新間隔を長く設定する事でサーバーへの負荷を下げる事ができます。
API の規約上、更新間隔が1時間の場合のみに商品の価格が表示できます。
割引率(画像)
画像の右下か左下に割引率を挿入できます。
割引率(テキスト)
価格の横に割引率を表示できます。
商品画像のサイズ
「大(160x160px)」、「中(120x120px)」、「小(90x90px)」から選べます。
横幅
ブログ記事のカラム幅に合わせて、インラインフレームの横幅を調整できます。
選択した画像サイズによって最少横幅が決まっています。

商品の紹介

ブログの記事内でアマゾンの商品を紹介するのはとても簡単です。
例えば「Amazon.co.jp ロゴ版 アラーム クロック 目覚まし時計 ブラック」という商品を紹介したいとします。

その商品のページに飛び、「登録情報」という項目下から ASIN (書籍の場合は ISBN-10)を探します。(下図、赤枠内)

商品の ASIN

ASIN を見つけたら(この商品の場合 B0061GL17I )をクリップボードにコピー(Ctrl + C)します。

次にブログの記事投稿画面に行き、[:ASIN:**********:] のように記述してください(********** は ASIN/ISBN-10)。

BlognPlus への投稿

投稿ボタンを押すと、[:ASIN:**********:] と記述した部分に商品の情報が表示されます。

ブックマークレット

以下のブックマークレットを「お気に入り/ブックマーク」に登録し、Amazon.co.jp の商品ページでブックマークレットを選択すると簡単に「ASIN」「ISBN-10」を取得できます。

ASIN Bookmarklet

  1. javascript:var%20p=prompt('ASIN','[:ASIN:'+document.getElementById('ASIN').value+':]');

仕様

記事内に [:ASIN:**********:] と書くとブログ上では商品紹介広告に変換されますが、RSS では変換されません。

RSS で [:ASIN:**********:] が表示されないようにするには以下の3通りの方法があります。

  1. 記事の「本文」部分には [:ASIN:**********:] と記述せず、「追記」部分のみに記述する(RSS は本文だけ配信されるため)。
  2. RSS/Atom 生成モジュール」を導入し、RSS2.0 か Atom1.0 で RSS を配信する(ver2.01 で対応予定)。
  3. 「index.php」を改造する。

「index.php」の改造方法

赤文字部分を追加する事で、RSS 内の [:ASIN:**********:] を除去します。

  1. $rssdata .= '</rdf:RDF>';
  2. $rssdata = preg_replace("/<br>/i", "<br />", $rssdata);
  3. $rssdata = preg_replace("/\[:ASIN:[A-Z0-9]{10}:\]/", "", $rssdata);
  4. echo $rssdata;

広告のプレビュー

初期状態では記事作成時のプレビュー画面には [:ASIN:**********:] という記述がそのまま表示されますが、「admin.php」を改造する事でプレビュー画面内にも広告を表示し、記事投稿前に広告を確認する事ができるようになります。

「admin.php」の改造方法

赤文字部分を追加する事で、記事作成時にプレビューができます。
以下 BlognPlus v2.6.8 の場合

  1. if (!$action) $action = "new";
  2. $preview_mes = blogn_permit_html_tag_restore($mes);
  3. $preview_more = blogn_permit_html_tag_restore($more);
  4. if (file_exists(BLOGN_MODDIR.'amnbo/a_function.php')) {
  5. $preview_mes = blogn_mod_amnbo_preview($preview_mes);
  6. $preview_more = blogn_mod_amnbo_preview($preview_more);
  7. }
  8. if ($action == "post" || $action == "edit" || $action == "update" || $action == "preview") {

アップグレードの仕方

ver1.00 〜 1.01→ ver1.02

「config.php」以外のファイルを全て上書きアップロードしてください。
/css/, /img/, /tool/ ディレクトリは上書きアップロードする必要はありません。

アンインストール方法

  1. モジュール管理画面から「モジュールアンインストール」ボタンを押す。
  2. (オプション)「index.php」への記述を削除する。
  3. (オプション)「admin.php」への記述を削除する。
  4. /amnbo/ ディレクトリを削除する。

注意事項

モジュールをアンインストールすると、それまでに記述した [:ASIN:**********:] は記事内で変換されずそのまま表示されます。

バージョンアップ情報

2015/07/11
ver1.02 Notice エラーが出る不具合修正
2012/04/29
ver1.01 記事作成時の広告プレビュー対応
2012/01/02
ver1.00 公開

サイト作成のヒント集に戻る