bees模板标签制作说明.doc

模板原理模板标签在模板文件中使用标签原理：标签获取的值都是使用php自定义函数，书写规则必须按照函数规则书写，可以自定义函数使用，函数放在includes/lib.php中处理标签输出的值可以结合php函数使用实例：loop source=get_article(index_1) tpl=案例展示 tpl_id=index_1print $vstyle_title/print date(m-d,$vupdatetime)/loop 模板结构模板统一放在template文件下，新建立目录保存模板，使用模板时通过目录名使用模板如默认中文模板目录为default，在网站设置中模板风格为default默认主要文件:主页：index.html列表页:list_内容模型名.html内容页：内容模型名_content.html表单页：list_order.html地图页：sitemap.html用户页：member_login.html留言页：book.html客服页：kefu.html主页、列表页、内容页、地图页为基本页，后台可生成静态页面自定义的模板在栏目高级设置中设置后使用模板中使用变量值：可参考注册文件对应的模板使用模板标签书写方式属性之间用空格分开，标签都不使用单双引号，source指定的函数都按照php函数规则书写print $val/输出标签用于显示内容到浏览器,和php中的echo一样。$val可以为函数和循环标签中的$v;如:print get_block_content(contact_us)/输出默认模板联系我们片段内容loop source=get_channel_content(article,0,4)print cn_substr($vtitle,50)/print date(Y-m-d,$vupdatetime)/loop 循环输出文章模型中的4条内容loop */loop循环标签主要用于输出多条内容，和单条内容中的多个信息，如根据ID值获取表中的多个字段内容loop标签的属性有：source指定注册的值；tpl模板位置名称【需要注册模板配置函数】；info模板位置使用说明；tpl_id模板位置标示，用于后台处理（字母数字下划线组合）【需要注册模板配置函数】；item指定输出数组，常用于多维数组输出,输出的值带$source是必须的，使用tpl_id属性可以在后台配置输出的内容，不使用后台将不会生成该位置配置如： loop source=get_article(article) tpl=首页新闻中心 tpl_id=articleprint $vtitle/loop使用了tpl_id,后台输出配置可以对该位置的内容进行输出设置，tpl和tpl_id不能忽略，tpl_id的值必须是字母和数字、下划线组合，要和source函数中的参数值一样，如加粗蓝色部分当使用了tpl_id的时候程序会保存该值作为模板的位置，在后台输出配置可以对该位置做相应的配置【要配合配置函数使用】，完全按照意愿配置，不用再在标签中添加修改输出栏目及其它属性loop source=get_link()./loop输出weblink中的值,没有使用tpl_id后台输出设置将不会显示配置位置使用item如：loop source=get_link() item=$linkprint $linkname/loop使用item的多级输出如：loop source=get_link() item=$linkprint $linkname/loop source=$link item=$link_childprint $link_childname/loop/loop不使用item如：loop source=get_link()print $vname/loopinclude foot/包含标签包含模板其它文件,多处重复的内容可以另外做成模板，通过include标签引入使用path 文件名/路径标签用于输出路径通过path 目录名/获得目录路径几个特殊路径使用如下path template/模板文件夹template路径，可以自动读取当前语言的模板路径path index/首页路径path cms/安装程序根目录if *else/if判断标签判断使用判断的值要带上$如：if $test print $test/ /ifflash/主广告标签输出flash幻灯【后台主广告配置使用】，直接使用assign source=* name=*/(1.9新增)source指定函数name获得返回的值不使用name默认使用$assign解析为 $assign=get_content();只要使用函数的地方都可以使用如：assign source=get_tpl_cate_content($tpl_id=1,$limit=0,10,$order_type=,$filter=,$pic=no,$order=,$lang=) name=index_arc/if $index_arc /if 常用全局函数常用函数在includes/lib.php文件中lang() 输出语言种类,返回数组无参数，输出所有语言种类，默认有英文和中文，函数可查看lib.php中的lang()函数输出：url：语言链接地址target：是否新窗口打开，需要后台配置使用，输出格式target=_blankclass：高亮选中，样式为focuslang_name：语言名称first：第一个值last：最后一个值显示图片：后台设置：使用：输出为数组，配合loop/loop标签使用实例：loop source=lang() print $vlang_name/ /loopweblangs($param=)输出语言包，返回数组输出网站语言包，常用于一套模板多种语言网站$parama：语言包中的语言标示显示图片:后台设置:输出:输出语言包中各参数，用标示输出使用：配合print /使用实例：模板中输出：print weblangs(contact)/webinfo($param=)网站配置信息，常用于seo优化,返回数组$param：输出网站基本配置参数输出:web_name：网站名称web_powerby：版权信息部分【可以包含统计代码】keywords：搜索关键词description：网站描述【seo】web_beian：网站备案web_yinxiao：营销代码使用：配合print /使用实例：模板页index.html中输出网站名称print webinfo(web_name)/nav_middle()中间导航无参数，输出中间导航，输出内容可查看lib.php输出：url：栏目链接地址class：高亮显示，focuscate_name：栏目名称target：新窗口打开，输出格式为target=_blankchild：下级栏目数组，输出内容和顶级栏目一样，没有高亮演示图片：后台设置：使用：和loop/loop配合使用实例：输出顶级栏目：index.html输出顶级loop source=nav_middle()print $nav_childcate_name/loopindex.html中输出顶级和下级loop source=nav_middle() item=$nav_child print $nav_childcate_name/if $nav_childchild loop source=$nav_childchildprint $vcate_name/loop /if/loopnav_bottom()底部导航无参数，输出底部导航，输出内容可查看lib.php输出：url：栏目链接target：新窗口打开cate_name：栏目名称first：第一个值last：最后一个值使用：配合loop/loop使用实例：foot.html模板页使用标签loop source=nav_bottom()print $vcate_name/if !$vlast|/if/loopget_article(tpl_id)输出内容列表,通过后台配置使用tpl_id模板标签中的tpl_id,和loop标签配合使用,输出内容可查看lib.php图片演示：后台操作：get_channel_content($table,$limit=0,5,$order_type=id,$filter=,$pic=no,$order=desc,$lang=)输出指定模型表内容参数必须按顺序参数：$table：模型表，不带前缀$limit：数量，和sql语法中的limit一样$order_type：排序类型，id为按id排序，hits为点击热门排序$filter：过滤内容，如推荐(a)、头条(b)等$pic：是否有图片$order：排序方式，asc和desc两种$lang：语言，默认程序文件为空可自动获取输出：title：标题style：标题样式，直接使用在style里，如style=print $vstyle/格式为color:red(1.9新增)target：新窗口打开url：链接地址thumb_pic：缩略图(1.9更改)cate_url：对应栏目地址cate_name：对应栏目名称autoindex：输出列表数量值，从1开始，如$limit=0,5，输出从1到5的值first：判断第一条内容last：判断最后一条内容同时可获得模型表和主表中的各字段内容演示图片：后台操作：使用：配合loop/loop使用实例：article_content.html中使用loop source=get_channel_content(product,0,5,b)print cn_substr($vtitle,10)/print cn_substr($vinfo,50)/loopget_cate_content($cate_id,$limit=0,5,$order_type=id,$filter=,$pic=no,$order=desc,$lang=)指定栏目内容输出参数必须按顺序参数：$cate_id：栏目id$limit：数量，和sql语法中的limit一样$order_type：排序类型，id为按id排序，hits为点击热门排序$filter：过滤内容，如推荐(a)、头条(b)等$pic：是否有图片$order：排序方式，asc和desc两种$lang：语言，默认程序文件为空可自动获取演示图片：后台操作：输出：title：标题style：标题样式，直接使用在style里，如style=print $vstyle/格式为color:red(1.9新增)target：新窗口打开url：链接地址thumb_pic：缩略图(1.9更改)cate_url：对应栏目地址cate_name：对应栏目名称autoindex：输出列表数量值，从1开始，如$limit=0,5，输出从1到5的值first：判断第一条内容last：判断最后一条内容同时可获得模型表和主表中的各字段内容使用：配合loop/loop使用实例：同指定模型表一样用法get_else_content($cate_id=,$limit=0,5,$order_type=id,$filter=,$pic=no,$lang=)指定栏目其它方式输出,内容页列表页默认程序可自动获取栏目id参数：$cate_id：栏目id$limit：数量，和sql语法中的limit一样$order_type：排序类型，id为按id排序，hits为点击热门排序$filter：过滤内容，如推荐(a)、头条(b)等$pic：是否有图片$lang：语言，默认程序文件为空可自动获取只能在列表页、内容页、单页使用演示图片：输出：输出内容和指定栏目内容输出一样实例：参考指定栏目输出实例get_block_content($block=)指定片段（标示）内容输出，不通过后台配置使用参数：$block：标示名演示图片：后台操作：输出：标示内容使用：配合print /使用实例：article_content.html中使用print get_block_content(contact_us)/get_block(tpl_id)输出片段（标示）内容,通过后台配置使用tpl_id模板标签中的tpl_id,和block标签配合使用，只输出后台添加的标示内容get_hot_words()搜索热门词无参数，输出网站配置中热门搜索词,自动判断语言演示图片：后台操作：输出：url：关键词链接name：关键词名使用：和loop/loop配合使用实例：index.html模板页使用loop source=get_hot_words()print $vname/loopget_market()客服列表，数组无参数，输出当前语言添加的客服输出：market_name：客服名称，如销售客服、技术客服market_num：客服号码，如电话号码、QQ号码market_type：客服类型使用：配合loop/loop标签使用实例：可参考kefu.html使用get_link()友情链接，返回数组无参数，输出友情链接，自动判断语言类型输出：link_name：链接名称link_url：链接地址link_logo：链接logo图片使用：配合loop/loop使用实例：index.html中使用：loop source=get_link()print $vlink_name/loopcateinfo($param=)栏目信息，用于SEO优化输出栏目信息$param：输出的内容输出：cate_name：栏目名称(1.9更改)cate_title_seo：栏目标题(1.9更改)cate_key_seo：栏目关键词(1.9更改)cate_info_seo：栏目描述(1.9更改)使用：配合print /使用实例：list_article.html中使用print webinfo(keywords)/print webinfo(description)/get_list_nav(tpl_id)输出列表页内容页导航列表tpl_id模板标签中的tpl_id参数为空自动获取当前栏目id值form(tpl_id)输出表单,通过后台配置输出tpl_id模板标签form中的tpl_id,和form标签结合使用，返回表单代码get_form($form_id=)指定输出表单，不通过后台配置使用参数：$form_id：表单标示名称输出：表单使用：print get_form(表单标示)/使用get_book_content($limit=0,5,$order=addtime,$is_reply=0,$lang=)获取留言内容参数：$limit：数量$order：排序类型，addtime添加时间，id排序$is_reply：是否回复，1为是，0为否$lang：指定语言输出：输出留言表book中的各字段内容get_lan_link($cate=)指定栏目输出，常用于输出单个栏目及其更多链接参数：$cate：栏目ID值输出：cate_name：栏目名称url：栏目链接使用：loop source=get_lan_link(5)print $vcate_name/loopget_web_param($param=)输出程序页中的变量值参数：$param：程序中的变量名输出：变量的值使用：如show_content.php中的 $lang 值在模板中使用print get_web_param(lang)/ 输出$lang的值 get_table_field_value($id=,$table=,$field=)根据内容ID获取表中的字段值该函数必须要存在表和内容才是使用参数：$id：已经添加的内容ID值$table：主表或模型表，只能使用一个表$field：表中的字段，多个字段用,分割输出：表中字段的内容和loop/loop标签使用使用：loop source=get_table_field_value(5,article,content)print $vcontent/loopget_tpl_cate_content($tpl_id=,$limit=0,5,$order_type=id,$filter=,$pic=no,$order=desc,$lang=)根据栏目模板ID指定栏目内容输出参数必须按顺序该函数只能配合assign /loop/标签使用参数：$tpl_id：栏目模板ID值$limit：数量，和sql语法中的limit一样$order_type：排序类型，id为按id排序，hits为点击热门排序$filter：过滤内容，如推荐(a)、头条(b)等$pic：是否有图片$order：排序方式，asc和desc两种$lang：语言，默认程序文件为空可自动获取演示图片：后台操作：输出：输出2个数组，栏目信息和列表内容栏目为arrcate,配合print /使用arrcatecate_url：对应栏目地址arrcatecate_name：对应栏目名称arrcatetarget：是否新窗口arrcatecate_pi1：栏目图片1arrcatecate_pi2：栏目图片2arrcatecate_pi3：栏目图片3arrcatecate_content：栏目内容内容列表为arrcontents，配合loop/loop使用，输出内容和上面的函数内容一样arrcontentstitle：标题arrcontentsstyle：标题样式，直接使用在style里，如style=print $vstyle/格式为color:red(1.9新增)arrcontentstarget：新窗口打开arrcontentsurl：链接地址arrcontentsthumb_pic：缩略图(1.9更改)arrcontentsautoindex：输出列表数量值，从1开始，如$limit=0,5，输出从1到5的值arrcontentsfirst：判断第一条内容arrcontentslast：判断最后一条内容同时可获得模型表和主表中的各字段内容使用：配合assing/loop/loopprint /使用实例：assign source=get_tpl_cate_content($tpl_id=1,$limit=0,10,$order_type=,$filter=,$pic=no,$order=,$lang=) name=index_arc/if $index_arcprint $index_arccatecate_name/loop source=$index_arccontentsprint cn_substr($vtitle,40)/print date(m-d,$vupdatetime)/loop /ifget_all_cate_content($tpl_id=,$content=no,$limit=0,5,$order_type=id,$filter=,$pic=no,$order=desc,$lang=)根据栏目模板ID输出该栏目的下级栏目及其内容(1.9新增)参数必须按顺序该函数只能配合assign /loop/标签使用，该函数实例可以参考默认模板参数：$tpl_id：栏目模板ID值$content：是否输出内容列表，no为否，yes为是$limit：数量，和sql语法中的limit一样$order_type：排序类型，id为按id排序，hits为点击热门排序$filter：过滤内容，如推荐(a)、头条(b)等$pic：是否有图片$order：排序方式，asc和desc两种$lang：语言，默认程序文件为空可自动获取演示图片：后台操作：输出：输出2个数组，栏目信息和列表内容栏目为arrcate,配合print /使用arrcatecate_url：对应栏目地址arrcatecate_name：对应栏目名称arrcatetarget：是否新窗口arrcatecate_pi1：栏目图片1arrcatecate_pi2：栏目图片2arrcatecate_pi3：栏目图片3arrcatecate_content：栏目内容内容列表为arrcontents，配合loop/loop使用，输出内容和上面的函数内容一样arrcontentstitle：标题arrcontentsstyle：标题样式，直接使用在style里，如style=print $vstyle/格式为color:redarrcontentstarget：新窗口打开arrcontentsurl：链接地址arrcontentsthumb_pic：缩略图arrcontentsautoindex：输出列表数量值，从1开始，如$limit=0,5，输出从1到5的值arrcontentsfirst：判断第一条内容arrcontentslast：判断最后一条内容同时可获得模型表和主表中的各字段内容使用：配合assing/loop/loopprint /使用实例：assign source=get_all_cate_content($tpl_id=2,$content=yes,$limit=0,8,$order_type=id,$filter=,$pic=no,$order=desc,$lang=) name=arc/if $arcloop source=$arc item=$arc_vprint $arc_vcatecate_name/loop source=$arc_vcontentsprint cn_substr($vtitle,40)/print date(m-d,$vupdatetime)/loop /loop/ifget_tpl_list_nav($tpl_id=)根据栏目模板ID输出该栏目的下级栏目(1.9新增)参数必须按顺序参数：$tpl_id：栏目模板ID值，为空自动获取当前栏目ID值演示图片：后台操作：输出：url：对应栏目地址cate_name：对应栏目名称target：是否新窗口cate_pi1：栏目图片1cate_pi2：栏目图片2cate_pi3：栏目图片3cate_content：栏目内容class：高亮选中样式child：栏目的下级栏目(数组)使用：配合assing/loop/loopprint /使用实例：用法和后台配置那个函数一样常用列表页函数常用函数在includes/lib.php文件中cateinfo($param=)栏目信息，用于SEO优化输出栏目信息输出：cate_name：栏目名称(1.9更改)cate_title_seo：栏目标题(1.9更改)cate_key_seo：栏目关键词(1.9更改)cate_info_seo：栏目描述(1.9更改)使用：配合print /使用实例：list_article.html中使用print $cateinfokeywords/print $cateinfodescription/get_list_nav(tpl_id)输出列表页内容页导航列表参数：tpl_id模板标签中的tpl_id，使用tpl_id后台可进行配置参数为空会自动获取当前栏目的下级栏目输出：url：栏目链接class：高亮显示，默认为focus；cate_name：栏目名称id：栏目IDchild：栏目下级栏目first：第一个值last：最后一个值target：新窗口打开使用：配合loop/loop标签使用实例：list_article.html模板页中使用使用后台配置loop source=get_list_nav(list_nav1) tpl=列表页导航 tpl_id=list_nav1 print $navcate_name/ /loop自动获取栏目loop source=get_list_nav() item=$nav print $navcate_name/ /loop输出下级栏目：loop source=get_list_nav() item=$nav print $navcate_name/loop source=$navchildprint $vcate_name/loop /looplist_article()输出列表页列表无参数，和loop标签配合使用输出：style：样式,配合style使用，如style=print $vstyle/(1.9新增)title：标题target：新窗口打开url：链接地址thumb_pic：缩略图(1.9更改)first：第一个值last：最后一个值可输出主表maintb和栏目的附加表（如文章栏目附加表article）中的字段值使用：配合loop/loop标签使用实例：list_article.html中使用loop source=list_article()print $vstyle_title/looplist_page()列表页分页无参数，返回列表页html代码，格式为首页实例：list_article.html中使用print list_page()/常用内容页函数常用函数在includes/lib.php文件中content($param=)基本内容输出该函数主要用于输出程序文件show_content.php中的变量$content的值参数：$param：输出各内容部分实例：article_content.htm中使用print content(主表和附加表各字段内容)/get_list_nav(tpl_id)输出列表页内容页导航列表参数：tpl_id模板标签中的tpl_id，使用tpl_id后台可进行配置参数为空会自动获取当前栏目的下级栏目输出：url：栏目链接class：高亮显示，默认为focus；cate_name：栏目名称id：栏目IDchild：栏目下级栏目first：第一个值last：最后一个值target：新窗口打开使用：配合loop/loop标签使用实例：list_article.html模板页中使用使用后台配置loop source=get_list_nav(list_nav1) tpl_id=list_nav1 print $navcate_name/ /loop自动获取栏目loop source=get_list_nav() item=$nav print $navcate_name/ /loop输出下级栏目：loop source=get_list_nav() item=$nav print $navcate_name/loop source=$navchildprint $vcate_name/loop /loopbody_pages()内容页分页无参数，返回分页html代码实例：article_content.html使用print body_pages()/album(多图字段名)多图输出参数使用多图字段名，返回图片数组输出：pic：图片大图alt：图片alt内容thumb：图片缩略图使用：配合loop/loop使用实例：product_content.html中使用loop source=album(pics)/loop可参考产品模板页使用常用其它函数常用函数在includes/lib.php文件中get_sitemap()网站地图无参数，返回地图html代码使用可参考sitemap.htmlget_search()搜索列表无参数，返回搜索数组，和loop结合使用使用可参考search.htmlget_search_page()搜索分页无参数，返回分页html代码使用可参考search.html制作实例如何使用标签以loop标签（可以使用后台输出配置）为例：一、书写或复制一份标签放在需要输出的位置，如：index.html模板中加入loop source=get_