主题

本页汇总智简魔方财务系统中“主题”相关文档，便于读者按现有分类快速查找具体说明。

【魔方开发者交流群：682866869】

本文档包括：

子主题开发文档
会员中心主题开发文档
主题自带语言文件能力
主题界面开发文档（模板引擎，推荐）
主题界面开发文档（API 方式，旧版）

一、子主题开发文档

会员中心主题支持子主题方式开发，类似于 whmcs/wordpress

新的主题，无需具备完整的主题。

定义父主题

只需要在主题配置文件中定义父主题，当子主题不存在对应 tpl 时，就会自动调用父主题的 tpl。

调用方式：

主题根目录 theme.config 子主题配置文件，用于配置本主题的继承主题，即当本主题中的文件不存在时，查找哪个主题

开发范例：

/public/themes/clientarea/child-theme-example

例如：

需求：客户需要修改升降级时候的文字，不希望改动主题和影响更新，需要使用子主题功能进行开发

/public/themes/clientarea/

/public/themes/clientarea/mytheme

将需要修改的父主题文件复制到自己的主题目录：

/public/themes/clientarea/default/servicedetail/zjmfdcim.tpl
/public/themes/clientarea/mytheme/servicedetail/zjmfdcim.tpl

建立子主题描述文件：

/public/themes/clientarea/mytheme/theme.config

文件内容：

name: "mytheme"
description: ""
author: ""
config-parent-theme: "default"

前往后台，将主题切换到 mytheme。

自动调用 custom.css

您可在子主题根目录中存放 custom.css

这时候访问时，系统会自动引用 custom.css

您无需修改父主题的 css 文件，实现自定义样式，方便更新

二、会员中心主题开发文档

用于使用财务系统 V2.0 以上，使用模板引擎方式开发主题会员中心和购物车主题时

智简魔方财务系统 V2.0 开始使用 ThinkPHP 模板引擎。模板目录与示例：

/public/themes/web/
/public/themes/clientarea/
/public/themes/cart/

模板文件后缀为 .tpl。调试标签：

{debug}

模板根目录配置文件：

theme.config

子主题范例：

/public/themes/clientarea/child-theme-example

自定义页面调用及模板：

domain.com/page=sdfsdf
sdfsdf.tpl

购物车主题顶部双重调用功能

购物车主题默认会调用会员中心的头部底部进行页面渲染。

我们也支持允许客户通过配置文件或者 url 定义调用的头部/底部

web 的头部/底部默认调用路径为

/web/主题名字/common/footer.html

/web/主题名字/common/header.html

会员中心主题的默认头部底部路径

/clientarea/主题名字/header.tpl

/clientarea/主题名字/footer.tpl

主题定义文件方法：

在购物车主题根目录建立主题配置文件 theme.config

写入配置

properties:
loggedheader: clientarea # 定义登录后的头部底部调用
nologinheader: clientarea # 定义未登录后的头部底部调用

URL 方法：

通过访问购物车时增加参数

使用 web 主题的头部底部

&site=web

使用会员中心主题的头部底部

&site=clientarea

例子

http://www.test.idcsmart.com/cart?action=configureproduct&pid=805&site=clientarea

如果未指定，系统会默认调用clientarea

2、开发案例

需求：客户需要修改升降级时候的文字，不希望改动主题和影响更新，需要使用子主题功能进行开发。

/public/themes/clientarea/

/public/themes/clientarea/mytheme

/public/themes/clientarea/default/servicedetail/zjmfdcim.tpl
/public/themes/clientarea/mytheme/servicedetail/zjmfdcim.tpl

建立子主题描述文件：

/public/themes/clientarea/mytheme/theme.config

文件内容：

name: "mytheme"
description: ""
author: ""
config-parent-theme: "default"

前往后台，将主题切换到 mytheme。

三、主题自带语言文件能力

主题自带语言文件能力

支持在主题根目录放置 language 目录，并放置你自己的语言文件。

系统加载时，将会优先使用您定义的语言文件，如不存在时，会寻找系统默认语言文件。

支持范围

会员中心主题

存放路径

/public/themes/clientarea/主题名字/language/

www 主题

存放路径

/public/themes/web/主题名字/language/

语言文件规则和系统一致

四、主题界面开发文档（模板引擎，推荐）

1、模板文件命名

**
**1）、模板文件后缀固定是.html
2）、浏览器中的地址需和模板名称一致。例如：在浏览器中输入www.xxx.com/a.html,就会在后台设定的模板文件夹中去找a.html。
3）、模板文件名称只能是字母和数字，不能有特殊字符，模板名称不能和public根目录下的html文件重名（如果重名访问的是public根目录下的html文件）

2、dubug调试输出

在模板文件中写入：

{debug}

访问模板后会弹出当前页面的数据；在公共页面 header.html 或 footer.html 中加入该标签，引用它们的页面也会显示调试弹窗。

tagdata 使用界面截图

3、tagdata使用

当前模板需要输出的数据：

{tagdata name="" /}

setting、userInfo 默认输出；多个字段用英文逗号分隔。

字段	字段名	说明
setting	网站设置数据	默认输出
userInfo	登录用户信息	默认输出，为空是未登录
newsCate	获取新闻分类	无参数
newsList	获取新闻列表	无参数
newsListCate	获取新闻分类列表	无参数
newsSearch	获取新闻搜索	无参数
newsContent	获取新闻内容	无参数
helpCate	获取帮助分类	无参数
helpList	获取帮助列表	无参数
helpListCate	获取帮助分类列表	无参数
helpSearch	获取帮助搜索	无参数
helpContent	获取帮助内容	无参数
firstGroups	产品一级分类	参数格式firstGroups[fid:1\|fid:2]输出ID=1和ID=2的一级分类， fid: 是指一级分类id，firstGroups参数为空则输出所有一级分类，多个参数用英文的竖线 \| 隔开
secondGroups	产品二级分类	参数格式secondGroups[sid:1\|sid:2]输出ID=1和ID=2的二级分类， sid: 是指二级分类id，secondGroups参数为空则输出所有二级分类，多个参数用英文的竖线 \| 隔开
product	获取产品	参数格式product[pid:1\|pid:3]输出ID=1和ID=3的产品, pid: 是指产品id.参数不能为空，多个参数用英文的竖线 \| 隔开
productGroups	获取二级分类ID下产品	参数格式productGroups[sid:1\|sid:2]输出产品分类ID=1和ID=2关联的产品, sid: 是指二级分类id，参数不能为空，多个参数用英文的竖线 \| 隔开

4、其它模板标签用法和thinkphp5一样

五、主题界面开发文档（API 方式，旧版）

魔方采用前后端分离开发，可使用魔方api中的信息接口，获取模板需要使用到的信息

API 文档：

http://w2.test.idcsmart.com/doc

接口调用演示：

财务系统地址为：

http://w2.test.idcsmart.com

我们将以 json 方式返回数据，以下接口，都无需登录直接访问

基础信息调用

http://w2.test.idcsmart.com/common_list

产品信息调用

①获取所有产品列表

http://w2.test.idcsmart.com/cart/all

②获取所有产品分组和产品分组下面的产品列表

http://w2.test.idcsmart.com/cart/index

新闻信息调用

①获取新闻列表

http://w2.test.idcsmart.com/news/list

②获取文章内容

http://w2.test.idcsmart.com/news/content&id=34

id=后加新闻 id

③获取新闻分类

http://w2.test.idcsmart.com//news/catelist

帮助信息调用

①获取帮助分类

http://w2.test.idcsmart.com//news/catelist

主题

一、子主题开发文档

定义父主题

自动调用 custom.css

二、会员中心主题开发文档

三、主题自带语言文件能力

四、主题界面开发文档（模板引擎，推荐）

五、主题界面开发文档（API 方式，旧版）

文档目录

WEB主题开发文档

子主题开发文档

会员中心与购物车主题开发文档

主题自带语言文件能力

主题界面开发文档(模板引擎，推荐)

主题界面开发文档(API方式，老)

本页目录