HOME  /Welcart
 /welcart_basic キャンペーン商品リスト関数の作成
2020年09月08日

welcart_basic キャンペーン商品リスト関数の作成


ここではキャンペーン商品設定の方法と、設定された商品リストを表示する関数を作成します。

 

尚、このプログラムは下記の設定が完了している事が前提となります。

商品リストを価格順に並べるカスタマイズ

Jqueryで制御するスライダープラグイン「slick.js」の導入と使い方

総ての「Font Awesome」アイコンフォントを利用可能にする

1.キャンペーン商品とは?

Welcarにはキャンペーンという仕組みが備わっています。

1.キャンペーン期間の設定

「Welcart Shop → 営業日設定」でキャンペーン期間を設定します。

 

2.キャンペーンの対象製品と内容の設定

「Welcart Shop → 基本設定」で対象製品及びキャンペーンの内容を設定します。

■上記はキャンペーン対象カテゴリに「キャンペーン商品」を選択した例です。
これはカテゴリに「スラッグ名:campaign名前:キャンペーン商品」が登録されている為に選択できています。

■キャンペーンは「ポイントUP」又は「価格値引き」が選択できます。

■商品にこのカテゴリを指定するとキャンペーン対象製品となります。

 

2.キャンペーン商品のリスト関数の開発方針

1.関数名と引数

campaign_products($pc_num,$sm_num,$msg)

引数 デフォルト値 備考
$pc_num 5 PC画面の時、1行に表示する商品数
$sm_num 2 スマホ画面の時、1行に表示する商品数
$msg ’キャンペーン商品’ タイトルに付ける名前

 

2.その他の条件

①キャンペーン商品が1行に表示する商品数を超えた場合は「slick.js」でスライドさせる。

よって「slik.js」がインストールされている必要があります。

 

3.この関数を利用する場所

プロントページ、固定ページを原則としますが、個別商品ページやその他のページに配置しても問題ありません。

 

3.プログラム

1.functions.phpに記述する内容

/* 商品リスト関数の追加 */
	get_template_part('func/welcart/item-list/campaign_products');	/* キャンペーン商品 */

■「welcart」の下に「item-list」フォルダを作成し、その中に「campaign_products.php」関数を作成します。

2.campaign_products.phpの中身

<?php 
/*****************************************************************************
キャンペーン商品(campaign)のリスト出力
引数 $pc_num:1行の表示個数(PC)		-デフォルトは5
引数 $sm_num:1行の表示個数(スマホ)	-デフォルトは2
引数 $msg   :タイトル名
*******************************************************************************/
function campaign_products($pc_num=5,$sm_num=2,$msg='キャンペーン商品') {
	global $post, $usces;
	$options	= $usces->options;
	if($options['display_mode'] !== 'Promotionsale'){return;} /* キャンペーン期間外は終了 */	

	$msg = '<i class="fas fa-glass-cheers" style="color:tomato;"></i>'.'&nbsp;'.$msg;		/* リストタイトル */
	$args = array(                                      /* wp_queryのパラメータセット */
  		'posts_per_page' 	=>-1,
	  	'category_name' 	=> 'campaign',
  		'meta_key'       	    => 'price',
  		'orderby'   			=> 'meta_value_num',
  		'order'     			    => 'asc',
  		
  	);
	$products = new WP_Query( $args );
?>

<h3><?php echo $msg;?></h3>
<div class="my_campaign">                    /* 商品リスト */
	<?php while ($products->have_posts()) : $products->the_post(); ?>
		<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
			<div class="itemimg">
				<a href="<?php the_permalink() ?>"><?php usces_the_itemImage(0, 150, 150); ?></a>
				<?php welcart_basic_campaign_message(); ?>
			</div>
			<div class="itemprice"><?php usces_the_firstPriceCr(); usces_guid_tax(); ?></div>
			<?php if(! usces_have_zaiko_anyone() ) : ?>
				<div class="itemsoldout"><?php _e('Sold Out', 'usces' ); ?></div>
			<?php endif; ?>
				<div class="itemname"><a href="<?php the_permalink() ?>"  rel="bookmark"><?php usces_the_itemName(); ?></a></div>
		</article>
	<?php endwhile; ?>
</div>

<style>		/* CSSの出力 */
	.my_campaign article{padding:10px;}
	.my_campaign .itemimg img {
		width: 100%;
		height: auto;
	}
	@media screen and (max-width:768px){.my_campaign{margin:0 20px;max-width:100%;}}
	.slick-prev:before,
	.slick-next:before{color:'#000';}
	.slick-track{margin-left:0;}	
</style>

<?php echo <<<EOM
<script>										/* Jqueryの出力 */
	$(function(){
  	$('.my_campaign').slick({
    	arrows:true,					/* 左右矢印を表示 */
    	dots:false, 					/* ドットは非表示 */
    	infinite:false,				    /* 無限ループ機能はOFF */
    	slidesToShow:$pc_num,	/* 1行の表示個数(PC) */
    	slidesToScroll:1,			    /* スクロール個数 */
    	swipeToSlide:true,		    /* スワイプはslidesToScroll値に影響を受けない */
    	responsive:[{
     		breakpoint:768,settings:{slidesToShow:$sm_num,}/* 1行の表示個数(スマホ) */
    	}]
  	});
	});
</script>
EOM;?>

<?php
 wp_reset_postdata();	/* WP_Queryのリセット */
}									/* functionの終了 */
?>

アイコンフォントは「fas fa-glass-cheers」を利用しています。
総ての「Font Awesome」アイコンフォントを利用可能にするの設定をして下さい。

wp_query」のパラメータは左記リンク先の解説を参照してください。

尚、価格順の表示方法は商品リストを価格順に並べるカスタマイズを実行して下さい。

商品の表示部分はwelcart_basicの商品表示プログラムを「wp_query」用に少し変更しました。

「slick.js」の設定は、プログラムで変更する必要がある為、phpプログラムで書きました。
<<<EOMはヒアドキュメントと言われる物で、何行にも渡る長い文章を出力する方法です。次のEOMまでが1つのドキュメントになります。

wp_reset_postdata()」は、Wp_Queryのリセット関数で必須です。

以上でこのドキュメントの説明は完了です。

関連ドキュメントは下記の関連記事一覧から探して下さい。


<関連記事一覧>

「wecart」に関連するドキュメントを表示しています。尚、このページネーションはJquryで制御しています。

Welcartには、カートを空にするクラス関数が用意されています。ここでは、この関数の使い方を解説しています。

Welcartの商品一覧ページに購入ボタンを配置する為には「usces_direct_intoCart」を利用しますが、この関数は必須オプションのチェックは行ってくれません。それをうまく行える方法を解説しています。

welcartで用意されているカート投入ボタンはwhile(usces_have_skus())ループの中でしか使えません。しかしforeachの方がカウンター処理がしやすいのでこれが使えるカート投入ボタンを作成しました。

welcartの購入数量指定はテキスト入力です。これをボタンで数値入力ができる様にしました

welcartの中ではどれ位のポイントが付与されるのか?どれ位の金額が値引きされるか?の表示がありません。そこでこれを表示する関数を作成しました。

welcartで用意されているSKU価格の表示関数はwhile(usces_have_skus())ループの中でしか使えません。しかしforeachの方がカウンター処理がしやすいのでこれが使えるSKU価格の表示関数を作成しました。

Welcart_basicテーマは、SKUが複数あると縦にダラダラと長く表示される問題点があります。そこでSKUを分解し、どのSKUを表示するのか?をラジオボタンやセレクトBOXで選択できる様にカスタマイズします。

welcartで用意されている業務パックデータの表示関数はwhile(usces_have_skus())ループの中でしか使えません。しかしforeachの方がカウンター処理がしやすいのでこれが使える業務パックデータの表示関数を作成しました。

Welcartでは業務パック割引(購入数量割引)という機能があります。この機能を使うとカートページにGPマークが表示させますがこのマークを任意のアイコンに変更する方法を解説しています。

カートに商品を投入すると、商品名は①商品名②商品コード③SKU名④SKUコードを合わせた文字列が商品名として表示されます。これをカスタマイズする方法を解説しています。

Welcartのカートへの投入ボタンのプログラム解説と、色と文字を変更する新しい関数の作成方法を解説しています。

welcart_basicのオプション表示は、入力必須をチェックしてもユーザから見て判りません。またチェックボックスやラジオボタン表示に一部、おかしい所があります。ここではこれらの修正方法を解説しています。

Welcartにはポイントを付与し、商品購入時にそのポイントを利用する仕組みがあります。又キャンペーン設定でポイントをn倍にしたり価格を値引く仕組みもあります。ここではそれらの概要と問題点及び解決策を解説しています。

Welcartでは業務パック割引(購入数量割引)という機能があります。これは、指定した数量以上を購入した場合に価格を値引く仕組みですが、業務パック割引という言葉はあまりなじみがないのでこのメッセージを変更する方法を解説しています。

Welcart_Basicの購入数量は数値入力です。しかしスマホではこのような入力方法は面倒なので+/-ボタンで購入数量が変更できる様に変更した事例を紹介しています。

Welcartでは個別商品画面に商品オプションやカスタムフィールドを追加する事ができます。ここではその追加方法を解説しています。

Welcartで個別商品表示画面から、商品マスタ編集にジャンプする事ができるとコンテンツ編集効率が飛躍的に向上します。しかしWelcartではこの機能が提供されていないのでこれを可能になる関数を作成します。

ここではWelcart商品を価格順に並び替える為に、WordpressのメタデータにWelcartの価格データを自動的に登録する関数の作成方法を解説しています。

ここではWelcartの商品カテゴリを指定して商品リストする関数を作成しています。全商品、おすすめ商品、新製品及び商品カテゴリが対象となります。

ここでは売れている商品をWelcartのDBから読み出して「売れ筋商品」としてリストする関数を作成する方法を解説しています。

Welcartには関連商品という概念はありません。そこで個別商品を表示した時に、その商品と同じカテゴリの商品を「関連商品リスト」として表示する関数を作成する方法を解説します。

Welcart_basicのメニュをカスタマイズする為にはどの様な仕組みで作られているか?を知る必要があります。そこでここではメニュの仕様を解説しています。

ここではWelcart_basicのカートボタンの「色」と「文字」を変更する関数の作成方法を解説しています。

カートボタンをカスタマイズする為には、このカートがどの様に作られているのか?を知る必要があります。そこでここではその仕様について解説しています。

Welcartで会員システムを使うのであれば、ログイン後の画面に現在使えるポイント数が表示されているのが親切です。そこでここではwelcart_bascで保有ポイントが表示されるようにカスタマイズしたサンプルを解説しています。

welcart_basicの会員システムをカスタマイズする為には、この機能がどの様に作られているか?を知る必要があります。
そこでこのでは会員システムの仕組みについて解説しています。

Welcart_basicの検索機能をカスタマイズする為には、これがどの様に作られているのか?を知る必要があります。ここではその仕様を解説しています。

welcart_basicは商品だけしか検索対象としていませんが、ここではページの情報を読み込んで、カテゴリ別に検索できる様にカスタマイズする方法を解説しています。

ここでは「welcart_basic」の「category.php」がブログ用のサイドーバーが使われてない問題点を修正方法を説明しています。また「welcart_basic」がどの様な構造になっているか?も併せて解説しています。

ここではwelcartの.検索機能制限の解除、カテゴリが製品か否かの判断関数、上位カテゴリの取得関数、.商品カテゴリの取得関数の作成方法を解説しています。

ここではWelcartで用意されている関数を解説しています。

Welcartのファンクションはfunctions.phpからincフォルダにあるファンクションをインクルードしています。この辺の構造を商品表示の設定例で解説しています。

Welcartのホームページと事前に作られている固有のページを解説してます。特にカートページやメンバーページ及びお問い合わせフォームの作り方も解説しています。

WelcartはWordPressの「固定ページ」と「投稿ページ」のみで作られております。この「投稿ページ」の中に「商品」が設定されています。そこで検索機能はファンクションの中で、商品のみを検索する様な設定が定義されている為、そのままではブログ等を検索できません。

ここではWelcartの商品画像を「slick」でスライドさせる方法を解説しています。スライド方法は下記の2つを解説しています。①.slickオプションだけでスライドさせる。②slickイベントやメソッドを使ってスライドさせる。

welcart_basicのカスタマイズ→ヘッダ画像で設定したヘッダ画像を「slick」で自動スライドさせる方法を解説しています。

「slick.js」はjqueryでスライド動作を指定するプラグインです。ここでは「slick.js」のインストールから、設定方法及び「slick.js」のオプションを解説しています。またslickのメソッドやイベントの使い方の説明しています。

ここでは「Welcart basic」の子テーマの作成方法を解説しています。

Welcartの商品画像適用ルールと「Media Library Assistant」による画像管理、及び商品画像の登録方法を解説しています。

Welcartで商品登録を行う前に.Welcart Shopの「基本設定」、「配送設定」及び「.商品カテゴリ」の登録が必要で、ここではその登録方法を解説しています。

ここではWelCartの商品の登録の仕方を解説しています。

WelcartはWordPressを使った無償のe-Commerceシステムです。ここでは「Welcart」の「インストール」と無償テンプレート「Welcart_basic」について解説します。

ここでは「Welcart_Basic」の「メニュ」や「ウィジェット」及び「ヘッダ画像」の使い方を解説します。