ぷくリンク

説明

ぷくリンクは、WordPress の中で商品を検索し、商品カードを挿入して、価格を最新に保ち、リンクのクリック数を計測できるアフィリエイトリンク作成プラグインです。

  • クラシックエディタとブロックエディタの両方で使えます。
  • Amazon・楽天市場・Yahoo! ショッピングを検索して、商品カードを挿入できます。
  • 楽天市場と Yahoo! ショッピングの推しショップを登録して、特定の店舗の中だけを検索できます。
  • 同一商品だと確認したモール間の商品を紐づけて、各モールの価格と取得日を1枚のカードに表示できます。
  • 商品を紐づけていないモールが使う検索キーワードを調整できます。カードの商品名は変わりません。
  • 価格の自動更新、カードごとの価格表示、セールラベル、口コミリンク、クリック計測を備えています。
  • Amazon Creators API の利用資格が一時的にない場合も、Amazon の検索リンクは挿入できます。
  • 6種類のテンプレートを収録: スタンダード、コンパクト、ラージカード、モダン、テキストリンク、比較表用ボタン。
  • スタンダード・ラージカード・モダンのテンプレートでは、Amazon と楽天市場の追加の商品写真をギャラリーとして表示できます。スワイプ、送り矢印、キーボード操作に対応します。カードごとにサイト設定を上書きして、常に表示または常に非表示にできます。
  • AI マーカーを使うと、検索結果を確認したうえで [pukulink_draft keyword="商品名"] のプレースホルダーを商品カードへ置き換えられます。商品は必ず利用者が選んで確定します。
  • 任意で schema.org の Product/Offer 形式の JSON-LD を出力できます。
  • 楽天市場と Yahoo! ショッピングのリンクは、「かんたんリンク」のコードから ID を取り込むことで、もしもアフィリエイト経由にもできます。
  • 「商品の健全性」レポートで、販売が終了した可能性のある商品を一覧できます。
  • 設定、商品台帳、履歴、クリック集計を JSON で書き出せます。

Yahoo! ショッピング API の利用ガイドラインに従い、ぷくリンクは Yahoo! の商品情報を表示したページの下部に、必須のクレジット「Web Services by Yahoo! JAPAN」を自動で表示します。

記事に保存されるのは、持ち運びできるショートコード [pukulink] だけです。アフィリエイト URL はページの表示時に組み立てるため、設定を変更すると、記事を1件ずつ編集しなくても既存のカードに反映されます。

外部サービス

ぷくリンクは、サイト管理者が有効化して設定したサービスとだけ通信します。リクエストは、商品検索、店舗の確認、価格更新、アフィリエイトリンクの生成に使います。Client Secret などの認証情報を、当該サービス以外の宛先や、プラグイン開発者が運用するサーバーへ送信・保存することはありません。

Amazon Creators API

  • 通信先: OAuth 認証は api.amazon.co.jp または creatorsapi.auth.us-west-2.amazoncognito.com、商品検索と価格取得は creatorsapi.amazon
  • 送信するデータ: Client ID、Client Secret、アソシエイト ID、商品の検索語、ASIN、マーケットプレイスの情報。
  • 目的: OAuth トークンの取得、Amazon の商品検索、価格の更新。
  • 規約とポリシー: https://affiliate.amazon.co.jp/help/operating/agreement/ および https://www.amazon.co.jp/gp/help/customer/display.html?nodeId=GX7NJQ4ZB8MHFRNJ

楽天市場商品検索 API / 楽天アフィリエイト

  • 通信先: 商品検索と価格取得は openapi.rakuten.co.jp、閲覧者がクリックするアフィリエイトリンクは hb.afl.rakuten.co.jp
  • 送信するデータ: アプリケーション ID、アクセスキー、商品の検索語、商品コード、推しショップの店舗コード、サイトの Origin ヘッダー。
  • 目的: 楽天市場の商品検索、店舗の確認、価格の更新、アフィリエイトリンクの生成。
  • 規約とポリシー: https://webservice.rakuten.co.jp/guide/rule および https://privacy.rakuten.co.jp/

Yahoo! ショッピング (日本) 商品検索 API / バリューコマース

  • 通信先: 商品検索と価格取得は shopping.yahooapis.jp、閲覧者がクリックするアフィリエイトリンクは ck.jp.ap.valuecommerce.com
  • 送信するデータ: Yahoo! の Client ID、商品の検索語、JAN コード、ストア ID。
  • 目的: Yahoo! ショッピングの商品検索、店舗の確認、価格の更新、アフィリエイトリンクの生成。
  • 規約とポリシー: https://developer.yahoo.co.jp/guideline/ および https://privacy.yahoo.co.jp/

もしもアフィリエイト (任意)

  • 通信先: af.moshimo.comi.moshimo.com
  • 送信するデータ: Amazon・楽天市場・Yahoo! ショッピング (日本) の商品 URL、もしもアフィリエイトのプロモーション ID。
  • 目的: もしもアフィリエイトを使う設定のモールについて、アフィリエイトリンクとインプレッションビーコンを生成します。
  • 規約とポリシー: https://af.moshimo.com/af/www/terms/shop および https://www.moshimo.co.jp/company/privacy

ブロック

このプラグインは1個のブロックを提供します。

  • blockLinkTitle

インストール

  1. プラグイン > 新規追加 > プラグインのアップロード から pukulink.zip をアップロードします。
  2. ぷくリンクを有効化します。
  3. 設定 > ぷくリンク を開き、利用したいサービスの認証情報を入力します。
  4. 記事の編集画面の 「ぷくリンクを追加」 ボタン、またはブロックエディタのブロック 「ぷくリンク」 から商品を検索します。ブロック検索では「商品リンク」でも見つけられます。

ぷくリンク 2.0.0 以降は、旧版との互換コードを持たない独立したプラグインです。2.0 より前のバージョンの設定、履歴、クリック集計、商品カードは引き継ぎません。必要な商品カードは、このバージョンで改めて作成してください。

FAQ

Amazon の商品を検索できないのはなぜですか ?

Creators API の Client ID、Client Secret、アソシエイト ID、そして Amazon アソシエイトの利用資格を確認してください。利用資格が一時的にない場合も、Amazon の検索リンクは作成できます。

価格はいつ更新されますか ?

WP-Cron が毎時実行され、設定したキャッシュ期間を過ぎた商品のうち、直近30日以内に表示された商品を少しずつ更新します。アクセスが少ないサイトでは、サーバーの cron で wp-cron.php を定期実行すると、より確実に更新できます。

以前のバージョンから設定は引き継がれますか ?

引き継がれません。ぷくリンク 2.0.0 は、以前のプラグインの設定や商品カードを移行しません。すべての識別子をぷくリンクの名前で統一するためです。

楽天市場の検索や価格更新が動作しないのはなぜですか ?

楽天の旧 API は2026年8月17日に終了しました。アクセスキーを設定していないと、楽天市場の商品検索と価格更新は動作しません。現行の楽天ウェブサービスの API でアプリケーションを登録し、アプリケーション ID と pk_ で始まるアクセスキーの両方を設定してください。あわせて、アプリケーションの許可ウェブサイトとして自分のサイト URL を登録する必要があります。

評価

このプラグインにはレビューがありません。

貢献者と開発者

ぷくリンク はオープンソースソフトウェアです。以下の人々がこのプラグインに貢献しています。

貢献者

“ぷくリンク” は1ロケールに翻訳されています。 翻訳者のみなさん、翻訳へのご協力ありがとうございます。

“ぷくリンク” をあなたの言語に翻訳しましょう。

開発に興味がありますか ?

コードを閲覧するか、SVN リポジトリをチェックするか、開発ログRSS で購読してみてください。

変更履歴

2.6.5

  • 楽天市場または Yahoo! ショッピングを、アフィリエイト ID を設定しないまま有効にしている場合に警告を追加しました。ボタンは従来どおり表示されますが、リンク先が素の店舗 URL になり報酬が発生しないため、これまで気づきにくい状態でした。ボタンの表示は変わりません。
  • Amazon Creators API の利用資格がない場合のメッセージに、楽天市場と Yahoo! ショッピングは通常どおり使えること、Yahoo! の Client ID は即時発行されることを追記しました。
  • 「使い方」タブのモール間の紐づけに関する説明を明確にしました。プラグインが商品コードを自動で紐づけることはなく、紐づけていないモールは検索結果へのリンクになります。
  • アンインストール時に、プラグインがキャッシュしていた Amazon のトークンと利用資格のフラグも削除するようにしました。
  • 楽天の旧 API に関する記述を過去形に更新しました。サポートは2026年8月17日に終了しました。

2.6.4

  • 画像ギャラリーのカード単位の上書き (常に表示 / 常に非表示) を追加しました。既存のカードごとの価格表示の選択肢と同じ形です。サイト全体で有効にする前に、1つの商品だけでギャラリーを試せます。

2.6.2

  • Amazon と楽天市場の商品について、任意の画像ギャラリーを追加しました。スワイプ、送り矢印、キーボード操作に対応します。「表示・デザイン」で有効にしたうえで、商品カードを挿入するときに商品ごとに「追加画像を含める」を選んでください。既定は無効で、既存のカードには影響しません。

2.5.5

  • 公式の Plugin Check ツールが報告した問題をすべて解消しました。エディタのボタン出力を出力地点でエスケープし、不足していた translators コメントを追加し、読み取り専用の管理画面のクエリパラメーター2件について nonce 検証の注釈を修正しました。機能と表示の変更はありません。

2.5.4

  • WordPress.org 配布用のパッケージを準備しました。この readme を英語に翻訳し、外部サービスのポリシーリンクを修正し、不要になった手動の翻訳ローダーを削除し、同梱していた日本語の翻訳と日本語の開発ドキュメントをリリース用 ZIP から除外しました。WordPress.org 版の翻訳は translate.wordpress.org から読み込まれます。

2.5.3

  • CSS のビューポート幅が広い横向きの iPhone で、モバイル向けのレイアウト修正が適用されない場合を修正しました。縦が短い横向きのタッチ画面でも、挿入プレビューの操作ボタンが表示されたままになります。

2.5.2

  • 一部の横向きのモバイル表示で、「挿入」ボタンがブラウザの UI の下に隠れる問題を修正しました。

2.5.1

  • 商品を紐づけていないモール向けに、挿入プレビューで検索キーワードを編集できるようにしました。空にすると、カードの商品名を使います。
  • メインのモールを変更したときに、入力中のリンク文字、価格表示、検索キーワードを保持するようにしました。

2.5.0

  • カードごとの価格表示と、複数の AI マーカーの連続処理を追加しました。

2.4.20

  • 一部の幅で「モダン」テンプレートのボタンが縦並びになる問題を修正しました。

2.4.19

  • 「モダン」テンプレートの下側のボタンが、ラベルの長さに応じた大きさになり、文字が上下中央に揃うようにしました。

2.4.18

  • ブロックエディタの入口のブロック名を「ぷくリンク」、保存されるカードのブロック名を「ぷくリンクカード」に変更しました。内部のブロック名と既存のショートコードは変わりません。

2.4.17

  • 「モダン」テンプレートのボタン配置を変更し、クラシックエディタの挿入ボタン名を「ぷくリンクを追加」に変更しました。

2.4.16

  • 塗りつぶしのモールボタンの既定の文字色を白に戻し、モールごとの文字色の設定を追加しました。

2.4.15

  • ダークモードに対応し、すべてのテンプレートでカードの配色を自動・ライト・ダークから選べるようにしました。

2.4.14

  • 「モダン」テンプレートのダークモード対応を追加し、ボタンのコントラストの扱いを改善しました。

2.4.13

  • 挿入プレビューのモールボタンを有効にし、紐づけた商品ページや検索結果を新しいタブまたは確認用ウィンドウで確認できるようにしました。編集画面に挿入済みのカードのリンクは、従来どおり無効のままです。

2.4.12

  • 紐づけていないモールの検索 URL に、長い商品名ではなく検索時の入力語を使うようにしました。商品検索モーダルのレイアウトをモール間で統一しました。

2.4.11

  • 「使い方」タブにブロックエディタの案内を追加しました。入口のブロック、保存されるカードのブロック、ショートコードへの変換について説明しています。

2.4.10

  • プレビューの生成中にモーダルを閉じたときに、まれに意図しない挿入が起きる問題を防ぎました。

2.4.9

  • テキストリンクの編集で、以前のリンクが意図したモールを保つように修正し、リンク文字を編集した直後のワンクリック挿入を修正しました。

2.4.8

  • 挿入プレビューと検索モーダルのレイアウトを調整しました。モバイルの入力欄の高さと、テキストリンクの表示文字を含みます。

2.4.7

  • 編集画面のカードにテンプレート名のバッジを追加し、「テキストリンク」テンプレートの表示文字を編集できるようにしました。

2.4.6

  • WordPress.org への提出用メタデータと、WordPress 7.0 の対応情報を更新しました。

2.4.5

  • 挿入履歴が保持するのは最新50件であることを明確にしました。

2.4.4

  • モールの表示順の設定と、「モダン」テンプレートで独立したモール別の色を追加しました。

2.4.3

  • 「モダン」テンプレートのモール別の色が、表示されたカードに適用されない問題を修正し、プレビューの操作を調整しました。

2.4.2

  • 挿入履歴を検索・ページ送りできるようにし、プレビュー、商品台帳、クリック計測の信頼性を改善しました。

2.4.1

  • 長いプレビューでも「挿入」の操作を表示したままにし、プレビューの操作を調整しました。

2.4.0

  • プラグインのソースを国際化し、日本語の翻訳ファイルと開発用の翻訳テンプレートを追加しました。

2.3.0

  • 楽天市場と Yahoo! のもしもアフィリエイト対応、商品の健全性レポート、JSON エクスポート、価格履歴の収集、楽天の旧 API 終了に関する案内を追加しました。

2.2.0

  • AI マーカーと、任意の Product/Offer 形式の JSON-LD 出力を追加しました。

2.1.3

  • 作成者名を Pukuo に更新し、クラシックエディタのボタンアイコンの大きさを統一しました。

2.1.2

  • クラシックエディタのカード表示の選択肢を簡素化し、画像とキャプションのモードを削除しました。

2.1.1

  • エディタのアイコンが大きく表示されることがある問題を修正し、新規インストールでは商品カードを編集画面の既定の表示にしました。

2.1.0

  • 「モダン」と「比較表用ボタン」のテンプレート、サービスクレジット、楽天 API の移行に関する案内を追加しました。

2.0.2

  • 設定ページの名前とエディタの起動アイコンを「ぷくリンク」で統一しました。

2.0.1

  • クラシックエディタとブロックエディタの起動アイコンを統一しました。

2.0.0

  • プラグイン名、スラッグ、テキストドメイン、メインファイル、ショートコードの識別子を「ぷくリンク」に変更しました。以前のカードと設定は引き継ぎません。