YJShopping

English information available at mw:Extension:YJShopping

Extension:YJShopping は、Yahoo!ショッピングの商品検索APIを使って記事中に商品リンクを埋め込むためのMediaWiki用Extension（拡張機能）。

特徴

できること

• フリーキーワード検索、JAN指定、ISBN指定^※に対応
• Yahoo!ショッピングに登録されている画像、商品名、販売店名を表示
• バリューコマースのアフィリエイトリンクを設定可
• Yahoo!ショッピングに加え、12ヶ所のインターネットショッピングモール（アマゾン (Amazon.co.jp), 楽天市場, ビックカメラ（2023年2月で終了）, ソフマップ (Sofmap.com), Sofmap リコレ！, ナチュラム, honto, ebookjapan, 7net, イトーヨーカドー (iyec), au PAY マーケット^※, OCN モバイル ONE オンラインショップ（旧 NTT-X Store）, ひかりTVショッピング, Qoo10, Anker Japan (Anker Direct)）, メルカリおよび「価格.com」へのリンクを追加できる（任意）。この場合、バリューコマースやAmazon・楽天、リンクシェアへの会員登録と提携が必要（価格.comを除く）。
• ビックカメラ、Sofmap、リコレ！、ナチュラム、イトーヨーカドー、qoo10とAnkerはISBN・JAN以外で表示される。
• hontoと7netは、ISBN・JAN検索または querytype="book" パラメータを付けた時のみ表示される。
• ebookjapanは、querytype="book" パラメータを付けた時かつISBN/JAN検索でない時のみ表示される。
• 見た目の変更はスタイルシートで → #Common.css
• BSDライセンスで提供 → Special:Version/License/YJShopping

YahooのAPI不具合により、ISBN検索はJAN検索として暫定処理している。これに伴い旧10桁ISBNでの検索は動作しない。

「au PAY マーケット」（旧「Wowma!」）はValueCommerceからLinkShareに変更になったため、引き続きリンクを貼りたい場合はLSでの提携と設定の書き換えが必要。

できないこと

• Yahoo!ショッピングの商品検索APIを使うため、Yahoo!ショッピングに登録されていない商品は表示できない。
  →Amazonの商品掲載は「AmazonSearch」をどうぞ
• 価格はあえて表示していない（しようと思えばできるが）
• 複数商品の表示（キーワード検索してAPIが返した最も上位1点のみ表示する）
• 記事中から自動でキーワードを拾うといった機能は持たせていないので、記事中の埋め込みたい場所に所定のタグを記述する必要がある。
• 一切の保証・補償とサポート（ご利用は自己責任でどうぞ）
• 日本語以外（英語を含む）での説明書きや問い合わせ対応

できたら良いこと

• honto と 7net は ISBN/JAN 検索の時のみ有効にしているが、キーワード検索でも任意にON/OFFできると良いかも？ → querytype="book" で仮対応
• Sofmapやリコレ、イトーヨーカドーなどの品揃えに偏りがあるサイトへのリンクボタンも追加したので、やはり何らかの形でON/OFFできるようにしたい。→ v1.3.0 で対応
• 即席で汚いコードなので整理したい。 → 少しずつ整理している

経緯

近頃流行りのブログパーツのように、記事を書いていると商品リンクを貼れたら便利に思うことが少なくないが、MediaWikiのExtensionに使えそうな物が見当たらず、それらしき物があってもまともに動作しなかった。また、特定のショッピングサイト専用にするのも使い勝手が悪いので、自作することにした。

フリーキーワードによる商品検索APIは、Amazon、楽天市場、Yahoo!ショッピングが提供しているが、API制限や規約等を含めた使い勝手を総合的に勘案し、Yahoo!ショッピングを使ってみることにした。

これを作った後で、バリューコマースが『MyLinkBox』を出してきたりもして、やっぱりこういうブログパーツを使いたいと思う人は多いのかなと改めて実感。（MediaWikiで使いたい人は少なさそうだけれど）

なお、Amazonでしか取り扱いのない商品もあるので、Amazon専用の姉妹ツール AmazonSearch も作って併用している。

記述例 Usage

フリーキーワード

<yjshopping>Anker PowerCore PD Redux</yjshopping>

Anker PowerCore 10000 PD Redux 25W（モバイルバッテリー 10000mAh 大容量 ）【USB Power Delivery対応/PPS規格対応/PowerIQ搭載/PSE技術基準適合】 アンカー

AnkerDirect

• Yahoo!ショッピング
• Amazon.co.jp
• 楽天市場
• au PAY マーケット
• メルカリ
• Anker Japan

• (v1.3.1-) フリーキーワードに "anker" が含まれているため、Anker Japan のリンクボタンが自動的に追加されている（$wgYJShoppingMatchAddbtn を参照）。

フリーキーワード＋ストアID指定

<yjshopping seller_id="ankerdirect">Anker PowerCore PD Redux</yjshopping>

Anker PowerCore 10000 PD Redux 25W（モバイルバッテリー 10000mAh 大容量 ）【USB Power Delivery対応/PPS規格対応/PowerIQ搭載/PSE技術基準適合】 アンカー

AnkerDirect

• Yahoo!ショッピング
• Amazon.co.jp
• 楽天市場
• au PAY マーケット
• メルカリ
• Anker Japan

• 旧APIの store_id が指定された場合は、新APIの seller_id に読み替えられる。

フリーキーワード＋リンクボタン追加

<yjshopping addbtn="sofmap sofmapused">AQUOS wish2</yjshopping>

AQUOS wish3 wish2 フィルム wish ガラスフィルム 保護フィルム 10Hガラスザムライ らくらくクリップ付き アクオス SH-53D SH-51C SHG06 A104SH SH-M20

OVER’s(オーバーズ)

• Yahoo!ショッピング
• Amazon.co.jp
• 楽天市場
• au PAY マーケット
• メルカリ
• Sofmap.com
• Sofmap リコレ！

• (v1.3.0-) LocalSettings.php で $wgYJShoppingDefaultButtons を指定しておき、規定で非表示のリンクボタンは必要に応じ addbtn で追加することができる。
• $wgYJShoppingDefaultButtons が未指定の場合は全てのリンクボタンが表示されるので、addbtn 指定は意味をなさない。
• (v1.3.1-) 所定のキーワードに対応して自動的にボタンを追加することもできる（$wgYJShoppingMatchAddbtn を参照）。

フリーキーワード＋カテゴリ指定

<yjshopping genre_category_id="10488">豚公爵</yjshopping>

豚公爵に転生したから、今度は君に好きと言いたい(８) ＭＦＣアライブ／ｆｕｊｙ(著者),合田拍子(原作),ｎａｕｒｉｂｏｎ(キャラクター原案

ブックオフ1号館 ヤフーショッピング店

• Yahoo!ショッピング
• Amazon.co.jp
• 楽天市場
• au PAY マーケット
• メルカリ

• 旧APIの category_id が指定された場合は、新APIの genre_category_id に読み替えられる。

フリーキーワード＋カテゴリ指定＋新品のみ／中古品のみ

<yjshopping genre_category_id="10268" condition="new">豚公爵</yjshopping>

豚公爵に転生したから、今度は君に好きと言いたい 10/合田拍子

bookfanプレミアム

• Yahoo!ショッピング
• Amazon.co.jp
• 楽天市場
• au PAY マーケット
• メルカリ

<yjshopping genre_category_id="10268" condition="used">豚公爵</yjshopping>

豚公爵に転生したから、今度は君に好きと言いたい ９／合田拍子

ネットオフ ヤフー店

• Yahoo!ショッピング
• Amazon.co.jp
• 楽天市場
• au PAY マーケット
• メルカリ

• カテゴリを指定し、さらに新品のみ／中古品のみを検索する例
• 追加されるリンクボタンをクリックした先では、カテゴリや新古を問わず全商品が検索対象になる

フリーキーワード＋book指定

<yjshopping querytype="book">豚公爵</yjshopping>

豚公爵に転生したから、今度は君に好きと言いたい ９／合田拍子

ネットオフ ヤフー店

• Yahoo!ショッピング
• Amazon.co.jp
• 楽天市場
• honto
• ebookjapan
• 7net
• au PAY マーケット
• メルカリ

• キーワード検索で honto, 7net などの書籍販売サイトを表示したい場合には querytype="book" を指定する。
• ebookjapan（電子書籍専門サイト）は querytype="book" 指定時にのみ表示される。
• 書籍を扱っていないサイトは表示されなくなる。

ISBN

<yjshopping querytype="isbn">9784040724218</yjshopping>
<yjshopping querytype="isbn">978-4-04-072421-8</yjshopping>

豚公爵に転生したから、今度は君に好きと言いたい 3／合田拍子

ネットオフ ヤフー店

• Yahoo!ショッピング
• Amazon.co.jp
• 楽天市場
• honto
• 7net
• au PAY マーケット
• メルカリ

• ISBNのハイフンは不要だが、付けたままでもOK
• 書籍を扱っていないサイトは表示されない
• querytype="book" 指定との違いは、紙の本も扱っているhontoは表示されるが、電子書籍専門ebookjapanはISBN非対応なので表示されない^※

原則として紙の本と電子書籍には別個のISBNを振ることになっているが、現状電子書籍でISBNはあまり使われておらず、ebookjapanでISBNを検索しても返答は得られない。hontoやamazonでは紙の本と電子書籍を関連づけて互いに行き来できるようになっているが、こうした機能はサイト側で構築しているもの。

JAN

<yjshopping querytype="jan" shipping="free" sort="+price">4988003579395</yjshopping>

CD/林原めぐみ/30th Anniversary Best Album VINTAGE DENIM

surpriseflower

• Yahoo!ショッピング
• Amazon.co.jp
• 楽天市場
• au PAY マーケット
• メルカリ

• ISBN/JAN指定と、各種APIパラメータの併用も可能

初期設定 Setting

Download

YJShopping_20231128.zip (12KB)

Download and unzip it on your MediaWiki extensions directory.

You can use it freely at your own risk. I license it under the Revised BSD License.

⇒English installation guide is here.

LocalSettings.php

Edit LocalSettings.php file to add below.

LocalSettings.php

/* YJShopping */
require_once "$IP/extensions/YJShopping/YJShopping.php";
$wgYJShoppingAppID = '★';
#$wgYJShoppingVCID = '//ck.jp.ap.valuecommerce.com/servlet/referral?sid=xxxxxxx&pid=xxxxxxxxx&vc_url=';
$wgYJShoppingPlus['yahoo']['sid'] = '※';
$wgYJShoppingPlus['yahoo']['pid'] = '※';
$wgYJShoppingPlus['amazon'] = '◆';
#$wgYJShoppingPlus['amazon']['sid'] = '※';
#$wgYJShoppingPlus['amazon']['pid'] = '※';
$wgYJShoppingPlus['rakuten'] = '▲';
#$wgYJShoppingPlus['rakuten']['lsid'] = '●';
#$wgYJShoppingPlus['rakuten']['sid'] = '※';
#$wgYJShoppingPlus['rakuten']['pid'] = '※';
$wgYJShoppingPlus['sofmap']['lsid'] = '●';
$wgYJShoppingPlus['sofmap']['bids'] = '111111.1';
$wgYJShoppingPlus['sofmapused']['lsid'] = '●';
$wgYJShoppingPlus['sofmapused']['bids'] = '111111.1';
$wgYJShoppingPlus['naturum']['lsid'] = '●';
$wgYJShoppingPlus['naturum']['bids'] = '111111.1';
$wgYJShoppingPlus['honto']['sid'] = '※';
$wgYJShoppingPlus['honto']['pid'] = '※';
$wgYJShoppingPlus['ebookjapan']['sid'] = '※';
$wgYJShoppingPlus['ebookjapan']['pid'] = '※';
$wgYJShoppingPlus['7net']['sid'] = '※';
$wgYJShoppingPlus['7net']['pid'] = '※';
$wgYJShoppingPlus['wowma']['lsid'] = '●';
$wgYJShoppingPlus['nttxstore']['a8mat'] = '△';
$wgYJShoppingPlus['qoo10']['sid'] = '※';
$wgYJShoppingPlus['qoo10']['pid'] = '※';
$wgYJShoppingPlus['anker']['sid'] = '※';
$wgYJShoppingPlus['anker']['pid'] = '※';
$wgYJShoppingPlus['mercari'] = '☆';
$wgYJShoppingPlus['kakakucom'] = true;

/* (option) */
$wgYJShoppingDefaultButtons = [ 'yahoo', 'amazon', 'rakuten', 'mercari' ];
$wgYJShoppingBookButtons = [ 'yahoo', 'amazon', 'rakuten', 'honto', 'ebookjapan', '7net', 'mercari' ];
$wgYJShoppingMatchAddbtn = [
	"anker" => "anker wowma",
	"中古" => "sofmapused mercari",
	"保護フィルム" => "wowma qoo10",
	"自転車" => "naturum",
	"キャンプ" => "naturum"
];

/* (option) */
#$wgYJShoppingAcceptParams = [ 'genre_category_id', 'brand_id', 'seller_id', 'start', 'shipping', 'payment', 'delivery_area', 'delivery_day', 'delivery_deadline', 'sort', 'condition' ];

/* (option) Link target */
$wgYJShoppingTarget = '_blank';

/* (option) Lazy loading */
$wgNativeImageLazyLoading = true;

• 【必須】★印には、Yahoo!JAPAN で取得したアプリケーションIDを入れる。
• 【任意】$wgYJShoppingVCID には、ここに書いてある要領で取得したYahoo!ショッピングのリンク先URLを入れる。任意。エンコードは不要（スクリプトにて行う）。
  ただし、$wgYJShoppingPlus['yahoo']['sid'] と $wgYJShoppingPlus['yahoo']['pid'] を指定する場合は省略可（sidとpidから自動生成する）。
• 【任意】※印には、バリューコマースの各提携先で取得したMyLinkコードから必要な値を抜き出して入れる。各社と提携した後、MyLinkコードを取得し、リンク先URLからsidとpid（いずれも数字）を抜き出す。任意（省略するとリンク自体が生成されない）。値を間違えると機能しないリンクが生成されてしまうので、要注意。
• 【任意】◆印には、各自で取得した Amazon.co.jp のトラッキングIDを入れる。省略するとリンクが生成されない。または、バリューコマースの MyLink から取得した sid, pid を指定しても良い。
• 【任意】▲印には、楽天のアフィリエイトIDを入れる。省略するとリンクが生成されない。
• 【任意】●印には、リンクシェアの【リンク→リンク作成→リンクビルダー】で生成したリンクコードから必要な値を抜き出して入れる。また、'bids' の '111111.1' には、<img> タグの中からbidsの値を抜き出して入れる。任意（'lsid' を省略するとリンク自体が生成されないが、'bids' は省略可）。値を間違えると機能しないリンクが生成されてしまうので、要注意。
• 【任意】楽天市場の●印には、リンクシェアのプログラム→提携中のECサイト→楽天市場→ECサイト情報→【楽天プログラム】専用ツールを利用する→楽天URL指定リンク で生成したリンクコードのURLからidの値を抜き出して入れる。楽天では'bids'は不要。楽天アフィリエイトIDとは異なるので注意。
• 【任意】△印には、A8.netの【商品リンク作成→フリー素材】で生成したリンクURLからa8matの値を抜き出して入れる。値を間違えると機能しないリンクが生成されてしまうので、要注意。
• 【任意】PayPayモールのアフィリエイトプログラムはYahoo!ショッピングと共通だが、MyLinkのpidが異なるので、ValueCommerceよりPayPayモール出店ストア用MyLinkコードの取得が必要。
• 【任意】$wgYJShoppingPlus['kakakucom'] を true にすると、「価格.com」へのリンク（アフィリエイト未対応）を追加する（ISBN・JAN検索を除く）
• 【任意】$wgYJShoppingAcceptParams 配列に値を追加すると、商品検索APIに渡すことのできる値を追加できる。
• 【任意】$wgYJShoppingTarget = ''; にすると、target="_blank" を付加しない。または任意のtargetを指定してもよい。
• 【任意】(v1.2.8-) $wgNativeImageLazyLoading = true; にすると、商品画像に loading="lazy" を付加する。なお、計測用画像（一部リンクに付加されている width="1" height="1" のもの）にはこの設定値にかかわらず loading="lazy" を付加する。
• 【任意】(v1.3.0-) $wgYJShoppingDefaultButtons を指定すると、ここに指定したリンクボタンのみが規定で表示される（省略すると従来通り全ての有効なリンクボタンを表示する）。この値は、並び順を指定したい時にも有効。
• 【任意】(v1.3.0-) $wgYJShoppingBookButtons は本（querytype が book または isbn）の場合の規定で表示するボタン（省略すると以下同様）。
• 【任意】(v1.3.1-) $wgYJShoppingMatchAddbtn は、検索フリーキーワードに指定した文字列（大文字・小文字は問わない）が含まれる場合に自動的にリンクボタンを追加する。
• 【任意】☆印には、メルカリアンバサダー登録後に生成できるリンクからafidの値を抜き出して入れる。

And check Special:Version on your wiki.

備考

hontoとebookjapan（いずれもValueCommerce）は、新規購入しか成果が発生しないものと、購入ごとに成果が発生するものの2種類がある。

hontoは「新規購入専用」でない方、ebookjapanは「【定率】」が付いている方と提携すると、購入ごとに成果が発生する。

Common.css

Edit MediaWiki:Common.css to add below (customize free).

MediaWiki:Common.css

/* Extension:YJShopping */
DIV.yjshopping {
	clear: both;
	width: 100%;
	min-height: 180px;
	margin: 0 auto;
	padding: 0.5em;
	border: 1px solid #444;
	overflow: hidden;
}
DIV.yjshopping IMG.yjshoppingimg {
	float: left;
	margin: 0.1em 1em 0.1em 0.1em;
}
DIV.yjshopping P.yjshoppingname {
	margin: 0;
	font-size: 90%;
	text-indent: 0;
}
DIV.yjshopping P.yjshoppingstore::before {
	background-color: #bbb;
	border-radius: 10%;
	color: #fff;
	font-size: smaller;
	padding: 0 0.5em 0 0.5em;
	margin-right: 0.5em;
	content: "広告";
}
DIV.yjshopping P.yjshoppingstore {
	margin: 0;
	font-size: 80%;
	text-indent: 0;
}
DIV.yjshopping UL {
	margin: 0;
}
DIV.yjshopping UL LI {
	display: inline-block;
	text-align: center;
	list-style: none;
	font-size: 85%;
	width: 10em;
	margin: 0.2em;
	padding: 0.2em 0.5em 0.2em 0.5em;
	border-radius: 0.5em;
	white-space: nowrap;
}
DIV.yjshopping UL LI A {
	color: #fff;
}
DIV.yjshopping UL LI.shoplinkyahoo {
	background-color: #f55;
}
DIV.yjshopping UL LI.shoplinkamazon {
	background-color: #f90;
}
DIV.yjshopping UL LI.shoplinkrakuten {
	background-color: #c00;
}
DIV.yjshopping UL LI.shoplinksofmap {
	background-color: #16f;
}
DIV.yjshopping UL LI.shoplinksofmapused {
	background-color: #3ba;
}
DIV.yjshopping UL LI.shoplinknaturum {
	background-color: #084;
}
DIV.yjshopping UL LI.shoplinkhonto {
	background-color: #4af;
}
DIV.yjshopping UL LI.shoplinkebookjapan {
	background-color: #f46;
}
DIV.yjshopping UL LI.shoplink7net {
	background-color: #153;
}
DIV.yjshopping UL LI.shoplinkwowma {
	background-color: #f71;
}
DIV.yjshopping UL LI.shoplinknttxstore {
	background-color: #06a;
}
DIV.yjshopping UL LI.shoplinkqoo10 {
	background-color: #5af;
}
DIV.yjshopping UL LI.shoplinkanker {
	background-color: #2ae;
}
DIV.yjshopping UL LI.shoplinkmercari {
	background-color: #f00;
}
DIV.yjshopping UL LI.shoplinkkakakucom {
	background-color: #02d;
}

Debug

LocalSettings.php ファイルに下記を追加すると、ログを出力するようになり、簡単なデバッグができる。

LocalSettings.php

/* for debug Extension:YJShopping */
define( 'YJSHOPPING_DEBUG', 'yjshopping' );
$wgDebugLogGroups[YJSHOPPING_DEBUG] = $IP . '/extensions/YJShopping/debug.log';

常時ONにしておくとサーバの負荷が増大し、デバッグログファイルも非常に大きくなるので、通常は無効にしておくことを推奨。

Dependency

• Yahoo!JAPAN Shopping search API v3 (Japanese)
• PHP 5.4.0+ (using http_build_query() with PHP_QUERY_RFC3986 option)

FAQ

レスポンシブですか？スマートフォン向けサイトでも使えますか？

対応しています。使えます。ただし表示はお使いのSkinに依存する部分が大きいので、実際に試してみて表示に不都合があれば #Common.css を書き換えて調整してください。

何も表示されませんが？

設定が不十分か誤りがある場合と、Yahoo!JAPAN API がエラーを返した場合には、何も表示されません。設定を見直すとともに、LocalSettings.php に error_reporting( E_ALL ); を追加してみてください。

Warning: file_get_contents(https://shopping.yahooapis.jp/ShoppingWebService/V3/itemSearch?…): Failed to open stream: HTTP request failed! HTTP/1.1 429 Too Many Requests in /path/to/your/mediawiki/extensions/YJShopping/YJShopping.php on line 315

APIがエラーを返した場合は、このようにエラー内容が表示されます（上記の例はAPIを立て続けに呼びすぎて一時的に規制されている状態）。

BOXを縦長にできますか？

#Common.css を書き換えてできます。

Common.css を書き換えられません。

MediaWiki 1.32 以降では、CSSの書き換えに特別な権限が必要になったので、Special:UserRights から追加してください。

Common.css の書き換えを不要にできませんか？

できなくはないものの、初期設定が一層煩雑になってしまいます。Extension をインストールできてCSSの書き換えができない状況を想定できないので、対応予定はありません。

対応リンクを自分で追加する際の注意点は。

ValueCommerce の場合、MyLink に対応している広告主は追加できます。

LinkShare の場合、リンクビルダーに対応している広告主は追加できます。

A8.net の場合、商品リンクに対応している広告主は追加できます。

もちろん、いずれの場合も広告主の通販サイトがフリーキーワード検索に対応しており、そのURLを取得できる必要があります（あまり無いとは思いますが、POSTやJavaScript(Ajax)等でしか検索できない通販サイトには対応できません）。

また、規定の文字コードはUTF-8ですが、時々認識されないサイトがあるので（例えばビックカメラはSJISしか認識しない）、その場合は文字コード変換処理を追加する必要があるかもしれません（ビックカメラ (LinkShare) の処理を参考にどうぞ）。

Amazonでしか取り扱いのない商品のリンクを置きたいのですが。

Amazon専用の姉妹ツール AmazonSearch を作ったので、そちらでどうぞ。
ただし、Amazon の API は利用制限が厳しいので、定期的に一定以上のアフィリエイト収益が上がるサイト以外では使い物にならないと思われます。

商品写真や商品名のリンクをクリックすると、以前は「Yahoo!ショッピング」に飛んでいましたが、いつからか「PayPayモール」に飛ぶようになっています。

Yahoo!ショッピング 商品検索API側で、PayPayモールを優先するように仕様変更が為されたようです。PayPayモールに無い商品の場合は、従来通りYahoo!ショッピングに遷移します。また、PayPayモール出店ストアの注文もアフィリエイト成果対象になるそうです。

→「PayPayモール」終了に伴い、リンクは「Yahoo!ショッピング」に転送されています。

このツールの利用は無料ですか？

無料で使っていただけます。一切の保証やサポートはありませんので自己責任で使える人向けですが、BSDライセンスで配布しますので、その範囲でご自由にご利用ください。

Tweeki のSkin領域で使えますか？

残念ながら使えません。Tweekiのページを参考にして自作するか、下記のブログツールを埋め込んで使うなどしてください。

MediaWiki以外で使えるものはありますか？

こちらでは用意していません。

2019年6月頃より、バリューコマースが『MyLinkBox』という、本ツールとそっくりさん（見た目が似ているだけで中身は別物、こちらはPHPであちらはJavaScript）を提供し始めたので、そちらを検討してみてください。

Yahoo!ショッピング 商品検索API v1 の提供終了予告（2020年 6月30日まで）が出ていました。 5月 8日に公開された新しい API v3 には対応していますか？

2020年 5月12日に、新APIに対応しました。新しいバージョンをダウンロード・上書きインストールすれば、新APIに切り替わります（追加設定不要）。

なお、何らかの理由で旧APIを使いたい場合は、YJShopping_v1.php を YJShopping.php に名前を変えて使うことで、しばらくは旧APIを使えます。⇒API v1 終了に伴い削除しました。

商品検索API v1 から v3 に変わったことで、記事中に埋め込んだタグの書き換えは必要になりますか？

旧 API v1 から変更があったパラメータのうち、よく使われているであろう category_id と store_id は新 API v3 のパラメータに読み替える処理を入れてありますので、多くの場合、そのまま動作すると思います。

上記以外は読み替えられませんが、必要であれば LocalSettings.php で追加することもできます（ご利用は自己責任でどうぞ）。例：

$wgYJShoppingChangeParams['affiliate_from'] = 'affiliate_rate_from';

これはあくまで後方互換性を確保するための機能なので、今後新たに執筆される記事においては、新APIのパラメータを利用することをお勧めします。

画面表示を早くしたい（遅延読み込み (Lazy loading)にしたい）

v1.2.8 より、$wgNativeImageLazyLoading = true; になっている場合には、商品画像に loading="lazy" を付加するようになりました。

なお、v1.2.8 より、この設定値にかかわらず計測用画像（一部リンクに付加されている width="1" height="1" のもの）には loading="lazy" を付加します。

SEO対策としては、CSS で min-heightを指定しておくなどの CLS (Cumulative Layout Shift)対策もおすすめです。

キャッシュされる？

v1.2.7 よりキャッシュに対応しましたが、かえって動作が遅くなる場合もあるため、v1.2.9 より規定でキャッシュ無効にしました。キャッシュしたい場合は LocalSettings.php に設定が必要です。

$wgYJShoppingCaching = true;

また、MediaWikiのObjectCacheを使っているので、本Extensionのためにデータベースの改変などは不要ですが、LocalSettings.php で $wgMainCacheType を適切に設定しておく必要があります。

キャッシュの保存時間は？

規定で3600秒（1時間）になっています。LocalSettings.php にて変更できます。

$wgYJShoppingCachingTime = 600;	/* 600秒（10分） */

タイムアウト時間は？

PHPの規定によります。規定値は60秒と長いため、php.ini の default_socket_timeoutを変更しておくことをお勧めします（ちなみに作者は5秒に設定していますが、YahooのAPIは反応が早いため、もっと短くてもいいかも）。

「広告」表記を入れたい

CSSで入れることができます。

メルカリアンバサダーのガイドラインに抵触しませんか？

作者が本Extensionに追加したい旨問い合わせたところ、ガイドラインの禁止事項に該当しない旨の回答が得られたので、機能追加しました。とはいえ、ガイドラインも変わる可能性がありますし、利用方法にもよるでしょうから、自己責任での利用をお願いするとともに、もし問題があれば適宜対応してください。

Bugs

• API v3 に対応するに際し、ISBN検索をすると "Bad Request" が返ってくる不具合が見つかったため、暫定的にJANコード検索に振り替えて対応している。Yahoo!の問い合わせ窓口に不具合報告したものの、修正する気は無さそうだった…
• 本Extensionから出力されたHTMLがMediaWiki内で中途半端にescapeされる（例：URLの一部 & が &amp; になっている）ことがある。継続調査中（未解決）。でもWebブラウザでは正常動作しているから不思議…
• API側が障害等で止まっているときにこちらに影響が及ぶ（ので、そのうちタイムアウトの設定等考えたい）。
• リンクボタンの数が多いと、はみ出すなど、表示が見にくくなることがある（CSSでうまく調整して使ってください）。
• 他にもいろいろ手抜きし放題。
• 英語があちこち壊れているのはいろいろ諦めてくださいorz
• その他にも気づいた点があれば直して使ってください:-)。その際、修正報告いただけると作者が喜びます:)

History

2023.11.28 (v1.3.2)

メルカリアンバサダーに対応

2023.10.01 (v1.3.1)

$wgYJShoppingMatchAddbtn に対応

2023.09.18 (v1.3.0)

「Anker Japan (Anker Direct)」（VC、ISBN/JAN非表示）に対応

$wgYJShoppingDefaultButtons, $wgYJShoppingBookButtons, addbtn に対応

2023.08.02 (v1.2.9)

$wgYJShoppingCaching = true; にした場合にのみキャッシュを有効にした（むしろ Object cache の処理に時間がかかる場合があるようなので）

2023.07.31 (v1.2.8)

遅延読み込み (Lazy loading)に対応（$wgNativeImageLazyLoading 指定時）

2023.07.12 (v1.2.7)

Object cache に対応

2023.07.04 (v1.2.6)

@ 演算子を使わないようにした（PHP 8 対応）

2023.06.15 (v1.2.5)

「NTT-X Store」を「OCN (NTT-X Store)」に改称

「PayPayモール」「ビックカメラ」「イトーヨーカドー」「ひかりTVショッピング」の終了に伴い該当パラメータを削除

2021.10.15 (v1.2.4)

querytype="book" パラメータを追加、ebookjapanに対応

7netのURL変更に対応

ビックカメラ等（検索キーワードがSJISのみに対応しているサイト）のリンクのtitleの文字化け対策

2021.01.23 (v1.2.3)

A8.netの処理を追加、「NTT-X Store」と「ひかりTVショッピング」に対応

2021.01.19 (v1.2.2)

au PAY マーケット（旧Wowma!）をLinkShareに切り替え

Qoo10(VC) に対応（ISBN/JAN非表示）

LinkShare の 'bids' を省略可にした

YJShopping_v1.php を削除

2020.06.04 (v1.2.1)

PHP 7.4 にしたら warning や notice が出るようになったので対策

2020.05.12 (v1.2.0)

商品検索API v3 に対応（以降、API v1 には非対応）

API v3 でISBN検索をすると "Bad Request" が返るため、暫定的にJANコード検索に振り替えて対応。13桁の新ISBNコードでは問題ないと思うが、2006年以前の10桁の旧ISBNコードではうまく検索できないと思う（未確認）。

2020.02.08 (v1.1.4)

ビックカメラ (LinkShare) に対応

target="_blank" を変更（または無指定に）できるようにした

2019.12.18 (v1.1.3-3)

PayPayモール (ValueCommerce) に対応

2019.07.10 (v1.1.3-2)

ナチュラム (LinkShare) に対応

2019.07.06 (v1.1.3)

イトーヨーカドーネット通販 (ValueCommerce) に対応

urlencode() を rawurlencode() に変更（空白のエンコードを + から %20 に変更）

JAN指定時に Sofmap.com, Sofmapリコレ（中古）を出ないようにした

display:table; を解除、#Common.css にて float:left; 指定

API呼出URLの生成に http_build_query() を使う処理に変更
→http_build_query() にて PHP_QUERY_RFC3986 を使うため、PHP 5.4.0 以降が必須になった

i18n/en.json を i18n/qqq.json (default) に変更

2019.06.10 (v1.1.2)

楽天市場のリンクをバリューコマースでも設定できるようにした

i18n/*.json のみの変更のため、バージョン番号には変更無し

2019.06.02 (v1.1.2)

楽天市場のリンクをリンクシェアでも設定できるようにした（試験的）

Sofmap.com, Sofmap リコレ！（リンクシェア）に対応

2019.05.30 (v1.1.1)

バージョン番号表記をMediaWikiっぽい形に変更

AmazonへのリンクもValueCommerceのMyLinkに対応（アソシエイトID指定と排他）

本Extensionから出力されたHTMLがMediaWiki内で中途半端にescapeされる問題を継続調査中（未解決）でもWebブラウザでは正常動作しているから不思議…

画像の配置方法を float:left から display:table に変更

2019.05.26 (v1.10)

煩雑になっていた内部処理の整理

$wgYJShoppingPlusのキー名'yj'を'yahoo'に変更

2019.05.24 (v1.00)

初版（商品検索API v1 に対応）

参考リンク

• mw:Manual:Extensions
• Yahoo!ショッピング 商品検索API v3
• Yahoo!ショッピング 商品検索API v1
• バリューコマース Yahoo!ショッピング
• バリューコマース『MyLinkBox』
• メルカリガイド メルカリアンバサダー

API障害情報

• すべてのお知らせ
• 【Yahoo!ショッピング】【復旧済み】商品検索APIの不具合について（2022年 6月22日）

関連記事

• AmazonSearch
• Yado
• MediaWiki