《建站管家》二次开发文档

本教程适用：WEB_V5.1.X及以上版本

一、目录结构

A、中文模板文件夹（英文类似）：

\template\default\cn\pc\（电脑版）

\template\default\cn\mobile\（手机版）

系统可设置前台PC端和移动端是否共用模板：

后台首页->全局管理->系统管理->语言管理->编辑对应的语言，设置前台PC端和移动端是否共用模板

如果是共用模板（自适应），则调用的模板文件存在于：\template\default\cn\pc\文件夹下（英文类似）。

二、标签使用

1、list标签（在所有模板页面均可调用）

使用方法：

{tag: list name="rs" table="数据表" where="查询条件" limit="显示数量" order="排序方式"}

循环内容

{/tag: list}

使用示例（幻灯片循环）：

{tag:list name="rs" table="ad" where="lang='cn' and ad_type='banner' and position='Index'" limit="5" order="sequence desc "}

<li><a href="{$rs.linkurl}">{$rs.thumb}</a></li>

{/tag:list}

其中limit可以这样：limit="3,6"表示显示第3到第6条

调用后台勾选：电脑端或移动端，如：

{tag:list name="rs" table="ad" where="find_in_set('wap',client)" limit="5" order="sequence desc "}

{/tag:list}

wap为移动端，pc为电脑端

2、调用后台“网站设置”里的字段在前台显示

方法：{$siteRs.数据表siteinfo里的字段}

示例：调用网站标题：{$siteRs.sitetitle}

3、调用后台“字段管理”里的内容在前台显示

方法：{$字段标签}

示例：如：你在后台添加了一个字段标签为：telephone，字段内容为：0755-XXXXXXXX

调用telephone标签：{$telephone}则显示为：0755-XXXXXXXX

4、各个模块列表页循环和分页（如：新闻模块、产品模块等）

使用方法：

{volist name="list" id="rs"}

{$rs.thumb}{$rs.title}

{/volist}

分页：<div>{$list->render()|raw}</div>

5、各个模块内容页字段显示（如：新闻模块、产品模块等）

使用方法：{$rs.数据表字段}

示例：产品图片在产品内容模板页调用：<img src="{$rs.thumb}">

三、URL路径（模板调用）

1、首页URL（中英文相同）：{$home_path}；语言首页路径：{$lang_path}，如：/cn/、/en/ 等

2、模块首页URL（没有选择分类的列表页，如产品、新闻等，中英文相同）：{$module_path}，如产品列表首页：/cn/product-p-1.html

3、模块分类列表页URL：/语言标识/模块分类的urlroute字段-模块标识字母+分类ID-页码.html，如：

中文产品分类列表页URL（英文：把cn替换为en）：/cn/biaoti-p123-1.html

cn —— 语言标识  

biaoti —— 分类的urlroute字段

p —— 产品模块标识（product首字母）

123 —— 分类ID

1 —— 第一页

中文新闻分类列表页URL：/cn/biaoti-n123-1.html

n —— 新闻模块标识（news首字母）

中文案例分类列表页URL：/cn/biaoti-c123-1.html

c —— 案例模块标识（case首字母）

中文下载分类列表页URL：/cn/biaoti-d123-1.html

d —— 下载模块标识（down首字母）

中文单页分类列表页URL：/cn/biaoti-a123-1.html

a —— 单页模块标识（about首字母）

4、模块详情页URL（如产品、新闻等）：/语言标识/模块内容的urlroute字段-模块标识字母+内容ID.html，如：

中文产品详情页URL（英文：把cn替换为en）：/cn/biaoti-p123.html

cn —— 语言标识  

biaoti —— 内容的urlroute字段

p —— 产品模块标识（product首字母）

123 —— 内容ID

中文新闻详情页URL：/cn/biaoti-n123.html

n —— 新闻模块标识（news首字母）

中文案例详情页URL：/cn/biaoti-c123.html

c —— 案例模块标识（case首字母）

中文下载详情页URL：/cn/biaoti-d123.html

d —— 下载模块标识（down首字母）

中文单页详情页URL：/cn/biaoti-a123.html

a —— 单页模块标识（about首字母）

四、前端模板命名规则

1、详情页以view_开头，如：view_default.html就是默认详情页

2、列表页以list_开头，如：list_default就是默认列表页

五、数据库表（因版本升级，可能会有所变动，具体请看真实数据库里的表，有注释）