EC-CUBE 4.2 / 4.3 対応公式マニュアル

会員管理Pro プラグイン

標準のEC-CUBEでは不足している「会員CSV登録・出力」「ドライラン事前検証」「ワンクリック代理ログイン」「CS対応履歴タイムライン」を統合。会員対応の業務効率化とカスタマーサポート品質の向上を両立する次世代の顧客管理ソリューションです。

1. プラグイン概要と主な機能

『会員管理Pro プラグイン (CustomerManagementPro)』は、日々のEC運営において発生する「会員データの一括登録や移行ができない」「お客様と同じ画面を確認したい」「電話やメールの対応履歴を共有したい」という現場の切実な要望に応えるオールインワン拡張プラグインです。

会員CSV一括登録（インポート）

新規登録および会員ID指定による一括更新。UTF-8・Shift-JISの自動判別や必須・重複検証を網羅。

ドライラン（安全な事前プレビュー）

DBを更新せずにCSV内容を事前検証。エラー行の原因や新規/更新の予定件数を画面上に一覧表示します。

全会員CSVストリーミング出力

大容量データでも安全に出力可能。本プラグインの登録形式と完全互換で、Excel一括メンテナンスを実現。

ワンクリック代理ログイン

会員詳細からお客様のマイページへ即座に代理ログイン。固定バナーと復帰ボタンで安全に画面確認。

CS対応履歴タイムライン

電話・メール・問合せ・クレーム等の記録をカード形式で時系列表示。編集モーダルや削除機能を完備。

カテゴリ絞り込み & ページネーション

種別ごとのタブ切り替え（件数バッジ付き）、キーワード検索、ページネーションで快適な閲覧性を確保。

2. インストール・有効化手順

1. 管理画面からのインストール

プラグインのアップロード

EC-CUBE管理画面 設定＞システム設定＞プラグイン一覧 を開き、「新規追加」ボタンから CustomerManagementPro.tar.gz をアップロードします。

プラグインの有効化

一覧に追加された「会員管理Pro」の右側にある「有効化」をクリックします（必要なテーブルが自動作成されます）。

メニューの確認

左側ナビゲーションの 会員管理＞会員CSV登録・出力 が追加されていることを確認します。

2. CLI（コンソールコマンド）からのインストール

# プラグインのインストール
$ bin/console eccube:plugin:install --code=CustomerManagementPro

# プラグインの有効化
$ bin/console eccube:plugin:enable --code=CustomerManagementPro

# キャッシュのクリア
$ bin/console cache:clear --no-warmup

3. 会員CSVフォーマット・登録項目仕様

「会員CSV登録・出力」画面の右上にある「標準CSV雛形ダウンロード」ボタンから、サンプル行付きの最新テンプレートCSV（UTF-8 BOM付き）を取得できます。

CSVヘッダー名	必須 / 任意	設定値の説明・記入例
会員ID	任意	既存会員の更新時は必須。新規登録時は空欄にします。
お名前(姓) / お名前(名)	必須	会員の氏名（例: `山田` / `太郎`）。
フリガナ(セイ) / フリガナ(メイ)	必須	カタカナフリガナ（例: `ヤマダ` / `タロウ`）。
会社名	任意	法人・会社名（例: `株式会社サンプル`）。
郵便番号	必須	ハイフン有無どちらでも可（例: `100-0001` または `1000001`）。
都道府県	必須	都道府県名（例: `東京都`）またはPref ID。
市区町村・番地	必須	番地までの住所（例: `千代田区千代田1-1`）。
建物名・部屋番号	任意	ビル・マンション名（例: `パレスビル10F`）。
電話番号	必須	市外局番付き電話番号（例: `03-1234-5678`）。
メールアドレス	必須	ログインIDとなるメールアドレス。重複チェックが行われます。
パスワード	任意	未入力の場合、新規時はランダム英数8桁が自動生成。更新時は既存パスワードが維持されます。
性別	任意	`男性`、`女性`、または性別マスタID。
職業	任意	`会社員`、`公務員`、または職業マスタID。
生年月日	任意	`YYYY-MM-DD` または `YYYY/MM/DD` 形式（例: `1990-05-15`）。
会員状態	任意	`本会員`、`仮会員`など。空欄時は「本会員」が適用されます。
所持ポイント	任意	付与ポイント数（半角数値、例: `1000`）。
ショップ用メモ	任意	管理者用メモ（フロントのお客様には表示されません）。

4. ドライラン（事前検証モード）の使い方

CSVファイルをアップロードする際、「事前プレビュー」ボタンをクリックすると、データベースを一切更新することなく内容の整合性を事前スキャンできます。

💡 本番反映前の事前チェックに最適

大量の会員データを一括インポートする前に、事前プレビューを実行してエラー行が存在しないことを確認してから本番登録を行う運用を推奨します。

プレビュー画面で確認できる情報

項目	説明
総データ行数	CSVファイル内の有効データ行数
新規登録（予定）件数	会員IDが未指定で、新規会員として追加される行数
既存更新（予定）件数	会員IDが既存会員と一致し、上書き更新される行数
エラー検出行数 & 詳細	必須項目漏れ、メール重複、不正な都道府県名など、エラー理由を行番号付きで一覧表示
データ行サンプルプレビュー	先頭最大50行のマッピング結果をカラーバッジ（新規/更新/エラー）付きテーブルで確認可能

5. 全会員CSV出力と一括更新フロー

登録されている全会員データを、本プラグインのインポートフォーマットと完全互換のCSV形式として1クリックで出力できます。

1. 出力方法と文字コード

「会員管理」→「会員一覧」画面上部、または「会員CSV登録・出力」画面の「会員データCSVエクスポート」ボタンよりダウンロードします。

UTF-8 (BOM付き)： Microsoft Excelでダブルクリックして開いても文字化けしない推奨形式。
Shift-JIS： 従来の業務基幹システムや古いツールとの連携用形式。

2. 会員データの一括更新メンテナンスフロー

会員データをエクスポート

「会員CSV出力(Pro)」ボタンから全会員データをダウンロードします（会員IDが付与された状態で出力されます）。

Excel等でデータを修正

住所変更、ポイントの一括調整、ステータスの変更など、必要な項目を編集して保存します（パスワード列は空欄のままで既存パスワードが保持されます）。

事前プレビュー＞一括登録

「会員CSV登録・出力」画面からアップロードし、まずドライランで検証後、一括登録を実行すると会員IDに基づき即座に上書き更新されます。

6. 代理ログイン機能 (Proxy Login)

ショップ管理者が、お客様のアカウントでフロントエンド（マイページや注文画面）へ代理ログインし、お客様と同じ画面を見ながらスムーズなサポートを行える機能です。

操作手順

管理画面の会員詳細画面右上の 「マイページへ代理ログイン」 ボタンをクリックします。
自動的にフロントのマイページが新しいタブまたは同ウィンドウで開き、お客様として認証されます。
画面最上部に常時 「代理ログイン中」通知バー が表示されます。
確認・サポート終了後、通知バー内の 「管理者画面に戻る」 ボタンをクリックすると、代理ログインが解除され管理画面の会員詳細へ即座に戻ります。

🔒 万全のセキュリティ & 監査ログ

有効期限2分間のワンタイム暗号化トークンにより厳格に認証。代理ログインの実行日時はCS対応履歴タイムラインへ自動的に監査ログとして記録されます。

7. CS対応履歴タイムライン管理

会員詳細画面の下部に、お客様との電話やり取り、メール対応、お問い合わせ、ご意見・クレームなどを記録・共有できるサポートタイムラインです。

1. 新規対応メモの記録

対応種別（お電話、メール対応、お問い合わせ、ご意見・クレーム、その他メモ）、件名、詳細内容を入力して「対応履歴を保存する」をクリックします。

2. 対応履歴の編集（Edit）

各カード右上の 鉛筆アイコン（編集ボタン） をクリックすると専用モーダルが開き、種別・件名・内容を修正できます。画面をリロードすることなくAJAXで即時反映されます。

3. カテゴリタブ絞り込み & 件数バッジ

タイムライン上部のタブボタンをクリックすることで、「📞 お電話のみ」「⚠️ クレームのみ」など特定の種別に絞り込んで確認できます。各タブには登録件数がバッジで表示されます。

4. キーワード検索 & ページネーション

キーワード入力欄から、やり取り内容や担当者名でリアルタイム検索可能。さらに10件ごとのページネーションにより、対応履歴が多いお得意様でも軽快に閲覧できます。

8. プラグイン基本設定

EC-CUBE管理画面 設定＞システム設定＞プラグイン一覧＞会員管理Pro「設定」 より各機能の有効/無効を切り替えられます。

設定項目	初期値	説明
会員CSV登録機能	有効 (ON)	CSVインポート画面および一覧拡張ボタンの有効/無効
代理ログイン機能	有効 (ON)	会員詳細画面の代理ログインボタンの表示/非表示
CS対応履歴タイムライン	有効 (ON)	会員詳細画面のタイムラインウィジェットの表示/非表示
代理ログイン時の自動ログ記録	有効 (ON)	代理ログイン実行時にタイムラインへ自動記録するかどうか

9. よくある質問・トラブルシューティング

Q. CSVインポートで既存会員のパスワードは上書きされますか？

いいえ。パスワード列を空欄にしてインポートした場合、既存会員の現在のパスワードはそのまま安全に保持されます。パスワードを変更したい場合のみ新しいパスワードを入力してください。

Q. Shift-JISのCSVファイルもそのままアップロードできますか？

はい。プラグインが内部で文字コード（Shift-JIS / UTF-8）を自動判別し、文字化けを起こさずにクリーンなUTF-8に変換してから処理します。

Q. 代理ログイン中にお客様自身のセッションに影響はありますか？

ありません。管理者のブラウザセッション内でのみ認証が確立されるため、お客様が同時に利用中であっても影響を与えません。

Q. プラグインをアンインストールした際、会員データは消えますか？

いいえ。アンインストールを実行しても、EC-CUBE本体の会員データ（dtb_customer）が削除されることは一切ありません。プラグイン専用の対応履歴テーブルと設定テーブルのみが安全にクリーンアップされます。