Gallery:主题:参考:标签

来自站长百科
Firebrance讨论 | 贡献2008年8月15日 (五) 16:01的版本
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳转至: 导航、​ 搜索

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中)

hiddenFormVars[ ]

g->hiddenFormVars

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

addToTrailer[ ]

g->addToTrailer

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

trailer[ ]

g->trailer

  • 显示添加到trailer的内容

debug[ ]

g->debug

  • 显示被收集的debug输出(见config.php)