编辑“Gallery:主题:参考:标签”

==Gallery2的Smarty对象==
通过添加'''g'''对象—它使得对Gallery的一些函数的访问成为可能—Gallery扩展了Smarty。下面有有关'''g'''对象的描述，并且使用对象语法即可由模板进行访问：

<pre>{g->method param1="value" ... paramN="value"}</pre>

其中param1...paramN为方法所取的参量。

==g 对象方法==

===block===
用法：{'''g->block''' type=''blockType'' [block特定参量]}

* '''g->block'''在模板中插入Gallery区块。这与通过站点管理界面为相册，相片等配置的区块相似
* '''[[Gallery:Themes:Reference:Blocks|Gallery2区块]]'''列出了可用的区块及它们的参量
* '''g->block'''的使用实例可以在Gallery附带的模板源代码中找到，如[http://svn.sourceforge.net/viewcvs.cgi/gallery/trunk/gallery2/themes/floatrix/templates/album.tpl?annotate=13913#l9 Floatrix外观主题]

===container===
用法：{'''g->container''' type='containerType' [container特定参量]} ... {'''/g->container'''}

* '''g->container'''在模板中插入一个容器，如图片框
* '''[[Gallery:Themes:Reference:Containers|Gallery2容器]]'''列出了可用的容器及它们的参量
* '''g->container'''需要闭合的'''/g->container'''标识
* 起始与结束'''g->container'''标识之间的内容被包含在了容器之中

===callback===
用法：{'''g->callback''' type=''callbackType'' [callback特定参量]}

* Callback被区块用于区块数据的读取。'''g->callback'''则作为一个callback的开始
* '''[[Gallery:Themes:Reference:Callbacks|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）中的&amp;amp;替换为&amp;
* 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=..] [&lt;img&gt;的其他参量]

* 为选定的项目渲染html内容；通常为&lt;img&gt;，但也可为被嵌入的视频，电影等

===date===
'''g->date''' [timestamp=..] [format=..] [style=..]

* 时间戳缺省为当前日期/时间
* 如有定义请使用给定的格式；否则的话为给定类型（date，time，或datetime；默认为date）使用系统设定
* 参见[http://php.net/strftime strftime的资料]来看看格式字串中可用的标记

===text===
'''g->text''' [text=..] [arg1=.. arg2=...] [l10Domain=..] [forJavascript=true] [hint=..] [cFormat=..] [postSprintfArg1=..]

* 使用此标识为[[Gallery:Localization|翻译]]标记文本
* Default l10Domain为当前选中的主题或模块
* forJavascript 将所有 ' 字符替换为 \'
* arg1，arg2等则用于当text=.. 含有 printf-类型的类似%s or %d标记之时
* 备用参量：one=.. many=.. count=.. [arg1=.. etc] <br> 如果计数为一就使用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支持 <br> 为迄今输入的文本给出url，使用__VALUE__标记生成{g->autoComplete}..{/g->autoComplete}之间的autoComplete列表（参见modules/core/templates/AdminCore.tpl中的相关例子）

===dimensions===
'''g->dimensions''' [formVar=..] [width=..] [height=..]
* 为输入dimensions添加表单元素<br> 除非直接编辑第二个dimension的值，否则Javascript将在第二个dimension中自动填充入与第一个dimension中相同的值（参见modules/core/templates/ItemEditPhoto.tpl中的相关例子）

===defaultButton===
'''g->defaultButton''' [name=..]

* 添加隐藏的表单元素以定义一个默认的提交按钮，它被使用于enter以文本形式输入之时 <br> 必须出现在表单中其他所有提交按钮之前（参见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=..] [..]
* 为选择列表将一个项目动作渲染为&lt;a&gt; link 或&lt;option&gt;。
* link参量为loadCommonTemplateData的'itemLinks'键所载入的数据。
* 为 <option> 标记通过type="option"（以建立一个&lt;select&gt; list）；否则生成&lt;a&gt;.
* 通过lowercase=true将所有动作的文本修改为小写字母。
* 任何额外参量将被作为属性添加到&lt;a&gt;或&lt;option&gt;标记上。
* 通过class=null以忽略默认在（图标的）&lt;a&gt;链接上添加的CSS类别。
* 举例：{foreach from=$theme.itemLinks item=link}{g->itemLink link=$link lowercase=true}{/foreach}
* 注：Gallery 2.3新增

===head===
'''g->head'''
* 显示准备好的&lt;head&gt; 内容（title，css，javascript及meta)

===mainDivAttributes===
'''g->mainDivAttributes'''
* 主Gallery &lt;div&gt;的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中）

===hiddenFormVars===
'''g->hiddenFormVars'''

* 将''{g->hiddenFormVars}''添加到你模板中所有的<form>区块中。否则的话你的表单将无法运作（缺失控制器变量，authToken…）.

===addToTrailer===
'''g->addToTrailer'''
* 将页面内部结尾处添加的内容置入{g->addToTrailer}..{/g->addToTrailer}中

===trailer===
'''g->trailer'''
* 显示添加到trailer的内容

===debug===
'''g->debug'''
* 显示被收集的debug输出（见config.php）

[[Category:Gallery 2:Development]]