文档← 返回官网
智简魔方文档
财务系统开发文档

主题

本章介绍子主题、会员中心与购物车主题、主题语言文件及两种界面开发方式。

魔方开发者交流群：682866869

子主题开发文档

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

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

定义父主题

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

调用方式：

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

开发范例：

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

例如：

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

  1. 前往主题目录：
/public/themes/clientarea/
  1. 建立自己的主题目录，例如：
/public/themes/clientarea/mytheme
  1. 将需要修改的父主题文件复制到自己的主题目录：
/public/themes/clientarea/default/servicedetail/zjmfdcim.tpl
/public/themes/clientarea/mytheme/servicedetail/zjmfdcim.tpl
  1. 建立子主题描述文件：
/public/themes/clientarea/mytheme/theme.config

文件内容：

name: "mytheme"
description: ""
author: ""
config-parent-theme: "default"
  1. 前往后台，将主题切换到 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。

开发案例

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

  1. 前往主题目录：
/public/themes/clientarea/
  1. 建立自己的主题目录，例如：
/public/themes/clientarea/mytheme
  1. 将父主题文件复制到自己的主题目录：
/public/themes/clientarea/default/servicedetail/zjmfdcim.tpl
/public/themes/clientarea/mytheme/servicedetail/zjmfdcim.tpl
  1. 建立子主题描述文件：
/public/themes/clientarea/mytheme/theme.config

文件内容：

name: "mytheme"
description: ""
author: ""
config-parent-theme: "default"
  1. 前往后台，将主题切换到 mytheme。

主题自带语言文件能力

主题自带语言文件能力

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

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

支持范围

  1. 会员中心主题

存放路径

/public/themes/clientarea/主题名字/language/
  1. www 主题

存放路径

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

语言文件规则和系统一致

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

模板文件命名

  1. 模板文件后缀固定为 .html。
  2. 浏览器地址应与模板名称一致。例如访问 www.xxx.com/a.html 时，系统会在后台设置的模板目录中查找 a.html。
  3. 模板名称只能包含字母和数字，且不能与 public 根目录下的 HTML 文件重名；如重名，会访问 public 根目录下的文件。

debug 调试输出

在模板文件中写入：

{debug}

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

tagdata 使用界面截图

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，参数不能为空，多个
参数用英文的竖线 | 隔开

其他模板标签的用法与 ThinkPHP 5 相同。

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

魔方采用前后端分离开发，可使用魔方 API 信息接口获取模板所需的信息。

接口详情请参阅API 文档。

接口调用演示：

财务系统地址为：

http://w2.test.idcsmart.com

以下接口以 JSON 格式返回数据，均无需登录即可访问。

  1. 基础信息调用
http://w2.test.idcsmart.com/common_list
  1. 产品信息调用

①获取所有产品列表

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

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

http://w2.test.idcsmart.com/cart/index
  1. 新闻信息调用

①获取新闻列表

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
  1. 帮助信息调用

①获取帮助分类

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

文档目录

WEB主题开发文档

子主题开发文档

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

主题自带语言文件能力

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

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

关键字删除

智简魔方财务系统「bot后台」分类的「关键字删除」接口参考。资料标注的调用地址为 /admin/interflow/keywordDel POST。来源方法为 InterflowSetingController.keywordDel。

WEB主题开发文档

面向开发智简魔方财务系统官网主题的人员，说明 public/themes/web 下的 HTML 文件与 URL 映射、默认主题参考、后台切换位置、theme.jpg 缩略图及 debug 标签，帮助创建并启用可动态渲染的 Web 主题。

本页目录

子主题开发文档定义父主题自动调用 custom.css会员中心主题开发文档开发案例主题自带语言文件能力主题界面开发文档（模板引擎，推荐）模板文件命名debug 调试输出tagdata 使用主题界面开发文档（API 方式，旧版）文档目录