苹果CMS用户字段调用教程

苹果CMS V10用户模块介绍

在苹果CMS V10的模板体系中，用户模块属于页面数量较多、交互功能较为复杂的一类模块。一个相对完整的用户中心包含多个HTML模板，并且不少页面还涉及AJAX接口交互，因此会员中心模板的开发工作量通常要明显高于普通的内容页面。

对于需要定制会员中心的站点来说，除了页面UI设计之外，还需要处理登录、注册、找回密码、用户资料、积分、收藏、历史记录以及其他用户相关功能，因此实际开发时需要同时关注模板结构和后端接口之间的关系。

用户模块模板目录为：

html/user/

用户模块核心信息

苹果CMS用户模块MID和AID

苹果CMS中的模型MID用于标识当前业务模型。用户模块对应的MID为6，在模板中可以通过以下标签获取当前模型的MID：

{$maccms.mid}

用户中心页面的AID同样为6。因此在开发用户中心模板时，可以根据MID和AID判断当前页面所属的模块。

苹果CMS用户信息调用方法

用户模块中会涉及当前登录用户的信息。根据使用场景不同，可以通过$obj或者$user访问用户数据。

用户中心页面使用$obj

在用户中心模块的页面中，当前登录用户的数据可以通过$obj进行调用。例如获取用户名称：

{$obj.user_name}

这种方式适用于用户中心自身的相关页面，可以直接读取当前用户对象中的字段。

用户中心外部使用$user

如果是在用户中心之外的页面调用当前登录用户信息，则通常使用$user变量。例如：

{$user.user_name}

需要注意的是，用户登录状态下的用户信息调用与页面渲染方式有关。对于纯静态页面，无法像动态模板一样直接依赖服务端用户变量，因此如果需要在纯静态页面显示实时登录状态或用户资料，通常需要通过JavaScript和接口进行交互获取。

苹果CMS V10用户字段大全

用户对象包含账号、联系方式、头像、积分、登录记录以及分销关系等多种信息。常用字段如下：

{$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} 一级分销
{$obj.user_pid_2} 二级分销
{$obj.user_pid_3} 三级分销

用户账号与用户组字段

user_id用于获取用户ID，user_name是用户登录账号，user_nick_name则用于获取用户昵称。

用户所属组可以通过group_id获取用户组ID，也可以通过关联字段直接读取用户组名称：

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

在会员中心中，可以利用这些字段判断用户所属会员组，并结合不同用户组设置显示不同的内容或功能。

用户联系方式与头像

苹果CMS用户资料中包含QQ、邮箱和手机等绑定信息，同时还提供用户头像及缩略头像字段。

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

如果模板需要显示会员头像，可以根据实际页面尺寸选择原始头像或者缩略头像，从而减少不必要的图片加载。

用户登录与状态字段

用户状态可以通过user_status获取，登录相关信息则包括当前登录时间、登录IP、上次登录时间、上次登录IP以及累计登录次数。

{$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}

这些字段适合用于会员中心的账户信息页面，也可以用于展示用户的基本登录记录。

用户积分字段

苹果CMS用户模块提供用户积分和冻结积分字段，可以用于会员中心显示当前账户积分状态。

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

其中user_points用于获取用户当前积分，user_points_froze则用于获取被冻结的积分数量。

用户注册信息

用户注册相关信息主要包括注册时间和注册IP：

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

如果只是面向普通会员展示资料，建议根据实际需求决定是否显示IP等信息，避免在前台暴露过多账户相关数据。

QQ与微信登录信息

如果网站启用了第三方账号登录功能，还可以通过对应字段读取用户的第三方登录标识：

{$obj.user_openid_qq}
{$obj.user_openid_weixin}

这类字段主要用于系统内部关联第三方账号。实际模板开发中通常不需要直接把OpenID显示给用户。

用户保密问题

用户资料中还包含密码找回相关的保密问题和答案字段：

{$obj.user_question}
{$obj.user_answer}

这些字段属于账户安全相关数据，开发会员中心时不建议直接在前台展示用户的保密答案等敏感信息。

用户分销字段

如果网站启用了多级分销相关功能，用户对象中还提供一级、二级和三级分销关系字段：

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

开发分销中心时，可以根据这些字段判断用户对应的上级关系。不过具体分销规则仍需要结合网站实际业务逻辑和后台设置进行处理。

苹果CMS用户中心模板开发注意事项

• 用户模板主要位于html/user/目录，修改前建议先备份原模板。

• 用户中心属于动态交互较多的模块，修改HTML时不要随意删除原有表单字段。

• 涉及AJAX操作的页面，还需要同时检查对应的JavaScript事件和接口地址。

• $obj和$user的使用场景不同，调用用户信息时应根据当前页面环境选择。

• 纯静态页面不能直接依赖服务端实时用户变量，需要实时显示会员状态时可以考虑通过JavaScript接口实现。

• 用户IP、OpenID、保密答案等属于用户账户相关信息，开发前台页面时应避免不必要地公开。

• 涉及积分、密码、登录和账户资料修改的功能，应同时关注接口权限和请求安全，而不能只依赖前端验证。

总结

苹果CMS V10用户模块是整个模板体系中功能较为复杂的模块之一，模板目录位于html/user/，对应User模型，MID和AID均为6。

在会员中心开发过程中，掌握用户变量、用户字段、用户组、积分、登录信息以及第三方登录字段是基础。对于简单的会员资料展示，可以直接使用对应模板标签；如果涉及登录、密码找回、积分操作等功能，则还需要结合苹果CMS现有接口和JavaScript交互逻辑进行开发。