编辑“Gallery:主题:参考:修改器”

==Smarty修改器基础==
[http://smarty.php.net Smarty]使用修改器来用不同的方式显示文本，比如将一个字串显示为大写字母，小写字母或标题。模板中的任何变量都可以被应用上一个修改器，只要带上一个竖杠标记（'<code>|</code>'）和某修改器名称即可：

===使用修改器===
{| style="margin-left:10px; border: lightgray thin dotted;"
|-
|width="350px"|<code>{$user.userName}</code> ||不改变格式的情况下显示变量<code>$user.userName</code>
|- 
|<code><nowiki>{$user.userName|upper}</nowiki></code> || 使用<code>upper</code>修改器以大写字母显示变量<code>$user.userName</code>
|-
|}

===将若干个修改器串链在一起===
使用竖杠就可以将若干个修改器串链在一起了：

{| style="margin-left:10px; border: lightgray thin dotted;"
|-
|width="350px"|<code>{$user.userName|upper|strip_tags}</code> ||先使用<code>upper</code>修改器接着是<code>strip_tags</code>修改器的方式来显示变量<code>$user.userName</code> 
|-
|}

===对修改器使用参量===
某些修改器可以使用参量来控制它们的行为，比如内置的Smarty修改器 <code>truncate</code>可以截取给定长度的字串。期望的字串长度作为一个参量传输给修改器：

{| style="margin-left:10px; border: lightgray thin dotted;"
|-
|width="350px"|<code>{$user.userName|truncate:20}</code> ||以20个字符的长度显示变量<code>$user.userName</code>
|-
|}

如果一个修改器有若干个参量的话，它们就必须按顺序进行传输，以冒号隔开。不愿为其赋值的可选参量的冒号之后的数值将被省略掉：

{| style="margin-left:10px; border: lightgray thin dotted;"
|-valign="top"
|width="350px"|<code>{$user.userName|truncate:20::true:true}</code> ||显示变量<code>$user.userName</code>并向<code>truncate</code>修改器传输四个参量：

*Parameter 1 = 20 - the length to truncate at
*Parameter 2 = optional and not specified
*Parameter 3 = true
*Parameter 4 = true
|-
|}

===深入了解修改器===
有关在模板中使用修改器以及Smarty中内置修改器的更详细信息可在 
[http://www.smarty.net/manual/en/plugins.modifiers.php Smarty 手册]中找到。

==Gallery2的Smarty修改器==
Gallery2向Smarty添加额外的修改器进行文本格式化以为gallery所用。包括有：

===entitytruncate===
用法： '''<code>entitytruncate</code>'''''<code>:length:etc:breakWords</code>''

<code>entitytruncate</code> 修改器截取一个字串，但禁止在HTML实体或multibyte字符的中部的截取

参量：
*''<code>length</code>''（整数）-输出字段的最大长度
*''<code>etc</code>''（字串）-用于后置到某被截取的字串，默认为3个句号（'...'）
*''<code>breakWords</code>'' (boolean) – 如为true，<code>entitytruncate</code>将在中部截断某字串。默认为<code>false</code>

===ireplace===
用法： '''<code>ireplace</code>'''''<code>:search:replace</code>''

<code>ireplace</code>作为一个大小写敏感的搜索，并替换它所修改的变量，将<code>search</code>替换为<code>replace</code>

参量：
*''<code>search</code>''（字串）-变量中进行查找的字串
*''<code>replace</code>''（字串）-替换<code>search</code>的字串

===markup===
用法： '''<code>markup</code>'''

<code>markup</code>修改器根据站点管理设定中设置的标记格式（raw HTML，BBCode或无格式）来格式化某个变量

===print_r===
用法： '''<code>print_r</code>'''

此修改器用于debug，并且如果某变量含有子键（subkey）的话，就会递归式地将其打印出来。更多有关<code>print_r</code>关键词的信息可在[http://php.net/print_r PHP手册]中找到

===repeat===
用法： '''<code>repeat</code>'''''<code>:count</code>''

<code>repeat</code>修改器按指定次数重复某变量

参量：
*''<code>count</code>''（整数）-此<code>repeat</code>所修改的变量重复次数

===split===
用法： '''<code>split</code>'''''<code>:separator:regexp</code>''

<code>split</code> 将某变量截断为使用给定分隔符的数组。有关<code>split</code>的更多信息可在[http://php.net/split PHP手册]中查到 

参量：
*''<code>separator</code>''（字串）–此字串标注变量应被截断的位置
*''<code>regexp</code>'' (boolean) - if <code>true</code> then <code>separator</code>解析为一个正则表达式。默认为<code>false</code>

[[Category:Gallery 2:Development]]