财务系统开发文档>主题
cs/wordpress新的主题,无需具备完整的主题。一.只需要在主题配置文件中定义副主题,当子主题不存在的tpl时,就会自动调用父主题tpl调用方式:主题根目录theme.config 子主题配置文件,用于配置本主题的继承主题,即当本主题中的文件不存在时,查找哪个主题开发范例:/public/themes/clientarea/child-theme-example例如:需求:客户需要修改升降级时候的文字,不希望改动主题和影响更新,需要使用子主题功能进行开发1.前往 /public/themes/clientarea/2.建立自己的主题目录,如mytheme/public/themes/clientarea/mytheme3.本次修改修改的文件是产品内页的描述文字,找到是下面这个文件,将文件拷贝到自己的主题目录/public/themes/clientarea/default/servicedetail/zjmfdcim.tpl 拷贝到/public/themes/clientarea/mytheme/servicedetail/zjmfdcim.tpl 修改文件内容4.建立子主题描述文件/public/themes/clientarea/mytheme/theme.config文件内容:name:"mytheme"description:""author:""config-parent-theme:"default"5.前往后台切换主题到mytheme二.css调用能力,当子主题存在custom.css时,将会自动调用子主题的custom.css您可在子主题根目录中存放custom.css这时候访问时,系统会自动引用custom.css您无需修改父主题的css文件,实现自定义样式,方便更新二、会员中心主题开发文档用于使用财务系统V2.0以上,使用模板引擎方式开发主题会员中心和购物车主题时智简魔方财务系统V2.0版本开始,使用了模板引擎作为界面渲染工具,不再使用V1.X所使用的的VUE框架本文章重点介绍,模板引擎功能和如何进行开发1、基础介绍模板目录智简魔方财务系统分为3个模板,分别为1.www界面使用的web模板模板路径:/public/themes/web/URL路径规则: www.abc.com/cloud.html 会自动查找/public/themes/web/cloud.tpl并渲染输出2.会员中心使用的clientarea模板/public/themes/clientarea/URL路径规则: 固定路径,无法直接增加,可参考官方模板获取url和tpl对应规则3.购物车使用的cart模板/public/themes/cart/URL路径规则: 固定路径,无法直接增加,可参考官方模板获取url和tpl对应规则智简魔方财务系统使用Thinkphp框架开发,模板引擎使用Thinkphp带的模板引擎模板文件后缀定义为 .tpl调试模式模板开发中,只需要在访问的模板文件中增加以下标签,即可弹出调试模式菜单,获取到所有变量{debug}添加以上标签到模板tpl任意位置,随后刷新访问,系统将会弹窗方式弹出debug模板配置文件每个模板都需要存在一个模板配置文件,本文件应该位于模板根目录theme.config文件内容模板继承能力模板支持继承,需要在可参考/public/themes/clientarea/child-theme-example子主题范例进行开发必须文件1.theme.config 子主题配置文件,用于配置本主题的继承主题,即当本主题中的文件不存在时,查找哪个主题自定义页面会员中心模板引擎支持自定义页面调用方法: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如果未指定,系统会默认调用clientarea2、开发案例需求:客户需要修改升降级时候的文字,不希望改动主题和影响更新,需要使用子主题功能进行开发1.前往/public/themes/clientarea/2.建立自己的主题目录,如mytheme/public/themes/clientarea/mytheme3.本次修改修改的文件是产品内页的描述文字,找到是下面这个文件,将文件拷贝到自己的主题目录/public/themes/clientarea/default/servicedetail/zjmfdcim.tpl 拷贝到/public/themes/clientarea/mytheme/servicedetail/zjmfdcim.tpl 修改文件内容4.建立子主题描述文件/public/themes/clientarea/mytheme/theme.config文件内容:name:"mytheme"description:""author:""config-parent-theme:"default"5.前往后台切换主题到mytheme三、主题自带语言文件能力主题自带语言文件能力支持在主题根目录放置 language目录,并放置你自己的语言文件。系统加载时,将会优先使用您定义的语言文件,如不存在时,会寻找系统默认语言文件。支持范围会员中心主题存放路径 /public/themes/clientarea/主题名字/language/2.www主题存放路径/public/themes/web/主题名字/language/语言文件规则和系统一致四、主题界面开发文档(模板引擎,推荐)1、模板文件命名1)、模板文件后缀固定是.html2)、浏览器中的地址需和模板名称一致。例如:在浏览器中输入www.xxx.com/a.html,就会在后台设定的模板文件夹中去找a.html。3)、模板文件名称只能是字母和数字,不能有特殊字符,模板名称不能和public根目录下的html文件重名(如果重名访问的是public根目录下的html文件)2、dubug调试输出1)、在模板文件中写入 {debug} ,在浏览器中访问该模板就会弹出当前页面输出的所有数据,如图所示:2)、在公共页面(header.html或footer.html)写入 {debug},所有引用了该模板的文件都可以看到弹出的debug页面3)、这时浏览器中对设置debug的模板访问,即可弹出debug弹窗,弹出页面上面是模板可以输出的数据,下面部分是当前模板输出的数据注意:浏览器不能屏蔽弹窗3、tagdata使用当前模板需要输出的数据1)、在模板文件中写入{tagdata name="" /},name中写入该模板页面需要的数据,name中的值可参看以下表格,也可以在debug弹窗中看得到。注: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方式返回数据,以下接口,都无需登录直接访问1.基础信息调用http://w2.test.idcsmart.com/common_list2.产品信息调用①获取所有产品列表http://w2.test.idcsmart.com/cart/all②获取所有产品分组和产品分组下面的产品列表http://w2.test.idcsmart.com/cart/index3.新闻信息调用①获取新闻列表http://w2.test.idcsmart.com/news/list②获取文章内容http://w2.test.idcsmart.com/news/content&id=34 id=后加新闻id③获取新闻分类http://w2.test.idcsmart.com//news/catelist4.帮助信息调用①获取帮助分类http://w2.test.idcsmart.com//news/catelist