苹果CMS V10用户中心字段调用与模板开发教程

一、苹果CMS V10用户模块基础概述

苹果CMS V10用户模块是站点会员交互的核心模块，涵盖登录注册、资料修改、积分查询、浏览收藏、分销数据等多项功能。该模块模板结构复杂、交互接口较多，定制开发难度高于普通内容页面，开发时需兼顾页面样式布局与后端数据交互逻辑。

用户模块所有前台模板文件统一存放于专属目录，所有会员相关页面开发、修改均在此目录完成。

模板目录：html/user/

二、用户模块核心基础参数

用户模块拥有固定的模型标识与页面参数，是模板开发判断页面模块、调取数据的核心依据，具体参数如下：

模板中可通过标签动态获取当前模型MID值，用于页面逻辑判断：

{$maccms.mid}

三、用户信息变量调用场景区分

苹果CMS针对不同页面场景，提供两种用户信息调取变量，适配站内不同页面的用户数据展示需求，两种变量不可混用。

1、用户中心页面 $obj 变量

仅适用于 html/user/ 目录下的会员中心页面，可直接读取当前登录用户的完整数据，是用户中心模板的专属调用变量。

调用示例（获取用户名）：

{$obj.user_name}

2、全站通用页面 $user 变量

适用于用户中心以外的所有站点页面，用于在首页、列表页、详情页等页面展示登录用户信息，适配全站用户状态展示需求。

调用示例（获取用户名）：

{$user.user_name}

纯静态页面无法直接读取服务端用户变量，如需实时展示登录状态、用户资料，需通过 JavaScript 对接系统接口异步获取数据。

四、用户模块全字段调用汇总

用户模型包含账号信息、头像、联系方式、登录记录、积分、分销、账号安全等全量字段，可满足会员中心所有展示需求，完整可用字段如下：

{$obj.user_id} 用户ID
{$obj.group_id} 用户组ID
{$obj.group.group_name} 用户组名称
{$obj.user_name} 用户登录账号
{$obj.user_nick_name} 用户昵称
{$obj.user_qq} 绑定QQ账号
{$obj.user_email} 绑定邮箱
{$obj.user_phone} 绑定手机号
{$obj.user_status} 账号状态
{$obj.user_portrait} 用户原始头像
{$obj.user_portrait_thumb} 用户缩略头像
{$obj.user_openid_qq} QQ登录标识
{$obj.user_openid_weixin} 微信登录标识
{$obj.user_question} 密保问题
{$obj.user_answer} 密保答案
{$obj.user_points} 可用积分
{$obj.user_points_froze} 冻结积分
{$obj.user_reg_time} 账号注册时间
{$obj.user_reg_ip} 注册IP地址
{$obj.user_login_time} 本次登录时间
{$obj.user_login_ip} 本次登录IP
{$obj.user_last_login_time} 上次登录时间
{$obj.user_last_login_ip} 上次登录IP
{$obj.user_login_num} 累计登录次数
{$obj.user_pid} 一级分销上级ID
{$obj.user_pid_2} 二级分销上级ID
{$obj.user_pid_3} 三级分销上级ID

五、细分字段功能说明

1、账号与用户组字段

用于展示用户基础账号信息与会员等级，可根据用户组权限差异化展示页面内容。

{$obj.group_id}
{$obj.group.group_name}

2、联系方式与头像字段

涵盖用户绑定的社交账号、联系方式及头像资源，可根据页面尺寸选用原图或缩略图，优化页面加载速度。

{$obj.user_qq}
{$obj.user_email}
{$obj.user_phone}
{$obj.user_portrait}
{$obj.user_portrait_thumb}

3、账号登录记录字段

记录用户登录行为数据，可用于会员中心安全中心页面，展示账号登录轨迹，方便用户核对账号安全状态。

{$obj.user_status}
{$obj.user_login_time}
{$obj.user_login_ip}
{$obj.user_last_login_time}
{$obj.user_last_login_ip}
{$obj.user_login_num}

4、积分数据字段

展示用户可用积分与冻结积分数据，是会员积分中心、权限解锁功能的核心调用字段。

{$obj.user_points}
{$obj.user_points_froze}

5、注册信息字段

记录账号注册基础数据，前台展示建议隐藏IP等敏感信息，保护用户隐私。

{$obj.user_reg_time}
{$obj.user_reg_ip}

6、第三方登录与安全字段

主要用于系统后台账号关联校验，前台模板一般无需展示，避免泄露用户私密数据。

{$obj.user_openid_qq}
{$obj.user_openid_weixin}
{$obj.user_question}
{$obj.user_answer}

7、多级分销字段

适配站点三级分销功能，用于分销中心展示上下级关联关系，结合后台分销规则实现数据联动。

{$obj.user_pid}
{$obj.user_pid_2}
{$obj.user_pid_3}

六、用户中心模板开发注意事项

• 修改用户模板前需备份原文件，避免功能代码丢失导致会员功能异常。

• 用户模块多为动态交互页面，不可随意删除表单元素、JS事件及接口请求代码。

• 严格区分 $obj 与 $user 变量使用场景，避免出现数据调取失效问题。

• 纯静态页面无法直接读取服务端用户变量，实时会员状态展示需通过JS接口实现。

• IP地址、密保答案、第三方OpenID等敏感数据，禁止在前台页面公开展示。

• 积分操作、密码修改、资料编辑等核心功能，需依托后端接口权限校验，不可仅依赖前端验证。

七、教程总结

苹果CMS V10用户模块以 User 模型为核心，MID与AID值均为6，所有模板文件统一存放于 html/user/ 目录。模板开发需根据页面场景选择对应的用户调用变量，熟练运用账号、积分、登录记录、分销等全量字段，同时兼顾页面交互安全与用户隐私保护，可快速完成个性化会员中心定制开发。