弘帝建站系统模板二次开发技术参考资料

admin

以下为已公开的参数，未公开的参数更多，可以实现更丰富的网站功能，欢迎加盟渠道合作参加培训班进行系统指导。
以下红字标识为新公开参数，我们将在适当时期开放更多功能，敬请期待。
未公开的秘密：您也可以在案例示范脚本中发现未公开的秘密哟！
由于系统不断更新，带有删除线的内容，可能已经不适用最新系统，为了兼容以往系统暂作保留，新网站不建议尝试。

开发须知：
模板位置在Userthemes下
比如建立red1模板，就是在Userthemes文件夹下建立red1文件夹，首页为index.zhg，子页为list.zhg，内容页content.zhg，如无内容页则默认list.zhg
默认js与css放在模板文件夹新建include，如上为red1：userthemes/red1/include，默认的css文件名为style.css，默认的js文件名为function.js

ABOUT
公司简介：
$func_about(navi=Navigator,para=About,plus=card,len=250,more=enter.gif)$
其它参数：link=1,2,3
2021年3月19日首次公开
新增：btn参数， btn参数可以指定1，2，3等值，也支持菜单定位参数名，多菜单参数用|分隔。
其中btn=1，表示同级菜单按纽，2表示父级子菜单（不包括父级），3表示父级子菜单（含父级）
新增：rows参数，值为数字，表示最多显示N个菜单链接（按纽）项。
2021年11月23日新增plus参数值htm,sys,usr
其中htm即html，需要配合ui参数，ui为指定的HTML(脚本不宜太长),更个性化的设计,设计参考sys
sys为系统systheme/template/功能文件夹自带的HTML,可为广大用户参考设计
usr(user)即用户独立文件设计,指向include文件夹的独立HTML设计文件,是ui的功能增强专用
新增plus需指向辅助内容,否则会提示出错，参见：http://wh.ac.cn/forum.php?mod=viewthread&tid=2949

ARTICLE
显示文章内容：
$func_summary(navi=Navigroator,para=About,len=250,more=more.gif)$
其它参数：img=1|图片名称

图文列表：
$func_article(navi=Navigator,css=List,para=News,len=13,rows=5,more=more.gif)$
显示Summary的新闻列表 1显示图片，2显示标题概要,3，显示图片与概要
$func_article(navi=NavigatorGray7,css=ArticleIndex,para=News,summ=3,len=18,rows=3,more=more.gif)$
文章列表滚动：dir=up,down,left,right

内部首次公开参数实现更强大功能(2017-3-11)：
summ=1,2,3类似于menu功能中的mode。
1=显示标题图,2=显示标题概要,3=显示标题图片概要
pics=1,2,3,...显示图片的个数，可省略默认为1
提醒：这是历史开发造成的，为了统一，建议summ用于其它用途，统一使用mode参数。

文章图片列表（建议淘汰）
$func_article(navi=Navigator,css=List,para=News,len=40,rows=10,pic=1,type=7,imgW=250,imgH=200,more=more.gif)$
上面仅适用于图片滚动多种特效，由于高度与宽度不宜在DIV中定死，故该功能不再建议使用，请淘汰之。
淘汰的参数有：pic,imgW,imgH,type紫色标注
替代办法：在遇到多图文滚动时，善用sid功能，采用msclass.js来实现图文滚动特效。

新增：title=10|20显示中英文双语标题
新增：title=11|12|21|22,其中尾数0表示无超链，1表示有超链，2表示弹出超链（2017年5月18日）

FILE
调用外部文件（2017年1月5日补充）
$func_file(...)$
para=
func=菜单功能ID值
path=路径
type=user|sys|js|css，可选项，默认为user
示例：$func_file(type=js,path=include/function)$

SUMMARY
只显示图片
$func_summary(para=Jobs,title=no,content=no,img=2)$
show=img|title|memo，show可以调整显示功能的先后顺序
如果para=id表明当前菜单ID
如果para=tid表明当前菜单之顶级菜单ID
只显示文字
$func_summary(para=Para,img=no,title=2,memo=no)
显示图片标题描述
$func_summary(para=Para,img=1,title=1,memo=1,show=title|pic|memo)
content=0|none|null,10|sec|section，0表示不显示内容,10表示显示功能设计内容，位置在后台-->布局管理-->功能版块设计
img=1显示图片,=2显示链接,=3链接弹出
title=0|no不显示title，=1显示标题,=2显示链接，=3链接弹出
memo=1显示描述，=2显示链接，=3链接弹出
show可指定先后顺序
PRODUCT
产品列表:
$func_product(navi=Navigator,css=Product,para=Product,len=8,rows=9,more=more.gif)$
sort=hit|date|hot|top，默认为new

Carousel
新增轮播动画（20190826），更简洁，功能更强大，取代Marquee与老传统Slider
格式：<carousel dir= width= height=>要滚动的内容</carousel>
支持的属于有：cid，hid，nid，pid，tid，sid，frame，dir，step，width，height，tt，timer，delay，wait，scroll，st，cm等
详情：http://wh.ac.cn/forum.php?mod=viewthread&tid=2626
SLIDER[建议淘汰]2018年1月11日
向上滚动：
$func_slider(navi=Navigator,sid=SliderUp,swidth=715,sheight=300,type=101,dir=0,para=Case,len=6,rows=16,more=moreplus.gif)$
2016年3月18日补充说明：
type=101上下滚动，默认dir=0向上滚动, dir=1向下滚动
type=102左右滚动，默认dir=0向左滚动, dir=1向右滚动
向左连续滚动
$func_slider(navi=NavigatorGreen,para=Case,len=6,rows=16,more=moreplus.gif)$
也可以以下组合实现
$func_slider(navi=Navigator,css=boxSlider,sid=Slider,para=Honor,type=0,len=10,rows=10,more=moreplus.gif)$
$func_marquee(obj=oSlider,sid=["Slider"|"boxSlider"],dir=2,tween=1,width=536,height=150,timer=20,delay=0,wait=0)$
图片轮显（显示数字和标题）
$func_slider(type=7,para=Photo,imgW=276,imgH=158,txtH=20,len=14)$
图片轮显（不显示数字）
$func_slider(type=8,para=Photo,imgW=200,imgH=158,txtH=20,len=14)$

MARQUEE(建议直接用msclass调用)
本功能淘汰于20190826，缘于Slider重新启用，功能更加强大
超强多样式滚动：
各种的匹配实现数十种滚动特效
timer,delay,wait为秒单位
间歇向上滚动：
$func_marquee(obj=obj,sid="Marquee",dir=0,tween=0.1,width=760,height=52,timer=20,delay=4,wait=5,step=52)$
向左间歇性滚动：
$func_marquee(obj=obj,sid=["Product"|"ProductView"],dir=2,tween=0.1,width=680,height=140,timer=20,delay=5,wait=5,step=52)$
向右间歇性滚动：
$func_marquee(obj=SliderUp,sid=["List"|"ProductView"],dir=3,tween=20,width=609,height=160,timer=20,delay=1,wait=2,step=180)$

MESSAGE
留言功能：
$func_message(para=Message)$
list默认参数为空时，是否完整显示message信息list=0默认不显示，list=1显示
form=0时，不显示留言表单
form=1时，显示留言表单

SEARCH
产品文章搜索：
$func_search(table=1|2,btn=1)$
2017年5月8日新增内容
支持para菜单配对，对show支持
新功能示例：
$func_search(table=1|2,btn=1,para=Search,memo=1,show=memo|title|content)$
2022年3月13日新增：table=99高级自定义搜索，对应于$func_content(so=99)$，需后台指定初始时菜单功能，以显示哪个菜单赋加的高级搜索功能

收藏本站 | 设为主页 | 简繁互换 | 多语支持
$show_addfavorite$ | $show_sethomepage$ | $show_gb2big5$
中英文切换：$show_language$收藏本站 设为主页，改由菜单设置，分别class设计为favorite,sethome

GUIDE
导航路径
$func_guide(css=GuideSplit,title=default,pre=default,sign=≡)$
css指定css类
sign指定路径分隔符，比如≡，>等，也可以图片或HTML
pre显示文字，当前位置：
title=default显示标题，也可以忽略
disp=1新增功能（2018.12.25）该功能显示顶级菜单+导航路径+当前菜单

LOGO
$show_logo$$func_logo(slogan=1,bg=1)$
更多参数有： name,alias,target,href,css等

Banner
首页和子页通用设计：$show_banner$
子页Banner，建议淘汰，这里建议仍使用$show_banner$以简化设计
特别提示：当后台未录入Banner信息时，可以在模板页添加两张图片分别为：include/sbanner.jpg或include/banner.jpg，当非主页时优先显示sbanner.jpg，主页优先显示banner.jpg
以下方法兼容往早期版本，未来将删除
$func_banner(css=sbanner,type=2,width=730,height=150,txt=0,pos=2,list=2)$
list=2表示多图片轮显，不显示数字
rows=1允许指定显示Banner个数（2019年2月3日追加功能）
pos=2已经在商业版取消表示子页面显示
type=1                '显示顶级菜单FLASH
type=2                '显示当前菜单FLASH
type=3                '显示文章FLASH
type=4                '显示产品FLASH
type=101            '显示自定义BANNER
show=clk[click]|title|thumbs|intro[summ|summary]
[]内容是同功能可选别名,clk为允许Banner点击。

MENU
菜单列表
$func_menu(css=Menu,pos=0,divi=null)$
plus="<div>内容</div>"
也可以是：plus=date|hotline|logo|search|para|msg等预置选项
msg也可以是message，但不建议。
plus1="<div>内容</div>"
plus2="<div>内容</div>"
在菜单条上赋加内容，一般多为图片、天气预报、时间表等，也可以是您任意定义的html
显示图片，描述必须添加mode
img=1|2|3
memo=1|2|3
mode=0|1|2

SUBMENU
下拉菜单参数
$func_submenu(navi=Navigator,css=SubMenu,pos=2)$
pos=0默认主菜单,pos=2默认为显示指定左菜单,1=底部菜单,3=右侧菜单。
pos不填时，当无子菜单不显示，有子菜单则显示子菜单
2015年11月22日新增项
smid="","all",显示高级选项->附属功能->MenuID值
smid=0,"no",显示正常全部子菜单
smid=166|167|188指定菜单值，多值用|分隔
smid=[1,3,5]未来是否支持子菜单按排序号选择值，尽敬期待。
支持show=smid参数值
2016年2月18日新增项
divi=null|none
null显示spacer.gif透明点图片,用div class="split"分隔菜单列表
none不显示split，让菜单更简洁
mode为子菜单需要展示的内容项，包括标题、缩略图、描述、MORE、FRAME等项。
$func_submenu(para=Ads,title=no,img=2,mode=1)$
显示子菜单标题与缩略图
$func_submenu(para=Ads,title=no,img=2,memo=1,mode=1)$
显示子菜单标题与缩略图与菜单描述
特别参数mode=1|2分别对应子菜单的标题描述图片|显示图片标题描述MORE
subimg=1|2子菜单的图片
submemo=1子菜单描述
bg=1，显示子菜单的背景
mode=10对应标题图片描述(2018.05.23)
lng=1,2,3显示不同的标题与副标题组合

LINK
友情链接
$func_link(navi=Navigator,para=Link,title=default,type=1)$
type=0标题,1图片,2下拉,3滚动新增功能支持友情链接：
$func_link(disp=2,type=1,prar=Parameter)
type=0为文字,1为图片,2为下拉菜单
支持css=CssName,相当于tabstrip中的cid。
支持鼠标动作mouse=0|1
显示最多标签数量tabs=2

CONTENT子页内容
$show_content$
$func_content(css=ContentGray)$
新增产品下一页，上一页功能，未来对文章等其它菜单功能也将适用：
参数：next=1|2|3,默认为0不显示
新增date参数，实现子页新闻功能项对date的展现方式的操控（2017-12-28）。
2022年3月13日 新增 so属于值为数字或者字符串，用于子页显示搜索功能。

广告位
<div id="AdPosition"></div>$func_ad(int=1,id=AdPosition)$

CONTACT
联系我们：
$show_contact$
$func_contact(navi=Navigator,para=Contact,show=company|tel|fax|mobile|address|zip|mail|hotline|url)$
hotline为服务热线
cln=0去掉冒号
int参数已经取消(2020.05.01)
新增秘籍(2020.05.23首次公开)：使用 file参数，实现外部文件个性设计，更灵活，更个性化。
file=abc，abc为所在模板文件夹abc.zhg文件，使用div+以下参数，实现个性化联系方式定制。
abbr,addr,app,bei,bus,company,fax,hotline,login,logo,mlogo,mail,map,mii,mini,mobile,msg,name,power,qq,qrcode,share,sitemap,sms,support,tel,url,urlqrcode,wechat,wx,zip
每个参数用前后加$，比如$tel$,$fax$,$mobile$
显示备案号的方法：$func_contact(show=mii|bei)$，其中mii为工信部备案，bei为公安备案号

COPYRIGHT
版权声明区
$show_copyright$
$func_copyright(type=3)$

STATISTICS
统计区
$show_statistics$

TABSTRIP
$func_tabstrip(disp=3,para=Product,len=8,rows=10,more=enter201.gif)$
支持cid=CssID,css=CssName
disp默认：显示父标题与子标题，鼠标触动对应标题内容显示
disp=1列表标题内容显示,不含父标题
disp=2不显示父菜单
disp=3显示父菜单
20190627新增disp=10，效果见模板：ylfs
disp=10显示父标题与子标题，鼠标触动对应标题内容显示20220823新增参数mode取代summ=1|2|3

DATETIME当前日期时间
<div id="ThisTime"></div><script>setInterval("ThisTime.innerHTML=new Date().toLocaleString();",1000);</script>

WELCOM显示公司欢迎
$show_welcome$
$func_login(wel=1,show=wel)$

LOGIN登陆注册入口
$func_login()$支持属性参数有：wel=1,login=1(默认),wf=1,plus=1
其中wel等同于welcome功能，login为注册登陆入口，wf(weather)为天气预报，plus高级html插件功能。

FLASH(建议淘汰,2020年后将不再提供支持)
指定FLASH
$func_flash(url=http://studio/fcst/fckp/image/xd.swf,width=570,height=101)$
网页HTML
<embed src=http://studio/fcst/fckp/image/xd.swf width=570 height=101></embed>

FRAME
功能一：
调用页面：$frame_<file>$
file为模板页的.zhg，常用的有main,list,top,bottom,left,right，文件需为.zhg格式。
功能二：
框架参数：frame=main|left|right|top|bottom，可与navi参数配合使用。
显示菜单高级选项功能中的页面框架，分别对应：主框架设计，顶部框架设计，左侧框架设计，右侧框架设计，底部框架设计
此功能二为内部定制网站保密，功能强大，2017年9月最新公开。

VIDEO(新增)
视频播放：$func_video(para=PATA)$
参考有：width=宽度,height=高度,ctrl=数字（显示视频控制工具条）,play=数字（是否自动播放）,loop=数字（显示是否循环）
相当于SUMMARY中show=video功能，但功能相对更强大。

Template
系统模板（渠道专用）
$func_template(para=Product,rows=12,more=more.png)$

admin

向上滚动更新说明
$func_slider(navi=Navigator,sid=SliderUp,swidth=715,sheight=300,type=101,dir=0,para=Case,len=6,rows=16,more=moreplus.gif)$，在老版本中的type=2，特此指出。
向左滚动：去掉type=101,即可。

admin

显示Summary的新闻列表 1显示图片，2显示标题概要,3，显示图片与概要
$func_article(navi=NavigatorGray7,css=ArticleIndex,para=News,summ=3,len=18,rows=3,more=moreplus.gif)$
在新版本中可能会出错，主因是summ=3造成，删除可以避免错误出现！

研发工程师核心成员备注，方便未来查错（非成员无需关注）：
在ArticleList代码中找到
    Select Case CStr(ShowSummary)
    Case "1", "3"
        If SummaryRows = "" Then SummaryRows = 1
        Sql = "Select TOP " & SummaryRows & " " & SqlField & VoteField & " FROM " & SqlTable & SqlInner & " Where a.HD_CompanyID = " & Site_ID & SqlWhere & " AND (HD_Pic<>'' OR HD_Thumbs<>'')" & SqlFlash & " Order By " & OrderBy
        StringArticle = StringArticle & ArticleSummaryList(Sql, CssName, WordNumber, DateType, CssDate, Effects, ShowSummary, SummaryRows, RequestID, DisplayTree, VoteField, SqlArticleID)
        PageListNumber = PageListNumber - SummaryRows
    Case "2"
        If SummaryRows = "" Then SummaryRows = 1
        Sql = "Select TOP " & SummaryRows & " " & SqlField & VoteField & " FROM " & SqlTable & SqlInner & " Where a.HD_CompanyID = " & Site_ID & SqlWhere & " AND HD_Summary<>''" & SqlFlash & " Order By " & OrderBy
        StringArticle = StringArticle & ArticleSummaryList(Sql, CssName, WordNumber, DateType, CssDate, Effects, ShowSummary, SummaryRows, RequestID, DisplayTree, VoteField, SqlArticleID)
        PageListNumber = PageListNumber - SummaryRows
    End Select

在此处插入容错代码。
    'pagelistnumber<=0不执行articlelist以免出错。
    If PageListNumber <= 0 Then
        StringArticle = StringArticle & "</ul>"
        ArticleList = StringArticle & "</DIV>" & vbCrLf
        If CssName <> "" Then ArticleList = "<DIV ID=""" & CssName & """>" & ArticleList & "</DIV>"
        Exit Function
    End If

在API20140511的的8月14日升级版，此问题已经得到容错，以下代码正错，不再需要删除summ=3
$func_article(navi=NavigatorGray7,css=ArticleIndex,para=News,summ=3,len=18,rows=3,more=moreplus.gif)$

admin

启用图片灯箱特效注意事项：
1、加载CSS：
<link type="text/css" rel="stylesheet" href="SysThemes/Css/lightbox.css" media="screen" />
2、加载JS:
document.write('<script type="text/javascript" src="SysThemes/js/prototype.js"></script>');
document.write('<script type="text/javascript" src="SysThemes/js/scriptaculous.js?load=effects,builder"></script>');
document.write('<script type="text/javascript" src="SysThemes/js/lightbox.js"></script>');

admin

下拉菜单代码：
<script type="text/javascript">jQuery(function(){jQuery(".menu ul li").hover(function(){jQuery(this).children("ul").slideDown();},function(){jQuery(this).children("ul").slideUp();})})</script>

admin

还有更多未公开的高级开发应用哟，弘帝网页技术培训辅导网专门为您的学习应运而生。
弘帝网页技术培训辅导网址：http://www.wuhusite.com
学员培训正在招生中，欢迎加QQ：472436818了解。
每次有免费4个名额，欢迎加QQ群交流，QQ群号：65281782。

admin

date属性值补充：
0= yyyy-mm-dd hh:mm:ss
1= yyyy年mm月dd日
2= yyyy-mm-dd hh:mm:ss
3= yyyy-mm-dd
4= yyyymmdd
5= mm-dd
6= hh:mm:ss
7= hh:mm
8= yyyy.mm.dd
100=<span class=""yymmdd""><span class=""yy"">yyyy</span><span class=""mm"">mm</span><span class=""dd"">dd</span></span><span class=""hhmmss"">hh:mm:ss</span>"
101="<span class=""dd"">dd</span><span class=""yymm"">yyyy-mm</span>

data格式化：
date=yymmdd hms
date=yy-mm-dd
date=yymmdd
双数字母重复yymmdd为年月日，单数字母hms表示时分秒

高级应用（仅商业版支持）：
{}要求增加<span class="括号内字符"></span>，示例：
{yymm}dd表示<span class="yymm">yymm</span>dd
dd{yy-mm} {hhmm}ss表示dd<span class="yymm">yy-mm</span> <span class="hhmm">hhmm</span>ss

admin

重大补充：所有func均支持show参数，但这一参数却很少得到应用，这里特别提醒。
show=content|img|memo|more|title|frame
show里面的参数可指定为以上几种，用|分享，可改变顺序，来调整页面显示效果。

admin

title参数的使用
title=alias显示别名，也可以alias=1显示，已被title=30-32取代
title=0-3,分别不显示或显示有无链接的多种情况，其中0也可以用no,null,none替换
title=10-12分别显示主副标题有无链接情况
title=20-22分别显示副主标题有无链接情况，title=10-12可以用flex-direction实现，故建议不再使用。
title=30-32分别显示别名有无链接情况
title=40-42分别显示别名主标题有无链接情况
title=50-42分别显示别名副标题有无链接情况

admin

product参数集用于最细化的模板设计。
$brand$,$browsetitle$,$code$,$companyid$,$content$,$currency$,$date$,$discount$,$flash$,$hits$,$id$,$interactive$,$isfront$,$keywords$,$marketprice$,$memberprice$,$menuid$,$metadescription$,$metakeywords$,$operator$,$particular$,$photos$,$pic$,$place$,$price$,$promotiondateend$,$promotiondatestart$,$promotionprice$,$promotiontype$,$recommend$,$sellout$,$source$,$standard$,$stocks$,$summary$,$thumbs$,$title$,$unit$,$url$,$vipprice$,$qr_code$,$qr_code_url$,$publisher$,$show$,$yun_id$,$winning_rate$,$m_pic$,$wechat_pay$,$alipay$,$pay_remark$,$video$
以上参数可在API调用获得更详细的内容，随着开发进度，随时会有新的参数加入，也可以自定义您的自有参数，以上仅供参考。