粉丝信息 - 微擎二次开发手册、文档、教程

粉丝信息获取、使用及更新的规范

由于系统中模块众多，如果模块不按规范及系统提供的方法来操作粉丝信息，很容易会使粉丝信息错乱、重复，不仅系统会产生很多冗余数据，对于构造统一化的粉丝及会员数据中心也带来了很大的困难。
以下来梳理一下各种情况如何使用系统中的方法来获取和更新粉丝信息。

注：模块中禁止直接插入、更新、删除操作mc_mapping_fans表，此规范适合于 0.7_20151012 以后的版本

粉丝的Openid获取方法

获取粉丝的Openid有两种办法：

通过回复关键字来获取粉丝的openid信息此方法适合于没有任何服务号权限的公众号，可以通过设置回复关键字，在回复的信息中（文本、图文）中添加链接
此链接会自动带上粉丝的Openid数据，进入系统后可通过_W['openid']和_W[‘fans’]来查看
通过OAuth接口来获取粉丝的openid信息此方法并不需要开发者来主动调用，当公众号是服务号或是使用了【借用OAuth权项】（管理公众号 - 参数配置 - 借用权限）的话系统会自动在粉丝进入页面的时候获取到其openid的信息，使用方法同上，通过_W['openid']和_W[‘fans’]来查看

粉丝信息获取方法

此处讨论的通过微信接口获取粉丝数据是基于服务号的前提

获取粉丝信息有多种方法及渠道，总结有以下几种：

已关注的粉丝从微信接口获取数据数据（昵称，头像等）
已关注的粉丝获取在微擎系统资料数据（电话，邮箱，性别等）
未关注的粉丝从微信接口获取数据数据（昵称，头像等）

已关注的粉丝从微信接口获取昵称及头像数据

已关注的粉丝，当公众号有获取信息权限的时候，可直接通过_W['fans']来得到粉丝的数据，也可以手动通过 mc_fansinfo(openid) 函数来获取。注：此数据只是微信端的昵称，头像等数据
结构如下：

$_W['fans'] = array(
	'fanid' => '33790' // 粉丝id
	'acid' => '6' 
	'uniacid' => '6' // 公众号id
	'uid' => '6944' // 用户id
	'openid' => 'oTKzFjv2FQ7EetJGLbxuGY6m0KmY' 
	'groupid' => '0' // 用户组id
	'salt' => 'FRj8Bffr'
	'follow' => '1' // 是否关注
	'followtime' => '1444465409' // 关注时间
	'unfollowtime' => '0' // 取消关注
	'tag' => array(
		'subscribe' => '1' // 关注
		'openid' => 'oTKzFjv2FQ7EetJGLbxuGY6m0KmY' 
		'nickname' => '微擎 ' //昵称
		'sex' => '1' // 性别
		'language' => 'zh_CN' // 语言
		'city' => '北京'// 居住城市
		'province' => '北京' // 省份
		'country' => '中国' // 国家
		'subscribe_time' => '1444465409' // 关注时间
		'remark' => ''
		'groupid' => '0' 
		'avatar' => 'http://wx.qlogo.cn/mmopen/GibvHudxm<x>lJYsBJRlWbtSXADlpc0IatIuAjS2Fm9oF6tvIq1GfPMibhyRRcdJdR4ZA0x6CIx3030I37OuGEFf4kg/0'// 头像
	)
	'updatetime' => '1444465531' // 更新日期
	'nickname' => '微擎' // 昵称
	'unionid' => ''
	'from_user' => 'oTKzFjv2FQ7EetJGLbxuGY6m0KmY' // 当前粉丝标识
)

已关注的粉丝获取在微擎系统会员资料数据

除了可以获取粉丝在微信端的昵称等数据外，也可以获取到其在微擎系统中登记的额外的会员数据资料。
通过 mc_fetch(uid) 函数来获取。此处的uid可以是_W['fans'][uid]也可以是_W[‘openid’]。
会员资料数据如下：

array(
	'uid' => '6944' // 用户id
	'uniacid' => '6' // 公众号id
	'mobile' => // 手机
	'email' => 'ab75d41d9679b7742fe3c8a7c9577e2a@we7.cc' // email地址
	'password' => 'c1e1d8b8c781f0df6866a495a849f9df' // 密码
	'salt' => 'qefDD454'
	'groupid' => '6' // 用户组id
	'credit1' => '0.00' // 积分 
	'credit2' => '0.00' // 余额
	'credit3' => '0.00' // 备用1
	'credit4' => '0.00' // 备用2
	'credit5' => '0.00' // 备用3
	'createtime' => '1444465531' // 创建时间
	'realname' => // 真实姓名
	'nickname' => '微擎' // 昵称
	'avatar' => 'http://wx.qlogo.cn/mmopen/GibvHudxm<x>lJYsBJRlWbtSXADlpc0IatIuAjS2Fm9oF6tvIq1GfPMibhyRRcdJdR4ZA0x6CIx3030I37OuGEFf4kg/132' //头像
	'qq' => //QQ号
	'vip' => '0' // 会员
	'gender' => '1' // 性别
	'birthyear' => '0' // 出生年
	'birthmonth' => '0' // 出生月
	'birthday' => '0' // 出生日
	'constellation' => // 星座
	'zodiac' => '', //生肖
	'telephone' => // 手机号
	'idcard' => // 身份证号
	'studentid' => // 学号
	'grade' => // 学籍
	'address' => //地址
	'zipcode' => //邮政编码
	'nationality' => '中国' // 现居国家 
	'resideprovince' => '北京'// 现居省分
	'residecity' => '北京市' // 现居地市
	'residedist' =>  // 居住地
	'graduateschool' => // 毕业院校
	'company' => // 公司信息
	'education' => // 教育情况
	'occupation' => // 职业
	'position' => // 所在位置
	'revenue' => // 收入情况
	'affectivestatus' => // 身高
	'lookingfor' => // 
	'bloodtype' => // 血型
	'height' => // 身高
	'weight' => // 体重
	'alipay' => // 支付宝
	'msn' => // msn
	'taobao' => // 淘宝号
	'site' => // 站点
	'bio' => 
	'interest' => // 个人兴趣
)

未关注的粉丝从微信接口获取数据数据(借用)

粉丝未关注公众号获取资料时，需要弹出确认授权的登录框，粉丝同意后公众号才可以获取到用户信息，此操作需要手动调动函数来完成。
通过 mc_oauth_userinfo() 来获取粉丝信息，如下：

if (empty($_W['fans']['nickname'])) {
	mc_oauth_userinfo();
}
print_r($_W['fans']);

$_W['fans'] = array(
	'uid' => 0,
	'openid' => 'oTKzFjv2FQ7EetJGLbxuGY6m0KmY',
	'follow' => '0' // 是否关注
	'tag' => array(
		'subscribe' => '1' // 关注
		'openid' => 'oTKzFjv2FQ7EetJGLbxuGY6m0KmY' 
		'nickname' => '微擎 ' //昵称
		'sex' => '1' // 性别
		'language' => 'zh_CN' // 语言
		'city' => '北京'// 居住城市
		'province' => '北京' // 省份
		'country' => '中国' // 国家
		'subscribe_time' => '1444465409' // 关注时间
		'remark' => ''
		'groupid' => '0' 
		'avatar' => 'http://wx.qlogo.cn/mmopen/GibvHudxm<x>lJYsBJRlWbtSXADlpc0IatIuAjS2Fm9oF6tvIq1GfPMibhyRRcdJdR4ZA0x6CIx3030I37OuGEFf4kg/0'// 头像
	)
)

强制粉丝登记扩展信息方法（会员信息）

在使用一些功能时，需要用户的一些额外信息，比如真实姓名，手机号等，才能使用，需要粉丝进行登记操作，使用 mc_require($uid, $fields) 来让用户登录信息。如下：

//注：第一个参数同样接受Openid或是Uid
//此方法会判断用户是否已经填写过资料，如果填写过了就会继续向下执行，如果未填写，会跳转到填写界面
mc_require($_W['fans']['uid'], array('realname', 'mobile'));

注：无论粉丝是否关注公众号，都可以产生一条uid数据也是通过$_W[‘fans’][‘uid’]来获取

更新已关注粉丝扩展信息方法（会员信息）

在模块功能开发中如果需要更新一些资料信息，比如真实姓名，手机号等，可以使用 mc_update()函数来操作

//注：第一个参数同样接受Openid或是Uid
mc_update($_W['member']['uid'],array('email' => 'test@163.com'));