BASE連動Pro 設定・操作ガイド
インストール
- WordPressの管理画面から プラグイン → 新規追加 → プラグインのアップロード を選択
bden-base-connect-pro.zipを選択してアップロード- 「プラグインを有効化」 をクリック
- 管理画面の左メニューに 「BASE連動Pro」 が追加されます
API設定・BASEとの連携
BASE Developersでアプリを登録
- BASE Developers にアクセスし、アカウントを作成
- 「アプリを作成」から新規アプリを登録
- クライアントID と クライアントシークレット を取得
- アプリの「コールバックURL」欄に、後述のコールバックURLを貼り付けて保存
プラグインにAPI情報を入力
- WordPressの管理画面から BASE連動Pro → 基本設定 を開く
- 以下の項目を入力して 「設定を保存する」 をクリック
| 項目 | 入力内容 |
|---|---|
| BASEショップ URL | 例：https://yourshop.base.shop/ |
| クライアントID | BASE Developersで取得したID |
| クライアントシークレット | BASE Developersで取得したシークレット |
- 「コールバックURL」欄に表示されているURLをコピーし、BASE Developersのアプリ設定の「コールバックURL」に貼り付けて保存
注意： コールバックURLはWordPressの管理画面URLを含むため、ドメインが変わった場合は再設定が必要です。
商品データの同期
- BASE連動Pro → 基本設定 を開く
- 「BASEと連携して商品データを同期する」 ボタンをクリック
- BASEのログイン画面が表示されたらログインして認証を許可
- 自動的に管理画面に戻り、同期完了メッセージが表示されます
同期後は以下の情報が確認できます。
最終同期: 2026-03-11 10:00:00 ｜ 取得商品数: 25件 ｜ カテゴリ管理APP: 連携済み（8カテゴリ）
カテゴリ管理APPについて
BASEの「カテゴリ管理APP」をインストールして商品にカテゴリを設定している場合、同期時に自動でカテゴリ情報も取得されます。カテゴリ絞り込み機能を使う場合は、事前にカテゴリ管理APPのセットアップと同期を行ってください。
補足： 同期は商品数が多いほど時間がかかります。完了後は次の同期を実行するまでデータが保持されるため、通常は商品を追加・変更したタイミングで同期すれば問題ありません。
ショートコードの使い方
ページや投稿の編集画面で、以下のショートコードを貼り付けると商品一覧が表示されます。
[dbs_pro]
ショートコード属性一覧
| 属性 | 説明 | デフォルト | 例 |
|---|---|---|---|
number |
1ページあたりの表示件数 | 12 |
number="8" |
cols |
1行あたりの列数（2〜5） | 4 |
cols="3" |
pager |
ページネーションの表示 | no |
pager="yes" |
items |
表示する商品IDをカンマ区切りで指定（空欄で全件） | 空 | items="12345,67890" |
cat |
表示するカテゴリーをカンマ区切りで指定（空欄で全件） | 空 | cat="トップス,アウター" |
search |
キーワード検索フォームの表示 | no |
search="yes" |
select_cat |
カテゴリー選択UIの表示 | no |
select_cat="yes" |
レスポンシブ対応
cols で指定した列数は画面幅に応じて自動的に調整されます。
| 画面幅 | 表示列数 |
|---|---|
| 769px 以上 | cols で指定した列数 |
| 481px 〜 768px | 最大2列 |
| 480px 以下 | 1列 |
ショートコードジェネレーター
コードを手書きせずにショートコードを生成できる画面です。
- 管理画面から BASE連動Pro → ショートコードジェネレーター を開く
- 各項目をフォームで設定するとショートコードがリアルタイムで生成される
- 「コピーする」 ボタンでクリップボードにコピー
- 投稿・固定ページの編集画面に貼り付けて保存
設定項目
- 表示件数 — 数値を入力
- 1行あたりの列数 — 2列〜5列をボタンで選択
- ページネーション — あり／なしをラジオボタンで選択
- 商品ID指定 — カンマ区切りで入力（空欄で全件）
- カテゴリー絞り込み — 同期済みデータからチェックボックスで選択（未同期時はテキスト入力）
- キーワード検索フォーム — 表示／非表示をラジオボタンで選択
- カテゴリー選択UI — 表示／非表示をラジオボタンで選択
表示のカスタマイズ例
シンプルに12件並べるだけ
[dbs_pro number="12"]
大きめ3列、ページネーションあり
[dbs_pro number="9" cols="3" pager="yes"]
特定カテゴリーのみ・検索UI付き
[dbs_pro number="12" pager="yes" cat="トップス,アウター" search="yes" select_cat="yes"]
特定の商品IDだけを2列で表示
[dbs_pro items="12345,67890,11111" cols="2"]
全機能をフル活用
[dbs_pro number="12" cols="4" pager="yes" search="yes" select_cat="yes"]
よくある質問
Q. 商品が表示されません
A. 基本設定から同期を実行してください。同期が完了していない場合、商品データが存在しないため表示されません。
Q. カテゴリーで絞り込みができません
A. BASEの「カテゴリ管理APP」がインストールされているか確認してください。インストール後、商品に対してカテゴリを設定し、管理画面から再度同期を実行する必要があります。
Q. 同期に時間がかかります
A. 商品数が多いほど同期時間が長くなります（商品1件につきAPIを1回呼び出すため）。同期はサーバー側でタイムアウトが発生する場合があります。その場合はサーバーの max_execution_time の延長をホスティング会社にご相談ください。
Q. 商品を追加・変更したのに反映されません
A. BASEで商品を変更した場合は、管理画面から手動で同期を実行してください。同期は自動では行われません。
Q. 同一ページに複数のショートコードを設置できますか？
A. できます。それぞれ異なるカテゴリや商品IDを指定して、複数のショートコードを同一ページに配置できます。