ECSHOP模板系统变量调节标签使用说明

ECSHOP作为国内使用最多的网上商城系统，却没有一个很好的API手册，着实比较让我们费心，要想查找一个函数的功能，只能通过查看其程序的源代码才可以知道有什么功能，官方的手册也不全面，很多东西都没有编写完成，可能作者已经不想在维护这个程序了，ECSHOP的版本也很久没有更新了。

介于如此，我就分享一个ECSHOP模板系统变量调节标签说明，希望对于ECSHOP商城二次开发的开发人员有所帮助。

escape [编码]

参数位置	参数类型	必需	可用参数	默认	描述
1	string	No	html,url,quotes	html	使用何种编码格式

描述

用于html转码,url转码,在没有转码的变量上转换单引号,十六进制转码,十六进制美化转码。默认是html转码。

实例

{$articleTitle}{$articleTitle|escape}{$articleTitle|escape:"html"} {* escapes& " ' <> *}{$articleTitle|escape:"url"}{$articleTitle|escape:"quotes"}

nl2br [换行符替换成 <br />]

描述

所有的换行符将被替换成 <br />.功能同PHP中的nl2br()函数一样.

例子

{$articleTitle|nl2br}

输出

Sun or rain expected<br />today, dark tonight

default [默认值]

参数位置	参数类型	必需	默认	描述
1	string	No	empty	这是变量为空的时候的默认输出。

描述

为空变量设置一个默认值。
当变量为空或者未分配的时候,将由给定的默认值替代输出。

例子

{$articleTitle|default:"no title"}{$myTitle|default:"no title"}

输出

Dealers Will Hear Car Talk at Noon.no title

truncate [截取]

参数位置	参数类型	必需	默认	描述
1	integer	No	80	截取字符的数量。
1	string	No	……	截取后追加在截取词后面的字符串。
1	boolean	No	false	是截取到词的边界（假）还是精确到字符（真）。

描述

从字符串开始处截取某长度的字符.默认是80个.

你也可以指定第二个参数作为追加在截取字符串后面的文本字串.该追加字串被计算在截取长度中。

默认情况下,smarty会截取到一个词的末尾。

如果你想要精确的截取多少个字符,把第三个参数改为”true”

例子

{$articleTitle}{$articleTitle|truncate}{$articleTitle|truncate:30}{$articleTitle|truncate:30:""}{$articleTitle|truncate:30:"---"}{$articleTitle|truncate:30:"":true}{$articleTitle|truncate:30:"...":true}

输出

Two Sisters Reunite after Eighteen Years at Checkout Counter.Two Sisters Reunite after Eighteen Years at Checkout Counter.Two Sisters Reunite after...Two Sisters Reunite afterTwo Sisters Reunite after---Two Sisters Reunite after EighTwo Sisters Reunite after E...

strip_tags [去除html标签]

描述

去除<和>标签,包括在<和>之间的任何内容.

例子

{$articleTitle}{$articleTitle|strip_tags}

输出：

Blind Woman Gets <font face="helvetica">New Kidney</font> from Dad she Hasn'tSeen in <b>years</b>.Blind Woman Gets New Kidney from Dad she Hasn't Seen in years.