supesite标签调用参数详解

参数：
blocktype模块名称，系统有一下模块
blocktype=category 系统分类模块
blocktype=spacenews   资讯模块
blocktype=poll    投票模块
blocktype=spaceblog 日志模块
blocktype=spaceimage   图片模块
blocktype=spacefile 文件模块
blocktype=spacegoods   商品模块
blocktype=spacelink 书签模块
blocktype=tag       TAG模块
blocktype=spacetag     TAG文章信息模块
blocktype=spacecomment 用户回复模块
blocktype=userspace 个人空间列表模块
blocktype=announcement 站点公告模块
blocktype=friendlink 站点友情链接模块
blocktype=spacevideo 影音模块
blocktype=group 圈子模块
blocktype=bbsthread 论坛主题模块
blocktype=bbsannouncement 论坛公告模块
blocktype=bbsforum 论坛板块模块
blocktype=bbslink 论坛友情链接模块
blocktype=bbsmember   论坛会员模块
blocktype=bbsattachment   论坛附件模块
blocktype=bbspost   论坛帖子模块
itemid(s) 指指定id的资讯，其中s为参数，
grade[] 审核等级，系统默认为五个等级，调用参数分别为1、2、3、4、5
catid[] 站点分类参数调用，即通过此参数的指定可以调用指定的某个类别的资讯信息，
uid 指定作者id
gid 指定id圈子，即通过此参数可以调用指定圈子的信息，用户类似与catid
haveattach 附件是否包含附件，有两个参数：1表示有，0表示没有
digest[] 精华级别，系统默认有三个级别，参数为1、2、3，分别表示精华1，2，3
top[] 置顶级别参数，系统默认有三个置顶级别，参数为1、2、3
dateline 发布时间参数，该参数可以为自定义，设置为0时表示不限制发布时间，参数计量单位为秒，比如：dateline/86400,表示一天之内发布的资讯参数还可以接一个排序参数，如这样：dateline/86400/desc ，表示一天之内发布的资讯，并按降序排列调用
lastpost 最后回复范围，其调用参数的用法和dateline差不多
viewnum 查看范围，即可以通过此参数调用查看数为一定范围的资讯
replynum 回复数范围，用法于vviewnum类似，并且二者都可以加上排序参数desc或asc，即降序和升序
trackbacknum 引用范围数
goograte 好评分范围
badrate 差评分范围
i.dateline 时间排序参数
i.lastpost 回复时间排序参数
i.viewnum 查看数排序参数
i.replynum 回复数排序参数
i.trackbacknum 引用数排序参数
i.digest 精华级别排序参数
i.goodrate 好评分排序参数
i.baddrate 差评分排序参数
limit数据条数参数
cachetime缓存参数
subjectlen 标题长度参数
subjectdot 超过标题长度是否截取并一省略号结尾，0表示不显示，1表示显示
showdetail 是否显示文章详细内容
messagelen 显示详细内容的长度
messagedot 详细内容截取后是否显示省略号
showcategory 是否显示文章所在的分类栏目名
举例说明：
下面是一个例子，该例子把所有的参数都用上了，实际上是有很多参数是不需要的，在调用时我们往往只需要常用的参数即可，这里为了是为了方便说明以上参数的作用。
<!--{block name="spacenews" parameter="grade/5/catid/1/gid/4/dateline/86400/lastpost/172800/viewnum/10,11/replynum/11,12/trackbacknum/12,13/goodrate/13,14/badrate/14,15/digest/3/top/3/haveattach/1/showspacename/1/showgroupname/1/order/i.dateline DESC,i.lastpost ASC,i.viewnum DESC/limit/0,10/cachetime/900/subjectlen/34/subjectdot/1/showdetail/1/messagelen/100/messagedot/1/showcategory/1/cachename/ceshi/tpl/data"}--><!--测试-->
解释说明：
   我们可以根据以上的参数说明一一读取这段模块的意义：
grade/5表示审核等级为5
catid/1表示站点分类中id为5的类别中调用，其中id的好可以在后台点击创建新模块，然后查看源代码，即可查看；
viewnum/10,11 表示查看数在10到11之间
order/i.dateline DESC,i.lastpost ASC,i.viewnum DESC/ 这段看上去比较复杂，其实很简单，其实这个就是为调用的数据排序，只不过排序的标准有多个而已，这个表示：第一排序按时间降序，第二排序按回复时间升序，第三排序按查看数降序，
cachename/ceshi 表示模块变量名为ceshi，这个名称只你自己随便取得，目的方便你在调用数据时使用这个别名，而且这个是必须有的参数，这个名称最好用英文，当然，也可以是中文，中文的话，要经过编码，并且调用时也只能用经过编码后的名称，所以强烈名称为英文或字母。这个意义可能大家不明白，没关系，举个简单的例子：
现在我要显示网页设计栏目的文章列表，并按查看数排列
那么就可以这样：
<!-- 网页设计阅读排行 -->
<!--{block name="spacenews" parameter="order/i.viewnum DESC/subjectlen/34/limit/0,15/cachetime/13600/showspacename/1/cachename/wangyesheji/tpl/data"}-->
<div id="focus">
<ul class="msgtitlelist linelist">
<!--{loop $_SBLOCK[wangyesheji] $value}-->
    <li><cite><a href="#uid/$value[uid]#">$value[username]</a> </cite>[<a href="#action/$value[type]#">{$lang[$value[type]]}</a>] <a href="$value[url]">$value[subject]</a></li>
<!--{/loop}-->
</ul>
</div>
其中<!--{loop $_SBLOCK[wangyesheji] $value}-->中的wangyesheji就是模块中的别名，即/cachename/wangyesheji

 

模块功能是 SupeSite 系统的一个亮点，通过该功能您可以随心所欲的打造您需要的模板，什么地方显示什么模块，调用什么内容，如何样的风格，尽在您的掌握。
在模块管理中，通过选择现有的模板代码，根据自己的需要，添加到站点模板文件的任意位置中，便可以实现对论坛、UCenter Home 上面的信息的读取显示。选择不同的基本模块，可以查看该基本模块下面的已有模块代码。您也可以通过创建模块操作，根据自己的需求，进行模块添加操作。只获取数据的模块只能进行模板内部调用，其他类模板代码可以进行两种模式的调用显示：模板内部调用、JavaScript 调用。数据会自动缓存并按指定的时间间隔进行周期更新。
通过创建不同的模块代码，并放置于模板中加以使用，就可以实现对论坛或 UCenter Home 上面的数据灵活显示。选择一个基本模块，在出现的创建模块向导页面中，根据站内对显示数据内容的需求进行自由设定，提交后就可以获得需要的模块代码了。选择模块风格为只获取数据时，模块将会把满足条件的数据读入到 $_SBLOCK[变量名] 数组中，您可以在模板文件对该数组变量进行自由操作，非常方便。
SupeSite 7.0 的数据调用设置的位置在：SupeSite后台 => 模块管理，数据调用可以调用三方面的数据：SupeSite、Discuz!、UCenter Home，但他们调用代码的格式都是一样的.

 

来自: http://hi.baidu.com/zhoujiping/blog/item/a364b57ed7547a330dd7da32.html