# おすすめ商品管理プラグイン

[![CI for Recommend4](https://github.com/EC-CUBE/Recommend-plugin/actions/workflows/main.yml/badge.svg)](https://github.com/EC-CUBE/Recommend-plugin/actions/workflows/main.yml)

## 概要
サイトにおすすめ商品の一覧を追加することのできるプラグイン。  
[http://www.ec-cube.net/products/detail.php?product_id=1067](http://www.ec-cube.net/products/detail.php?product_id=1067)  


----------------------------------------------------------------------
## フロント画面
### F1:おすすめ商品一覧から、商品詳細ページにアクセスすることができる。
- F1-1:おすすめ商品一覧を表示する。
	- おすすめ商品ブロックを配置した場所に表示する。
	- 写真/商品名/価格/説明文を表示する。
	- 非公開商品は、おすすめ商品リストに表示されないように制御する。

- F1-2:おすすめ商品一覧の商品をクリックすると、その商品の詳細ページに移動することができる。
	- 商品詳細ページにリンクを張る。

----------------------------------------------------------------------
## 管理画面
### A1:おすすめ商品管理ページで、おすすめ商品を登録/解除することができる。
- A1-1:おすすめ商品の一覧を確認することができる。
	- メニューバーのカテゴリ管理から、おすすめ商品管理ページにアクセスできる。
	- おすすめ商品として登録されている商品の一覧を表示する。

- A1-2:おすすめ商品の一覧に、商品を登録することができる。
	- [おすすめ商品を新規登録]ボタンを押すと、おすすめ商品情報の編集ページにアクセスできる。
	- 商品の選択には、商品検索ダイアログを利用する。

- A1-3:おすすめ商品ごとに、説明文を書くことができる。
	- 商品の選択と同時に、説明文の入力ができるフォームを表示する。
	- 説明文は必ず入力しなければならない。
	- HTMLタグを利用することができる。

- A1-4:おすすめ商品情報を編集することができる。
	- おすすめ商品一覧ページに、[編集]ボタンを用意する。
	- [編集]ボタンを押すと、おすすめ商品の情報入力ページにを遷移し、情報を更新することができる。

- A1-5:おすすめ商品の一覧から、商品の登録を解除することができる。
	- おすすめ商品一覧ページに、[削除]ボタンを用意する。
	- [削除]ボタンを押すと、確認の後に、おすすめ商品の登録を削除することができる。

- A1-6:おすすめ商品の並び順を変更することができる。
	- おすすめ商品一覧ページの各行を、ドラッグ＆ドロップで移動できるようにする。
	- この並び順が、フロントに表示するときの並び順になる。

- A1-7:非公開の商品も、おすすめ商品として登録しておくことができる。
	- おすすめ商品登録時の商品検索ダイアログで、非公開の商品も検索の対象にする。

### A2:おすすめ商品一覧の表示を、ブロックとしてカスタマイズすることができる。
- A2-1:レイアウト編集画面で、おすすめ商品ブロックの表示位置を変更することができる。
	- 既存ブロックと同じように、レイアウト編集画面で[おすすめ商品ブロック]を利用することができる。
	- 全ページ適用もすることができる。
	- プラグインインストール時に、[おすすめ商品]ブロックを#main_buttomに配置しておく。

- A2-2:ブロック編集画面で、おすすめ商品ブロックの内容を変更することができる。
	- 既存ブロックと同じように、ブロック編集画面でブロック内容(twig)を編集することがでる。
	- おすすめ商品ブロックを削除することはできない。

