RepeatX43 運用マニュアル

EC-CUBE 4.3用 定期購入(サブスクリプション)管理プラグイン v1.0.0







1. プラグイン紹介

1.1 RepeatX43とは?

RepeatX43はEC-CUBE 4.3ショップで定期購入(サブスクリプション)サービスを運営できるようにするプラグインです。

お客様が一度定期購入を申し込むと、設定された周期に従って自動的に注文が生成され、繰り返し配送されます。

1.2 主要機能

🔄
定期注文自動生成
設定された配送周期に従って自動で注文生成
📅
多様な配送周期
毎週、隔週、毎月特定日、N週間隔など
📦
商品別状態管理
有効/一時停止/解約状態を商品別に管理
💰
割引設定
初回割引、定期購入割引など
👤
顧客セルフ管理
マイページで配送日変更、一時停止、解約が可能
📧
自動メール送信
注文確認、配送予定、状態変更通知メール

1.3 こんなビジネスに最適です







2. はじめに

2.1 プラグインインストール

管理画面にアクセス

https://your-shop.com/admin にアクセス

プラグインインストール画面へ移動

左側メニュー: オーナーズストアプラグインプラグインをインストール

プラグインアップロード

RepeatX43.zip ファイルを選択してアップロードし、「インストール」ボタンをクリック

プラグイン有効化

プラグイン一覧で RepeatX43 を探し、「有効」ボタンをクリック

キャッシュ削除(重要)

コンテンツ管理キャッシュ管理 に移動し、「キャッシュ削除」ボタンをクリック後、ページを更新(F5)

⚠️
キャッシュ削除を行わないとメニューが表示されません。必ず実行してください。
インストール確認

左側メニューに 定期購入管理 メニューが追加されれば成功!

2.2 初期設定チェックリスト







3. 管理画面案内

3.1 メニュー構成

プラグイン有効化後、管理画面左側に定期購入管理メニューが追加されます。

3.2 各メニューの役割

メニュー いつ使う?
ダッシュボード 毎朝全体状況を確認するとき
定期顧客管理 特定顧客の定期購入を探したり、電話注文を登録するとき
定期注文一覧 定期注文を検索したり、一括処理するとき
統計・分析 月間レポート作成や売上分析のとき
設定 プラグイン動作方式を変更するとき







4. ダッシュボード使用方法

ダッシュボードは定期購入サービスの全体状況を一目で把握できる画面です。

4.1 統計カードの理解

画面上部に5つの統計カードが表示されます。

カード 意味 正常範囲
有効な定期注文数 現在有効状態の定期注文数 多いほど良い
本日発送予定 今日配送すべき件数 スケジューラー実行後0になるべき
一時停止中 一時停止状態の件数 全体の10%以下が理想的
解約済み 解約された件数 モニタリング必要
処理待ち 未処理件数(過去含む) 0が理想的
⚠️
「処理待ち」に数字がある場合、スケジューラーが正常動作していないか、手動処理が必要な件があるという意味です。

4.2 週間配送計画

今日から7日間の配送予定件数を棒グラフで表示します。

活用方法
  • 特定曜日に注文が集中すれば配送スケジュール調整を検討
  • 物流チームへ予想物量を共有

4.3 日次業務チェックリスト

毎日ダッシュボードで確認すべき事項:







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 一般設定

定期注文番号の接頭辞

設定値 注文番号例
ADAD-000001, AD-000002
REPREP-000001, REP-000002
空白000001, 000002(一般注文と同じ)
💡
ADREPのように定期注文であることがわかる接頭辞を使用することを推奨します。

8.3 配送日数設定

地域別配送所要日を設定します。この設定は次回配送日計算に使用されます。

地域 配送日数 説明
東京都1日首都圏翌日配送
大阪府2日関西圏2日
北海道3日遠距離地域
沖縄県5日離島地域
⚠️
配送日数が設定されていない地域はデフォルト値(2日)が適用されます。

8.4 周期設定

タイプ 説明
毎週毎週特定曜日毎週月曜日
毎月(日付)毎月特定日付毎月1日、15日
毎月(曜日)毎月特定週/曜日毎月第一月曜日
週間隔N週間隔2週毎、4週毎

8.5 支払設定

自動決済が可能なクレジットカードを主要決済手段として設定することを推奨します。







9. 定期購入商品登録

9.1 定期購入商品設定方法

商品編集ページを開く

商品管理商品一覧 で設定する商品をクリック

販売種別設定

商品編集ページ上部の商品情報セクションで、販売種別ドロップダウンから定期商品を選択

販売種別設定画面
商品編集ページの販売種別設定
商品基本情報入力
  • 商品名: 商品名の前に【定期商品】を付けるとお客様が区別しやすい
    例: 【定期商品】チェリーアイスサンド
  • 販売価格: 定期購入価格
  • 通常価格: 一般価格(割引表示用、オプション)
割引設定(オプション)
割引設定画面
定期購入割引設定

定期購入顧客に割引を提供する場合、割引タイプと割引値を設定

  • 定額:固定金額割引(例:100円割引)
  • 定率:比率割引(例:10%割引)
割引適用方式画面
割引適用方式設定
  • 初回のみ: 初回購入のみ割引適用、期間制限なし
  • 期間限定: 割引期間範囲内で初回購入のみ割引適用。イベント期間終了後は自動終了
保存

「登録」または「更新」ボタンをクリック

9.2 割引設定例

例1:初回購入50%割引
割引タイプ:定率
割引値:50
適用回数:初回のみ

→ 最初の注文のみ50%割引、以後定価







10. スケジューラー完全ガイド

スケジューラーは定期注文を自動で処理するコア機能です。

10.1 スケジューラーがすること

  1. 今日配送予定の定期注文を照会
  2. 各注文に対してEC-CUBE一般注文を生成
  3. 次回配送日計算および更新
  4. 配送回数増加
  5. 通知メール送信(設定時)
  6. 実行結果ロギング

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設定(簡単)

擬似Cron設定画面
スケジューラー設定画面 - 擬似Cron

サイト訪問時にバックグラウンドで自動実行されます。

動作原理
  1. 顧客がフロントページを訪問
  2. ページ応答後バックグラウンドでチェック
  3. 最終実行後設定間隔が過ぎていれば実行
  4. スケジューラー実行
⚠️
注意事項:
  • 訪問者がいないと実行されない
  • 管理者ページでは実行されない
  • 正確な時間保証なし







11. 顧客マイページ案内

11.1 マイページメニュー

プラグインインストール後、顧客マイページに定期購入管理メニューが追加されます。

11.2 顧客ができる作業

作業 説明 設定で無効化可能
一覧確認自分の定期購入一覧を確認-
詳細確認個別定期購入の詳細情報を確認-
配送日変更次回配送日を変更
配送周期変更配送間隔を変更
一時停止配送一時停止
再開一時停止解除-
解約定期購入解約







12. よくある質問(FAQ)

Q1. プラグインインストール後メニューが表示されません

A: プラグイン有効化後、必ずキャッシュを削除してください:

  1. コンテンツ管理キャッシュ管理 に移動
  2. 「キャッシュ削除」ボタンをクリック
  3. ページを更新(F5キー)

※ これは仕様であり、正常な動作です。

Q2. スケジューラーが実行されません

A: 以下を確認してください:

  1. 設定スケジューラーで有効化状態を確認
  2. ダッシュボードで最終実行時間を確認
  3. 擬似Cron使用時:フロントページに訪問者がいる必要がある
  4. ログファイルでエラーを確認
Q3. 顧客がマイページで定期購入を見つけられません

A: 以下を確認してください:

  1. プラグイン有効化後キャッシュ削除したか確認
  2. マイページテンプレートがカスタマイズされている場合、navi.twigの修正が必要
Q4. 割引が適用されません

A: 以下を確認してください:

  1. 商品編集で定期販売割引が設定されているか確認
  2. 割引適用回数設定を確認
  3. 割引値が0でないか確認
Q5. 解約した顧客のデータはどうなりますか?

A: 解約された定期注文は:

  • 削除されず「cancelled」状態で保管される
  • 統計・分析で確認可能
  • 必要に応じて管理者が手動削除可能







13. トラブルシューティング

13.1 キャッシュ削除方法

コマンド(SSH)
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 緊急時対応

スケジューラー障害時
  1. ダッシュボードで手動実行 - 「手動実行」ボタンをクリック
  2. 個別注文手動発行 - 定期注文一覧で該当注文を選択、「発行」ボタンをクリック
  3. 一括発行 - 対象注文のチェックボックスを選択、「一括発行」ボタンをクリック