first

firstは、現在実行中の foreach構造の実行開始時に式を実行します。たとえば次の式では最初に「<br />タグ」を２つ挿入します。

<!--{foreach "$field"}-->
  <!--{first}--><br /><br /><!--{/first}-->
  <!--{$title}-->
  <!--{$description}-->
<!--{/foreach}-->

!first

!firstは、現在実行中の foreach構造の実行開始時以外に式を実行します。たとえば次の式では$descriptionの前に「/」を挿入し、最初にはなにも挿入しません

<!--{foreach "$field"}-->
  <!--{!first}-->/<!--{/!first}-->
  <!--{$title}-->
  <!--{$description}-->
<!--{/foreach}-->

date_format

日付・時刻を書式化する

<!--{if "$malldata['rakuten_release']" != ""}-->
  <!--{$malldata['rakuten_release']|date_format:"Y/m/d"}-->
<!--{/if}-->

dateフォーマット文字一覧

フォーマット文字	説明
a	午前／午後（am または pm）
A	午前／午後（AM または PM）
B	インターネット時間（000 ～ 999）
d	2桁で示す日付（01 ～ 31）
D	3文字の曜日（Sun ～ Sat）
F	フルスペルの月（January ～ December）
g	先頭に 0 をつけない12時間単位の時間（1 ～ 12）
G	先頭に 0 をつけない24時間単位の時間（0 ～ 23）
h	2桁で示す12時間単位の時間（01 ～ 12）
H	2桁で示す24時間単位の時間（00 ～ 23）
i	2桁の分（00 ～ 59）
I	サマータイム中かどうかのフラグ（1 または 0）
j	先頭に 0 をつけない日付（1 ～ 31）
l	フルスペルの曜日（Sunday ～ Saturday）
L	閏年かどうかのフラグ（1 または 0）
m	2桁で示す月（01 ～ 12）
M	3文字で表す月（Jan ～ Dec）
n	先頭に 0 をつけない月（1 ～ 12）
O	グリニッジ標準時（GMT）との時間差（+0900 など）
r	RFC822に定義されている日付形式（Thu, 21 Dec 2000 16:01:07 +0900 など）
s	2桁で示す秒（00 ～ 59）
S	2文字で表す英語形式の序数を表すサフィックス（st, nd, rd または th）
t	指定した月の日数（28 ～ 31）
T	ローカルマシーンのタイムゾーンの設定
U	Unix時間（Unixタイムスタンプ：time（）の値と同じ）
w	数値で示す曜日（0：日 ～ 6：土）
W	ISO-8601 月曜日に始まる年単位の週番号（42：1年の第42週目）
y	西暦を2桁を示す年
Y	西暦を4桁で示す年
z	年間の通算日― 1月1日からの通算日数（0 ～ 366）
Z	タイムゾーンのオフセット秒数（-43200 ～ 43200）

変数の修飾子

変数の修飾子は、 変数を修飾して出力することができます。修飾子を適用するには、 変数名の後に | (パイプ) と修飾子の名前を指定します。 また、修飾子はその動作に影響を及ぼす追加のパラメータを受け入れる場合もあります。 そのパラメータは修飾子の後に続き、: (コロン) によって区切られます。 また、修飾子は 組み合わせる こともできます。

変数の修飾子一覧

変数の修飾子の一覧は以下のとおりです。

例	名前	結果
<!--{$price|ceil}-->	少数点切り上げ	$priceの少数点第一を切り上げ
<!--{$price|floor}-->	小数点切り捨て	$priceの少数点第一を切り捨て
<!--{$price|round}-->	少数点四捨五入	$priceの少数点第一を四捨五入
<!--{$price|number_format}-->	カンマ付加	数字に千位毎にカンマをつける（金額などで使用）
<!--{$item_name|strip_tags}-->	タグを除去	HTMLタグを除去します。不完全または壊れたタグにより予想以上に多くのデータが削除される可能性があります。
<!--{$item_name|strip_tags:br}-->	<br>以外のタグを除去	<br>以外のHTMLタグを除去します。不完全または壊れたタグにより予想以上に多くのデータが削除される可能性があります。
<!--{$item_name|strip_tags:br,i}-->	<br>,<i>以外のタグを除去	<br>,<i>以外のHTMLタグを除去します。不完全または壊れたタグにより予想以上に多くのデータが削除される可能性があります。
<!--{$item_name|mb_strimwidth:0:30}-->	文字列トリミング	文字列を0-30文字でトリミングする。トリミングされた場合に「…」という文字が付加されます。
<!--{$item_name|str_replace:○○}-->	文字列削除	○○という文字を削除する。 ※修飾子内の一部文字は無視されてしまうため、半角スペースを使用したい場合は「&nbsp;」カンマを使用したい場合は「&#x2c;」パイプを使用したい場合は「&#x7c;」コロンを使用したい場合は「&#x3a;」と記述する
<!--{$item_name|str_replace:○○:△△}-->	文字列置換	○○という文字を△△に置換する ※修飾子内の一部文字は無視されてしまうため、半角スペースを使用したい場合は「&nbsp;」カンマを使用したい場合は「&#x2c;」パイプを使用したい場合は「&#x7c;」コロンを使用したい場合は「&#x3a;」と記述する
<!--{$item_name|str_replace:○○,□□}-->	文字列削除	○○、□□という文字を削除する。 ※修飾子内の一部文字は無視されてしまうため、半角スペースを使用したい場合は「&nbsp;」カンマを使用したい場合は「&#x2c;」パイプを使用したい場合は「&#x7c;」コロンを使用したい場合は「&#x3a;」と記述する
<!--{$item_name|str_replace:○○,□□:△△}-->	文字列置換	○○、□□という文字を△△に置換する ※修飾子内の一部文字は無視されてしまうため、半角スペースを使用したい場合は「&nbsp;」カンマを使用したい場合は「&#x2c;」パイプを使用したい場合は「&#x7c;」コロンを使用したい場合は「&#x3a;」と記述する
<!--{$item_name|str_replace:○○,□□:△△,■■}-->	文字列置換	○○という文字を△△に、□□という文字を■■に置換する ※修飾子内の一部文字は無視されてしまうため、半角スペースを使用したい場合は「&nbsp;」カンマを使用したい場合は「&#x2c;」パイプを使用したい場合は「&#x7c;」コロンを使用したい場合は「&#x3a;」と記述する
<!--{$item_name|urlencode:EUC-JP}-->	パーセントエンコード（URLエンコード）	$item_nameをEUC-JPにパーセントエンコードする、他は「Shift-JIS」に対応しており、それ以外の記述をした場合には「UTF-8」になります、この他の文字コードをご希望の場合は弊社までお問い合わせ下さい。
<!--{$date|date_format:”Y-m-d”}-->	デートフォーマット	$dateをY-m-dの形式に変換します、フォーマットに関してはdateフォーマット一覧をご確認ください。※注意）$dateが空の場合は「1970-01-01」が返却されてしまうため、ifなどで$dateが空の場合は本処理を行わないなどの分岐をしてください。
<!--{$textarea|nl2tag:<li>:</li>}-->	改行をタグで囲む	改行された文字列をタグで囲みます「あああ[改行]いいい[改行]ううう」→「<li>あああ</li><li>いいい</li><li>ううう</li>」

end

endは、現在実行中の foreach構造の実行終了時に式を実行します。たとえば次の式では最後に「<br />タグ」を２つ挿入します。

<!--{foreach "$field"}-->
  <!--{$title}-->
  <!--{$description}-->
  <!--{end}--><br /><br /><!--{/end}-->
<!--{/foreach}-->

!end

!endは、現在実行中の foreach構造の実行終了以外に式を実行します。たとえば次の式では$descriptionの後に「/」を挿入し、最後にはなにも挿入しません

<!--{foreach "$field"}-->
  <!--{$title}-->
  <!--{$description}-->
  <!--{!end}-->/<!--{/!end}-->
<!--{/foreach}-->

foreach

foreach は、配列を反復処理するための便利な方法です。 foreach が使えるのは配列であり、別のデータ型に使うとエラーになります。

「$field（商品情報）」をforeachで反復処理する例

<!--{foreach "$field"}-->
  <!--{$title}-->
  <!--{$description}-->
<!--{/foreach}-->

else

ある条件が満たされている場合にある文を実行し、 その条件が満たされていない場合に別の文を実行したいと考えた ことが度々あるかと思います。 このためにelseがあります。 elseは、if文における式の値が FALSEの場合にある文を 実行するようにif文を拡張します。 例えば、次のコードは、$aが $bよりも大きい場合に aはbより大きいと表示し、 そうでない場合に、 aはbよりも大きくないと表示します。

 
<!--{if "$a" > "$b"}-->
 
	aはbより大きい
 
<!--{else}-->
 
	aはbより大きくない
 
<!--{/if}-->
 

else 文は、if式が FALSEと評価された場合のみ実行されます。 また、elseif式がある場合には、それも FALSEと評価された場合にのみ実行されます。

elseif

elseifは、その名前から分かるように、if とelseの組み合わせです。elseifは、 elseのように、元のif式の値が FALSEの場合に別の文を実行するようにif 文を拡張します。 しかし、elseとは異なり、elseif式が TRUEの場合にのみ代わりの式を実行します。 例えば、次のコードは、aはbより大きい、 aはbに等しい、 aはbより小さいを出力します。

 
<!--{if "$a" > "$b"}-->
 
	aはbより大きい
 
<!--{elseif "$a" == "$b"}-->
 
	aはbと等しい
 
<!--{else}-->
 
	aはbより小さい
 
<!--{/if}-->
 

複数の elseif を同じ if 文の中で使用することができます。 TRUE と評価された最初の elseif 式を実行します。elseif 文は、前にある全ての if 文と elseif の値が FALSE であり、 現在の elseif 式の値が TRUE である場合にのみ実行されます。

比較演算子

比較演算子は、その名前が示すように、二つの値を比較します。

比較演算子一覧

比較演算子の一覧は以下のとおりです。

例	名前	結果
$a == $b	等しい	$a が $b に等しい時に TRUE
$a != $b	等しくない	$a が $b に等しくない場合に TRUE
$a < $b	より少ない	$a が $b より少ない時に TRUE
$a > $b	より多い	$a が $b より多い時に TRUE
$a <= $b	より少ないか等しい	$a が $b より少ないか等しい時に TRUE
$a >= $b	より多いか等しい	$a が $b より多いか等しい時に TRUE
$a %% $b	割り切れる	$a と $b が割り切れる場合は TRUE （$aと$bは強制的に整数にキャストされる）
$a @@ $b	文字列が存在する	$aの中に$bという文字列が存在する場合はTRUE
$a !@ $b	文字列が存在しない	$aの中に$bという文字列が存在しない場合はTRUE

if

if 構文は、出品管理スクリプトにとって最も重要な 機能の一つです。 この構文は、命令の条件実行を可能にします。

式は論理値で評価されます。 式が TRUE と評価された場合、出品管理スクリプトは文を実行します。FALSE と評価された場合は、これを無視します。

以下の例は、$a が $b より大きい場合、「aはbより大きい」を表示します。

<!--{if "$a" > "$b"}-->
aはbより大きい
<!--{/if}-->

if文は、他のif文の中で無限に入れ子にできます。 これは、プログラムの様々な部分の条件付実行について 完全な柔軟性を提供します。

比較演算子に関してはこちらをご確認下さいませ

導入

出品スクリプトは、一連の文からなります。 文としては、代入、関数コール、ループ、条件文、を使用することができます。