作用:定义页面区块属性,通常将此标签添加到本地编辑的页面模板文件的所需位置,定义好其相关参数,上传至服务器端模板代码动态生成页面区块;该区块和后台手动添加的区块没有任何分别,都可以在后台人工维护。
区块类型对照表:
类型 |
说明 |
推荐区块(push) |
即手自动区块,可以手动在此区块中录入内容,也可以由内容编辑直接推送 |
代码(html) |
支持html和js代码,通常用于不规则数据和广告位维护等 |
自动(auto) |
支持通过模板标签调用数据,可以定时刷新,无需人工维护 |
手动(hand) |
支持手动更新数据,并通过设定的模板代码输出 |
Rss |
获取指定的rss新闻源,并通过设定的模板代码输出,可定时刷新,通常用于RSS数据远程调用 |
Json |
获取指定的json数据源,并通过设定的模板代码输出,可定时刷新,通常用于JSON数据远程调用 |
Rpc |
获取指定的rpc接口数据,并通过设定的模板代码输出,可定时刷新,通常用于RPC协议接口 |
参数对照表:
参数名 |
必选 |
说明 |
sectionid |
否 |
区块ID,如果没填写就会自动创建此碎片 |
name |
是 |
区块名称,可以重复 |
type |
是 |
区块类型,(push,html,auto,hand,rss,json,rpc)其中之一 |
url |
是 |
当type为(rss,json,rpc)时有效,用于填写rss数据源、json数据源或rpc数据源 |
method |
是 |
当type为rpc时有效,并为必选参数,即调用接口 |
args |
否 |
当type为rpc时有效,即参数 |
width |
否 |
区块宽度,主要用来参考标题长度是否合适 |
frequency |
否 |
更新频率,当type为html和hand时此选项无效 |
rows |
否 |
默认的行数,仅type为hand时有效 |
origdata |
否 |
默认的数据,需php序列化以后的数据,用于存储初始的区块内容 |
output |
否 |
输出格式,(html,xml,json)三者之一 ,仅type为hand时有效 |
description |
否 |
区块备注,一般用来说明区块显示在什么位置,缩略图规格,标题最大长度等 |
示例:
<!--{section name="热点专题 图片" type="hand" width="0" frequency="0" rows="1" output="html" description=""}-->
{loop $data $k $r}
{loop $r $i $c}{$c[title]}{/loop}
{/loop}
<!--{/section}-->
上例说明:通过section标签在本地编辑器建立手动区块,命名为“热点专题 图片”,默认区块宽度,区块更新频率为默认,初始行数为1,输出格式为html,描述为空。定义好section标签相关属性后,添加手动区块代码,通过loop循环,输出手动区块中添加的内容标题。
示例:
<!--{section name="运营商动态" type="auto" width="0" frequency="0"}-->
<!--{content modelid="1" catid="11" weight="80," order="published desc" size="5"}-->
<li><a target="_blank" href="{$r[url]}" title="{$r[title]}">{$r[title]}</a></li>
<!--{/content}-->
<!--{/section}-->
上例说明:通过section标签在本地编辑器建立自动区块,命名为“运营商动态“,默认区块宽度,区块更新频率为默认。定义好section标签相关属性后,通过{content}标签来实现数据的调取。
注:标签类型或区块类型,即type为html的时,区块中代码只能为html,其他类型时,区块代码可以是html跟模板标签的组合。