模组参考会员
充值订单记录
MacCMS 充值订单记录:当前会员至少有一条已创建的充值订单。说明页面入口、操作步骤、模板数据与失败排查。
MacCMS V10 · 更新于 · MacCMS Club 编辑部 · 版本与验证范围
充值订单记录属于前台会员功能。当前会员至少有一条已创建的充值订单。
页面与数据
| 项目 | 说明 |
|---|---|
| 当前模板文件 | html/user/orders.html |
| 入口 | user/orders |
| 模型/页面编号 | mid=6,aid=6 |
| 当前用户 | 控制器提供的 $obj;私有字段不要输出到公开页面 |
| 本页数据 | $list 是记录列表,$PAGING 是分页对象 |
按顺序操作
查看订单号、金额与状态;只有未付订单才进入继续支付。测试已付订单不会再次扣费。
最小显示示例
{empty name="list"}<p>暂无记录。</p>{/empty}
{volist name="list" id="row"}
<p>order_code:{$row.order_code}</p>
<p>order_price:{$row.order_price}</p>
<p>order_status:{$row.order_status}</p>
{/volist}此例用于自行编写服务端列表,显示当前会员的原始记录字段;时间戳可使用 date 过滤器格式化。当前默认主题的一些列表改由页面脚本请求 API 后显示,修改这类主题时保留它的容器、脚本和分页,不要同时叠加两套列表。
默认主题的 user-orders-list.js 请求 /api.php/order/get_list?page=1&limit=20,从 info.list 渲染订单;登录身份由会话决定。order_status=1 表示已支付。
自定义模板时保留什么
- 从本文底部的同版本默认模板核对表单字段和调用方法,再移植到自己的主题。
- 同时保留公共 include、public/jsvar 和页面专用脚本;只复制表单标签会丢失 AJAX、验证码或错误处理。
- 本版本使用 CSRF 令牌。需要提交的表单按原实现携带 token 或相应头部,令牌取当前页面,不写死。
- 不修改用户 ID 来查看其他账号数据;身份和订单归属由后端决定。
如何验收
同一订单号在支付页和列表一致;换账号不能查看他人订单。
常见失败
用订单号查状态,不靠金额猜测;排查服务端权限与渠道回调。 在浏览器 F12 → Network 中查看请求的状态码与响应 code/msg。不要只看按钮是否变色。