php微信开发自定义菜单
2018-09-07 19:17
目前微信服务号自定义菜单最多包括3个一级菜单,每个一级菜单最多包含5个二级菜单。一级菜单最多4个汉字,二级菜单最多7个汉字,多出来的部分将会以“...”代替。请注意,创建自定义菜单后,由于微信客户端缓存,需要24小时微信客户端才会展现出来。建议测试时可以尝试取消关注公众账号后再次关注,则可以看到创建后的效果。
目前自定义菜单接口可实现两种类型按钮,如下:
click:
用户点击click类型按钮后,微信服务器会通过消息接口推送消息类型为event的结构给开发者(参考消息接口指南),并且带上按钮中开发者填写的key值,开发者可以通过自定义的key值与用户进行交互;
view:
用户点击view类型按钮后,微信客户端将会打开开发者在按钮中填写的url值(即网页链接),达到打开网页的目的,建议与网页授权获取用户基本信息接口结合,获得用户的登入个人信息。
接口调用请求说明
http请求方式:POST(请使用https协议)
请求示例(JSON数据请使用UTF-8编码)
{ button:[ {type:click,name:我的信息,sub_button:[ {type:click,name:拇指查询,key:BUTTON_1}, {type:click,name:拇指请假,key:BUTTON_2}, {type:view,name:工号绑定,url:业务流程,key:BUTTON_3}, {name:员工建议,sub_button:[ {type:view,name:思想火花,url:奖品兑换,url:赞一下我们,key:BUTTON_ZAN}] } ] }
参数说明
返回结果
正确时的返回JSON数据包如下:
{errcode:0,errmsg:ok}
错误时的返回JSON数据包如下(示例为无效菜单名长度):
{errcode:40018,errmsg:invalid button name size}
以下是示例代码(PHP)。
<!DOCTYPE html PUBLIC -//W3C//DTD XHTML 1.0 Transitional//EN 创建菜单 $url =
menu.json
{ button:[ {type:click,name:我的信息,sub_button:[ {type:click,name:拇指查询,key:BUTTON_1}, {type:click,name:拇指请假,key:BUTTON_2}, {type:view,name:工号绑定,url:业务流程,key:BUTTON_3}, {name:员工建议,sub_button:[ {type:view,name:思想火花,url:奖品兑换,url:赞一下我们,key:BUTTON_ZAN}] } ] }
响应自定义菜单事件
$wechatObj = new wechatCallbackAPI(); if (isset($_GET[echostr])) { $wechatObj->valid(); } else { $wechatObj->responseMsg(); } class wechatCallbackAPI { private $token = WEIXIN; private $appId = APPID; private $appSecret = APPSECRET; private function checkSignature() { $signature = $_GET[signature]; $timestamp = $_GET[timestamp]; $nonce = $_GET[nonce]; $tmpArr = array($this->token, $timestamp, $nonce); sort($tmpArr); $tmpStr = implode($tmpArr); $tmpStr = sha1($tmpStr); if($tmpStr == $signature) { return true; } else { return false; } } private function getAccessToken() { $url = 文本消息模板 $textTpl = <xml> <ToUserName><![CDATA[%s]]></ToUserName> <FromUserName><![CDATA[%s]]></FromUserName> <CreateTime>%s</CreateTime> <MsgType><![CDATA[%s]]></MsgType> <Content><![CDATA[%s]]></Content> <FuncFlag>0</FuncFlag> </xml>; switch (strtolower(trim($postObj->MsgType))) { case text: //文本消息 $keyword = trim($postObj->Content); if(!empty($keyword)) { $msgType = text; $contentStr = $fromUsername, 您发送了文本信息: $keyword ; if (strtolower($keyword) == time) { $contentStr = date(Y-m-d H:i:s, $time); } $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr); } else { $resultStr = Input something...; } break; case image: //图片消息 $msgType = text; $contentStr = $fromUsername, 您发送了图片信息; $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr); break; case voice: //声音消息 $msgType = text; $contentStr = $fromUsername, 您发送了声音信息; $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr); break; case video: //视频消息 $msgType = text; $contentStr = $fromUsername, 您发送了视频信息; $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr); break; case location: //位置消息 $msgType = text; $contentStr = $fromUsername, 您发送了位置信息; $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr); break; case link: //链接消息 $msgType = text; $contentStr = $fromUsername, 您发送了链接信息; $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr); break; case event: //事件 switch (strtolower(trim($postObj->Event))) { case subscribe: //关注事件 $msgType = text; $contentStr = 欢迎您关注XXXXXXX; $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr); break; case unsubscribe: //取消关注事件 break; case scan: //用户已关注时扫描二维码事件 $msgType = text; $contentStr = $fromUsername, 您扫描了二维码; $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr); break; case location: //上传地理位置事件 $msgType = text; $contentStr = $fromUsername, 您上传地理位置; $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr); break; case click: //自定义菜单事件 $msgType = text; $contentStr = $fromUsername, 您点击了自定义菜单 $postObj->EventKey ; if (BUTTON_ZAN == $postObj->EventKey) { $contentStr = 感谢您的赞,我们会继续提供更优质的服务。; } $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr); ; break; default: $resultStr = ; } break; default: $resultStr = ; } echo $resultStr; } } ?>
自定义菜单查询
使用接口创建自定义菜单后,开发者还可使用接口查询自定义菜单的结构。
请求说明
http请求方式:GET
返回说明
对应创建接口,正确的Json返回结果: 复制代码 代码如下:{menu:{button:[{name:我的信息,sub_button:[{type:click,name:拇指查询,key:BUTTON_1,sub_button:[]},{type:click,name:拇指请假,key:BUTTON_2,sub_button:[]},{type:view,name:工号绑定,url:http:\/\/XXXXXXXX,sub_button:[]}]},{type:click,name:业务流程,key:BUTTON_3,sub_button:[]},{name:员工建议,sub_button:[{type:view,name:思想火花,url:http:\/\/XXXXXXXX,sub_button:[]},{type:view,name:奖品兑换,url:http:\/\/XXXXXXXX,sub_button:[]},{type:click,name:赞一下我们,key:BUTTON_ZAN,sub_button:[]}]}]}}
自定义菜单删除
使用接口创建自定义菜单后,开发者还可使用接口删除当前使用的自定义菜单。
请求说明
http请求方式:GET
返回说明
对应创建接口,正确的Json返回结果:
{errcode:0,errmsg:ok}
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持脚本之家。