お気に入りプラグイン

WCEX Favorites
導入マニュアル

作成日：2021年10月20日
更新日：2022年2月7日
コルネ株式会社

WCEX Favorites

目次
目次

1

改版履歴

2

はじめに

3

このプラグインでできること

3

ご利用上の注意点

3

ライセンス

3

著作権

3

免責

3

サポート

3

テーマの対応について
設定方法

4
5

プラグインの有効化

5お気に入り設定

6

ウィジェット：みんなのお気に入り商品

10

フロントでの運用方法

11お気に入りリストへの追加・削除

11

お気に入りリストの表示

11

Welcart 公式テーマ以外での対応について

13

1. CSS ファイルを設置する

13

2. 商品詳細ページに「お気に入りボタン」を追加する

13

3. 商品詳細ページに「アイコン」を追加する

14

4. 商品一覧ページに「アイコン」を追加する

15

5. お気に入りリストページを設置する

15

6. お気に入り一覧ページへのリンクを設置する

16

よくある質問18

1
Copyright © 2021 Collne Inc.

WCEX Favorites

更新履歴公開「Welcart 公式テーマ以外での対応について」を追加

2021.10.20
1.0.1

2022.02.07

2
Copyright © 2021 Collne Inc.

WCEX Favorites

はじめに
このプラグインでできること
このプラグインは、会員がお買い物中、気に入った商品を「お気に入りリスト」に追加（登録）できるものです。
お気に入り登録した商品は、マイページの「お気に入りリスト」で確認することができ、商品価格・商品名などリアルタイムに反映されます。データベースに保存するためログアウトしても、お気に入りリストに登録した商品が消失する心配がありません。
「みんなのお気に入り商品」ウィジェットを設定することにより、サイト内にランキングを表示することができます。
※WelcartShop 基本設定 ＞ 会員システム「利用する」に設定しているサイトでのみご利用可能です。会員システム「利用しない」に設定しているサイトでは本プラグインの機能はご利用できません。

ご利用上の注意点
ライセンス
このプラグインのライセンスは GPL となっております。営利・非営利問わずご利用いただけますが、このパッケージ自体をそのまま再販することはできません。
また、正規に購入していただいた方のみがアップデートを行うことができます。詳しくは「拡張プラグイン・テーマのご利用条件」をご覧ください。

著作権
著作権は、コルネ株式会社に帰属します。

免責
このプラグインを利用して起こったいかなる損害も補償は致しかねます。
ご利用に際しましては使い方、注意事項をよくご確認ください。
またカスタマイズを行う場合は、脆弱性を十分に考慮して行なわれますようご注意ください。

サポート
このプラグインについてのご不明な点は、「開発フォーラム - 拡張プラグイン - 」にてご質問ください。
ご希望の機能が付いているか、またどの程度カスタマイズできるかなどお確かめの上、十分に納得されてからご購入くださいますようお願いいたします。
この商品のサポートについては、サポートポリシーをご覧ください。
3
Copyright © 2021 Collne Inc.

WCEX Favorites

テーマの対応について
Welcart 公式テーマでは、下記のバージョン以降でお気に入りプラグインに対応しています。
お気に入りプラグインを有効化する際は、ご利用中の Welcart 公式テーマがお気に入りプラグインに対応しているバージョンかどうかご確認ください。

テーマ名

バージョン

Welcart Mode

1.1 以降Welcart Panetteria

1.2 以降Welcart Basic

1.4 以降Welcart Beldad

1.1 以降Welcart VOLL

1.1 以降Welcart Carina

1.1 以降Welcart Square

1.1 以降Welcart Nova

1.2 以降Welcart Bordeaux

1.2 以降上記以外の Welcart 公式テーマで、お気に入りプラグインの公開後にリリースされる Welcart 公式テーマについては、リリースされた時点でお気に入りプラグインに対応しています。
Welcart 公式テーマ以外または独自でカスタマイズされている場合は、テーマの編集が必要となります。
こちらからご確認ください。

4
Copyright © 2021 Collne Inc.

WCEX Favorites

設定方法
プラグインの有効化
WordPress 管理画面 [ プラグイン ] > [ 新規追加 ] に移動してください。
プラグインを追加の横の「プラグインのアップロード」をクリックしてください。

zip 形式のプラグインファイルをインストールできる画面が表示されます。
ダウンロードしてきた zip ファイルを選択して「今すぐインストール」をクリックしてください。

インストールが完了したら「プラグインを有効化」ボタンをクリックして有効化してください。

5
Copyright © 2021 Collne Inc.

WCEX Favorites

お気に入り設定WordPress 管理画面 [ Welcart Shop ] > [ お気に入り設定 ] に移動します。

●「お気に入り」ラベル
お気に入りラベルを変更できます。
フロントでの表示が全てここで指定したラベルに変更されます。
初期値：お気に入り

6
Copyright © 2021 Collne Inc.

WCEX Favorites●

お気に入りリストのテンプレートパス
有効化されているテーマ配下に「/wc_templates/member/wc_favorite_page.php」が存在しない場
合、ここで指定したテンプレートが適用されます。初期値は「WCEX Favorites」の中にある「お気に入りリスト」ページのテンプレートのディレクトリパスが設定されています。
お気に入りプラグイン対応バージョンの Welcart公式テーマ をご利用の場合は、既にテーマ内に「/wc_templates/member/wc_favorite_page.php」が存在しているため、特に設定しなくても問題ありません。ご利用中の Welcart 公式テーマ がお気に入りプラグインに対応しているかどうかはこちらからご確認ください。
設定を戻したい場合には空白にし「変更を保存」すると初期値が入ります。
初期値：[ サイトのルートパス ]/wp-content/plugins/wcex_favorites/templates/wc_favorite_page.php●

CSS ファイルパス
有効化されているテーマ配下に「/assets/css/favorite.css」が存在しない場合、ここで指定したスタイルシートが適用されます。初期値は「WCEX Favorites」の中にあるスタイルシートの URL が設定されています。
お気に入りプラグイン対応バージョンの Welcart 公式テーマをご利用の場合は、既にテーマ内に「/assets/css/favorite.css」が存在しているため、特に設定しなくても問題ありません。ご利用中のWelcart 公式テーマ がお気に入りプラグインに対応しているかどうかはこちらからご確認ください。
設定を戻したい場合には空白にし「変更を保存」すると初期値が入ります。
初期値：[ WordPress アドレス (URL) ]/wp-content/plugins/wcex_favorites/assets/css/favorite.css●

登録済アイコン
商品画像の右下に表示されるアイコンを指定することができます。初期値は、「WCEX Favorites」の中にある画像 URL が入力されています。
初期値：[ WordPress アドレス (URL) ]/wp-content/plugins/wcex_favorites/assets/images/icon/favorite.svg●

未登録アイコン
商品画像の右下に表示されるアイコンを指定することができます。初期値は、「WCEX Favorites」の中にある画像 URL が入力されています。
初期値：[ WordPress アドレス (URL)]/wp-content/plugins/wcex_favorites/assets/images/icon/not-favorite.svg●

商品詳細ページのお気に入り追加
商品詳細ページのお気に入り追加の表示を指定することができます。
初期値：ボタンで追加

7
Copyright © 2021 Collne Inc.

WCEX Favorites「ボタンで追加」の表示 ※「カートに入れる」の下にボタンが表示されます。

すでに「お気に入りに追加」されていると「お気に入りから削除」と表示されます。

8
Copyright © 2021 Collne Inc.

WCEX Favorites「アイコンで追加」の表示 ※商品画像の右下にアイコンが表示されます。

9
Copyright © 2021 Collne Inc.

WCEX Favorites

ウィジェット：みんなのお気に入り商品
お気に入り登録されている商品のランキングをウィジェットで表示させることができます。
ウィジェットの設定方法についてはこちらをご覧ください。
【 フロント表示 】

10
Copyright © 2021 Collne Inc.

WCEX Favorites

フロントでの運用方法
お気に入りリストへの追加・削除
お気に入りリストに追加するには、会員ログインが必須となります。
ログインしていない場合にはお気に入りボタン（アイコン）は表示されません。

お気に入りリストの表示
会員のマイページより「お気に入りリスト」を確認できます。
お気に入りプラグイン対応バージョンの Welcart 公式テーマ をご利用の場合は、トップページのヘッダー部分からも「お気に入りリスト」を確認できます。
なお、お気に入りプラグインに対応していないテーマをお使いの場合は、レイアウトの修正が必要になる場合があります。修正内容については、こちらからご確認ください。

【 マイページ 】【 トップページのヘッダー 】※お気に入りプラグイン対応バージョンの Welcart 公式テーマのみ

11
Copyright © 2021 Collne Inc.

WCEX Favorites【 お気に入りリスト 】「お気に入りリスト」内でアイコンをクリックするとお気に入りから削除されます。

12
Copyright © 2021 Collne Inc.

WCEX FavoritesWelcart 公式テーマ以外での対応について
Welcart 公式テーマ以外でお気に入りプラグインを利用する場合は、下記いずれかの修正が必要となります。
1.
2.
3.
4.
5.
6.

お気に入りプラグイン専用の CSS ファイルを設置する
商品詳細ページに「お気に入りボタン」を追加する
商品詳細ページに「アイコン」を追加する商品一覧ページに「アイコン」を追加する
お気に入りリストページを設置する
お気に入り一覧ページへのリンクを設置する

1. CSS ファイルを設置する利用されているテーマによってマークアップが異なるため、CSS での調整は必ず必要となります。
お気に入りプラグイン専用の CSS ファイルを読み込む場合には、テーマ内に専用の CSS ファイルを設置して「設定方法 - CSS ファイルパス 」より設定してください。
※ ご利用になられているテーマ配下に ’/assets/css/favorite.css’ が存在する場合は、「設定方法 - CSS
ファイルパス 」で設定した CSS ファイルは読み込まれませんのでご注意ください。

2. 商品詳細ページに「お気に入りボタン」を追加する
商品詳細ページのお気に入り追加設定を「ボタンで追加」で指定している場合、商品詳細ページテンプレートに以下のフックがないと「お気に入りボタン」が表示されません。
「お気に入りボタン」が表示されない場合には、商品詳細ページテンプレートに以下のフックを追加してください。

<?php do_action( 'usces_action_single_item_outform' ); ?>実際に、wc_item_single.php にフックを書き足したコードの例です。
このコードは、最新版の Welcart Basic テーマ内の wc_item_single.php です。
wc_item_single.php 127行目あたり<div class="item-info">・・
13
Copyright © 2021 Collne Inc.

WCEX Favorites<form action="<?php echo USCES_CART_URL(); ?>" method="post">
・・<div class="item-info">・・<div class="error_message"><?phpusces_singleitem_error_message( $post->ID, usces_the_itemSku( 'return' ) );?></div></div><!-- .skuform --><?php } while ( usces_have_skus() ); ?><?php do_action( 'usces_action_single_item_inform' ); ?></form><?php do_action( 'usces_action_single_item_outform' ); ?></div><!-- .item-info --><?php usces_assistance_item( $post->ID, __('An article concerned', 'usces') );?>3. 商品詳細ページに「アイコン」を追加する
商品詳細ページのお気に入り追加設定を「アイコンで追加」で指定している場合、商品詳細ページテンプレートに以下のフックがないと「アイコン」が表示されません。
商品詳細ページテンプレートに以下のフックを追加してください。

<?php do_action( 'usces_theme_favorite_icon' ); ?>実際に、wc_item_single.php にフックを書き足したコードの例です。
このコードは、最新版の Welcart Basic テーマ内の wc_item_single.php です。
wc_item_single.php 36行目あたり<div class="itemimg"><a href="<?php usces_the_itemImageURL( 0 ); ?>" <?php echo
apply_filters( 'usces_itemimg_anchor_rel', null ); ?>><?phpusces_the_itemImage( 0, 335, 335, $post ); ?></a><?php do_action( 'usces_theme_favorite_icon' ); ?></div><?php$imageid = usces_get_itemSubImageNums();
14
Copyright © 2021 Collne Inc.

WCEX Favorites
if ( ! empty( $imageid ) ) :※ フックの設置場所に指定はありませんが、SKU 単位でお気に入り登録をすることはできませんので、商品 SKU がループされているような場所では使用しないでください。
※ Welcart Basic では、CSS で商品画像の上にアイコンを設置するよう調整しております。うまく表示されない場合には CSS で調整をおこなってください。

4. 商品一覧ページに「アイコン」を追加する商品一覧ページにアイコンを表示させる場合は、以下のフックを追加してください。

<?php do_action( 'usces_theme_favorite_icon' ); ?>実際に、category.php にフックを書き足したコードの例です。
このコードは、最新版の Welcart Basic テーマ内の category.php です。
category.php 19行目あたり<div class="cat-il type-grid"><?php while ( have_posts() ) : the_post(); ?><article id="post-<?php the_ID(); ?>" <?php post_class(); ?>><div class="itemimg"><a href="<?php the_permalink() ?>"><?php usces_the_itemImage( 0, 300, 300 ); ?><?php do_action( 'usces_theme_favorite_icon' ); ?></a>※ while( have_posts() ) のループ内で使用してください。ループ内であれば設置場所に指定はありません。商品名の下や価格の下などに設置してください。
※ Welcart Basic では、CSS で商品画像の上にアイコンを設置するよう調整しています。うまく表示されない場合は CSS で調整を行ってください。

5. お気に入りリストページを設置する
デフォルトで表示される「お気に入り一覧ページ」用のテンプレートは、Welcart Basic に合わせたマークアップとなっています。

15Copyright © 2021 Collne Inc.

WCEX Favorites
ご利用になられているテーマにマークアップを合わせる場合には、下記の手順に沿って設置・調整作業をおこなってください。
1. プラグイン内に同梱されている「wc_favorite_page.php」をコピーしてください。

※ wc_favorite_page.php は、プラグインの「templates」フォルダ内に同梱されております。
2. コピーしたテンプレートをご利用になられているテーマ内に設置してください。
3. 「設定方法 - お気に入りリストのテンプレートパス 」を参考にテーマ内に設置したテンプレートの読み込み指定をおこなってください。
※ ご利用になられているテーマ配下に ’/wc_templates/member/wc_favorite_page.php’ が存在する場合は、「設定方法 - お気に入りリストのテンプレートパス 」で指定したテンプレートは読み込まれませんのでご注意ください。
4. 「お気に入りリストのテンプレートパス」の設定完了後に、「wc_favorite_page.php」のマークアップ変更や CSS でのスタイル調整をおこなってください。

6. お気に入り一覧ページへのリンクを設置する
Welcart Basic では、会員がログインしている場合にヘッダーメニューにお気に入り一覧ページへのリンクを表示させています。
メンバーメニューの表示

16
Copyright © 2021 Collne Inc.

WCEX Favorites
以下のフックを追加することでお気に入り一覧ページへのリンクを表示することができます。

<?php do_action( 'usces_theme_login_menu' ); ?>実際に、Welcart Basic にフックを書き足したコードの例です。
header.php 44行目あたり<?php do_action( 'usces_theme_action_membersystem_before' ); ?><?php if ( usces_is_login() ): // 会員がログインしている時 ?><li><?php printf( __( 'Hello %s', 'usces' ), usces_the_member_name('return' ) ); ?></li><li><a href="<?php echo USCES_MEMBER_URL; ?>"><?php _e( 'My page','welcart_basic' ) ?></a></li><?php do_action( 'usces_theme_login_menu' ); ?><li><?php usces_loginout(); ?></li><?php else : // ログインしていない時 ?><li><?php _e( 'guest', 'usces' ); ?></li>※ 「会員がログインしている時」の条件の中にフックを追加してください。

17
Copyright © 2021 Collne Inc.WCEX Favorites

よくある質問Q. 最新版の情報はどこで確認すればよいですか？
A. 「WCEX Favorites」 がアップデートされた場合は、Welcart.com の「リリース情報」にてご案内いたしております。

Q. SKU 単位でのお気に入り登録はできますか？
A. お気に入り登録できるのは、商品単位となります。SKU 単位での登録はできません。

Q. お気に入りの登録数を管理画面で確認できますか？
A. 個別カスタマイズが必要となります。

Q. Welcart 公式テーマを使っているのにお気に入りアイコンが表示されません。
A. ご利用中の Welcart 公式テーマのバージョンがお気に入りプラグインに対応していない可能性があります。各テーマの対応バージョンはこちらからご確認ください。

Q. Welcart 公式テーマ以外を利用しているが、テンプレート・CSS の修正方法が分からない。
A. 「Welcart 公式テーマ以外での対応方法について」をご確認ください。
ご自身での作業が難しい場合は、WelCustom よりご依頼ください。別途お見積りさせていただきます。

Q. 「Welcart 公式テーマ以外での対応方法について」を参考にお気に入りアイコンのフックを追加してみましたが、会員ログインしている状態でもアイコン画像が表示されません。
B. 設置する場所によっては、アイコン画像（<img>タグ）に 「 幅（width）」と「高さ（height）」の指定が必要になる場合があります。
下記を参考に、 CSS で アイコン画像に「幅」と「高さ」を指定してください。
.favorite-icon img{
width: 30px;
height: auto;}18
Copyright © 2021 Collne Inc.