自定义产品页开发说明

云业务管理系统（国内版）

自定义产品页开发说明

最后更新时间：2023-01-17 14:12:37

#### 文件位置及命名规范

**文件位置**

所有自定义模板文件均放在 `template\Home\Zkeys\PC\Page\Custom` 目录

其中路径中的 `Zkeys` 为实际模板目录名称，官方默认模板为`Zkeys`，如二开模板请根据实际情况创建对应自定义功能的模板目录

**文件命名**
 
 注：`{name}` 为自定义名称
 
 产品页面文件：index-{name}.html
 
 购买页面文件：buy-{name}.html

#### 开发步骤

1.创建模板文件

文件命名：

产品页面文件：`index-custom.html`

购买页面文件：`buy-custom.html`

2.后台配置自定义产品

添加步骤可参考:[自定义产品功能说明](https://www.apayun.com/doc/551 "自定义产品功能说明")

3.对模板页面进行开发

开发模板页面需要熟悉 ThinkPHP3.2

**产品页**

页面变量：

| 参数名  |  说明 |
| ------------ | ------------ |
| product  |  产品详情 |

模板使用示例:

产品信息

```
产品名称：{$product.name}
产品描述：{$product.description}
产品标识：{$product.code}
产品到期提醒规则：{$product.renew_notice_rule}
到期后保留时长：{$product.retention_days}
产品状态：{$product.status}
```

套餐信息

```
输出示例
<volist name=”packages” id=”vo”>
	套餐名称: {$vo.name}
	套餐描述: {$vo.description}
	一次最大购买数: {$vo.max_num}
	配置信息：
		<volist name=”vo.config” id=”value”>
			{$key}:{$value}
		</volist>
	价格信息：
		<volist name=”vo.price” id=”price”>
			购买时长:{$price.name}
			购买价格:{$price.price}
		</volist>
</volist>
```

**购买页**

后端返回数据在一个名为: `syncData` 的json对象中．使用时, 请先用js获取数据对象，之后再将相关数据赋值到模板

如:

```
<script>var syncData = {$syncData };</script>
```

返回数据示例：

```
{
    "product": {								//产品信息
        "code": "pen",							//产品标识
        "create_time": "2020-05-28 10:32:04",		//产品创建时间
        "description": "",						//产品描述
        "name": "写字笔",						//产品名称
        "renew_notice_rule": "1,3,7",				//到期提醒规则，单位：天
        "retention_days": "2",					//到期后保留时长，单位：天
        "status": "1"							//产品状态0关闭、1开放'
    },
    "fields": 								//用户端自定义字段列表
        {
            "name": "身高",						//字段名称
            "code": "length",						//字段标识
            "required": "1",						//是否必须
            "type": "select",						//字段类型: 单行文本text、多行文本											//textarea、单选radio、下拉select
            "default_value": "10,15,20"				//单选和下拉类型字段选项值
        },
        {
            "name": "体重11",
            "code": "weights",
            "required": "1",
            "type": "text",
            "default_value": ""
        }
    ],
    "packages": [							//产品套餐列表
        {		
            "name": "最新手表--豪华版",			//套餐名称
            "code": "lastest",						//套餐标识
            "description": "",						//套餐描述
            "max_num": "3",						//最大购买数量
            "config": {							//套餐配置信息(后台纯文本自定义类型字段)
                "外观": "可爱",						//配置名称: 配置值
                "触感": "爽"
            },
            "price": {							//套餐价格
                "day": {							//支付方式
                    "name": "1天",					//购买时长
                    "price": "200.00"					//套餐价格
                },
                "week": {
                    "name": "1周",
                    "price": "250.00"
                },
                "month": {
                    "name": "1个月",
                    "price": "250.00"
                }
            }
        }
    ]
}
```

5.下单接口

接口地址: `/custom/order`

请求方式: POST

请求参数:

| 参数名  | 必选  |  类型 |  说明 |
| ------------ | ------------ | ------------ | ------------ |
| product_id  | 是  | Int  | 产品id  |
| package_id  | 是  | Int  | 套餐id  |
| num  | 是  | Int  | 购买数量  |
| pay_type  | 是  | String  | 支付方式，day:1天，week:1周，month:1个月，half-year:半年，year:1年，two-year:2年，three-year:3年，five-year:5年，ten-year:10年 |
| length  | 后台定义  | 后台定义  | 后台自定义用户端字段  |
| weights  | 后台定义  | 后台定义  | 后台自定义用户端字段  |

返回数据:

```
{
    "result": true,									//返回结果
    "text": "订单生成成功，请前往支付",				//返回提示
    "url": "/user/order/view.html?id=15760"				//跳转路由
}
```

阿帕云引擎

云引擎受控端

云引擎控制器

云引擎开放API

文档首页

云业务管理系统（国内版）

18+

1000+

30+

5+