一、通用栏目信息标签(通用)
${bannerImgList} 'Banner高清图列表
${bannerImgSmallList} 'Banner缩略图列表
${bannerImgList_autoplayTime} 'Banner轮换间隔时间
${siteName} '网站主标题,名称
${siteNameComm} '网站主标题,名称(与依赖标签共用)
${siteSubName} '网站副标题
${detail_motto} '网站描述
${myimg} '站长相片地址
${realname} '管理者网名
${age} '年龄
${msn} 'MSN
${email} '电子邮件
${qq} 'QQ
${tel} '电话
${introduce} '个人简介
${detail_conn} '联系方式
${advertisement} '广告位置
${webLink} '网站的绝对地址 (带后斜杠,形如http://www.c945.com/)
${webLink_n} '网站的绝对地址 (不带后斜杠,形如http://www.c945.com)
${MY_secCheckSiteLink} '网站域名地址(形如http://www.c945.com)
${MY_defineName_art} '自定义文件夹-文章
${MY_defineName_work} '自定义文件夹-作品案例
${MySidebar} '侧边栏
${MySidebar_defaultPage} '侧边栏(首页,带友情链接)
${MySidebar_NonCate} '侧边栏-无分类导航
${MY_ProgramCharacter} '程序平台名称
${thisPageSEOURL} '双重收录SEO网址
${landScapeCateNav} '横向分类导航
${columnImgSwitch} '多栏目图片切换
${meta_keywords} 'meta标签-关键词
${meta_author} ' meta标签-作者
${meta_copyright} ' meta标签-版权
${copyright} '版权信息
${Author} '发布作者
${pageURL_comm_home} '通用地址(首页)
${pageURL_comm_mood} '通用地址(站内微博)
${pageURL_comm_contact} '通用地址(留言本)
${pageURL_comm_about} '通用地址(关于我们)
${pageURL_comm_links} '通用地址(友情链接列表)
${pageURL_comm_search} '通用地址(搜索页面)
${pageURL_comm_article} '通用地址(文章列表)
${pageURL_comm_article[文章类别名称]} '通用地址(文章分类列表)
${pageURL_comm_works} '通用地址(案例作品列表)
${pageURL_comm_works[作品类别名称]} '通用地址(案例作品分类列表)
${listcontent_comm_classWorks} '【作品分类】通用侧边模块(用于独立的侧边栏)
${listcontent_comm_classarticle} '【文章分类】通用侧边模块(用于独立的侧边栏)
${listcontent_comm_randomArticle} '【随机文章】通用侧边模块(用于独立的侧边栏)
${listcontent_comm_comment} '【最新评论】通用侧边模块(用于独立的侧边栏)
${listcontent_comm_art} '【最新文章】通用侧边模块(用于独立的侧边栏)
${listcontent_comm_hot_month_art} '【本月热文】通用侧边模块(用于独立的侧边栏)
${listcontent_comm_hot_week_art} '【本周热文】通用侧边模块(用于独立的侧边栏)
${listcontent_comm_hot_art} '【最热文章】通用侧边模块(用于独立的侧边栏)
${listcontent_comm_siteCounter} '【网站统计】通用侧边模块(用于独立的侧边栏)
${listcontent_comm_links} '【友情链接】通用侧边模块(用于独立的侧边栏)
${listcontent_comm_netname} '【站长名字】通用侧边模块(用于独立的侧边栏)
${listcontent_comm_search} '【快速搜索】通用侧边模块(用于独立的侧边栏)
${listcontent_comm_classarticle_landScape} '【横向分类导航-文章】通用模块(用于内容栏和其他区域)
${listcontent_comm_topArticle} '【置顶推荐文章】通用模块(用于内容栏和其他区域)
${listcontent_comm_newcase} '【最新案例推荐】通用模块(用于内容栏和其他区域)
${listcontent_comm_tags} '【随机文章标签】通用模块(用于内容栏和其他区域)
${listcontent_comm_newcase[作品类别名称]} '【最新推荐作品-指定类别】通用模块(用于内容栏和其他区域)
${listcontent_comm_topArticle[文章类别名称]} '【最新推荐文章-指定类别】通用模块(用于内容栏和其他区域)
${listcontent_comm_ArticleClassList[频道名称]} '【文章分类-对应频道】通用模块(用于内容栏和其他区域)
二、导航菜单(通用)
${Nav_all} '通用导航菜单,不指定任何类型的模板页面
三、首页专用标签(在{#body:columnShow.home}{/body:columnShow.home}依赖标签内使用生效)
${MySidebar_defaultPage} '首页自定义侧边栏
${homeLinks} '首页指定显示数量的友情链接
${homeLinks_txt} '首页指定显示数量的友情链接(纯文字)
${newMood} '最新微博输出
四、大栏目(文章)模板标签(在{#body:content.show.栏目标识}{/body:content.show.栏目标识}依赖标签内使用生效)
'----
${ArticleTitle} '文章标题
${Summary} '文章摘要,简介
${Content} '文章内容
${articleid} '文章ID
${tags} 'Tags标签及相关文章
${keywords_show} '文章关键词列表
${SummaryDescr_article} 'meta文章内容页描述
'----
${ClassSrc} '相应的分类列表
${hits} '对应访问数
${readnum} '对应评论数目
${SubDate} '发表时间
${ClassName} '类别
${linkRel_start} (${linkRel_start_title}) 'link标签rel-集合起始文档(标题)
${linkRel_prev} (${linkRel_prev_title}) 'link标签rel-集合上一文档(标题)
${linkRel_next} (${linkRel_next_title}) 'link标签rel-集合下一文档(标题)
五、作品案例(独立模板,template/作品案例内容页.html)
${work_title} '作品标题
${work_date} '发布时间
${work_class} '作品分类
${work_con} '作品介绍
${work_show} '展示高清大图
${work_show_thumbs} '展示缩略图
${work_id} '作品ID
${work_path} '作品路径
${work_siteURL} '作品展示URL
${work_recentU} '上一个作品链接
${work_recentD} '下一个作品链接
${work_classList} '作品分类列表
六、其他标签(在{#body:columnShow.栏目标识}{/body:columnShow.栏目标识}依赖标签内使用生效)
${moodNum} '微博发布总数
${classname} '类别名称【带有分页的通用标签】
${linkslist} '内容页友情链接列表
一、依赖标签说明
(1)没有依赖标签包括的内容属于所有模板通用内容
(2)如果栏目不包括依赖标签,则系统自动清除
(3)依赖标签不得有重复,而且不能修改依赖标签的任何字符,单然,您可以去掉或者修改之外的HTML和CSS扩充界面样式
(4)详细的 ${ }类型通用标签,请查看后台"自定义标签 - 查阅网站标签集",您可以合理调用"通用标签"到首页
二、DIY皮肤主题的流程和步骤
流程:
(1)使用photoshop设计网站主题
(2)结合template文件夹下的样式文件 main.css,caseStyle.css,进行切图和基础的html,css代码编写
(3)html文件编写完成后,对应到模板文件的每个栏目的依赖标签,进行模板整合(顾名思义把内容对应替换成标签),参考本页API实例部分
三、依赖模块属性设置标签
<DSSetting.中文依赖参数标识 Property1="***" Property2="***" />
(1)定义:使用不同栏目的依赖标签时,可能需要对一些内容模块做个性化调整,比如侧边栏,转发网址,整体代码输出等,这一系列的个性设置,就由 <DSSetting.??? />这个HTML标签里的属性值决定,它的优先级最高,模板里可以包含,也可以不包含。
(2)具体的标签用法及其实例,
(2)返回值:存在:返回value属性值;不存在:返回-1
(2)例子:假设要分别给不同的栏目(首页、文章列表、关于我们)设置有依赖标签的侧边栏是否显示,则可以使用此HTML标设置;
如果您想把模板中某个栏目的依赖标签内的代码单独生成页面,不与其他依赖标签产生关系,则可以使用此HTML标签设置;
自定义图文单页和列表页面,需要使用此HTML标签设置自定义页面的基本属性。
具体实例用法请参考文档第三部分《模板标签使用API实例》
四、首尾闭合依赖标签
'模板大注释
{#note:template} {/note:template}
{#note:commCreateInfo} {/note:commCreateInfo}
{#note:text1} {/note:text1}
{#note:text2} {/note:text2}
{#note:text3} {/note:text3}
{#note:text4} {/note:text4}
{#note:text5} {/note:text5}
{#note:text6} {/note:text6}
{#note:text7} {/note:text7}
{#note:text8} {/note:text8}
{#note:text9} {/note:text9}
{#note:text10} {/note:text10}
'网站标题-列表页和其他页,内容页(文章),列表页
{#title:commonUse.title} {/title:commonUse.title}
{#title:content.article} {/title:content.article}
{#title:columnShow.article} {/title:columnShow.article}
{#title:columnShow.works} {/title:columnShow.works}
{#title:columnShow.mood} {/title:columnShow.mood}
{#title:columnShow.about} {/title:columnShow.about}
{#title:columnShow.search} {/title:columnShow.search}
{#title:columnShow.links} {/title:columnShow.links}
{#title:columnShow.message} {/title:columnShow.message}
'META页面描述-列表页和其他页,内容页(文章)
{#meta:comm.desc} {/meta:comm.desc}
{#meta:content.articleDesc} {/meta:content.articleDesc}
'META关键词-列表页和其他页、内容页(文章)、列表页
{#meta:commonUse.keywords} {/meta:commonUse.keywords}
{#meta:home} {/meta:home}
{#meta:content} {/meta:content}
'页面通用- 文章RSS订阅
{#rss:commonUse.article} {/rss:commonUse.article}
{#rss:commonUse.article.class} {/rss:commonUse.article.class}
{#atom:commonUse.article} {/atom:commonUse.article}
{#atom:commonUse.article.class} {/atom:commonUse.article.class}
'页面通用-banner轮换,
{#body:commonUse.banner} {/body:commonUse.banner}
{#head:commonUse.banner} {/head:commonUse.banner}
'页面通用-搜索框,订阅图标,置顶推荐文章,最新案例作品,banner轮换,规定数量随机tags输出
{#body:commonUse.searchBoard} {/body:commonUse.searchBoard}
{#body:commonUse.articleFeed} {/body:commonUse.articleFeed}
{#body:commonUse.article.top} {/body:commonUse.article.top}
{#body:commonUse.works.list} {/body:commonUse.works.list}
{#body:commonUse.article.tags.random} {/body:commonUse.article.tags.random}
'自定义图文单页
{#body:columnShow.CustomPage[序号]} {/body:columnShow.CustomPage[序号]}
'内容页-SEO可选link
{#head:content.linkRel} {/head:content.linkRel}
'侧边栏-首页,内容页(文章),列表页
{#sideBar:article,search,about,message}
{/sideBar:article,search,about,message}
{#sideBar:home}
{/sideBar:home}
{#sideBar:content.comm}
{/sideBar:content.comm}
'列表页-文章,文章分类,文章tags列表
{#js:columnShow.article} {/js:columnShow.article}
{#body:columnShow.article} {/body:columnShow.article}
{#body:columnShow.article.class} {/body:columnShow.article.class}
{#body:columnShow.article.tags} {/body:columnShow.article.tags}
{#autoUpdateTemp:columnShow.article} {/autoUpdateTemp:columnShow.article}
{#autoUpdateTemp:columnShow.article.class} {/autoUpdateTemp:columnShow.article.class}
'列表页-作品,作品分类
{#body:columnShow.worksIe6Js} {/body:columnShow.worksIe6Js}
{#js:columnShow.works} {/js:columnShow.works}
{#body:columnShow.works} {/body:columnShow.works}
{#body:columnShow.works.class} {/body:columnShow.works.class}
{#autoUpdateTemp:columnShow.works} {/autoUpdateTemp:columnShow.works}
{#autoUpdateTemp:columnShow.works.class} {/autoUpdateTemp:columnShow.works.class}
'列表页-微博
{#body:columnShow.mood} {/body:columnShow.mood}
{#autoUpdateTemp:content.js.mood} {/autoUpdateTemp:content.js.mood}
'内容页-关于我们(网站、个人信息)
{#body:columnShow.about} {/body:columnShow.about}
{#autoUpdateTemp:columnShow.about} {/autoUpdateTemp:columnShow.about}
'内容页-搜索
{#body:columnShow.search} {/body:columnShow.search}
{#body:columnShow.searchResult} {/body:columnShow.searchResult}
{#autoUpdateTemp:columnShow.search} {/autoUpdateTemp:columnShow.search}
{#autoUpdateTemp:columnShow.searchResult} {/autoUpdateTemp:columnShow.searchResult}
'内容页-友情链接
{#body:columnShow.links} {/body:columnShow.links}
{#autoUpdateTemp:columnShow.links} {/autoUpdateTemp:columnShow.links}
'列表页-留言
{#js:columnShow.message} {/js:columnShow.message}
{#body:columnShow.message} {/body:columnShow.message}
{#autoUpdateTemp:columnShow.message} {/autoUpdateTemp:columnShow.message}
'首页
{#js:columnShow.home} {/js:columnShow.home}
{#body:columnShow.home} {/body:columnShow.home}
{#autoUpdateTemp:columnShow.home} {/autoUpdateTemp:columnShow.home}
'内容页-(文章)及其JS
{#body:content.js.comm.form} {/body:content.js.comm.form}
{#body:content.show.commJs} {/body:content.show.commJs}
{#body:content.show.article} {/body:content.show.article}
{#autoUpdateTemp:content.js.article} {/autoUpdateTemp:content.js.article}
{#js:content.js.comm} {/js:content.js.comm}
{#js:content.article} {/js:content.article}
'各栏目循环体HTML代码
{#loopList:article} {/loopList:article}
{#loopList:article.home} {/loopList:article.home}
{#loopList:article.tagsList} {/loopList:article.tagsList}
{#loopList:works.classList} {/loopList:works.classList}
{#loopList:works} {/loopList:works}
{#loopList:mood} {/loopList:mood}
{#loopList:notice} {/loopList:notice}
{#loopList:message} {/loopList:message}
{#loopList:comment} {/loopList:comment}
{#loopList:relative.article} {/loopList:relative.article}
{#loopList:sidebarList_begin} {/loopList:sidebarList_begin}
{#loopList:sidebarList_content} {/loopList:sidebarList_content}
{#loopList:sidebarList_end} {/loopList:sidebarList_end}
{#loopList:sidebarList.class_begin} {/loopList:sidebarList.class_begin}
{#loopList:sidebarList.class_content} {/loopList:sidebarList.class_content}
{#loopList:sidebarList.class_end} {/loopList:sidebarList.class_end}
{#loopList:sidebarList_more} {/loopList:sidebarList_more}
{#loopList:sidebarList.alone_begin} {/loopList:sidebarList.alone_begin}
{#loopList:sidebarList.alone_content} {/loopList:sidebarList.alone_content}
{#loopList:sidebarList.alone_end} {/loopList:sidebarList.alone_end}
{#loopList:sidebarList.alone_more} {/loopList:sidebarList.alone_more}
{#loopList:sidebarList.catLandscape_begin} {/loopList:sidebarList.catLandscape_begin}
{#loopList:sidebarList.catLandscape_content} {/loopList:sidebarList.catLandscape_content}
{#loopList:sidebarList.catLandscape_end} {/loopList:sidebarList.catLandscape_end}
{#loopList:works.list.comm} {/loopList:works.list.comm}
{#loopList:article.top.comm} {/loopList:article.top.comm}
{#loopList:article.tags.random.comm} {/loopList:article.tags.random.comm}
五、独立输出依赖标签
{#labelEcho:relative.article} {/labelEcho:relative.article}
{#labelEcho:recent.article} {/labelEcho:recent.article}
六、循环输出列表依赖标签
{#loopListContentShow:article.top.comm/} '通用置顶文章(通用)
{#loopListContentShow:works.list.comm/} '通用最新案例作品(通用)
{#loopListContentShow:article.tags.random.comm/} '规定数量随机tags输出(通用)
{#loopListContentShow:notice/} '网站通知公告
{#loopListContentShow:article.top/} '首页置顶文章
{#loopListContentShow:article.home/} '首页文章
{#loopListContentShow:works.home/} '首页作品案例
{#loopListContentShow:article/} '文章
{#loopListContentShow:article.class/} '文章分类
{#loopListContentShow:article.tags/} '文章相关tags内容列表
{#loopListContentShow:works/} '作品案例分类导航-普通列表
{#loopListContentShow:works.classList.class/} '作品案例分类导航-分类列表
{#loopListContentShow:works.classList/} '作品案例
{#loopListContentShow:works.class/} '作品案例分类
{#loopListContentShow:mood/} '站内微博
{#loopListContentShow:message/} '留言本
{#loopListContentShow:relative.article/} '内容页相关文章
{#loopListContentShow:comment.article/} '内容页文章评论
{#loopListContentShow:column.class.comm.customPage/} '分类文章独立页面-分页列表
七、依赖变量
{#loopVar:依赖变量/}
(1)变量是系统分配对应到HTML代码里,这里不详细介绍,直接参看模板文件即可知晓
(2)自定义模板时不用操作变量,只要配合对应依赖标签使用即可
例子1:调用通用依赖标签的内容到相应的栏目
标签类型:
{#body:commonUse.标识}■{/body:commonUse.标识}
说明:
通用依赖标签其间的内容,可以通用到模板任何地方,包括栏目依赖标签内部和外部
使用方法:
(1)找到模板文件的 [通用依赖标签] {#body:commonUse.栏目标识}{/body:commonUse.栏目标识}
(2)在网站任意地方插入里面的代码即可在任何地方调用
下面是示例【如何在文章列表页面插入通用的banner代码?】:
其他通用的依赖标签以此类推
<!doctype html>
<html>
<head>
<title>${siteName}</title>
</head>
<body>
<div id="main">
{#body:columnShow.article}
文章列表的内容
这里调用的通用依赖标签banner的代码,通用到其他栏目时只要拷贝{#body:commonUse.banner}{/body:commonUse.banner}依赖标签里
面的代码即可,不需要连同标签一起移动复制
{/body:columnShow.article}
</div>
</body>
</html>
例子2:初识列表页(栏目页)依赖标签
标签类型:
{#js:columnShow.栏目标识}■{/js:栏目标识}
{#body:columnShow.栏目标识}■{/body:栏目标识}
说明:
这类标签就是网站不同栏目的输出功能,比如(首页、文章栏目、作品案例栏目、搜索、留言、友情链接等等)
使用方法:
(1)找到模板文件的 [栏目列表页面的依赖标签] {#body:columnShow.栏目标识}{/body:columnShow.栏目标识}
(2)自定义修改标签内的代码即可完成不同栏目生成静态时的代码修改
下面是示例【如何自定义网站首页案例作品页面生成静态页面时的代码?】:
其他列表页的依赖标签以此类推
<!doctype html>
<html>
<head>
<title>${siteName}</title>
</head>
<body>
<div id="main">
{#js:columnShow.home}
首页需要用到的特定js,您可以在这里修改,以此类推其他栏目
{/js:columnShow.home}
{#body:columnShow.home}
这里是生成静态首页的内容
{/body:columnShow.home}
{#js:columnShow.works}
作品案例的对应js
{/js:columnShow.works}
{#body:columnShow.works}
这里是生成静态作品案例列表的内容
{/body:columnShow.works}
</div>
</body>
</html>
例子3:不同的栏目对应的循环依赖标签
标签类型:
{#loopList:栏目标识}■{/loopList:栏目标识} 循环输出列表的html代码,您可以自定义这里的代码,个性化输出样式
{#loopListContentShow:栏目标识/}类型的依赖标签是循环列表输出的替换符,不用去改动
{#loopVar:article.依赖变量/} 是输出列表时的动态变量,不要改动即可,可自己设计它的位置或者不使用它
说明:
{#??:columnShow.栏目标识} {/??:columnShow.栏目标识} 和 {#loopList:栏目标识}{/loopList:栏目标识},属性
"栏目标识"都是等同的,以便使用者能辨别对应的列表输出循环标签和栏目标签
使用方法:
循环标签都是集中在模板里,便于修改,这里原理不难,循环标签只是一个自定义输出列表的html代码
下面是示例【如何修改文章栏目循环输出的HTML代码?】:
其他循环依赖标签以此类推
<!doctype html>
<html>
<head>
<title>${siteName}</title>
</head>
<body>
<div id="main">
{#js:columnShow.article}
文章栏目的js
{/js:columnShow.article}
{#body:columnShow.article}
文章栏目的内容代码
{/body:columnShow.article}
{#loopListContentShow:article/}
{#loopList:article}
请在模板页搜索【{#loopList:article}】类似的标签,这些标签在多个栏目是可能重复使用的,并不在栏目依赖标签内部。
下面是输出列表时的文章列表的HTML样式代码,您可以自己设计,您可以选择减少{#loopVar:article.依赖变量/}这类型的变量
作品列表、留言评论列表、微博列表、分类列表 循环输出html代码均同理修改
<div class="boxgrid caption">
<img src="{#loopVar:article.sSmallPath/}" >
<h3><a href="{#loopVar:article.mypath/}">{#loopVar:article.Title/}</a></h3>
</div>
{/loopList:article}
</div>
</body>
</html>
下面是示例【如何自定义侧边栏、文章列表、案例作品列表输出的HTML代码结构?】:
【直接Ctrl+F 搜索下面的循环依赖标签进行修改】
{#loopList:sidebarList_begin}
侧边栏头部
{/loopList:sidebarList_begin}
{#loopList:sidebarList_content}
侧边栏[循环列表]部分
{/loopList:sidebarList_content}
{#loopList:sidebarList_end}
侧边栏尾部
{/loopList:sidebarList_end}
{#loopList:sidebarList_more}
侧边栏[更多]链接
{/loopList:sidebarList_more}
{#loopList:article.home}
这个循环标签 loopList:article.home 内的内容, 代表[首页文章列表]
利用依赖标签,就可以改变循环输出内容的HTML结构,配合自定义的CSS,达到个性化设置
{/loopList:article.home}
{#loopList:works.home}
这个循环标签 loopList:works.home 内的内容, 代表[首页作品案例列表]
利用依赖标签,就可以改变循环输出内容的HTML结构,配合自定义的CSS,达到个性化设置
{/loopList:works.home}
{#loopList:article}
这个循环标签 loopList:article 内的内容, 代表[文章列表]
利用依赖标签,就可以改变循环输出内容的HTML结构,配合自定义的CSS,达到个性化设置
1.如果想文章未发布主题图片,列表中同时又不想显示,只留下文字效果,就把下面的首尾注释放置到主题图片的html代码首尾即可
2.如果未发布图片依然在列表页中显示没有图片的样子,还是图文并茂,那就不要把他们包含在主题图片html代码首尾
<!--{#imgUse:begin/}--><!--{#imgUse:end/}-->
{/loopList:article}
{#loopList:works}
这个循环标签 loopList:works 内的内容, 代表[作品案例列表]
利用依赖标签,就可以改变循环输出内容的HTML结构,配合自定义的CSS,达到个性化设置
{/loopList:works}
【同理寻找类似的依赖循环标签】
例子4:深入理解依赖标签的"依赖模块属性设置标签"
标签类型:
a)<DSSetting.某栏目侧边栏 value="***" />
(功能:列表页和内容页侧边栏的依赖标签设置参数)
(依赖性:在{#body:columnShow.??} {/body:columnShow.??} 和 {#body:content.show.??} {/body:content.show.??}类型的依赖标签内使用有效)
(参数:0:调用、1:不调用,例如调用侧边栏,写成<DSSetting.某栏目侧边栏 value="0" />)
b)<DSSetting.自定义图文内容页面[?] value="???.html" />
(功能:自定义图文单页的地址设定)
(依赖性:在{#body:columnShow.CustomPage[?]} {/body:columnShow.CustomPage[?]}类型的依赖标签内使用有效)
(参数:序号 [?] 为自定义依赖标签的索引,取值范围为"大于等于1的正整数")
说明:
(1)您也可以在模板中直接指定"是否显示侧边栏",如果侧边栏在栏目依赖标签之外,那生成静态时就是独立的,就需要单独在栏目依赖标签内指定
(2)<DSSetting.某栏目侧边栏 value="***" /> 属性只对模板通用的3个侧边栏依赖标签有效:
{#sideBar:home}侧边栏内容{/sideBar:home}
{#sideBar:content.comm}侧边栏内容{/sideBar:content.comm}
{#sideBar:article,search,about,message}侧边栏内容{/sideBar:article,search,about,message}
${MySidebar}、${MySidebar_defaultPage}、 ${MySidebar_NonCate}这三个是通用的普通标签(三种类型的侧边栏内容)
(3)模板文件里指定侧边栏的优先权是最大的,起最终决定作用
使用方法:
参看上面的属性的[依赖性] ,对应使用到依赖标签内即可
下面是示例【如何控制文章栏目的侧边栏,调用部分侧边栏?】:
<!doctype html>
<html>
<head>
<title>${siteName}</title>
</head>
<body>
<div id="main">
{#body:columnShow.article}
<DSSetting.文章列表页侧边栏 value="0" />
上面的属性就说明 "文章栏目使用侧边栏",此侧边栏是在依赖标签之外
即文章调用了对应的侧边栏
{#sideBar:content.comm}侧边栏内容{/sideBar:content.comm}
的内容,并且此内容不包含在文章依赖标签之内
{/body:columnShow.article}
</div>
</body>
</html>
<!doctype html>
<html>
<head>
<title>${siteName}</title>
</head>
<body>
<div id="main">
{#body:columnShow.article}
<DSSetting.文章列表页侧边栏 value="1" />
<div id="sideArticle">
${listcontent_comm_classarticle}
${listcontent_comm_randomArticle}
</div>
文章栏目单独调用了侧边栏通用普通标签(文章分类、随机文章),并且把文章依赖标签之外的通用侧边栏加以屏蔽
并且此内容包含在了文章依赖标签之内,不是独立的
您可以把普通通用标签加到模板任意位置,即可实现不同的栏目调用不同的内容
{/body:columnShow.article}
</div>
</body>
</html>
下面是示例【如何新建独立的图文单页,丰富个性化您的网站?】:
<!doctype html>
<html>
<head>
<title>${siteName}</title>
</head>
<body>
<div id="main">
{#body:columnShow.CustomPage[1]}
<DSSetting.自定义图文内容页面[1] value="awards.html" />
<p style="padding:70px">
这里放置自定义单页awards.html的内容
利用依赖标签,新建了awards.html这个页面
更多的新建页面可以一次类推,修改属性里 【No.】 序号即可
</p>
<!--自动生成更新-对应ID,这样就可以实现访问页面即时更新此自定义页面-->
<script src="../cat_js/uptempRequire_ID.js"></script>
<script>var upID = '1' ; upTempRe("myNewPage");</script>
{/body:columnShow.CustomPage[1]}
{#body:columnShow.CustomPage[2]}
<DSSetting.自定义图文内容页面[2] value="service.html" />
<p style="padding:70px">
这里放置自定义单页service.html的内容
利用依赖标签,新建了service.html这个页面
更多的新建页面可以依次类推
这样网站就新建了2个自定义单页了
</p>
<!--自动生成更新-对应ID,这样就可以实现访问页面即时更新此自定义页面-->
<script src="../cat_js/uptempRequire_ID.js"></script>
<script>var upID = '2' ; upTempRe("myNewPage");</script>
{/body:columnShow.CustomPage[2]}
</div>
</body>
</html>
例子5:认识内容列表依赖标签
标签类型:
{#body:content.show.栏目标识}■{/body:content.show.栏目标识}
说明:
此类标签其间的内容即是不同的栏目内容页显示的内容
使用方法:
(1)找到模板文件的 [栏目内容页依赖标签] {#body:content.show.栏目标识}{/body:content.show.栏目标识}
(2)自定义修改标签内的代码即可完成不同栏目生成静态时的代码修改
下面是示例【如何个性化文章栏目内容页?】:
其他循环依赖标签以此类推
<!doctype html>
<html>
<head>
<title>${siteName}</title>
</head>
<body>
<div id="main">
{#body:content.show.article}
某篇文章的内容就详细显示在这里咯,充分发挥您的自定义水平
{/body:content.show.article}
</div>
</body>
</html>
例子6:深入认识自定义页面的依赖标签结构
标签类型:
("?"号表示"1、2、3、4、..."的标签序号; "***"号表示可变量)
{#body:columnShow.CustomPage[classList?]}■{/body:columnShow.CustomPage[classList?]} 分类文章分页列表
{#body:columnShow.CustomPage[classListWorks?]}■{/body:columnShow.CustomPage[classList?]} 分类作品分页列表
{#body:columnShow.CustomPage[?]}■{/body:columnShow.CustomPage[?]} 自定义单页
说明:
此类标签也是属于依赖标签新建单页类型,注意后面的[classList序号]的写法,在例子中已经给出
使用方法:
(1)找到模板文件的 [自定义分类文章分页列表页依赖标签]
(2)
<DSSetting.class.article[?] classname="***" datacheck[?]/>
<DSSetting.class.url.article[?] url="***" />
<DSSetting.class.works[?] classname="***" datacheck[?]/>
<DSSetting.class.url.works[?] url="***" />
a)序号 [?] 为自定义依赖标签的索引
b)classname属性值:栏目分类名称(支持中英文);url属性值:页面生成的文件名字,不需要写.html后缀(特别注意不能使用中文)
c)?表示序号,并且序号对应到{#body:columnShow.CustomPage[classList?]}
(3)
<DSSetting.自定义图文内容页面 value="***" />
a)***表示自定义单页的地址,只支持跟目录生成,比如写成service.html
b)?表示序号,并且序号对应到{#body:columnShow.CustomPage[?]}
(4)
使用{#loopListContentShow:column.class.comm.customPage/}来输出分页和列表内容(支持分类文章列表,作品案例分类列表)
(5-1)
使用 <script src="../cat_js/uptempRequire_ID.js"></script>
<script>var upID = 'classList?' ; upTempRe("myNewPage_classList_art");</script>
,可以实现访问页面即时更新分类文章列表
(5-2)
使用 <script src="../cat_js/uptempRequire_ID.js"></script>
<script>var upID = 'classListWorks?' ; upTempRe("myNewPage_classList_works");</script>
,可以实现访问页面即时更新分类作品列表
(5-3)
使用 <script src="../cat_js/uptempRequire_ID.js"></script>
<script>var upID = '?' ; upTempRe("myNewPage");</script>
,可以实现访问页面即时更新对应的自定义单页
(6-1)使用
<!-- 分页ajax输出 -->
<script>
$(document).ready(function(){
$.post('../plugins/pageShow/?1|customPage_work_class|' + document.location.href, function(data) {
//注意:../plugins/pageShow/?【这里的序号要和指定分类内容输出列表名称[1]】那个[1]等同
$('#pageShow').html(data);
});
})
</script>
<span id="pageShow"></span>
显示作品案例分页链接
(6-2)使用
<!-- 分页ajax输出 -->
<script>
$(document).ready(function(){
$.post('../plugins/pageShow/??|customPage_art_class|' + document.location.href, function(data) {
$('#pageShow').html(data);
});
})
</script>
<span id="pageShow"></span>
显示作品案例分页链接
下面是示例【如何自定义分类文章分页列表页面?】:
注意:支持此功能只有"文章分类"这个分页列表模块
<!doctype html>
<html>
<head>
<title>${siteName}</title>
</head>
<body>
<div id="main">
{#body:columnShow.CustomPage[classList1]}
<DSSetting.class.article[1] classname="企业新闻" datacheck[1]/>
<DSSetting.class.url.article[1] url="newsShow" />
上面的属性就表示【调出了分类"企业新闻"下的所有文章,并进行分页列表】,
【生成的页面地址结构为:/classlist/文章前缀名-newsShow_default.html】
<div id="sidebar">
自定义的侧边栏
</div>
<div id="article">
{#loopListContentShow:column.class.comm.customPage/}
<!-- 分页ajax输出 -->
<script>
$(document).ready(function(){
$.post('../plugins/pageShow/?1|customPage_art_class|' + document.location.href, function(data) {
//注意:../plugins/pageShow/?【这里的序号要和指定分类内容输出列表名称[1]】那个[1]等同
$('#pageShow').html(data);
});
})
</script>
<span id="pageShow"></span>
这个标签是对应的分类文章列表输出内容(带分页)
</div>
<!--自动生成更新-对应ID,这样就可以实现访问页面即时更新列表-->
<script src="../cat_js/uptempRequire_ID.js"></script>
<script>var upID = 'classList1' ; upTempRe("myNewPage_classList_art");</script>
{/body:columnShow.CustomPage[classList1]}
{#body:columnShow.CustomPage[classList2]}
<DSSetting.class.article[2] classname="设计心得" datacheck[2]/>
<DSSetting.class.url.article[2] url="ourthinking" />
上面的属性就表示【调出了分类"设计心得"下的所有文章,并进行分页列表】,
【生成的页面地址结构为:/classlist/文章前缀名-ourthinking_default.html】
<div id="sidebar">
自定义的侧边栏
</div>
<div id="article">
{#loopListContentShow:column.class.comm.customPage/}
<!-- 分页ajax输出 -->
<script>
$(document).ready(function(){
$.post('../plugins/pageShow/?2|customPage_art_class|' + document.location.href, function(data) {
//注意:../plugins/pageShow/?【这里的序号要和指定分类内容输出列表名称[2]】那个[2]等同
$('#pageShow').html(data);
});
})
</script>
<span id="pageShow"></span>
这个标签是对应的分类文章列表输出内容(带分页)
</div>
<!--自动生成更新-对应ID,这样就可以实现访问页面即时更新列表-->
<script src="../cat_js/uptempRequire_ID.js"></script>
<script>var upID = 'classList2' ; upTempRe("myNewPage_classList_art");</script>
{/body:columnShow.CustomPage[classList2]}
{#body:columnShow.CustomPage[classListWorks1]}
<DSSetting.class.works[1] classname="动漫设计" datacheck[1]/>
<DSSetting.class.url.works[1] url="cartoon" />
上面的属性就表示【调出了分类"动漫设计"下的所有案例作品,并进行分页列表】,
【生成的页面地址结构为:/classlist/案例作品前缀名-cartoon_default.html】
<div id="sidebar">
自定义的侧边栏
</div>
<div id="article">
{#loopListContentShow:column.class.comm.customPage/}
<!-- 分页ajax输出 -->
<script>
$(document).ready(function(){
$.post('../plugins/pageShow/?1|customPage_work_class|' + document.location.href, function(data) {
//注意:../plugins/pageShow/?【这里的序号要和指定分类内容输出列表名称[1]】那个[1]等同
$('#pageShow').html(data);
});
})
</script>
<span id="pageShow"></span>
这个标签是对应的分类案例作品列表输出内容(带分页)
</div>
<!--自动生成更新-对应ID,这样就可以实现访问页面即时更新列表-->
<script src="../cat_js/uptempRequire_ID.js"></script>
<script>var upID = 'classListWorks1' ; upTempRe("myNewPage_classList_works");</script>
{/body:columnShow.CustomPage[classListWorks1]}
</div>
</body>
</html>
例子7:综合运用:个性化网站首页实例
下面是示例【如何使用依赖标签首页的模块,譬如去掉侧边栏设计成企业类型】:
<!doctype html>
<html>
<head>
<title>${siteName}</title>
</head>
<body>
<div id="main">
//{#js:columnShow.home}
请在模板里搜索这个依赖标签内的js(专用于首页),您也可以去掉它,在下面的首页栏目依赖标签里写自定义js
//{/js:columnShow.home}
{#body:columnShow.home}
这里就是放置首页显示的HTML代码了,所有首页显示的代码都可以写在这里,下面是设计企业版式
(首页默认显示banner,当然你也可以自己在这里加入banner代码,不过为了避免重复,您可以删除
{#body:commonUse.banner}{/body:commonUse.banner}依赖标签里的通用banner代码)
<DSSetting.首页侧边栏 value="1" />
<!-- 上面的代码屏蔽了侧边栏 -->
<!-- ++++++通知公告++++++ -->
<div>
<ul>
{#loopListContentShow:notice/}
</ul>
<!-- 下面是通知公告循环输出的HTML代码 -->
{#loopList:notice}
<li><a href="#">[News] {#loopVar:notice.Title_show/}(发布时间:{#loopVar:notice.time_/})</a><li>
{/loopList:notice}
</dl>
</div>
<!-- ++++++置顶文章+文章列表++++++ -->
<div>
{#loopListContentShow:article.top/}
{#loopListContentShow:article.home/}
<a href="../list/${MY_defineName_art}_default.html" title="浏览更多日志"></a>
</div>
<!-- ++++++友情链接(后台可以设置最多输出数目)++++++ -->
<div>
${homeLinks}
</div>
<!-- ++++++最新文章随机关键词(后台可以设置最多输出数目)++++++ -->
<div>
${listcontent_comm_tags}
</div>
<!-- ++++++自定义标签(后台自定义标签功能管理标签内容)++++++ -->
<div>
${myLabel_自定义通用版权信息}
</div>
提示:
在模板文件中搜索 {#loopList:article.home}内容{/loopList:article.home}
这个是首页专用文章列表循环输出代码,您可以个性化这里的代码控制HTML和CSS
{/body:columnShow.home}
</div>
</body>
</html>
例子8:综合运用:生成页面时只生成某栏目依赖标签内的HTML代码(其它所有依赖标签的内容均不调用)
下面是示例【生成页面时只生成{#body:columnShow.about}{/body:columnShow.about}栏目依赖标签内的HTML代码】:
首先在模板里找到{#body:columnShow.???}类型的对应栏目依赖标签,加入以下依赖模块属性设置标签<DSSetting.完全独立页面代码.不调用其它任何依赖标签的内容 value="true" />
{#body:columnShow.about}
<DSSetting.完全独立页面代码.不调用其它任何依赖标签的内容 value="true" />
<!doctype html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gbk" />
<meta name="robots" content="none" />
<title>关于我们 - ${siteName}</title>
</head>
<body>
<!-- 内容区 begin -->
<div id="pageCustomContainer">
<!-- 关于我们 -->
这里是自定的内容,可使用通用标签
只要任何栏目依赖标签内容包含上面的<DSSetting.??? />依赖模块属性设置标签,则生成页面时其它所有依赖标签
的内容均不调用,也就是说生成的页面只独立包含{#body:columnShow.about}{/body:columnShow.about}
里面的内容
</div>
<!-- 内容区 end -->
</body>
</html>
{/body:columnShow.about}
一.模板自定义说明
(1)所有栏目的模板全部静态分离,有html和css基础的可以直接使用软件边浏览边编辑,依赖标签不属于程序范畴,是本产品原创的一种标识功能:
(2)整站模板都在 文件夹template里(包括模板图片),相关的模板样式表和图片在文件夹skins 里,其他通用的网站图片在文件夹images 里
二.怎么理解模板里的标签,来完成自己的自定义模板?
(1)模板标签分类:
普通标签: ${ label }
定义:普通标签只有在依赖标签内部配套使用时才具备栏目依赖关系,否则则属于全站栏目的通用标签
依赖标签:{#依赖符:标识} {/依赖符:标识}, {#依赖符:标识/}
定义:只有对应到生成静态时的栏目才能发挥其作用,依赖于生成静态时的特定栏目,并和普通标签有依赖关系
(2)普通标签使用事项:
a) 普通标签可以直接放置到模板的任何依赖标签内
b) 后台自定义的 ${} 普通标签和网站通用的普通标签可以放置模板的任意位置
c) 形如 {#sideBar:栏目标识}■{/sideBar:栏目标识} 的侧边栏依赖标签内的普通标签,请不要在依赖标签之外使用
d) 如果您想任意调用内容,请参看 [普通标签] 里的通用标签,通用标签可以插入到模板任意位置,包括依赖标签内部
e)下面类型的依赖标签,普通标签就只能在其内才有效果,不能取出来放置到其他位置或者栏目依赖标签之外:
{#依赖符:columnShow.栏目标识}■{/依赖符:columnShow.栏目标识}
{#依赖符:content.show.栏目标识}■{/依赖符:content.show.栏目标识}
f) 不支持变量系统的普通标签和依赖标签请不要修改标签任意字符,避免系统无法解析
三.怎样在模板中快速接入网站API,实现ajax信息交互?
参看本文档 [API数据接口说明] 部分,轻松实现站内站外数据对接与同步.
| 参数 | 功能 | 是否必填 | 赋值 | 描述 |
|---|---|---|---|---|
| webidKey | 网站ID | 是 | 安装系统后自动分配 | 每个网站的唯一授权ID,此ID进入后台即可在欢迎界面里查看 |
| apiSQLKey | 接口查询密匙 | 是 | 网站管理员在后台[参数/模块设置-API数据接口设置]里设置此项 | 网站管理员授权的API查询密匙 |
| user | 数据录入用户 | 否 | 网站管理员用户名 | 依赖于参数apiInfoAddKey,进行非数据查询接口时需要此参数 |
| apiInfoAddKey | 接口管理密匙 | 否 | 网站管理员在后台[参数/模块设置-API数据接口设置]里设置此项 | 网站管理员授权的API管理录入密匙 |
| API_KEY | 社会化应用接口密匙 | 否 | 网站管理员在后台[参数/模块设置-API数据接口设置]里查看(48位) | 当您使用社会化登录,社会化留言接入到网站同步网站时,就需要API-KEY |
| openData | 数据操作逻辑判断 | 是 |
1)值:true,可查询数据 2)值:false,不可查询数据 |
当使用数据输出同步或者APP录入数据时调整此参数 |
| infoKeyword | 关键词 | 否 | 自定 | 取出类似的标题关键词 |
| infoTitle | 标题文字 | 否 | 自定 | 取出类似的标题的信息,关键词字符数越长越准确取出的越优先(输出单条) |
| infoID | 栏目内容对应ID | 否 | 自定 | 取出对应的栏目的信息(输出单条) |
| infoEchoNum | 输出列表数 | 否/是 | 数字类型 | 依赖于参数columnType,类型为列表时此参数必须存在 |
| columnType | 栏目类型 | 是 |
1)值:article,文章栏目单条 2)值:article.list,文章栏目列表 3)值:works,案例作品栏目单条 4)值:works.list,案例作品栏目列表 5)值:mblog.list,站内微博栏目列表 6)值:sociallogin,社会化登录入口 7)值:socialcontact,社会化留言同步入口 |
API对应的接口栏目和社会化接入类型 |
| infoClass | 输出条件 | 否 |
1)值:栏目分类名称,输出相应分类列表 2)值:top,输出置顶列表(只限文章栏目) 3)值:hot,输出热门列表 4)值:month,输出近一月的热门列表 5)值:week,输出近一周的热门列表 |
对应栏目输出的类型条件筛选 |
| infoScanType | 列表方式 | 否 |
1)值:random,随机排序输出 2)值:asc,顺序输出 3)值:desc,倒序输出 4)值:hot,按浏览量输出 5)值:comment,按评论量输出(只限文章栏目) |
对应栏目输出列表的呈现方式 |
| cp1~cp4 | 数据管理录入接收参数 | 否 | 自定,(只限文章栏目) | 远程对接录入数据时的数据传输,一次代表文章栏目的值为: cp1:同步录入的标题/电子邮箱 cp2:类别 cp3:关键词 cp4:同步录入的内容 |
//部署第三方登录APP的HTML和JS代码---begin 第三方登录JS回调函数(function(){ //code... callback:{ //回调本网站API接口返回值及其处理过程code...//此白色区域的内容是 [第三方入口登录成功后] 回调网站本地的处理过程,其余的都是第三方APP登录接口代码 $(document).ready(function(){ var data; $.getJSON('http://您的网址/api/?webidKey=Yzk***b20g&openData=true&apiSQLKey=HKI***XOWXOWU&columnType=sociallogin&API_KEY=67eb6feb4580**********813fca8b6070dd9e317be7a2&user=user**name',data,function(data){ $.each(data,function(entryindex,entry){ var userName = entry.userName; //获得网站用户名 var userPass = entry.userPass; //获得网站加密密码 //执行本地登录验证处理过程code... //登录本地网站成功跳转code... }) }); });} }); //部署第三方登录APP的HTML和JS代码---end
<script>$(document).ready(function(){
//普通用法
var jsonData =
[
{"title":"建站产品功能文档","classname":"设计"},
{"title":"运动,调理,设计湿别忘了自己的身体","classname":"生活"},
{"title":"json数据接口调用范例","classname":"设计"}
]
for (var i=0;i<6;i++){
$("#list").append("标题: "+jsonData[i].title+" 【类别: "+jsonData[i].classname+"】<br>");
}
//接口调用方法(注意:json不能跨域读取数据)
var data;
$.getJSON('http://您的网址/api/?webidKey=Yzk***b20g&openData=true&apiSQLKey=HKI***XOWXOWU&columnType=article.list&infoEchoNum=5&infoScanType=hot',data,function(data){
$.each(data,function(entryindex,entry){
$("#list2").append("标题: "+entry.title+" 【类别: "+entry.classname+"】<br>");
})
});
});
</script>
<ul id="list"></ul>
<ul id="list2"></ul>
//部署第三方APP的HTML和JS代码---begin 第三方应用的JS回调函数(function(){ //code... callback:{ //回调本网站API接口返回值及其处理过程code...//此白色区域的内容是 [第三方应用接入成功后] 回调网站本地的处理过程,其余的都是第三方应用接口代码 $(document).ready(function(){ var data; $.getJSON('http://您的网址/api/?webidKey=Yzk***b20g&user=user**name&apiInfoAddKey=OIEIUU8X7J2J*********24JVFH885JF&columnType=article &cp1=字段1&cp2=字段2&cp3=字段3&cp4=字段4',data,function(data){ $.each(data,function(entryindex,entry){ var title = entry.title; //获得栏目标题 var preURL = entry.preURL; //获得预览地址 //执行本地信息同步处理过程code... }) }); });} }); //部署第三方APP的HTML和JS代码---end