Contents
動作要件
| 項目 | 必要バージョン |
|---|---|
| WordPress | 6.0 以上 |
| PHP | 7.4 以上 |
| Welcart e-Commerce | 2.9 以上 (最新推奨) |
| MySQL / MariaDB | WordPress 要件に準ずる |
Welcart が有効化されていない環境で報助を有効化すると、管理画面に警告が表示され、ボタン注入・在庫検知等の機能は停止します。設定画面へのアクセスは可能です。
インストール
WordPress.org からインストール (推奨)
- WordPress 管理画面 → 「プラグイン」→ 「新規追加」
- 検索欄に
報助 for Welcartまたはhosuke welcartと入力 - 「今すぐインストール」→ 「有効化」
ZIP からインストール
WordPress.org プラグインページ から ZIP をダウンロードし、「プラグイン」→ 「新規追加」→ 「プラグインのアップロード」から ZIP を選択してインストール。
- カスタムテーブル 2 種 (
{prefix}hosuke_notifications、{prefix}hosuke_stock_watch) - 固定ページ「通知の解除」(スラッグ
hosuke-unsubscribe) - 15 分周期の WP-Cron イベント (在庫スキャン用)
- 3 種のメールテンプレのデフォルト値 (日本語)
Welcart 連携の確認
管理画面のメニューに「報助」が追加されているか確認してください。左サイドバー「報助」→ 「診断」ページで、Welcart との連携状況が自動チェックされます。
次の項目がすべて OK になっていれば準備完了です:
- ✓ Welcart e-Commerce プラグインが有効
- ✓ Welcart 会員 API が呼び出し可能
- ✓ SKU 取得 API (
wel_get_skus) が利用可能 - ✓ カスタムテーブルが作成済
- ✓ WP-Cron イベントが登録済
- ✓ 解除ページ (固定ページ「通知の解除」) が作成済
基本設定
「報助 → 設定」→ 「基本設定」タブから以下を設定できます。
| 項目 | デフォルト | 説明 |
|---|---|---|
| ボタンの自動挿入 | ON | Welcart の「売切」ラベル横に自動でボタンを挿入するか |
| ボタンラベル | 再入荷お知らせ通知 | ボタンに表示する文字列 |
| Welcart マイページ自動注入 | OFF | Welcart 会員マイページに通知一覧を自動注入するか |
| プライバシー同意チェック | ON | 登録フォームに同意チェックボックスを表示するか |
| プライバシーポリシー URL | (空) | 同意チェック横のリンク先。空欄の場合はリンクなし |
| データ保持期間 | 90 日 | 解除済 / 通知済レコードの自動削除期間 (日) |
| アンインストール時にデータ削除 | OFF | プラグイン削除時に全データを削除するか |
reCAPTCHA v3 の設定 (任意)
スパム登録を防ぐため、Google reCAPTCHA v3 の統合をサポートしています。設定しない場合でも IP 別レートリミット (デフォルト: 1 IP あたり 10 分に 5 回まで) は動作します。
① Google 側でキーを取得
- reCAPTCHA 管理コンソール にアクセス
- 「+ 新しいサイトを追加」を選択
- reCAPTCHA タイプ: reCAPTCHA v3 を選択
- ドメイン欄に運用サイトのドメイン (例:
example.com) を追加 - 「送信」を押すと サイトキー と シークレットキー が発行される
② 報助側にキーを登録
「報助 → 設定」→ 「セキュリティ」タブに以下を貼り付け:
- reCAPTCHA サイトキー: 上記で取得したサイトキー
- reCAPTCHA シークレットキー: 上記で取得したシークレットキー
- reCAPTCHA スコア閾値: デフォルト
0.5(0.0〜1.0)
閾値は低いほど通過しやすく、高いほど厳しくなります。導入直後は 0.5 のままで運用し、ログを見ながら調整してください。
メールテンプレの確認
「報助 → 通知メール」から 3 種類のテンプレを編集できます:
- 登録確認メール: 通知登録直後にお客様へ送信
- 再入荷通知メール: 在庫が戻った瞬間にお客様へ送信
- 管理者アラートメール: 送信リトライが上限を超えた際にサイト管理者へ送信
プラグイン有効化時に日本語のデフォルトテンプレが 3 種すべて自動入力されているため、そのまま運用可能です。差込変数はエディタ上部のボタンから挿入できます:
{customer_name}: お客様の氏名 (Welcart 会員の場合){shop_name}/{shop_url}: サイト情報{item_name}/{item_url}: 対象商品情報{sku_name}/{sku_code}: 対象 SKU 情報{unsubscribe_url}: 解除ページ URL
テスト送信で動作確認
「報助 → 通知メール」ページ下部の「テスト送信」セクションから、任意のテンプレを任意のアドレスへプレビュー送信できます。
- テンプレ種別を選択 (登録確認 / 再入荷通知 / 管理者アラート)
- 宛先メールアドレスを入力 (自分のアドレス推奨)
- 「テスト送信」ボタンを押下
- 1〜3 分以内に受信箱を確認
wp_mail() だと Gmail / Outlook 等の厳格プロバイダに届きません。下記 SMTP プラグイン の設定を推奨します。
Welcart マイページ統合
Welcart 会員向けに、マイページに通知一覧を追加できます。自動注入と手動配置の 2 通り。
自動注入
「報助 → 設定」→ 「基本設定」→ 「Welcart マイページ自動注入」を ON にするだけ。マイページの「購入履歴」タブの下に通知一覧が自動で追加されます。
手動配置 (テーマ側で位置調整したい場合)
自動注入を OFF にし、Welcart マイページテーマファイルの任意の位置に以下を挿入:
<?php echo do_shortcode( '[hosuke_my_notifications]' ); ?>会員でないゲスト訪問者にはこのショートコードは何も表示しません。
メール到達性を上げる (推奨)
報助 は WordPress 標準の wp_mail() 経由で送信します。実際にメールが受信箱に到達するかは、サーバのメール送信環境と送信元ドメインの DNS レコード次第です。
Gmail / Outlook 宛の重要通知や、月に数十件以上の送信がある場合は、SMTP プラグインの併用を強く推奨します。
推奨構成
WP Mail SMTP / FluentSMTP / Post SMTP のいずれか + 認証済み送信サービス。
| 送信サービス | 特徴 |
|---|---|
| Amazon SES | 低コスト、高信頼、要 AWS アカウント |
| SendGrid | 無料枠あり (100 通/日)、UI 分かりやすい |
| Mailgun | 無料枠あり、開発者向け |
| Google Workspace | 既に契約しているなら追加コストなし |
| Microsoft 365 | 既に契約しているなら追加コストなし |
SMTP プラグインは wp_mail() の呼出しを透過的に横取りするため、報助側のコード変更は不要です。設定したその日から全通知が認証済み経路で送信されるようになります。