SupeSite7.0数据调用模块参数详解.doc

SupeSite7.0数据调用模块参数详解22 康盛创想（北京）科技有限公司  模块简介 模块功能是 SupeSite 系统的一个亮点，通过该功能您可以随心所欲的打造您需要的模板，什么地方显示什么模块，调用什么内容，如何样的风格，尽在您的掌握。 在模块管理中，通过选择现有的模板代码，根据自己的需要，添加到站点模板文件的任意位置中，便可以实现对论坛、UCenter Home 上面的信息的读取显示。选择不同的基本模块，可以查看该基本模块下面的已有模块代码。您也可以通过创建模块操作，根据自己的需求，进行模块添加操作。只获取数据的模块只能进行模板内部调用，其他类模板代码可以进行两种模式的调用显示：模板内部调用、JavaScript 调用。数据会自动缓存并按指定的时间间隔进行周期更新。 通过创建不同的模块代码，并放置于模板中加以使用，就可以实现对论坛或 UCenter Home 上面的数据灵活显示。选择一个基本模块，在出现的创建模块向导页面中，根据站内对显示数据内容的需求进行自由设定，提交后就可以获得需要的模块代码了。选择模块风格为只获取数据时，模块将会把满足条件的数据读入到 $_SBLOCK[变量名] 数组中，您可以在模板文件对该数组变量进行自由操作，非常方便。 SupeSite 7.0 的数据调用设置的位置在：SupeSite后台 = 模块管理，数据调用可以调用三方面的数据：SupeSite、Discuz!、UCenter Home，但他们调用代码的格式都是一样的，均为 !--{block name=”模块名” parameter=”参数列表”}-- 例如：调用最新发布的资讯列表，共调用5条，要求调用出资讯的内容及所属分类的信息 !--{block name=spacenews parameter=order/i.dateline DESC/limit/0,5/cachetime/900/subjectlen/20/showdetail/1/messagelen/200/messagedot/1/showcategory/1/cachename/new_news/tpl/data}-- 当看到parameter参数列表中长长的参数，也许会不了解每一个参数代表什么含义，有哪些参数可以使用，下面将详细的罗列出每一个模块，以及该模块中可以使用的参数及参数值。 本文件适用产品版本 程序版本: SupeSite 7.0 () 参数列表中的一些约定 所有参数的参数名和参数值中间使用 / 连接。 一组参数名和参数值组成一组参数对，参数对之间使用 / 连接。 参数值中，可写多个参数值的，均用英文逗号 , 分隔。 参数可选值中，若要选择 0 为值，则此参数对不需要书写。 各个模块所列出来的参数名均可使用，但此列表不保证完全与SupeSite后台，创建模块中看到的各个参数一致。 各个模块通用参数列表单独列出，表示每一个模块均可以使用这些通用的参数。 参数列表中正常的黑色字体“显示指定数目的信息好评分范围 支持的模块名和对应的参数列表 模块名 各个模块通用参数列表 参数名 参数可选值 说明 举例 limit 显示指定数目的信息，设置起始数据行数和显示数据条数，中间使用英文逗号分隔，前5条数据为0,5，第6到10条数据为5,5，此参数不可与perpage参数同时使用，若同时出现limit和perpage，则perpage参数生效， 如果参数中limit和perpage均不出现，则默认使用limit/0,1/参数 limit/0,5/ limit/5,5/ perpage 设定每页显示的数目，表示读取所有满足条件的信息，并分页显示，默认为20，此参数不可与limit参数同时使用，若同时出现limit和perpage，则perpage参数生效，如果参数中limit和perpage均不出现，则默认使用limit/0,1/参数 perpage/25/ cachetime 缓存更新时间间隔，单位为秒，15分钟更新一次为900 cachetime/900/ cachename 变量名，可以任意设置，您可以把获取的数据集合放置到一个模块变量中，在模板文件中可以使用 $_SBLOCK[变量名] 来调用该数据集合 cachename/hotnews/ tpl data 用来控制该模块数据的显示样式的模板文件名，只调用结果数据，不需要显示样式，请填写data，需要显示样式请自行填写创建的风格模板名称 tpl/data/ tpl/subject_li/ 模块名 spacenews 参数名 参数可选值 说明 举例 itemid 指定资讯的itemid(s)，多个itemid使用英文逗