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

高機能お気に入り＆リスト共有プラグイン
CubeWishlist

ショップの売上と購入率を最大化する次世代のお気に入りソリューション。会員はもちろん未ログインのゲスト客にも対応し、一括カート投入、値下げ自動検知、商品個別メモ、URL共有（QRコード・LINE・SNSシェア）、再入荷通知希望登録、そして管理画面での人気ランキング分析・CSV出力をオールインワンで提供します。

1. プラグイン概要 & ショップ導入のメリット

標準のEC-CUBEにも「お気に入り」機能は存在しますが、「会員ログインが必須で離脱率が高い」「複数商品をまとめて買えない」「値下げに気づけない」「家族や友人にリストを共有できない」など、現代のEコマースにおいて売上機会を逃す要因が多くありました。

CubeWishlist はこれらの課題を完全に解決し、直感的なAjax操作とリッチなマイクロインタラクションによって、お客様の検討フェーズを強力に購入へと後押しします。

ショップ導入の5大メリット

ゲスト対応でカゴ落ち防止: ログイン不要で即座に保存可能。新規会員登録またはログイン時に自動で統合され、会員化を強力に促進します。
「すべてカートに入れる」で客単価向上: 在庫のある商品をワンクリックで一括投入。セット買いやついで買いを加速させます。
「値下げ！」自動バッジで即買いを誘発: お気に入り追加時の価格を記録し、値下がり時に視覚的なバッジでアピール。セール時の購買率が劇的に向上します。
バイラル共有（ギフト・代理購入需要の獲得）: ワンタップでLINEやSNSへシェア、QRコード自動生成。誕生日や内祝い、代理購入リストとして拡散されます。
完全テーマ非依存: Font Awesome等の外部ライブラリ依存ゼロ（内蔵インラインSVG）。独自CSSスコープにより、どんなカスタムテーマでも崩れず美しく動作します。

2. 主な特徴・機能一覧

Ajax マイクロインタラクション

画面遷移なしでハートが鼓動アニメーション。トースト通知とヘッダーバッジがリアルタイムに連動します。

ゲスト対応 & 自動マージ

未ログインでもCookie/Sessionで安全に保存。ログインや会員登録が行われた瞬間に会員データへ自動統合されます。

「すべてカートに入れる」一括投入

お気に入り内の在庫あり商品を1クリックでまとめてカートに追加。購入フローへの最短導線を実現します。

「値下げ！」バッジ自動検知

追加時の価格から値下がりした商品を自動検知し、アニメーション付きの「値下げ！」バッジとお得差額を表示します。

商品ごとの個別メモ機能

「サイズ検討中」「母の誕生日用」など、商品ごとにメモをAjax保存・編集可能。検討の確度を高めます。

公開リンク共有 & ギフト支援

安全な32文字トークンで公開URLを発行。URLを知っている相手が受取人専用ページから代理購入できます。

QRコード & LINE/SNSシェア

スマホで読み取れるQRコードの自動生成に加え、LINE、X（旧Twitter）、Facebookへのワンタップ投稿に対応。

品切れ商品の再入荷通知希望

在庫切れ商品には「再入荷通知を希望」ボタンを表示。ゲスト客用にはメールアドレス登録モーダルを提供。

3. 動作環境・システム要件

項目	要件・対応バージョン
EC-CUBE 本体	EC-CUBE 4.2.0 ～ 4.3.x
PHP	PHP 7.4 / 8.0 / 8.1 / 8.2 / 8.3
データベース	MySQL 5.7 / 8.0系, PostgreSQL 10 ～ 16系

4. インストール・初期セットアップ

管理画面またはコマンドラインからプラグインをインストール

EC-CUBEルートディレクトリにて以下のコマンドを実行します（管理画面の「オーナーズストア > プラグイン一覧」からもインストール可能です）:

# 1. プラグインのインストール
php bin/console eccube:plugin:install --code=CubeWishlist

# 2. プラグインの有効化
php bin/console eccube:plugin:enable --code=CubeWishlist

# 3. キャッシュクリア
php bin/console cache:clear --no-warmup

有効化完了の確認

プラグインを有効化すると、商品詳細画面・一覧画面に自動的にハートボタンが配置され、管理画面に「商品管理 > お気に入り統計」メニューが追加されます。

5. プラグイン基本設定

管理画面 [設定] > [プラグイン] > [プラグイン一覧] を開き、CubeWishlistの [設定] ボタンをクリックすると基本設定画面が開きます。

設定項目	初期値	説明・推奨設定
ゲスト利用の許可	有効 (許可する)	未ログインの訪問者によるお気に入り登録を許可します。離脱を防ぐため「有効」を強く推奨します。
ゲストデータ保持日数	`30日`	未ログイン客のお気に入りデータを保持する日数（1〜365日）。期限を過ぎた放置データはクリーンアップコマンドで定期削除されます。
リスト共有機能	有効 (利用する)	お気に入りリストの専用URL発行・SNSシェア・QRコード共有機能を有効化します。ギフト需要を獲得するために推奨されます。
デフォルトリスト名	`お気に入り商品リスト`	お客様がお気に入りを新規作成した際のデフォルトタイトルを設定できます。

6. ブロック配置（ヘッダー・ナビゲーション）

本プラグインには、お気に入り件数バッジ付きのリンクを表示する「お気に入りナビゲーション」ブロックが同梱されています。

自動挿入スクリプトについて

プラグイン内蔵のスクリプトにより、ブロックを手動配置しない場合でも、ヘッダーの「カート」アイコン付近を自動検出してお気に入りアイコンがスマートにマウントされます。より厳密な位置調整を行いたい場合は、以下の手順でブロックを配置してください。

レイアウト管理画面を開く

管理画面 [コンテンツ管理] > [レイアウト管理] へ移動し、配置したいページ（例: 「下層ページ」「トップページ」など）を選択します。

ブロックをドラッグ＆ドロップ

未使用ブロック一覧にある 「お気に入りナビゲーション」 をドラッグし、ヘッダー枠内のお好みの位置（カートブロックの横など）へドロップして [登録] します。

7. フロントエンド機能・画面仕様

7-1. 提供画面一覧 & URL

画面名	URL	対象ユーザー & 仕様
会員お気に入り一覧	`/mypage/wishlist`	ログイン会員用。マイページナビと連携し、全機能（一括カート、個別メモ、URL共有）が利用可能。
ゲストお気に入り一覧	`/wishlist`	未ログイン訪問者用。上部に会員登録・ログインを促す案内バナーをスマートに表示。
公開共有リスト閲覧	`/wishlist/shared/{shareToken}`	URL共有を受けた受取人・友人用。リスト内の商品を直接選んでカート投入・代理購入が可能。

7-2. 商品詳細・一覧画面のハートボタン

商品一覧カード: 商品画像右上にフローティングハートボタンが自動配置されます。クリックするとバウンスアニメーションとともにトースト通知がポップアップします。
商品詳細画面: 「カートに入れる」ボタンの下部にフルワイドの「お気に入りに追加」ボタンが自動挿入されます。登録済みの場合はアクティブ状態（ピンク背景・塗りつぶしハート）へ変化します。
規格選択の連動: 規格1・規格2が存在する商品の場合、選択中の規格情報がお気に入りアイテムへ正確に保持されます。

7-3. お気に入り一覧画面のリッチ機能

すべてカートに入れる: 画面上部の緑色ボタンをクリックすると、お気に入り内の在庫がある商品がワンアクションですべて買い物かごへ投入され、カート画面へ移動します。
値下げバッジ: 追加時の税込価格と現在の税込価格を比較し、値下がりしている場合に「値下げ！」バッジと「追加時: ¥〇〇」の取消線付き価格を表示します。
商品メモ機能: 「メモを追加」をクリックしてテキストを入力し [保存] すると、Ajaxで瞬時にメモが記録されます。
再入荷通知登録: 品切れ中の商品には「再入荷通知を希望」ボタンを表示。会員は1クリックで登録完了、ゲスト客には通知先メールアドレス入力モーダルが開きます。

9. 管理画面・マーケティング活用

9-1. 会員詳細でのお気に入り閲覧 (CS・接客支援)

管理画面 [会員管理] > [会員一覧] > 会員詳細 を開くと、その会員が現在お気に入りに登録している商品リスト（サムネイル画像・規格・現在価格・在庫状況・顧客メモ・登録日時）がカード形式で表示されます。

活用シナリオ

「電話での注文受付やお問い合わせ対応時にお客様が検討している商品を即座に把握」「VIP顧客へのお気に入り商品を絡めたパーソナライズメルマガや個別提案」に絶大な効果を発揮します。

9-2. お気に入り統計・人気ランキング

管理画面 [商品管理] > [お気に入り統計] では、全顧客から最も多くお気に入りに登録されている人気商品のランキング一覧（順位、商品ID、商品名、公開ステータス、登録件数）を集計・閲覧できます。

上位3位は順位バッジでハイライト表示。
商品名をクリックすると直接商品編集画面へジャンプ可能。

9-3. Excel対応 CSVダウンロード

お気に入り統計画面右上の [CSVダウンロード] ボタンをクリックすると、ランキングデータを一括エクスポートできます。

文字化け防止: UTF-8 BOM 付きで出力されるため、日本のWindows Excelでも文字化けせずダブルクリックでそのまま開けます。
出力項目: 順位、商品ID、商品コード、商品名、公開ステータス、販売価格、お気に入り登録数。
仕入れ・セール計画への活用: 「お気に入り数が多いのに売れていない＝価格や納期がネックになっている可能性」を分析し、タイムセールの対象選定や在庫補充計画に役立ちます。

10. 定期クリーンアップ（Cron自動実行）

ゲストのお気に入りデータはCookieおよびDBに保存されます。長期間アクセスのない放置データを定期削除してデータベース容量を最適化するため、コンソールコマンドをサーバーのcronに登録してください。

# デフォルト実行（設定画面の「ゲストデータ保持日数」、または30日以上未更新のデータを削除）
php bin/console eccube:cubewishlist:cleanup

# 日数を明示的に指定して実行（例: 14日以上前のデータを削除）
php bin/console eccube:cubewishlist:cleanup --days=14

Cron設定例（毎日深夜3時に自動実行）

0 3 * * * cd /path/to/eccube && php bin/console eccube:cubewishlist:cleanup >> /dev/null 2>&1

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

独自にカスタマイズしたテーマでもレイアウトは崩れませんか？

はい、崩れません。本プラグインは完全テーマ非依存設計を採用しており、独自のCSSスコープ（.plg-wishlist-*）と自立型レイアウトコンテナを持っています。標準テーマはもちろん、EC-CUBE Storeで購入したサードパーティ製テーマや独自デザインテーマでも影響を受けずに正常動作します。

Font Awesome等の外部アイコンフォントを読み込む必要はありますか？

一切不要です。ハートやカート、SNS、矢印アイコンはすべてプラグイン内部で自己完結したインラインSVGシステムによって描画されます。外部フォントのバージョン違いによるアイコン文字化けや、サイト表示の遅延の心配がありません。

未ログイン時に保存したお気に入りは、ログインしたら消えてしまいますか？

消えません。ゲストユーザーがログインまたは新規会員登録を行った際、プラグインのログインイベントリスナーが作動し、ゲスト用リストの内容を自動的にその会員アカウントへ安全に統合します。重複した商品は自動で名寄せされます。

EC-CUBE標準のお気に入り機能と競合しませんか？

競合しません。本プラグインの有効化と同時に、EC-CUBE標準のお気に入りボタンやヘッダーリンクは自動的に非表示化され、CubeWishlistの高機能なAjaxボタンへと置き換わります。

プラグインのアンインストールコマンドを教えてください。

以下のコマンドで安全に無効化およびアンインストールが可能です:
php bin/console eccube:plugin:disable --code=CubeWishlist
php bin/console eccube:plugin:uninstall --code=CubeWishlist
php bin/console cache:clear --no-warmup