多图集设置组件

名扬银河数字官网系统的前台页面信息的多图集设置组件文档：

一、组件名称：多图集设置组件。

二、组件作用：将前台页面上呈现的位置相同的多张图片，作为管理后台的一个设置编辑项，方便管理员维护更新。最常用于页面幻灯片播放图片组。

三、组件写法：[picbox #id @name {备注说明} ] $url$ $name$ $link$ [/picbox]。其中，$url$为系统固定的，表示其中某一张图片的url地址信息。$name$为系统固定的，表示其中某一张图片相关的名称信息。$link$表示其中某一张图片可打开的链接地址。调用$url$、$name$、$link$时可嵌套使用自定义的html标签。

多图集设置组件的写法分解：

• 1、[picbox - 开头部分。

• 2、#id - 表示唯一名称码部分，用于定义该文本项在页面中的唯一性，id后名称只能使用英文字母、数字、下划线、短横线。比如：#banner_slide。

• 3、@name - 表示唯一中文名称部分，用于定义该文本项在当前页面中的唯一中文名称，应尽量简洁化，须8个字以内。以@号开头，@后名称只能使用中文、字母、数字、下划线、短横线。比如：@幻灯图片。

• 4、{备注说明} - 表示该文本项的备注说明：以{开头，以}结尾，在其间为备注说明内容，备注内容只能使用中文、字母、数字、下划线、短横线、中文特殊符号。比如：首页某个位置上需幻灯图片组的备注写法，{幻灯图片尺寸要求：宽1920px*高600px}。

• 5、扩展属性refpage - 表示直接引用使用前台其他页面中所配置的相同#id的单行文本设置组件的数据内容，refpage=原定义此组件的页面文件名称，比如：refpage=index。使用此引用方式可共享前台的某些页面上模块的数据内容。网站管理后台只有原定义页面可编辑数据，其他引用页面不再进行编辑设置项管理，只需一处编辑数据，多处使用。主要用于前台页面之间存在相同数据内容模块的编辑和调用处理问题。

• 6、封闭前半段使用：]

• 7、具体内容调用使用：$url$ - 代表每张图片的url地址；$name$ - 代表每张图片相关名称信息；$link$ - 代表每张图可打开的链接地址信息。可结合嵌套自定义的html标签应用。具体应用参考第8点说明。

• 8、结尾：[/picbox]

• 9、完整示例：

  [picbox #banner_slide @幻灯图片 {幻灯图片尺寸要求：宽1920px*高600px}]

  <li><a href="$link$" target="_blank" title="$name$"><img src="$url$" alt="$name$"/></a></li>

  [/picbox]

• 10、输出结果形式：用户在管理后台编辑的图片组信息，按实际页面代码中的结合嵌套信息得到各图片的url地址、名称、链接信息结果。

四、组件用法：请将完整的多图集设置组件，放置于前台具体某个页面代码中，结合自定义html标签灵活使用。浏览前台页面将呈现图片组，后台管理图片组。前台幻灯片播放效果需结合javascript、css等处理。

五、使用范围：只能在所在的页面中有效，在前台本页面中呈现，在系统后台此页面信息设置中编辑管理图片组信息。

六、网站系统后台在哪里对各页面信息设置项进行内容编辑呢？具体操作请详见后台文档中的【前台页面信息设置功能文档】。