Gallery:主题:参考:标签
Gallery2的Smarty对象[ ]
通过添加g对象—它使得对Gallery的一些函数的访问成为可能—Gallery扩展了Smarty。下面有有关g对象的描述,并且使用对象语法即可由模板进行访问:
{g->method param1="value" ... paramN="value"}
其中param1...paramN为方法所取的参量。
g 对象方法[ ]
block[ ]
用法:{g->block type=blockType [block特定参量]}
- g->block在模板中插入Gallery区块。这与通过站点管理界面为相册,相片等配置的区块相似
- Gallery2区块列出了可用的区块及它们的参量
- g->block的使用实例可以在Gallery附带的模板源代码中找到,如Floatrix外观主题
container[ ]
用法:{g->container type='containerType' [container特定参量]} ... {/g->container}
- g->container在模板中插入一个容器,如图片框
- Gallery2容器列出了可用的容器及它们的参量
- g->container需要闭合的/g->container标识
- 起始与结束g->container标识之间的内容被包含在了容器之中
callback[ ]
用法:{g->callback type=callbackType [callback特定参量]}
- Callback被区块用于区块数据的读取。g->callback则作为一个callback的开始
- Gallery2 Callbacks列出了Gallery2中实现的callback及它们的参量
url[ ]
用法:{g->url href=hrefUrl params=array arg1="param=value" arg2="param=value" htmlEntities=false forceDirect=true forceFullUrl=true forceSessionId=true|false
- htmlEntities=false 在url(之前为forJavascript=true)中的&替换为&
- forceDirect=true 以生成G2站点url—即使已被嵌入
- forceFullUrl=true 以生成绝对路径的url而非相对路径的url
- forceSessionId=true/false 以定义G2对话id是否应被嵌入到url中;默认情况下,当未使用cookies时,仅为非href的url所包含
- params=和arg#=在G2.2中可以同时用于开始(arg1等被添加到给定的参量数组)
image[ ]
g->image [item=..] [image=..] [maxSize=..] [fallback=..] [<img>的其他参量]
- 为选定的项目渲染html内容;通常为<img>,但也可为被嵌入的视频,电影等
date[ ]
g->date [timestamp=..] [format=..] [style=..]
- 时间戳缺省为当前日期/时间
- 如有定义请使用给定的格式;否则的话为给定类型(date,time,或datetime;默认为date)使用系统设定
- 参见strftime的资料来看看格式字串中可用的标记
text[ ]
g->text [text=..] [arg1=.. arg2=...] [l10Domain=..] [forJavascript=true] [hint=..] [cFormat=..] [postSprintfArg1=..]
- 使用此标识为翻译标记文本
- Default l10Domain为当前选中的主题或模块
- forJavascript 将所有 ' 字符替换为 \'
- arg1,arg2等则用于当text=.. 含有 printf-类型的类似%s or %d标记之时
- 备用参量:one=.. many=.. count=.. [arg1=.. etc]
如果计数为一就使用one=.. 字串;否则就使用many=.. 字串 - hint=".." 提供置于po文件中的文本以协助翻译者(必须使用双引号而不是单引号)
- cFormat=false 确保PO文件不会将此文本译为c-format,即使它包含%字符
- postSprintfArg1=".." 尝试对具有此值的sprintf后的字串的特殊翻译;如果无翻译被找到,则退回到含有%s的一般字段的翻译,稍后处理sprintf。举例:
{g->text text="%s Date and Time" arg=$ItemEditItem.typeName.0 postSprintfArg1=$ItemEditItem.typeName.2} {* 特殊翻译:{g->text text="Link Date and Time"} *}
theme[ ]
g->theme [include=..] or [url=..]
- Include为{include file="gallery:[path to theme/templates]/.."}的快捷方式
- Url为{g->url href="[path to theme]/.."}的快捷方式
formVar[ ]
g->formVar [var=..]
- 为给定的变量名称添加前缀;如var="form[input]" gives g2_form[input]
autoComplete[ ]
g->autoComplete [element=..]
- 为一个给定id的表单文本元素添加autoComplete支持
为迄今输入的文本给出url,使用__VALUE__标记生成{g->autoComplete}..{/g->autoComplete}之间的autoComplete列表(参见modules/core/templates/AdminCore.tpl中的相关例子)
dimensions[ ]
g->dimensions [formVar=..] [width=..] [height=..]
- 为输入dimensions添加表单元素
除非直接编辑第二个dimension的值,否则Javascript将在第二个dimension中自动填充入与第一个dimension中相同的值(参见modules/core/templates/ItemEditPhoto.tpl中的相关例子)
defaultButton[ ]
g->defaultButton [name=..]
- 添加隐藏的表单元素以定义一个默认的提交按钮,它被使用于enter以文本形式输入之时
必须出现在表单中其他所有提交按钮之前(参见modules/core/templates/AdminEditGroupUsers.tpl中的相关例子)
changeInDescendents[ ]
g->changeInDescendents [module=..] [g->text params..]
- 为给定的带有给定文本的模块添加一个复选框。
- 被ItemEditOptions用于ItemEdit表单中来添加一个选项,以使得所作的更改递归式地应用于子项目。
linkId[ ]
g->linkId [urlParams=..]
- 为给定链接生成一个css类别名称;类别用于图标模块
itemLink[ ]
g->itemLink link=.. [type=..] [lowercase=..] [..]
- 为选择列表将一个项目动作渲染为<a> link 或<option>。
- link参量为loadCommonTemplateData的'itemLinks'键所载入的数据。
- 为 <option> 标记通过type="option"(以建立一个<select> list);否则生成<a>.
- 通过lowercase=true将所有动作的文本修改为小写字母。
- 任何额外参量将被作为属性添加到<a>或<option>标记上。
- 通过class=null以忽略默认在(图标的)<a>链接上添加的CSS类别。
- 举例:{foreach from=$theme.itemLinks item=link}{g->itemLink link=$link lowercase=true}{/foreach}
- 注:Gallery 2.3新增
head[ ]
g->head
- 显示准备好的<head> 内容(title,css,javascript及meta)
mainDivAttributes[ ]
g->mainDivAttributes
- 主Gallery <div>的Id和class
language[ ]
g->language
- HTML语言属性的语言格式
logoButton[ ]
g->logoButton [type=..] [target=..] [link=false] [showToAll=true]
- 类型可为gallery2,gallery2-version,donate or validation
- Optional target parameter 添加链接目标(例如:target="_blank")
- Optional link=false 无任何链接,仅显示logo
- Optional showToAll=true 总显示logo(默认情况下,除了"gallery2"以为的所有类型仅显示给站点管理员)
- (在Gallery 2.1发布后link/showToAll参量被添加于CVS中)
[ ]
g->hiddenFormVars
- 将{g->hiddenFormVars}添加到你模板中所有的<form>区块中。否则的话你的表单将无法运作(缺失控制器变量,authToken…).
addToTrailer[ ]
g->addToTrailer
- 将页面内部结尾处添加的内容置入{g->addToTrailer}..{/g->addToTrailer}中
trailer[ ]
g->trailer
- 显示添加到trailer的内容
debug[ ]
g->debug
- 显示被收集的debug输出(见config.php)