Mh_163K系统模版二次开发文档序言我们尝试新的功能将引领行业前沿,一切为用户着想,你的体验反馈将是我们不断完善的源泉.你的思路将是我们开发的动力,你的需求将是我们开发的根本,我们一起做好无限的Mh_163K!本文旨于如何应用万能标签系统的应用.为了更直观描述,会引用甚至转义一部分术语.目的是让初学者更容易上手.(一):模版文件夹结构:/template/pc/模版套系文件夹/ 用于电脑版的主站模版文件./template/wap/模版套系文件夹/ 用于手机版的主站模版套系:文件结构和电脑版要完全一致并对应如电脑版内有/template/pc/aaa/ 套系模版wap里面也必须同时有aaa套系/template/zhuanti/company/套系文件夹/ 口碑店铺模版:套系取名规则必须是8位以下纯数字(将来会支持英文字符,等待升级完善)./template/zhuanti/fuwu /套系文件夹/ 服务机构模版:套系文件夹名也必须是纯数字./template/zhuanti/news/套系文件.html 专题新闻模版:html文件.非文件夹./template/zhuanti/qiye/套系文件夹/ 企业模版,也必须是纯数字文件夹./template/zhuanti/shop/套系文件夹/ 商城模版(开发中)/template/zhuanti/tg/套系文件夹/ 团购模版:字母文件夹(开发中)(二): 模版制作:1:建立自己的套系:1):你只需要在../template/pc/文件夹下新建一个英文名文件夹,该文件夹名就是你的新套系.如: ../template/pc/Scholarly/ 这里的Scholarly 就是你的新模板套系,建好后在后台标签管理和模板选择里就能看到.2):新套系里必须具备所有和官方默认模板套系里面完全相同的htm和html文件数量和名称. 内容可以自定,Js和css名可以自定.2: 说明和注意事项:1:完全打破了前版本的局限性.各套系模版完全独立.包括解析出来的标签.如主站/pc/default默认模版中解析{$tplPath}为../template/pc/default/而同样的标签放在专题新闻模版中{$tplPath}会解析为../template/zhuanti/news/2:模版中标签越少,解析速度越快.如果你为自己的网站创建一套模版.请尽量将你网站中固定的信息直接写到模版中.如网站名称,js地址.css地址.页面固定调用的图片地址.网站链接地址.导航等.如:你创建一套../template/pc/usertemp/ 其中的usertemp就是你的电脑版的模版套系名称.写模版时.由于你的模版位置已经固定.:<link href="{$tplPath}skin/_kbShop.css" type="text/css" rel="stylesheet" />这中间的{$tplPath}就没有必要写.直接写成:<link href="../template/pc/usertemp/skin/_kbShop.css" type="text/css" rel="stylesheet" /> 将会提高程序运行速度.3:各套系(包括新建套系)中的文件数量必须独立完整.如: /template/zhuanti/qiye/1/ 套系文件夹下也必须有自己独立的page_head.html和Page_bottom.html模版文件.4:系统解析不到相应的模版文件会报告是哪个模版文件缺少.如有报告.请补充完整即可. 5:在制作和修改模版时.可以将缓存系数设置为-1,禁止缓存.就能实时看到模版改动后的解析效果.(三):标签模版的结构和概念:1:框架和块:任何一个网页整页.都可以看成一张海报,一张大图.一面墙.一个整体.我们这里引入一个概念:块.一个完整网页看成一个整块.既然是一个块.那么就可以分割成无数小块.这种分割方式就叫框架式.分割出来的大块小块组合就看成了框架.2:标签层:在html中就有层的概念,这里也引用一下,意思基本一致.一个网页按照”品”字形分割,我们这里叫块分割,可以将一个网页在平面上分割成很多块:头部块,中部块,尾部块.换一种方式分割:按照”回”字形分割,我们标签系统里就叫层分割.一个块可以分成无数层.层分割是嵌套关系.该模版结构分析:整页分为上中下3块. 网站头部,中部块,网站尾部3个顶层标签.网站头部:中嵌套了log和广告两个并排同层关系标签.中部块:中有3个标签:首页专用_新闻,首页房产推荐,和首页广告.这3个同层并列关系. 而{新闻}中,又有两块图片新闻和新闻列表. 新闻列表再次分为{头条}和{新闻推荐列表}而这整个页面的html模版文档里,只有:{$Default_头部}{$Default_中部}{$Default_尾部}这三行内容.其它所有的标签都是套在这三个标签中的模版内.称为:<标签嵌套>三:我们一起来创建这个模版.目的是理清块与层的概念和关系.1:用任意网页编辑器.创建一个index.html文件.里面只写以下内容.<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><meta http-equiv="X-UA-Compatible" content="IE=EmulateIE7" /><title>{$SiteName}</title></head><body><div>{$Default_头部}</div><div>{$Default_中部}</div><div>{$Default_尾部}</div></body></html>当然前后的html,head和body内容部分你自己添加,不在本文讲述范围.将模版保存为utf-8编码格式(大部分网页编辑器默认就是utf-8编码).传到网站: /template/pc/default/文件夹下.2:在标签系统里添加标签:(顶层标签创建):我们将最顶层设置为10,当然可以是任意数字,层数不限.你有自己的标准什么是顶层:就是直接写到你html模版文件中的标签.最先解析,称为顶层.一{$Default_头部}:注意这个标签模版中要套两个标签.选项:标签层:10,客户端:电脑,模版套系:default,栏目:首页专用,登陆状态:不限制,标签类型:文本模版头部:<table>模版内容:<tr><td>{$Default_Logo}</td><td>{$Default_广告}</td></tr>模版尾部:</table>确定创建.二: {$Default_中部} 注意这里面要套3个标签.选项:同上.模版头部:<table>模版内容:<tr><td>{$Default_首页专用_新闻}</td></tr><tr><td>{$Mh163k_首页房产推荐列表}</td></tr><tr><td>{$首页广告}</td></tr>模版尾部:</table>确定创建.三:{$Default_尾部} 根据以上样式,这里的内容你试着自己写.只写几个字在模版内容里也可以(框架层标签创建) : 可有可无.框架层:是指给上层和下层提供衔接和嵌套关系的层.实际模版制作中.一: {$Default_首页专用_新闻}:选项:层:5(必须低于嵌套本标签的层数),选项其他同上.模版头部:<table>模版内容:<tr><td>{$首页图片新闻}</td><td>{$Default_新闻头条和列表}</td></tr>模版尾部:</table>确定创建.二: {$Default_新闻头条和列表}:可以单独创建,也可以直接将内容写到上面标签内容中.请自己随意创建.(数据标签创建) :重点.数据标签:将数据库中的数据以我们需要的形式格式提取出来展示在网页中. 一: {$Default_Logo}选项:层数0(小于嵌套本标签的层数都可以):其他选项同上.模版头部:留空模版内容: {$topurl}模版尾部:留空确定创建.二: {$Default_广告}选项:层数0(小于嵌套本标签的层数都可以):其他选项同上.模版头部:留空模版内容:这是我的广告内容,支持任意广告代码.模版尾部:留空三: {$Mh163k_首页房产推荐列表}选项:层数0(小于嵌套本标签的层数都可以):其他选项同上.类型:内容列表,内容范围:_房产出租(出售),二级分类:出售,三级分类:所有分类.调用内容:勾选:ID,标题,区域,面积,价格附加条件:审核情况: 等于1条数:10条, 50字节, 100 字节排序方式:ID,降序.模版头部:<ul>模版内容: <li><a href=”/house/shoulou_{$id}.html”>标题:{$chrtitle} 区域:{$Chrcategory},面积:{$chrsize}㎡, 价格:{$price}万元</a></li>模版尾部:</ul>确定创建.以上内容创建好后.清空缓存.打开首页看看什么效果.系统固定标签和通用过程.(四)系统通用固定标签:通用标签:网站关键字:{$SiteKeyWord}, 网站描述: {$SiteDescription}, 网站名称:{$SiteName},网站域名:{$SiteUrl},网站LOGO图片地址:{$topurl}, 登陆用户名:{$loginname},登陆ID:{$loginuserid} 用户级别:{$loginjibie} 信息地址:{$liveurl}, 信息频道名称:{$livename}, 招聘地址:{$zpurl},招聘名称:{$zpname}, {$fcurl}, {$fcname}, {$bianmingname}, {$bianmingurl}, {$goodname}, {$goodurl}, {$shopname}, {$shopurl}, {$tuangouname}, {$tuangouurl}, {$tgname}, {$tgurl}, {$daohangname}, {$daohangurl}, {$videoname}, {$videourl}, {$articlename}, {$articleurl}, {$sitetongji}, {$jifenname}, {$daijinname}, {$SiteColor}, {$shouyecss}, {$SiteYuming}, {$topurl}, {$bbsurl},{$city} ,{$sitetel},{$siteqq1},{$siteqq2},{$siteqqkey1},{$siteqqkey2},,{$siteqqqun}当前位置: {$Clienttype}=模版套系当前位置编号: {$Tempid}=对应form_common.js中data_change过程中的位置编号{bbs整合开关 {$bbsopen} QQ整合登陆开关 {$qqiskill} 微博微信开关 {$weiboiskill} 微博地址 {$weibourl} 微信账户 {$weixinuser} 微信二维码图片 {$weixinimg}当前模版地址:{$tplPath},输出: ../template/客户端/你的模版套系/默认模版地址:{$Default_tplPath} 固定输出:http://你的域名/template/pc/你的模版套系/默认模版地址主要用户调用通用js,css,jpg等全站通用文件.如:登陆按钮图片. {$Default_tplPath}images/submit.png将解析为: http://你的域名/template/pc/你选择的主站模版套系/ images/submit.png系统当前时间: {$system_datetime 正则格式化}{$system_datetime MM\/dd\/yyyy HH:mm:ss}缓存更新相对随机数: {$CacheHash} 用于经常改动静态文件后缀添加,确保每次系统缓存更新后,所有用户能获取到最新文件.如: <script src="{$tplPath}js/common.js?{$CacheHash}"></script>(六) 数据标签的应用说明.一:普通数据标签,直接输出实际数据:直接使用选择的内容列名加{$列名}为数据标签.如:{$title} 将直接输出标题内容.2:时间数据标签,两种输出方式:1):直接输出记录时间格式为{$dtappenddate} 输出为:2014-01-01 12:12:12长完整时间数据2):带格式输出标签{$列名格式}.将按照你的格式输出数据(注意列名和格式之间必须只有一个空格).如{$dtappenddate yyyy年MM月dd日HH时mm分ss秒}将输出: 2014年01月01日12时12分12秒时间格式数据{$dtappenddate yy年MM月dd号HH点} 将输出: 14年01月01号12点3): {$list_num}列表列数量数据标签:输出当前内容的条数1递增.4): {$list_id}内容列表内第一列内容数据逗号分隔集合数据.5):时间日期做条件,条件右数据支持sql函数:如getdate()dateadd()datediff()等所有sql日期时间函数.如:发布日期大于dateadd(day,-10,getdate()) 函数标示只搜索10天内发布如:结束日期大于getdate() 函数表示调用未到期数据(七):团购列表页面标签说明:1:loop标签<tag:Loop ListType="listtgqian" RecType="New" PageSize="24" ColorSplit="1" TitleLen="26" RecColumn="6" CusTpl="1" Template="tg/list_old.html" />PageSize=每页条数,TitleLen:标题字数RecColumn:top条数输出:<div class="top_list"><ul class="clearfix">6条tg/list_old.html模版内容</ul></div><div class="cen_list"><ul class="clearfix">每页条数-RecColumn条剩余条数tg/list_old.html模版内容</ul></div>2:分类标签: {$category}3:地区标签: {$quyu}4:快捷排序标签: {$pages} 分页: {$pages1} {$pages2}5:分页标签: {$PageSplit}tg/list_old.html 新标签列表:<s class="tuijian{$isindex1}">今日推荐</s> {$isindex1}返回0或1<s class="{$iskill}" >状态</s> {$iskill} : soldOut:卖光 jieshu 结束, buy:正常<< 18个标志使用前4个标志<s class="bz1_{$iskill1}" >状态标志</s> {$iskill1} 1到4 输出1或空如<s class="biaozhi1_{$iskill1}" ></s>输出: <s class="biaozhi1_" >或<s class="biaozhi1_1" > <s class="biaozhi2_{$iskill2}" ></s>输出: <s class="biaozhi2_0" >或<s class="biaozhi2_1" ><s class="biaozhi{$k1}" >状态标志</s> {$k1} 1到{$k14}14 输出1或空如<s class="bz1_{$k1}" ></s>输出: <s class="bz1_" >或<s class="bz1_1" ><s class="bz2_{$k2}" ></s>输出: <s class="bz2_" >或<s class="bz2_1" >地区:{$chrcategory}:店铺:{$chrshop} 图片:{$chrimage},团购地址tg_{$tgid}.html原价:{$chrmoney1},现价:{$chrmoney2}列表页搜索表单.标题name="keyword1"排序规则:name=keyword0:价格降序,1:价格升序,2:销量降序,3:销量升序,4:新单,5:折扣率底高,6:折扣高低,7:免预约,8:今日推荐价格区间:起始价格name=keyword2 最高价格name=keyword3分类: name=styleid 0:消费类,1:实物类,2:实物订单类,3:代金券类团购标志使用建议:文字<div class="bzy{$k1}" >支持</div><div class="bzn{$k1}" >不支持</div>css.bzn1,.bzy{display:none;}.bzn,.bzy1{你的控制}图片<div class="bz1_{$k1}" ></div>css.bz1_1{支持图片}.bz1_{display:none;}<div class="bz2_{$k2}" ></div>css.bz2_1{支持图片}.bz2_{ display:none;}2: {$listtg$}列表标签(八):信息频道标签变动说明.一:电话号码解密接口.<img src=”../request.ashx?action=telimg&t=解密字串”>输出加密img显示电话号码图片.(九)模板选择数据接口,模板列表数据接口:1:ajax数据接口../request.ashx?action=template&_clienttype=模板客户端0到13可选json=和jsoncallback=参数输出标准json格式{“模板文件或文件夹名称”:”模板中文名称”}/other.aspx?action=moban&_clienttype=0到13套系&mobanid=当前使用套系&PageSize=每页显示条数所用模板: mobanxuanze.html:列表标签: {$TplList}列表标签模板 List_moban_Tr.htm 内容标签: {$ID} {$filepath} {$filepath_large} {$mobanname} {$checked{$ID}}Clienttype数据:0:电脑版主站,1:手机版主站模版,2:企业模版,3:口碑店铺模版4:新闻专题模版,5:商城店铺模版,6:团购模版待开放模板:8:信息模板,9:职位模板,10:活动模板,11:投票选手模板,12:房产模板,13:服务机构模板(十):专用纯数据接口(客户端)参数说明:接口地址../request.ashx?action=getdata&tempid=作用范围id&template=模板名称模板名称为../template/data/当前套系/文件夹下的完整文件名.其中作用范围请参阅以下:10到22110数字.如: ../request.ashx?action=getdata&tempid=1001&template=live_index_data.json输出数据将会调用作用范围为:客户端:数据接口模板,默认default模板,信息首页创建的标签内容.当然你需要在live_index_data.json模板内写入相应的标签名.数据模板可以是任意文档,如index. xml index.html index.json index.sql任意格式均可.专用系统标签{$common$}将读取固定的../template/data/default/common.html模板文件作为通用模板数据接口专用采集标签:{GetHtml: Url="完整网页地址" } 将完整输出采集网页内容作用范围数字对应:10:首页专用 20:通用1001:信息首页标签", "1000:信息通用标签", "1002:_大类首页通用", "1010:??交易类首页" 2001:房产首页标签", "2000:房产通用标签", "2002:_大类首页通用", "2010:??新房(楼盘)? 3001:首页(今日团购)", "3000:团购通用标签", "3010:??更多团购", "3011:??流程问题合作001:活动首页", "4000:活动通用标签", "4002:_大类首页通用", "4110:___活动详情", "411 5001:人才首页", "5000:人才通用标签", "5002:_大类首页通用", "5010:??职位列表", "501 6001:投票首页", "6000:投票通用标签", "6010:??选手列表", "6110:___选手详情", "6111: 7001:购物首页", "7000:购物通用标签", "7010:??购物列表", "7011:??品牌列表", "7012:? 8001:店铺首页(电脑/手机)", "8000:店铺通用标签(电脑/手机)", "8010:??商家店铺列表(电9001:视频首页", "9000:视频通用标签", "9010:??视频列表", "9110:___视频播放页", "911 10001:文章/新闻首页", "10000:文章/新闻通用标签", "10002:_大类首页通用", "10010:??? 11001:网址首页", "11000:网址通用标签", "11010:网址分类列表" 12001:礼品兑换首页列表" 13001:相册首页", "13000:相册通用标签", "13010:??相册类别列表", "13111:___相册内容? 14001:黄页首页", "14000:黄页通用标签", "14002:_分类首页通用", "14010:??服务机构列? 16001:地图首页", "16000:地图通用标签", "16110:地图标注标签", "16111:地图标注调用标17001:促销首页", "17000:促销通用标签", "17110:促销卡页标签", "17111:商家动态标签", 18001:电台首页" 19001:帮助通用", "19000:帮助(网站信息)通用", "19010:网站信息", "19011:会员管理" 20001:历史上的今天"21001:音乐首页" 22001:公告列表页","22000:公告(留言通用)","22010:留言列表","22110:公告内容页(家乡)"(十一) 程序登陆和验证二次开发接口1: 登陆判断接口protected void Page_Load(object sender, EventArgs e){Util.Cls_SiteBase nsb = new Util.Cls_SiteBase();nsb.GetSiteSettings(-1);#region 前台用户登录判断getdata getdata = new getdata();System.Collections.Generic.IList<string> loginstr = getdata.Login_str(bool是否二次验证);//loginstr[0] 已经登录返回userid 未登录返回””空.(非null)//loginstr[1] 店铺ID//loginstr[2]用户名//loginstr[3] 用户email//loginstr[4] 企业名称//loginstr[5] 用户级别//loginstr[6]用户权限,号分隔集#endregion#region管理员登录和权限判断System.Collections.Generic.IList<string> Adminloginstr =nsb.ChkALogin(-1);// nsb.ChkALogin(管理员功能权限值);-1为不限制//功能权限请参阅后台管理员用户组组权限设置页// Adminloginstr返回null未登录// Adminloginstr[0] 管理员id// Adminloginstr[1] 用户名// Adminloginstr[2]真实名// Adminloginstr[3]权限组集#endregion}2:用于ajax登陆接口(用于2,3,4ajax接口均可带json=和jsoncallback参数):请自行添加url转码后传递参数../request.ashx?action=login&str1="+ username+"&str2="+password+"&str3="+remeber参数说明:str1用户名str2密码str3是否记住登陆.3:退出ajax接口:提交地址1:"../request.ashx?action=loginout&date=" + new date();提交地址2:" {$SiteUrl}request.ashx?action=loginout&json=1&jsoncallback=返回参数&date=" + new date();4:用于ajax登陆验证接口提交地址1: ”../request.ashx?action=islogin&date=” + new date();提交地址2: ”../request.ashx?action=islogin&json=1&date=” + new date();提交地址3: ”../request.ashx?action=islogin&json=1&jsoncallback=loginstr&date=” + new date();1:返回|号分隔数组2: 返回json集合{'islogin':'1',’userid’:’2315’,’shopid’:’22’,’name’:’张三’,’jibie’:’0’,’styleid’:’2,3’,’bbsopen’:’open’,’bbslo ginurl’:’http://****’}3:带jsoncallback= loginstr返回集合loginstr([{'islogin':'1',’userid’:’2315’,’shopid’:’22’,’name’:’张三’,’jibie’:’普通会员’,’styleid’:’2,3’ ,’bbsopen’:’open’,’bbsloginurl’:’http://****’}]);参数说明islogin:0:未登陆,1:已经登陆/登陆成功,2:需要邮箱激活,3:用户需要短信激活.Error:错误信息bbsopen’:是否整合bbs:openbbsloginurl’bbs同步登陆地址(当bbsopen’:open时,必须建立一个框架或过程,访问一次bbsloginurl返回地址.).(十二)团购兑换平台二次开发资料:1:兑换平台独立域名设置:后台—团购—参数配置:增加表单:团购独立兑换平台域名前缀.name=dhost value=”{$dhost}”注意事项:有无开启二级域名均有效,请设置:后台→二级域名→参数配置→网站根域名.2:共用域名地址:{$SiteUrl}index.aspx?d3:团购添加和编辑页面增加表单 name=dhuserids value=”{$dhuserids}”表单名称:设置兑换权限会员为(营业员),如果选择有活动商家关联,商家默认具有兑换权限.数据条件逗号分隔用户id如: 326,53823:页面模板: pc\套系\member\tgduihuan.html 和 wap\套系\member\tgduihuan.html可用标签: 系统标签,{$chrname}:用户名. {$chrtruename}:企业名称,4:ajax兑换接口:地址{$SiteUrl}request.ashx?action= tgduihuan&chrcode=消费券号可带&json=1&jsoncallback=参数返回值islogin:兑换状态0失败 1成功error:失败原因:message:兑换成功信息.record:1条兑换查询信息.5:ajax兑换查询接口:地址{$SiteUrl}request.ashx?action= tgrecord可选查询参数&startdate=兑换起始时间&enddate=兑换结束时间&tgid=团购id&num=显示条数&json=1&jsoncallback=参数返回值islogin:查询状态0失败 1成功error:失败原因:message:查询成功信息.record:兑换记录查询结果.6:导出兑换记录xls报表超链接地址:地址{$SiteUrl}request.ashx?action= tgrecord&xls=1可选查询参数&startdate=兑换起始时间&enddate=兑换结束时间返回xls报表文件下载(十三)数据接口:一:根据企业名称搜索企业网站ID和企业名称键值对,返回20条记录.权限范围:不限request.ashx?action=qiyeidname&qiyename=企业名称&jsoncallback=二:根据企业名称搜索企业用户ID和企业名称键值对,返回20条记录,权限范围:后台. request.ashx?action=qiyeusername&qiyename=企业名称&jsoncallback=三:根据企业ID集返回该企业所有招聘信息数组.权限:不限.request.ashx?action=qiyejob &id=企业逗号分隔ID集&jsoncallback=四:人才行业,岗位分类.权限:不限.request.ashx?action=jobcategory&id=可选行业id&jsoncallback=行业id为空或0时返回行业数据五:图集分页接口.权限:不限.request.ashx?action=photopage& Colname=分类PageNo=页数&jsoncallback=可选参数: Colname=图集分类&key=排序方式1:最新,2:推荐& PageSize=每页条数:默认20条&strlen=图集介绍截取长度默认220字节&titleLen=标题截取长度默认100(十四) 职位搜索表单统一页面地址../job/zhiwei.html表单支持GET,POST表单名: 值意义返回页面标签name=s_gangwei 岗位ID {$s_gangwei}name=s_hangye 行业ID {$s_hangye}name=keyword 职位名关键字{$keyword} url转码后{$keywordcode}name=key 排序方式0空,时间,1:点击量(关注),2:关注(时间倒序),3:热门,4:紧急,5:时间,6:推荐{$key}name=s_didian 工作地点ID(调用区域ID) {$s_didian}name=s_xinzhi 职位性质ID {$s_xinzhi}name=s_date 发布(刷新)间隔天{$s_date}name=s_qiyexingzhi 企业性质ID {$s_qiyexingzhi}name=s_daiyu 待遇ID {$s_daiyu}标签行业名:{$s_hangyechrcategory}标签岗位名:{$s_gangweichrcategory}搜索框:{$searchhangye} 行业选择{$searchgangwei} 岗位选择(十五) 专题团购制作指南.1:文件规划:将tg\zhuanti.aspx复制到任意位置并可以改名.如复制到\chunjie\miaosha.aspx 访问地址就是: 域名\chunjie\miaosha.aspx2:参数说明 ?m=模板名称前缀.默认专题模板为template\zhuanti\tg\zhuanti.html如?m=chunjie 模板就是template\zhuanti\tg\chunjie.html3:标签创建位置:团购频道 专题团购。
