ecstore关于smarty语法调用

以下是smarty语法

assign

属性类型是否必须描述varstringyes被赋值的变量名valuestringyes赋给变量的值

<{assign var="age" value=20}><{$age}>输出：    20<{assign var="arr" value=array("s","b")}><{dump var=$arr}>输出：array  0 => string 's' (length=1)  1 => string 'b' (length=1)

foreach foreachelse

属性类型是否必须描述fromstringyes待循环数组的名称itemstringyes当前处理元素的变量名称keystringon当前处理元素的键名namestringon该循环的名称，用于访问该循环

概述:       用于在模板被执行时循环foreach 必须和 /foreach 成对使用，且必须指定 from 和 item 属性.name 属性可以任意指定.foreach 可以嵌套，但必须保证嵌套中的 foreach 名称唯一.from 属性(通常是数组)决定循环的次数。foreachelse 语句在 from 变量没有值的时候被执行.% 输出数组$array中所有元素<{foreach from=$array item=value key=key}><{$key}> : <{$value}><br><{/foreach}>输出：    a : c#    b : php    c : java% 当输出为空时, 输出foreachelse的值<{foreach from=$array item=value key=key}><{$key}> : <{$value}><br><{foreachelse}        empty<{/foreach}>输出:    empty

include

概述:       加载app级模板, 加载网店级模板可以用require

<{include file='site/product/goods_js.html' app=b2c}>

if,elseif,else

概述:       条件判断

修饰符备用词语法用例说明php等同表达式==eq,is$a eq $bequals==!=ne,neq$a neq $bnot equals!=>gt$a gt $bgreater than><lt$a lt $bless than<>=gte,ge$a ge $bgreater than or equal>=<=lte,le$a le $bless than or equal<==== $a === 0check for identity===!notnot $anegation(unary)!%mod$a mod $bmodulous%is [not] odd $a is not odd[not] an odd number(unary)$a%2!=0is [not] even $a is not even[not] an even number(unary)$a%2=0

注意：每一个{if}必须与一个{/if}成对出现，允许使用{else}和{elseif}，所有php条件和函数在这里同样适用，诸如||、or、&&、and、is_array()等等

下面是一串有效的限定符，它们的左右必须用空格分隔开，注意列出的清单中方括号是可选的，在适用情况下使用相应的等号（全等或不全等）。

<{if $name eq "yi"}>...<{elseif $name eq "yu"}>...<{else}>...<{/if}>{if $name == 'Fred' || $name == 'Wilma'}...{/if}% 允许使用圆括号{if ( $amount < 0 or $amount > 1000 ) and $volume >= #minVolAmt#}...{/if}% 可以嵌入函数 {if count($var) gt 0}...{/if}% 数组检查 {if is_array($foo) }.....{/if}% 是否空值检查 {if isset($foo) }.....{/if}% 测试值为偶数还是奇数{if $var is even}...{/if}{if $var is odd}...{/if}{if $var is not odd}...{/if}% 测试var能否被4整除

math

所属类:     base_view_compiler
概述:       在模板中进行运算

属性类型是否必须描述equationstringyes计算表达式assignstringno被赋值的变量名formatstringno输出格式

<{math equation="x*2+y" format="--%03d--" assign="newkey" x=10 y=3}><{$newkey}>输出：    --023--    --023--<{math equation="x*2+y" assign="newkey" x=10 y=3}>输出：    23

require

所属类:     site_view_compiler
概述:       加载当前模板目录下模板文件

属性类型是否必须描述filestringyes指定模板文件路径

<{require file="block/header.html"}>输出：    加载当前模板目录下block/header.html文件

include

引用view下html输出

<!--引入B2C下xxx.html--> <{include file="admin/sales/coupon/xxx.html" app=b2c}><!--引入ome下xxx.html--> <{include file="admin/sales/coupon/xxx.html" app=ome}><!--注意：该引用默认目录指向/app/app名称/view-->

main
所属类:     site_view_compiler
概述:       模板系统级区域

属性类型是否必须描述viewstringno指定主区域模板路径

<{main}>输出：    使用系统内置的主区域模板进行渲染, 并输出主区域内容<{main view="abc.html"}>输出：    使用{$ecstore_root}/themes/{$template_name}/abc.html 作为主区域模板进行渲染, 并输出主区域内容

widgets

所属类:     site_view_compiler
概述:       模板挂件区域

属性类型是否必须描述idstringno挂件区域唯一标识, 一旦设定请勿轻易改动

<{widgets id='index-banner'}>输出：    为模板页面增加了一个挂件区域, 可通过后台模板可是化编辑中挂载挂件

default
所属类:     base_view_compiler
功能:       设置默认值

<{assign var="key" value=''}><{$key|default:30}>输出:    30

ship_area

所属类:     site_view_compiler
概述:       将内部地址转换为, 显示地址
方式:       modifier

<{assign var="ship_area" value="mainland:广东/广州市/东山区:425"}><{$ship_area|ship_area}>输出:    广东广州市东山区

cur/cur_odr

所属类:     ectools_view_compiler
概述:       将货币价格(默认系统里价格为基准货币价格)转换成当前货币价格, 并以当前货币格式输出
别名:       cur_odr

% 当前货币和基准货币价格一致, 并且基准价格为人民币<{40|cur}>输出:    ￥40.00

 counter

所属类:     base_view_helper
概述:       用于显示一个计数器

counter 用于输出一个记数过程. counter 保存了每次记数时的当前记数值. 用户可以通过调节 interval 和 direction 调节该值. 也可以决定是否输出该值. 如果需要同时运行多个计数器，必须为它们指定不同的名称. 如果没有指定名称，模板引擎使用 “default” 作为缺省值.如果指定了 “assign” 这个特殊属性，该计数器的输出值将被赋给由 assign 指定的模板变量，而不是直接输出.

属性类型是否必须默认值描述namestringNodefault计数器的名称startnumberNo1数器初始值skipnumber | No1记数器间隔、步长directionstringNoup记数器方向，(增/减)printbooleanNotrue是否输出值assignstringNon/a输出值将被赋给模板变量的名称

% counter 例子：0-<{counter name="wocao" start=6 skip=3 direction=down print=false}><br />1-<{counter name="wocao"}><br />2-<{counter name="wocao"}><br />3-<{counter name="wocao" assign="result"}><br />4-<{counter name="wocao"}><br />5-<{$result}><br />-----                <br />                0-<{counter name="kkk" start=6 skip=2 direction=down print=false}><br />1-<{counter name="kkk"}><br />2-<{counter name="kkk"}><br />3-<{counter name="kkk" assign="result"}><br />4-<{counter name="kkk"}><br />5-<{$result}><br />  <{counter start=6 skip=3 direction=down print=false}><br /><{counter}><br /><{counter}><br /><{counter assign="www"}><br /><{$counter}>输出：    0-    1-3    2-0    3-    4--6    5--3    -----     0-    1-4    2-2    3-    4--2    5-0

 html_options

所属类:     base_view_helper
概述:       生成HTML的<select><option>标签
建议:       详细用法可参考smarty文档

属性类型是否必须默认值描述valuesarrayYes, 除非使用 options 属性n/a下拉框值的数组outputarrayYes, 除非使用 options 属性n/a下拉框显示的数组selectedstring/arrayNoempty选中的项options数组Yes, 除非使用 values 和 outputn/a键值对的数组，用于下拉框namestringNoemptyselect组的名称

%必要的属性是values 和 output, 除非你使用组合的options来代替。%除非提供了可选属性name， 才会创建 <select></select>标签， 不然，只会生成<option>列表。%如果设置的value是数组，会当作HTML的<optgroup>，并且显示该下拉组。 <optgroup>是支持递归的。%其他不在上面列表中的键值对参数，会直接在输出的 <select> 标签中显示成 名称=值 的属性。 如果可选参数name没有设置，那么它们将被忽略。%全部的输出都符合XHTML的。<{assign var="options" value=array('a'=>'php','b'=>'c#','c'=>'java')}><{html_options name='bb' options=$options }>输出：    <select name="bb">    <option label="php" value="a">php</option>    <option label="c#" value="b">c#</option>    <option label="java" value="c">java</option>    </select>

html_table

所属类:     base_view_helper
概述:       可使用数组形式的数据来创建一个HTML的<table>, 此plugin是smarty的html_table简化版
建议:       详细用法可参考smarty文档

属性类型是否必须默认值描述looparrayYesn/a循环赋值的数组colsmixedNo3表 格的列数，或者是逗号分隔的列头文字列表，或是列头文字的数组。 如果cols属性为空，但设置了rows，将以rows数量和显示元素的总数进行计算得出列数， 以便每列能显示全部的元素。 如果rows和cols都设置了，那么cols会忽略默认值3. 如果设置cols为一个列表或数组，那么列数将取决于列表或数组的元素个数。table_attrstringNoborder=”1″<table>标签的属性tr_attrstringNoempty<tr>标签的属性 (循环)td_attrstringNoempty<td>标签的属性 (循环)trailpadstringNo&nbsp;在最后行空单元格中填充的字符(如果有的话)

<{assign var="loop" value=array(1,2,3,4,5,6,7,8,9,10)}><{html_table  loop=$loop cols=3 }>输出：    <table border="1">    <tr><td>1</td><td>2</td><td>3</td></tr>    <tr><td>4</td><td>5</td><td>6</td></tr>    <tr><td>7</td><td>8</td><td>9</td></tr>    </table>

 json
所属类:     base_view_helper
概述:       对变量进行JSON编码

属性类型是否必须默认值描述fromstringNonull需要进行JSON编码的变量

% $array 要进行JSON编码的变量<{assign var="array" value=array(1,2,3,4,array(2,4,5))}><{json from=$array}>输出:    [1,2,3,4,[2,4,5]]

mailto

所属类: base_view_helper
概述: 可以自动创建一个mailto:链接，而且可以选择编码方式。 对邮件编码可以使邮件地址更难以被网络爬虫抓取

属性类型是否必须默认值描述addressstringYesn/a电邮地址textstringNon/a显示的文字，默认是电邮地址encodestringNonone如何编码电邮。可以是none,hex,javascript或者javascript_charcode.ccstringNon/a抄送的电邮地址，用逗号隔开bccstringNon/a暗送的地址，用逗号隔开。subjectstringNon/a邮件标题newsgroupsstringNon/a发送到的新闻组地址，用逗号隔开。followuptostringNon/a回执地址，用逗号隔开。extrastringNon/a任何附加的链接信息，如样式表等

<{mailto address="[e-mail]"}><br /><{mailto address="[e-mail]" text="send me some mail" subject="Hello to you!"         cc="[e-mail],[e-mail]" extra='class="email"'}><br /><{mailto address="[e-mail]" encode="javascript"}><br /><{mailto address="[e-mail]" encode="hex"}><br />输出：    <a href="mailto:[e-mail]" >[e-mail]</a><br />    <a href="mailto:[e-mail]?cc=[e-mail][e-mail]&subject=Hello%20to%20you%21"    class="email">send me some mail</a><br />    <script type="text/javascript" language="javascript">    eval(unescape('%64%6f%63%75%6d%65%6e%74%2e%77%72%69%74%65%28%27%3c%61%20%68%72%65%66%3d%22%6d%    61%69%6c%74%6f%3a%6d%65%40%64%6f%6d%61%69%6e%2e%63%6f%6d%22%20%3e%6d%65%40%64%6f%6d%61%69%6e%    2e%63%6f%6d%3c%2f%61%3e%27%29%3b'))</script><br />    <a href="mailto:%6d%65@%64%6f%6d%61%69%6e.%63%6f%6d" >    &#x6d;&#x65;&#x40;&#x64;&#x6f;&#x6d;&#x61;&#x69;&#x6e;&#x2e;&#x63;&#x6f;&#x6d;</a><br />

 appconf

所属类: base_view_helper
概述: 变相的使用app::get($app_id)->getConf($key)取数据

属性类型是否必须默认值描述appstringYesemptyapp_idkeystringYesemptykey

<{appconf app="site" key="site.name"}>输出:    商店名称

pager

所属类: base_view_helper
概述: 简单分页组件

属性类型是否必须默认值描述dataarrayYes paper数据

data格式:

属性类型是否必须默认值描述currentintYes 需要进行JSON编码的变量totalintYes 需要进行JSON编码的变量linkstringYes 需要进行JSON编码的变量tokenstringYes 需要进行JSON编码的变量

分配变量$this->pagedata['pagers'] = array(    'current' => 33,    'total' => 3333,    'token' => '_PPP_'    'link'=>'index.php/shopadmin/#app=ecbook&ctl=admin_dbeav&act=index&p=_PPP_',);html中调用<{assign var=data value=array('current=>33,'total<{pagers data=$pagers}>

 pagers

所属类: b2c_view_helper
概述: 分页组件

属性类型是否必须默认值描述dataarrayYes paper数据

data格式

属性类型是否必须默认值描述dataarrayYes 需要进行JSON编码的变量

pager   current 当前页        total   总页数        link    连接地址<{assign var="data" value=array('current'=>35,'total'=>3333,'token'=>'@@@','link'=>'http://a/@@@')}><{pagers data=$data}> <{pager  current=1 total=30 link='index.php/shopadmin/#app=ecbook&ctl=admin_dbeav&act=index' }>

效果预览：

ecstore关于pager分页效果

pagers得第二种写法

分配变量$this->pagedata['pagers'] = array(    'current'=>2,    'total'=>20,    'link'=>'index.php/shopadmin/#app=ecbook&ctl=admin_dbeav&act=index',);html中调用<{pagers data=$pagers}>

 toinput隐藏框

参数： from 包含隐藏框的name和value的关联数组

先分配数据：         $this->pagedata['toinput'] = array('a'=>'c#','b'=>'php','c'=>'java');         $this->page('list.html'); list.html：            <{toinput from=$toinput}><br /> 输出：    <input type="hidden" name="a" value="c#" />    <input type="hidden" name="b" value="php" />    <input type="hidden" name="c" value="java" />

amount

参数    第一个参数：货币币种(货币代码) 默认为人民币        第二个参数：是否为基本数据格式 false|true        第三个参数：是否需要改变费率   false|true注意    此方法是继承ectools的，所以要调用必须安装ectools。 <{123466789|amount:'CNY'}> 输出效果：￥123,466,789.00

storager

根据image_id对图片显示进行修饰

参数    l   大图        m   中图        s   小图默认显示原图<{$image_id|storager:'s'}>//显示小图,如无图片,显示默认设置图<{$ajuncts.thumbnail_pic|default:$env.conf.site.default_thumbnail_pic|storager:'s'}>

 cdate控制日期输出

参数:   FDATE        Y-m-d        SDATE        y-m-d        DATE         m-d        FDATE_FTIME  Y-m-d H:i:s        FDATE_STIME  Y-m-d H:i        SDATE_FTIME  y-m-d H:i:s        SDATE_STIME  y-m-d H:i        DATE_FTIME   m-d H:i:s        DATE_STIME   m-d H:i        默认：FDATE_FTIME先分配数据：     $this->pagedata['time'] = time();     $this->page('list.html');     list.html:     <{$time|cdate:FDATE}>     输出：     2011-01-06

 cut控制字符串输出

 参数：第一个参数 输出几个字符   默认是80       第二个参数 后三个代替字符 默认是 ...先分配数据：     $this->pagedata['string'] = 'abcdefghijklmno';     $this->page('list.html');     list.html:       <{$string|cut:10}><br />       <{$string|cut:10:'+++'}><br />输出：   abcdefg...   abcdefg+++

 

date

参数：参照php中date函数写参数先分配数据：     $this->pagedata['time'] = time();     $this->page('list.html');     list.html:       <{$time|date:'r'}><br />输出：    Thu, 06 Jan 2011 17:53:26 +0800

 

date_format

参数： 参数php中strftime函数写参数先分配数据：    $this->pagedata['time'] = time();$this->page('list.html');    list.html:    <{$time|date_format:'%Y年'}><br />输出：    2011年

t 将所要修饰的字符串调用语言包格式输出

参数:   appid alt=$___b2c="删除"|t:'b2c'

number

对$number数据进行格式化

参数    0   把$number强制转换为int型原样输出        1   判断$number是否小于1,如果小于1则输出‘低于1’,否则如果是整数则原样输出，小数则进1位输出        2   判断$number是否小于1,如果小1则输出'超过99'，否则输出100-$number        3   判断$number是否小于1,如果小于1则输出'低于1',否则输出对小数四舍五入的值<{1234.247|number:3}>  //1234.3

 regex_replace正则替换

参数：第一参数：替换正则表达式.      第二参数：用来替换的文本字符串先分配数据：    $this->pagedata['articleTitle'] = "Infertility unlikely to\nbe passed on, experts say.";    $this->page('list.html');    list.html:    <{$articleTitle}><br />    <{$articleTitle|regex_replace:"/[\r\t\n]/":" "}>输出：    Infertility unlikely to    be passed on, experts say.    Infertility unlikely to be passed on, experts say.

 region

参数：第一参数 被替换的字符串      第二参数 用来替换的字符串先分配数据：        $this->pagedata['region'] = "afsd/fsd:bbcd/czxc:fsd";$this->page('list.html');        list.html:            <{$region}><br />            <{$region|replace:'/':'-'}><br />输出：    afsd/fsd:bbcd/czxc:fsd    afsd-fsd:bbcd-czxc:fsd

 strip替换空格

先分配数据：    $this->pagedata['strip'] = "ss  fbsd fsd   fs ";$this->page('list.html');    list.html:    <{$strip}><br />    <{$strip|strip:''}><br />输出：    ss fbsd fsd fs    ssfbsdfsdfs