phpcms 语句语法.doc

CMS通提示：本文为CMS通站长站对PHPCMS官方提供的PHPCMS模板语法进行了详细的解述，方便使用PHPCMS的站长朋友们加深对PHPCMS模板的理解，文中也对各语法在PHPCMS模板中具体的使用进行了举例。 标签：PHPCMS模板语法模板修改PHPCMS模板一、PHPCMS模板语法规则1、变量表示$name 被解析成 ，表示显示变量$name的值，其中的“name”由英文字母、数字和下划线组成首字母必须是英文字母或者下划线。如：内容页常用到的表示文章标题的$title，表示文章摘要的$discription，表示文章内容的$content，表示文章关键词的$keywords，另外就是GET标签调用数据是常用的$rtitle，$rurl等，登陆用户的ID一般为$_userid蓝色部分文字为CMS通注释，下同2、常量表示name被解析成，表示显示常量name的值，其中的“name”由英文字母、数字和下划线组成首字母必须是英文字母或者下划线。如：当间时间TIME，当前浏览的地址URL(在模板中加页内锚链接可用锚文字，id可以为要跳转到的地方附近的div等的id属性值，如down_address等)3、条件判断if * * else * else * /if 或者 if * * /if，其中if *中的*就是此判断语句的条件表达式，符合php的表达式。在PHPCMS模板中常用条件判断，选择性显示某些值，如：当我们想在没填写文章来源时默认显示本站网站名，则可以if $copyfrom$copyfromelseCMS通/if；又如在显示用户信息是如果没填写的项不显示：if $tel手机：$tel/if等。又如，你想在文章列表中使今天更新的文章的日期显示为红色，可以if date(m-d,TIME)=date(m-d,$rinputtime)date(Y-m-d,$rinputtime)elsedate(Y-m-d),$rinputtime/ifif $userid $usernameelse $noname/if判断用户组可以用if $_groupid=1显示用户组ID为1的用户组能显示的内容/if4、循环loop $a $b * /loop 或者 loop $a $b $c * /loop ，loop $a $b * /loop被解析成 * 而 loop $a $b $c * /loop 则被解析成 $c) ? * 循环标签一般用在对PHP中传给模板的数组变量进行循环，如果站长朋友们是自己PHP代码修改代码，那loop标签一般自己用到的比较少，主要用到的在PHPCMS的标签模板中和碎片模板中，如：XML/HTML代码1. loop$data$n$r 2. if$showdatedate(m月d日,$rupdatetime)/if 3. if$showcatname$CATEGORY$rcatidcatname/if 4. if$rstylestr_cut($rtitle,$titlelen)elsestr_cut($rtitle,$titlelen)/if5. /loop上面的代码是复制于落叶修改后的tag_content.html模板中,通过loop循环，把标签读取的$data数组中记录的内容循环格式化输出。5.模板包含template module name,file name例如: template phpcms,header表示包含模板目录,phpcms目录下header.html文件简单来讲，如果在模板中包含中某模板或HTML文件，可直接将文件放在相应目录下，然后包含，如想在phpcms模板目录下的index.html中包含abc.html文件，只需将abc.html上传到templates/default/phpcms目录下，然后在该目录下的index.html中加上template phpcms,abc即可，其它模块类似操作，只是修改文件所在目录名(和模块名相同)和要引用的文件名即可建议 if 和 loop 语法应该写在html注释符之间，这样可以避免在编辑工具中难看，例如：这样写 if$b- 这样写 loop 这是一般模板引擎都基本采用的方式，模板中的变量或者语法都可以用HTML注释方式注释起来，这样直接浏览模板时可视化效果会清晰。HTML注释方式:如果您不习惯这套语法，也可以直接在模板中书写php代码，例如本文网址：/cmshelp/show/25.shtmlCMS通提示：本文为CMS通站长站对PHPCMS官方提供的PHPCMS模板语法进行了详细的解述，方便使用PHPCMS的站长朋友们加深对PHPCMS模板的理解，文中也对各语法在PHPCMS模板中具体的使用进行了举例。 标签：PHPCMS模板语法模板修改PHPCMS模板二、PHPCMS模板制作常用变量常用的系统变量打开文件 ./include/common.inc.phpIP /取得ip TIME /取得时间戳，格式（1229393941 ）可以通过date 函数格式化一个本地时间日期，请参考php手册 在PHPCMS中PHP文件中使用可直接用TIME，而在模板中输出当前时间即可用date(Y-m-d,TIME)URL /取得当前浏览的url地址 SITE_URL /网站的url地址 /以上是系统常量，直接调用，如（） $MODULE /系统模块信息 MODULEphpcms = Array ( module = phpcms name = Phpcms path = url = iscore = 1 version = ) $MODEL /模型信息 MODEL = Array ( 1 = Array ( modelid = 1 name = 新闻 description = tablename = news itemname = 新闻 itemunit = 篇 workflowid = 1 template_category = category template_list = list template_show = show template_print = print ishtml = 1 category_urlruleid = 1 show_urlruleid = 7 enablesearch = 1 ischeck = 1 isrelated = 1 disabled = 0 modeltype = 0 ) ) 模块缓存或以直接在模板中或者PHP文件中用$MODEL$modelid.读取模板相关的信息，如当前模板为PHPCMS的文章模板，可以直接使用$MODEL1name读取模块ID为1的模块名称，详细介绍请见CMS通常PHPCMS二次开发栏目的PHPCMS二次开发手册注释详解。$CATEGORY /栏目信息 CATEGORY = Array ( 1 = Array ( catid = 1 module = phpcms type = 1 modelid = 0 catname = 网站介绍 style = image = catdir = about url = /cms/phpcms_utf/about/index.html parentid = 0 arrparentid = 0 parentdir = child = 1 arrchildid = 1,2,3,4,5 items = 0 ismenu = 0 ) ) 同样，落叶在修改PHPCMS程序或模板时常用到读取当前栏目的父栏目ID，可直接用栏目缓存变量$CATEGORY$catidpatentid读取，这在模板中内容页修改面包屑导航，显示当前文章文章所在的栏目及该栏目的父栏目时用到。如：本文处于CMS通首页-CMS教程-phpcms-高级技巧栏目下，虽然PHPCMS模板中使用一个函数可以直接读取该文章的所有父目录，但有时如果目录层级太深，不方便将所有父目录级别全显示，而只需要显示该文章所在的栏目，及该栏目的上一级目录，则可用该目录缓存完成。完成上面包屑导航的两种方法：1.PHPCMS公共函数：XML/HTML代码1. catpos($rcatid)2.栏目缓存变量手动读取：XML/HTML代码1. 2. $CATEGORY$catidcatname3. 4. $CATEGORY$CATEGORY$catidparentidcatname栏目缓存的具体用法可详见CMS通PHPCMS二次开发栏目的开发文档详细解读文章。$TYPE /类型信息 TYPE = Array ( 1 = Array ( typeid = 1 module = link name = 默认分类 style = typedir = url = ) ) $AREA /地区信息 AREA = Array ( 1 = Array ( areaid = 1 name = 北京 style = parentid = 0 arrparentid = 0 child = 0 arrchildid = 1 ) ) $URLRULE /url规则信息 URLRULE = Array ( 1 = $categorydir/index.$fileext|$categorydir/$page.$fileext 2 = category/$catid.$fileext|category/$catid_$page.$fileext 3 = $catdir/index.$fileext|$catdir/$page.$fileext 4 = list.php?catid=$catid|list.php?catid=$catid&page=$page 5 = list.php?catid-$catid.html|list.php?catid-$catid/page-$page.html 6 = list-$catid-$page.html 7 = $year/$month$day/$contentid.$fileext|$year/$month$day/$contentid_$page.$fileext 8 = $categorydir/$year/$month$day/$contentid.$fileext|$categorydir/$year/$month$day/$contentid_$page.$fileext 9 = show/$contentid.$fileext|show/$contentid_$page.$fileext 10 = show.php?contentid=$contentid|show.php?contentid=$contentid&page=$page 11 = show.php?contentid-$contentid.html|show.php?contentid-$contentid/page-$page.html 12 = show-$contentid-1.html|show-$contentid-$page.html 13 = $typedir/index.$fileext|$typedir/$page.$fileext 14 = $typedir.$fileext|$typedir_$page.$fileext 15 = $typeid.$fileext|$typeid_$page.$fileext 16 = list.php?typeid=$typeid|list.php?typeid=$typeid&page=$page 17 = list.php?typeid-typeid.html|list.php?typeid-typeid/page-$page.html 19 = $typedir/$filename.$fileext 20 = $typedir_$filename.$fileext 21 = $filename.$fileext 22 = show.php?specialid=$specialid 23 = show.php?specialid-$specialid.html 24 = show-$specialid.html 25 = show-$id.html 26 = ask/list-$catid-$action-1.html|ask/list-$catid-$action-$page.html 27 = $id.html 28 = show.php?id=$id ) URL规则的缓存一般用到不多，如果有用到，一般可用于GET标签读取数据时用该缓存变量来读取相应URL规则，不过那种情况下，直接在GET中写URL规则可能更方便些。$M /存储模块信息，在模块下想得到该模块的信息 可以直接使用$M本文网址：/cmshelp/show/25.shtml二、PHPCMS模板制作常用变量常用的系统变量打开文件 ./include/common.inc.phpIP /取得ip TIME /取得时间戳，格式（1229393941 ）可以通过date 函数格式化一个本地时间日期，请参考php手册 在PHPCMS中PHP文件中使用可直接用TIME，而在模板中输出当前时间即可用date(Y-m-d,TIME)URL /取得当前浏览的url地址 SITE_URL /网站的url地址 /以上是系统常量，直接调用，如（） $MODULE /系统模块信息 MODULEphpcms = Array ( module = phpcms name = Phpcms path = url = iscore = 1 version = ) $MODEL /模型信息 MODEL = Array ( 1 = Array ( modelid = 1 name = 新闻 description = tablename = news itemname = 新闻 itemunit = 篇 workflowid = 1 template_category = category template_list = list template_show = show template_print = print ishtml = 1 category_urlruleid = 1 show_urlruleid = 7 enablesearch = 1 ischeck = 1 isrelated = 1 disabled = 0 modeltype = 0 ) ) 模块缓存或以直接在模板中或者PHP文件中用$MODEL$modelid.读取模板相关的信息，如当前模板为PHPCMS的文章模板，可以直接使用$MODEL1name读取模块ID为1的模块名称，详细介绍请见CMS通常PHPCMS二次开发栏目的PHPCMS二次开发手册注释详解。$CATEGORY /栏目信息 CATEGORY = Array ( 1 = Array ( catid = 1 module = phpcms type = 1 modelid = 0 catname = 网站介绍 style = image = catdir = about url = /cms/phpcms_utf/about/index.html parentid = 0 arrparentid = 0 parentdir = child = 1 arrchildid = 1,2,3,4,5 items = 0 ismenu = 0 ) ) 同样，落叶在修改PHPCMS程序或模板时常用到读取当前栏目的父栏目ID，可直接用栏目缓存变量$CATEGORY$catidpatentid读取，这在模板中内容页修改面包屑导航，显示当前文章文章所在的栏目及该栏目的父栏目时用到。如：本文处于CMS通首页-CMS教程-phpcms-高级技巧栏目下，虽然PHPCMS模板中使用一个函数可以直接读取该文章的所有父目录，但有时如果目录层级太深，不方便将所有父目录级别全显示，而只需要显示该文章所在的栏目，及该栏目的上一级目录，则可用该目录缓存完成。完成上面包屑导航的两种方法：1.PHPCMS公共函数：XML/HTML代码1. catpos($rcatid)2.栏目缓存变量手动读取：XML/HTML代码1. 2. $CATEGORY$catidcatname3. 4. $CATEGORY$CATEGORY$catidparentidcatname栏目缓存的具体用法可详见CMS通PHPCMS二次开发栏目的开发文档详细解读文章。$TYPE /类型信息 TYPE = Array ( 1 = Array ( typeid = 1 module = link name = 默认分类 style = typedir = url = ) ) $AREA /地区信息 AREA = Array ( 1 = Array ( areaid = 1 name = 北京 style = parentid = 0 arrparentid = 0 child = 0 arrchildid = 1 ) ) $URLRULE /url规则信息 URLRULE = Array ( 1 = $categorydir/index.$fileext|$categorydir/$page.$fileext 2 = category/$catid.$fileext|category/$catid_$page.$fileext 3 = $catdir/index.$fileext|$catdir/$page.$fileext 4 = list.php?catid=$catid|list.php?catid=$catid&page=$page 5 = list.php?catid-$catid.html|list.php?catid-$catid/page-$page.html 6 = list-$catid-$page.html 7 = $year/$month$day/$contentid.$fileext|$year/$month$day/$contentid_$page.$fileext 8 = $categorydir/$year/$month$day/$contentid.$fileext|$categorydir/$year/$month$day/$contentid_$page.$fileext 9 = show/$contentid.$fileext|show/$contentid_$page.$fileext 10 = show.php?contentid=$contentid|show.php?contentid=$con