この記事では主に PHP WeChat のカスタム メニューの開発について詳しく紹介します。興味のある方は参考にしてください。
現在、WeChat サービス アカウントのカスタム メニューにはそれぞれ最大 3 つのメニューが含まれています。各第 1 レベルのメニューには、最大 5 つの第 2 レベルのメニューが含まれます。第 1 レベルのメニューには最大 4 文字、第 2 レベルのメニューには最大 7 文字の中国語を含めることができます。余分な部分は「...」に置き換えられます。カスタム メニューを作成した後、WeChat クライアントのキャッシュのため、WeChat クライアントがそれを表示するまでに 24 時間かかることに注意してください。テストする場合は、公開アカウントのフォローを解除してから再度フォローしてみて、作成後の効果を確認することをお勧めします。
現在、カスタム メニュー インターフェイスは次の 2 種類のボタンを実装できます:
クリック: ユーザーがクリック タイプのボタンをクリックした後、WeChat サーバーはメッセージ タイプのイベント構造をメッセージを通じて開発者にプッシュします。インターフェイス (メッセージ インターフェイス ガイドを参照) を作成し、開発者が入力したキー値をボタンに表示します。
ビュー:
ユーザーがクリックした後、ビュー タイプ ボタンを使用すると、WeChat クライアントが開きます。開発者がボタンに入力した URL 値 (つまり、Web リンク) は、Web ページを開くために使用されます。これを Web ページ認証インターフェイスと組み合わせて、ユーザーの基本認証を取得することをお勧めします。ユーザーのログイン個人情報を取得するための情報。
インターフェース呼び出しリクエストの説明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":"My information","sub_button":[{"type":"click", "name" :"親指クエリ","key":"BUTTON_1","sub_button":[]},{"type":"クリック","name":"親指休暇","key":"BUTTON_2" ,"sub_button ":[]},{"type":"view","name":"Work ID Binding","url":"http://XXXXXXXX","sub_button":[]}]}, {" type":"click","name":"ビジネス プロセス","key":"BUTTON_3","sub_button":[]},{"name":"従業員の提案","sub_button":[{ "type ":"view","name":"Spark of Thought","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"}
概要: 上記がこの記事の全内容です。皆さんの学習に役立つことを願っています。
関連する推奨事項:
PHPでのcall_user_func_arrayコールバック関数の使用法
curl関数を使用してPostリクエストを送信するPHPに関する注意事項
以上がphp WeChatでカスタムメニューを開発する方法を共有の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。
![[Web フロントエンド] Node.js クイック スタート](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
