10月 15 2007

WordPress: Amazon ISBN Anchor Plugin

Published by HoLY

Amazon ISBN Anchor Plugin は WordPress で アマゾンアソシエイトのリンクを手軽に作成するためのプラグインです。

以下のような特徴があります。

  • すべての設定はWordPressの設定画面から行うことができるため、すばやく設定することができます。
  • aタグのhref属性に設定するため、独自タグを利用するより汎用性があるかもしれません。
  • Markdown プラグインとの相性が良いです(と勝手に思っています)。
  • XML レベルでキャッシュしています。

次のような簡易記述で、 Amazon アソシエイトのリンクを作成します。

isbn

<a href="isbn:978-4086012447">マリア様がみてる ハローグッバイ</a>

と書くと、書影及びコメント入りのアソシエイトリンクを作成します。 本文を省略すると自動取得します。

マリア様がみてる ハローグッバイ

ISBNは10桁及び13桁のものに対応します。またハイフンは省略可能です。

asin

ISBNと同様にASINを指定することが可能です。例えば次のようにします。

<a href="asin:B001P4WVBG"></a>

マリア様がみてる スペシャルプライスDVD-BOX(初回限定生産)

ASINは10桁固定です。13桁のISBNとは互換性がないのでご注意ください。

検索

amazon で検索した最初の候補をリンクとして取得できます。 例えば次のようにします。

<a href="amazon:マリア様がみてる"></a>

マリア様がみてる―ハローグッバイ (コバルト文庫)

現在は書籍にしか対応しておりません。

オプション

画像サイズをURIの語尾で指定することができます。

  • :l (大)
  • :m (中)
  • :s (小)
  • :n (なし)

例えば次のように。

<a href="isbn:978-4086012447:s">マリア様がみてる ハローグッバイ</a>

マリア様がみてる ハローグッバイ

指定しない場合は、設定画面で設定されたものが使われます。

[上級者向け] また、さらに画像に対するオプションを管理画面および個別に指定できます。 個別に指定する場合には、画像サイズオプションにつづけて、追加したいオプション文字列を:のあとに記述します。

たとえば上の画像にさらに右下にドロップシャドウをつけるには、「PC」と追加します。

<a href="isbn:978-4086012447:s:PC">マリア様がみてる ハローグッバイ</a>

マリア様がみてる ハローグッバイ

複数のオプションを追加するには、それぞれ「_」で繋ぎます。

<a href="isbn:978-4086012447:s:PC_PV5">マリア様がみてる ハローグッバイ</a>

マリア様がみてる ハローグッバイ

どのような文字列を入れるとどのような効果があるかについてはここでは触れません(仕様がいつ変わるかわからないものです)。 興味がある方は以下のサイトなどを参考にしてください。

参考サイト

設定項目

管理画面へは「各種設定」の「Amazon ISBN Anchor」から利用できます。 以下の項目が管理画面から設定できます。

  • amazon associate ID
  • aws subscription id
  • デフォルト画像サイズ
  • HTML テンプレート
  • 画像に対するオプション

[上級者向け]テーマ内で利用するには

isbn_anchor をテーマ内で利用するには、若干の準備と、違う書式を利用する必要があります。

使用するテーマファイルの先頭に

<?php include_once(ABSPATH.'/wp-content/plugins/isbn_anchor/isbn_anchor.php'); ?>

を追加します。(あるいはテーマファイル中の function.php の最後でもかまいません。)

次に、利用したいところに

<?php echo isbn_anchor_link('isbn:978-4086012447', 'マリア様がみてる ハローグッバイ'); ?>

と書きます。若干煩雑になってしまいますが、今のところこれで利用できます。

このプラグインについてのお問い合わせは

このエントリのコメントまでどうぞ。メールでも構いませんが、すぐの返答ができるかは保証しかねます。

1.2.0 での変更点

以前のバージョンを使っている方は、こちらのバージョンで再インストールされることを強く推奨します。

  • 画像の装飾を指定できるようになりました。
  • 画像の装飾のための設定項目 ‘custom image option’ を追加しました。
  • 画像がない場合のURLを指定するための ‘default_image’ オプションは廃止されました。画像がない商品の場合、Amazon による代替画像を利用します。
  • 画像がない場合に代替画像が利用されないことがある問題を修正しました。
  • http_get() 関数の使用方法にバグがあり、正しく動かないことがある問題を修正しました。
  • このプラグインにより変換されるHTMLのフォーマットを指定する設定項目’text_format’を追加しました。
  • リンク先 URL のフォーマットを変更しました。リンク先がカウントされないことがあったのを修正しました。
  • HTMLのクラス名を指定するための ‘class_name’ オプションは廃止されました。かわりに ‘text_format’ オプションを利用してください。

This page has the following sub pages.

2 responses so far

2 Responses to “WordPress: Amazon ISBN Anchor Plugin”

  1. しむon 20 3月 2008 at 17:21:54

    はじめまして。
    こんなにシンプルに設置・表示できるamazonプラグインを探していました。
    しかし、インストールしてみたのですが
    記事内以外(サイドバー等)では使用できないみたいですね。
    残念ですた。

  2. HoLYon 22 3月 2008 at 10:25:23

    しむさん、コメントありがとうございます。

    はい、自分で(今のところ)需要がなかったので、サイドバー等で使用することを試していませんでした。
    できそうならば実装してみますね。アイディアありがとうございました。

Trackback URI | Comments RSS

Leave a Reply