这里有新鲜出炉的精品教程,程序狗速度看过来!
微信(英文名:wechat)是腾讯公司于2011年1月21日推出的一个为智能终端提供即时通讯服务的免费应用程序,微信支持跨通信运营商、跨操作系统平台通过网络快速发送免费语音短信、视频、图片和文字,同时,也可以使用通过共享流媒体内容的资料和基于位置的社交插件“摇一摇”、“漂流瓶”、“朋友圈”、”公众平台“、”语音记事本“等服务插件。
这篇文章主要为大家详细介绍了php微信开发自定义菜单,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
目前微信服务号自定义菜单最多包括3个一级菜单,每个一级菜单最多包含5个二级菜单。一级菜单最多4个汉字,二级菜单最多7个汉字,多出来的部分将会以“...”代替。请注意,创建自定义菜单后,由于微信客户端缓存,需要24小时微信客户端才会展现出来。建议测试时可以尝试取消关注公众账号后再次关注,则可以看到创建后的效果。
目前自定义菜单接口可实现两种类型按钮,如下:
click:
用户点击click类型按钮后,微信服务器会通过消息接口推送消息类型为event 的结构给开发者(参考消息接口指南),并且带上按钮中开发者填写的key值,开发者可以通过自定义的key值与用户进行交互;
view:
用户点击view类型按钮后,微信客户端将会打开开发者在按钮中填写的url值 (即网页链接),达到打开网页的目的,建议与网页授权获取用户基本信息接口结合,获得用户的登入个人信息。
接口调用请求说明
http请求方式:POST(请使用https协议) https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN
请求示例(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":"http://XXXXXXXXXXXXXXXXX"}]
- },
- {"type":"click","name":"业务流程","key":"BUTTON_3"},
- {"name":"员工建议","sub_button":[
- {"type":"view","name":"思想火花","url":"http://XXXXXXXXXXXXXXXXXX"},
- {"type":"view","name":"奖品兑换","url":"http://XXXXXXXXXXXXXXXXXX"},
- {"type":"click","name":"赞一下我们","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" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
- <html xmlns="http://www.w3.org/1999/xhtml" lang="zh-CN">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
- <meta name="author" content="Chris Mao" />
- </head>
- <body>
- <?php
- $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET";
- $ch = curl_init($url);
- curl_setopt($ch, CURLOPT_HEADER, 0);
- curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
- curl_setopt($ch, CURLOPT_POST, 0);
- curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
- curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
- $output = curl_exec($ch);
- curl_close($ch);
- if (empty($output)) { var_dump($output); exit; }
- $result = json_decode($output);
- $token = $result->access_token;
- //创建菜单
- $url = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=$token";
- $jsonData = file_get_contents("menu.json");
- $ch = curl_init($url);
- curl_setopt($ch, CURLOPT_HEADER, 0);
- curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
- curl_setopt($ch, CURLOPT_POST, 1);
- curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData);
- curl_setopt($ch, CURLOPT_USERAGENT, $_SERVER['HTTP_USER_AGENT']);
- curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
- curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
- $output = curl_exec($ch);
- curl_close($ch);
- var_dump($output);
- ?>
- </body>
- </html>
menu.json
- {
- "button":[
- {"type":"click","name":"我的信息","sub_button":[
- {"type":"click","name":"拇指查询","key":"BUTTON_1"},
- {"type":"click","name":"拇指请假","key":"BUTTON_2"},
- {"type":"view","name":"工号绑定","url":"http://XXXXXXXXXXXXXXXXX"}]
- },
- {"type":"click","name":"业务流程","key":"BUTTON_3"},
- {"name":"员工建议","sub_button":[
- {"type":"view","name":"思想火花","url":"http://XXXXXXXXXXXXXXXXXX"},
- {"type":"view","name":"奖品兑换","url":"http://XXXXXXXXXXXXXXXXXX"},
- {"type":"click","name":"赞一下我们","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 = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$this->appId&secret=$this->appSecret";
- $ch = curl_init($url);
- $curl_setopt($ch, CURLOPT_HEADER, 0);
- $curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
- $curl_setopt($ch, CURLOPT_POST, 0);
- $curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
- $curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
- $output = curl_exec($ch);
- curl_close($ch);
- if (empty($output)) {
- return "";
- }
- $result = json_decode($result);
- return $result - >access_token;
- }
- public
- function valid() {
- $echoStr = $_GET["echostr"];
- //valid signature, option
- if ($this - >checkSignature()) {
- echo $echoStr;
- exit;
- }
- }
- public
- function responseMsg() {
- //get post data, May be due to the different environments
- $postStr = $GLOBALS["HTTP_RAW_POST_DATA"];
- if (empty($postStr)) {
- echo "";
- exit;
- }
- //extract post data
- $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
- $fromUsername = $postObj - >FromUserName;
- $toUsername = $postObj - >ToUserName;
- $time = time();
- //文本消息模板
- $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
https://api.weixin.qq.com/cgi-bin/menu/get?access_token=ACCESS_TOKEN
返回说明
对应创建接口,正确的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
https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN
返回说明
对应创建接口,正确的Json返回结果:
{"errcode":0,"errmsg":"ok"}
来源: http://www.phperz.com/article/17/0829/342919.html