phpcmsv9二次开发手册

1、PHPCMSV9二次开发文档文件目录结构根目录|-api接口文件目录|-caches缓存文件目录|-configs系统配置文件目录|-caches_*系统缓存目录|phpcmsphpcms框架主目录|-languages框架语言包目录|-libs框架主类库、主函数库目录|-model框架数据库模型目录|-modules框架模块目录|-templates框架系统模板目录|-phpsso_serverphpsso主目录|-statics系统附件包|-css系统css包|-images系统图片包|-js系统js包|-uploadfile网站附件目录|-admin.php后台管理入口|-index.p

2、hp程序主入口|-crossdomain.xmlFLASH跨域传输文件|-robots.txt搜索引擎蜘蛛限制配置文件|-favicon.ico系统icon图标PC标签使用说明在PHPCMSV9中我们正式开始需要PC标签做为数据的获取的方式。PC标签是以下面的方式进行声明pc:contentaction=listscache=3600num=20page=$page/pcPC标签必须以pc开头，并以/pc结尾的代码片段。当然不以/pc结尾并不会引起程序致命性的错误，导致程序无法继续运行。以下为两种已知可能会出现的问题：1 .当网页中出现两个PC标签时，可能会使得没有闭合的PC标签之后的PC标签

3、数据和其混乱。2 .在后台可视化编辑时，可能出现网页结构错乱的问题。PC标签分析：PC标签中pc:冒号之后跟随的为模块名。如上面的例子中调用的是内容模型的PC标签。action=list这个形式所代表的是参数。每一个PHPCMSV9模型都为其PC标签定义了调用的参数。其中有一些调用参数是系统保留的参数，其对所有的PC标签都是有效的。参数必须使用参数名=参数值的方式填写，多个参数之间使用空格分开（如下例），参数值可使用双引号来包括，无论是什么形式的引号都必须是成对出现的。pc:content参数名=参数值参数名=参数值参数名=参数值请查看PC标签保留参数相关章节，以了解具体保留参数及其用途。PC

4、标签分类:PC标签包含两个类别，分别为:1 .工具类2 .模块类工具类，大体上可以理解为PHPCMSV9所提供的一些工具箱。请查看PC标签工具箱相关章节，以了解更多关于工具类的PC标签的更多信息。而模块类，是PHPCMSV9各个模型提供给大家调用模块数据的数据接口。查看具体模块的相关说明章节，以了解更多关于模块类的PC标签的更多信息。如何显示PC标签中的数据：默认情况下PC标签中的数据都是数组方式返回的，你都可以通过$data来获取到这个数组，如果你在PC标签中定义了return参数，返回的数组将使用return的值进行命令。一般情况下你可以使用如下的方式来显示值：loop$data$key$

5、val$valtitle/loop基中的$valurl和$valtitle需要具体根据所使用的PC标签，返回的数据来判断。PC标签保留参数卜表为PC标签保留参数表，几乎所有的PC标签都支持这些保留参数设置变量名默认值说明actionnull本参数的值表示为操作事件， 模型类 PC标签必须使用包含本参数，以说明要进行的操作。cache0缓存存储时间（单位秒）num20获取记录的条数，最后会被模板引擎处理成 limit 传送到处理函数中。pagenull当前分页。一般填写为$_GETpageurlrulenullURL 规贝 Ureturndata返回数据变量名下例中是一个完整的使用例子。pc:c

6、ontentaction=listscatid=25num=20page=$_GETpagereturn=dataloop$data$n$r$rtitle/loop/pcget标签GET标签源自于PHPCMS2008版，其使用SQL语句直接获取数据的特性，成为大家制作模板的首选。在V9中这样强大的工具也得到保留下来。GET标签使用方式如下：pc:getsql=SELECT*FROMphpcms_membercache=3600page=$pagedbsource=discuzreturn=dataloop$data$key$val$valusername/loop$page/pc从上面的代码里

7、面可以看出GET标签所支持的参数。对照下面的列表了解每一个参数的用途：参数默认值必须说明sqlnull是要执行的 SQL 语句cache0否缓存时间，单位为秒page0否分页，通过变量把当前的分布传给 PC 标签进行处理dbsource null数据源，当你通过系统后台的数据源模块配置过数据源时，可把数据源名填写到这里，系统会去对应的数据本系统的数据请留空returndata返回的数据的变量内容模块内容模块PC标签调用说明模块名：content模块提供的可用操作操作名说明lists内容数据列表relation内容相关文章hits内容数据点击排行榜category内容栏目列表position内容

8、推荐位列表position操作说明如下:内容推荐位列表（position）可用参数:参数名是否必须默认值说明posid是null推荐位 IDcatid否null调用栏目 IDthumb否0是否仅必须缩略图order否null排序类型num是null数据调用数量代码例子:pc:contentaction=positionposid=2order=listorderDESCnum=4loop$data$key$val$valtitle/loop/pc返回参数如下表:字段类型空默认注释titlechar(80)否NULL推荐位标题urlchar否NULL推荐位链接地址inputtimeint(10)

9、否NULL推荐位发布时间thumbchar是NULL推荐位缩略图其他/、定是根据模型所设置的加入到推荐位中字段名称内容列表（lists）可用参数:参数名是否必须默认值说明catid否null调用栏目 IDwhere否Inullsql 语句的 where 部分thumb否|0是否仅必须缩略图order否|null排序类型num是null数据调用数量moreinfo否0是否调用副表数据提醒：从PHPCMSV9Beta20101105版本开始支持moreinfo参数属性，本参数表示在返回数据的时候，会把副表中的数据也一起返回。一个内容模型分为2个表，一个主表一个副表,主表中一般是保存了标题、所属栏目

10、等等短小的数据（方便用于索引），而副表则保存了大字段的数据，如内容等数据。在模型管理中新建字段的时候，是允许你选择存入到主表还是副表的（我们推荐的是，把不重要的信息放到副表中）。想要在列表中调取副表的数据就需要在PC标签中使用moreinfo这个属性。代码例子:pc:contentaction=listscatid=2order=idDESCnum=4loop$data$key$val$valtitle/loop/pcwhere用法：pc:contentaction=listscatid=2where=thumb!=ANDstatus=99order=idDESCnum=4loop$data$

11、key$val$valtitle/loop/pc返回参数如下表：字段类型空默认注释titlechar(80)否NULL推荐位标题urlchar否NULL推荐位链接地址inputtimeint(10)否NULL推荐位发布时间thumbchar是NULL推荐位缩略图其他不定是其他模型字段点击排行榜（hits）可用参数:参数名是否必须默认直说明catid否null调用栏目 IDday否0调用多少天内的排行order否nullr排序类型（本月排行-monthviewsDESC、本周排行-weekviewsDESC、今日排行-dayviewsDESC）num是null1数据调用数量代码例子:pc:con

12、tentaction=hitscatid=2order=weekviewsDESCnum=10loop$data$key$val$valtitle/loop/pc返回参数如下表:字段类型空默认注释titlechar(80)否NULL推荐位标题urlchar否NULL推荐位链接地址inputtimeint(10)否NULL推荐位发布时间thumbchar是NULL推荐位缩略图其他/、定是其他模型字段相关文章（relation）可用参数:参数名是否必须默认值说明catid否null调用栏目 IDrelation否$relation无需更改keywords否null内容页面取值：$rskeyword

13、snum是null数据调用数量代码例子:pc:contentaction=relationrelation=$relationcatid=$catidnum=5keywords=$rskeywordsloop$data$r$rtitle(date(Y-m-d,$rinputtime)/loop/pc返回参数如下表:字段类型空默认注释titlechar(80)否NULL推荐位标题urlchar否NULL推荐位链接地址inputtimeint(10)否NULL推荐位发布时间thumbchar是NULL推荐位缩略图!其他/、定是其他模型字段栏目列表（category）可用参数:参数名是否必须默认值说

14、明catid否0调用该栏目下的所有栏目，默认 0,调用一级栏目$siteid否1默认调用系统站点order否|null排序方式、一般按照 listorderASC 排序，即栏目的添加顺序代码例子:pc:contentaction=categorycatid=0num=25siteid=$siteidorder=listorderASCloop$data$r$rcatname/loop/pc返回参数如下表:字段类型默认值说明catidsmallint无栏目 IDsiteidtinyint(3)0站点 IDmodulevarchar(15)无模块 IDtypetinyint(1)1栏目类型 IDmodelidtinyint(5)5模型 IDparentidsmallint(5)5上级父栏目arrparentidvarchar(255)无所有父栏目childtinyint(1)0子栏目arrchildidmediumtext无所有子栏目catnamevarchar(30)无栏目名称imagevarchar(100)无栏目图片descriptionmedi