详解nodejs微信公众号开发――6.自定义菜单
时间:2021-03-24 10:29:57|栏目:NodeJS|点击: 次
上一篇文章:nodejs微信公众号开发――5.素材管理接口,我们实现了新增临时素材、管理永久素材的接口,这些接口的实现,使我们能够推送多样的消息给用户。本节介绍的内容是关于自定义菜单
1. 自定义菜单的介绍
自定义菜单能够帮助公众号丰富界面,让用户更好更快地理解公众号的功能。关于自定义菜单需要掌握以下几点内容:
- 自定义菜单最多包括3个一级菜单,每个一级菜单最多包含5个二级菜单。
- 一级菜单最多4个汉字,二级菜单最多7个汉字,多出来的部分将会以“...”代替。
- 创建自定义菜单后,由于微信客户端缓存,需要24小时微信客户端才会展现出来。测试时可以尝试取消关注公众账号后再次关注,则可以看到创建后的效果。
更多信息查看官方文档:自定义菜单创建接口
2. 创建自定义菜单
2.1 首先罗列以下操作的请求地址:
var api = { ... menu:{ create:prefix+'/menu/create?', //access_token=ACCESS_TOKEN 创建菜单 get:prefix+'/menu/get?', //access_token=ACCESS_TOKE 获取菜单,GET请求 delete:prefix+'/menu/delete?', //access_token=ACCESS_TOKEN 删除菜单,GET请求 getInfo:prefix+'get_current_selfmenu_info?' //access_token=ACCESS_TOKEN 获取自定义菜单配置接口 } }
2.2 定义createMenu函数
Wechat.prototype.createMenu = function(menu){ var that = this; return new Promise(function(resolve,reject){ that.fetchAccessToken().then(function(data){ var url = api.menu.create + 'access_token=' + data.access_token; request({url:url,method:'POST',body:menu,json:true}).then(function(response){ var _data = response.body; if(_data.errcode === '0'){ resolve(); }else{ throw new Error('create menu failed!'); } }).catch(function(err){ reject(err); }); }); }); }
参数menu由外部业务层传入。为了方便管理,将自定义菜单的内容单独写在一个menu.js文件中:
/* * 配置自定义菜单 */ 'use strict' module.exports = { 'button':[ { 'name':'最新', 'type':'click', 'key':'menu_click' }, { 'name':'类别', 'sub_button':[ { 'name':'科幻', 'type':'view', 'url':'music.163.com' }, { 'name':'悬疑', 'type':'scancode_push', 'key':'qr_scan' }, { 'name':'爱情', 'type':'scancode_waitmsg', 'key':'qr_scan_wait' }, { 'name':'教育', 'type':'pic_photo_or_album', 'key':'pic_photo_album' } ] }, { 'name':'地域', 'sub_button':[ { 'name':'大陆', 'type':'pic_weixin', 'key':'pic_weixin' }, { 'name':'欧美', 'type':'location_select', 'key':'location_select' } ] }] }
里面的类型暂时随意写的。我们在业务层weixin.js里面实现自定义菜单的使用:
wechatApi.deleteMenu().then(function(){ return wechatApi.createMenu(menu); }).then(function(msg){ console.log(msg); });
保险起见先把原有的菜单删了,重新建立自己新的菜单。
2.3 定义deleteMenu函数
Wechat.prototype.deleteMenu = function(){ var that = this; return new Promise(function(resolve,reject){ that.fetchAccessToken().then(function(data){ var url = api.menu.delete + 'access_token=' + data.access_token; request({url:url,json:true}).then(function(response){ var _data = response.body; if(_data.errcode === '0'){ resolve(); }else{ throw new Error('delete menu failed!'); } }).catch(function(err){ reject(err); }); }); }); }
测试了一下,取关重新关注后微信测试号并没有立即呈现自定义菜单,要等一段时间,略坑。