1. プラグイン紹介
1.1 RepeatX43とは?
RepeatX43はEC-CUBE 4.3ショップで定期購入(サブスクリプション)サービスを運営できるようにするプラグインです。
お客様が一度定期購入を申し込むと、設定された周期に従って自動的に注文が生成され、繰り返し配送されます。
1.2 主要機能
1.3 こんなビジネスに最適です
- 健康食品、サプリメント定期配送
- 日用品(洗剤、トイレットペーパーなど)定期配送
- 食品(コーヒー、おやつなど)サブスクリプションサービス
- 化粧品リフィルサービス
- ペット用品定期配送
- その他繰り返し購入が必要なすべての商品
2. はじめに
2.1 プラグインインストール
https://your-shop.com/admin にアクセス
左側メニュー: オーナーズストア → プラグイン → プラグインをインストール
RepeatX43.zip ファイルを選択してアップロードし、「インストール」ボタンをクリック
プラグイン一覧で RepeatX43 を探し、「有効」ボタンをクリック
コンテンツ管理 → キャッシュ管理 に移動し、「キャッシュ削除」ボタンをクリック後、ページを更新(F5)
左側メニューに 定期購入管理 メニューが追加されれば成功!
2.2 初期設定チェックリスト
- 配送日数設定 - 地域別配送所要日設定
- 配送周期設定 - 使用する配送周期選択
- 決済設定 - 許可する決済方式選択
- マイページ設定 - 顧客セルフ管理オプション設定
- メール設定 - 通知メールオプション設定
- スケジューラー設定 - 自動注文生成設定
- 定期購入商品登録 - 最低1つ以上の商品登録
3. 管理画面案内
3.1 メニュー構成
プラグイン有効化後、管理画面左側に定期購入管理メニューが追加されます。
3.2 各メニューの役割
| メニュー | いつ使う? |
|---|---|
| ダッシュボード | 毎朝全体状況を確認するとき |
| 定期顧客管理 | 特定顧客の定期購入を探したり、電話注文を登録するとき |
| 定期注文一覧 | 定期注文を検索したり、一括処理するとき |
| 統計・分析 | 月間レポート作成や売上分析のとき |
| 設定 | プラグイン動作方式を変更するとき |
4. ダッシュボード使用方法
ダッシュボードは定期購入サービスの全体状況を一目で把握できる画面です。
4.1 統計カードの理解
画面上部に5つの統計カードが表示されます。
| カード | 意味 | 正常範囲 |
|---|---|---|
| 有効な定期注文数 | 現在有効状態の定期注文数 | 多いほど良い |
| 本日発送予定 | 今日配送すべき件数 | スケジューラー実行後0になるべき |
| 一時停止中 | 一時停止状態の件数 | 全体の10%以下が理想的 |
| 解約済み | 解約された件数 | モニタリング必要 |
| 処理待ち | 未処理件数(過去含む) | 0が理想的 |
4.2 週間配送計画
今日から7日間の配送予定件数を棒グラフで表示します。
- 特定曜日に注文が集中すれば配送スケジュール調整を検討
- 物流チームへ予想物量を共有
4.3 日次業務チェックリスト
毎日ダッシュボードで確認すべき事項:
- 「処理待ち」が0か確認
- スケジューラー最終実行時間が今日か確認
- 決済失敗通知があるか確認
- 在庫不足商品があるか確認
5. 定期注文管理
5.1 定期注文一覧画面
定期購入管理 → 定期注文一覧 メニューですべての定期注文を管理します。
5.2 一覧の理解
各行は商品単位で表示されます。(一人の顧客が2つの商品を定期購入すると2行で表示)
| カラム | 説明 |
|---|---|
| チェックボックス | 一括作業時に選択 |
| 顧客名 | 注文した顧客名 |
| 商品名 | 定期購入商品名 |
| 配送周期 | 配送間隔(例:14日毎) |
| 次回発送日 | 次の配送予定日 |
| 状態 | active(有効)、paused(一時停止)、cancelled(解約) |
| 配送回数 | これまで配送された回数 |
5.3 検索とフィルター
すべて | 全体表示 |
有効 | 有効状態のみ |
一時停止 | 一時停止状態のみ |
解約 | 解約状態のみ |
5.4 個別作業ボタン
| ボタン | 機能 | いつ使う? |
|---|---|---|
| 一時停止 | 配送一時停止 | 顧客の要望で一時休止するとき |
| 再開 | 一時停止解除 | 再度配送を開始するとき |
| 解約 | 定期購入解約 | 顧客が解約を希望するとき |
| 発行 | 次回注文即時生成 | 手動で注文を生成するとき |
| 削除 | 発行済み注文削除 | 誤って発行した注文を取消すとき |
6. 定期顧客管理
6.1 画面アクセス
定期購入管理 → 定期顧客管理
6.2 顧客検索
検索窓で以下の情報で検索できます:
- 顧客名
- メールアドレス
- 電話番号
6.3 電話注文登録
顧客が電話で定期購入を申し込んだとき、管理者が直接登録できます。
既存顧客:検索して選択 / 新規顧客:「新規顧客登録」ボタンで登録
商品検索窓で定期購入可能商品を選択、数量入力
希望する配送周期を選択(例:14日毎)
既存配送先を選択または新しい配送先を追加、決済方法を選択
「注文作成」ボタンをクリックして完了
7. 統計・分析活用
7.1 全体統計
| 指標 | 説明 | 活用方法 |
|---|---|---|
| 総注文件数 | 全定期注文数 | サービス規模把握 |
| 有効注文 | 現在有効な注文数 | 実際の有効顧客数 |
| 一時停止 | 一時停止中の注文数 | 離脱リスク顧客把握 |
| 解約 | 解約された注文数 | 解約率計算 |
| 総売上額 | 定期注文で発生した総売上 | 事業成果把握 |
7.2 解約率計算
解約率 = 解約件数 ÷ (有効 + 解約) × 100
8. 環境設定詳細ガイド
8.1 設定画面アクセス
定期購入管理 → 設定
設定画面は7つのタブで構成されています。
8.2 一般設定
定期注文番号の接頭辞
| 設定値 | 注文番号例 |
|---|---|
| AD | AD-000001, AD-000002 |
| REP | REP-000001, REP-000002 |
| 空白 | 000001, 000002(一般注文と同じ) |
ADやREPのように定期注文であることがわかる接頭辞を使用することを推奨します。8.3 配送日数設定
地域別配送所要日を設定します。この設定は次回配送日計算に使用されます。
| 地域 | 配送日数 | 説明 |
|---|---|---|
| 東京都 | 1日 | 首都圏翌日配送 |
| 大阪府 | 2日 | 関西圏2日 |
| 北海道 | 3日 | 遠距離地域 |
| 沖縄県 | 5日 | 離島地域 |
8.4 周期設定
| タイプ | 説明 | 例 |
|---|---|---|
| 毎週 | 毎週特定曜日 | 毎週月曜日 |
| 毎月(日付) | 毎月特定日付 | 毎月1日、15日 |
| 毎月(曜日) | 毎月特定週/曜日 | 毎月第一月曜日 |
| 週間隔 | N週間隔 | 2週毎、4週毎 |
8.5 支払設定
9. 定期購入商品登録
9.1 定期購入商品設定方法
商品管理 → 商品一覧 で設定する商品をクリック
商品編集ページ上部の商品情報セクションで、販売種別ドロップダウンから定期商品を選択
- 商品名: 商品名の前に【定期商品】を付けるとお客様が区別しやすい
例:【定期商品】チェリーアイスサンド - 販売価格: 定期購入価格
- 通常価格: 一般価格(割引表示用、オプション)
定期購入顧客に割引を提供する場合、割引タイプと割引値を設定
- 定額:固定金額割引(例:100円割引)
- 定率:比率割引(例:10%割引)
- 初回のみ: 初回購入のみ割引適用、期間制限なし
- 期間限定: 割引期間範囲内で初回購入のみ割引適用。イベント期間終了後は自動終了
「登録」または「更新」ボタンをクリック
9.2 割引設定例
割引タイプ:定率
割引値:50
適用回数:初回のみ
→ 最初の注文のみ50%割引、以後定価
10. スケジューラー完全ガイド
スケジューラーは定期注文を自動で処理するコア機能です。
10.1 スケジューラーがすること
- 今日配送予定の定期注文を照会
- 各注文に対してEC-CUBE一般注文を生成
- 次回配送日計算および更新
- 配送回数増加
- 通知メール送信(設定時)
- 実行結果ロギング
10.2 3つの実行方式
| 方式 | 適した環境 | 難易度 | 安定性 |
|---|---|---|---|
| Server Cron | VPS/専用サーバー | 中 | ★★★ |
| Webhook | ウェブホスティング | 中 | ★★★ |
| 擬似Cron | 共有ホスティング | 低 | ★★ |
10.3 Server Cron設定(推奨)
# 毎日午前6時に実行
0 6 * * * /usr/bin/php /path/to/ec-cube/bin/console repeatx43:scheduler:run
10.4 擬似Cron設定(簡単)
サイト訪問時にバックグラウンドで自動実行されます。
- 顧客がフロントページを訪問
- ページ応答後バックグラウンドでチェック
- 最終実行後設定間隔が過ぎていれば実行
- スケジューラー実行
- 訪問者がいないと実行されない
- 管理者ページでは実行されない
- 正確な時間保証なし
11. 顧客マイページ案内
11.1 マイページメニュー
プラグインインストール後、顧客マイページに定期購入管理メニューが追加されます。
11.2 顧客ができる作業
| 作業 | 説明 | 設定で無効化可能 |
|---|---|---|
| 一覧確認 | 自分の定期購入一覧を確認 | - |
| 詳細確認 | 個別定期購入の詳細情報を確認 | - |
| 配送日変更 | 次回配送日を変更 | ☑ |
| 配送周期変更 | 配送間隔を変更 | ☑ |
| 一時停止 | 配送一時停止 | ☑ |
| 再開 | 一時停止解除 | - |
| 解約 | 定期購入解約 | ☑ |
12. よくある質問(FAQ)
A: プラグイン有効化後、必ずキャッシュを削除してください:
コンテンツ管理→キャッシュ管理に移動- 「キャッシュ削除」ボタンをクリック
- ページを更新(F5キー)
※ これは仕様であり、正常な動作です。
A: 以下を確認してください:
設定→スケジューラーで有効化状態を確認- ダッシュボードで最終実行時間を確認
- 擬似Cron使用時:フロントページに訪問者がいる必要がある
- ログファイルでエラーを確認
A: 以下を確認してください:
- プラグイン有効化後キャッシュ削除したか確認
- マイページテンプレートがカスタマイズされている場合、navi.twigの修正が必要
A: 以下を確認してください:
- 商品編集で定期販売割引が設定されているか確認
- 割引適用回数設定を確認
- 割引値が0でないか確認
A: 解約された定期注文は:
- 削除されず「cancelled」状態で保管される
- 統計・分析で確認可能
- 必要に応じて管理者が手動削除可能
13. トラブルシューティング
13.1 キャッシュ削除方法
cd /path/to/ec-cube
rm -rf var/cache/*
コンテンツ管理 → キャッシュ管理 → キャッシュ削除
13.2 エラーログ確認
# ログファイル場所
var/log/prod/site-YYYY-MM-DD.log # サイトログ
var/log/prod/admin-YYYY-MM-DD.log # 管理者ログ
# エラーのみフィルター
grep -E "ERROR|CRITICAL" var/log/prod/site-$(date +%Y-%m-%d).log
13.3 一般的なエラーと解決策
| エラー | 解決策 |
|---|---|
| "Class not found" | composer dump-autoload を実行 |
| "Template not found" | キャッシュ削除後再試行 |
| "Database error" | データベース接続確認、マイグレーション実行 |
| 画面が真っ白 | .envファイルでAPP_DEBUG=1に設定してエラー確認 |
13.4 緊急時対応
- ダッシュボードで手動実行 - 「手動実行」ボタンをクリック
- 個別注文手動発行 - 定期注文一覧で該当注文を選択、「発行」ボタンをクリック
- 一括発行 - 対象注文のチェックボックスを選択、「一括発行」ボタンをクリック
運用マニュアル