menuCreate() - 自定义/个性化菜单创建
### 说明
```
menuCreate($menu)
```
### 参数
- **$menu** array() 菜单数据（结构如下）
click和view的请求结构示例：
```
array(
'button' => array( //一级菜单数组，个数应为1~3个
array(
'type' => 'click', //菜单的响应动作类型，view表示网页类型，click表示点击类型，miniprogram表示小程序类型
'name' => '今日歌曲', //菜单标题，不超过16个字节，子菜单不超过60个字节
'key' => 'V1001_TODAY_MUSIC' //click等点击类型必须，菜单KEY值，用于消息接口推送，不超过128字节
),
array(
'name' => '菜单',
'sub_button' => array( //二级菜单数组，个数应为1~5个
array(
'type' => 'view',
'name' => '搜索',
'url' => 'https://www.we7.cc'
),
array(
'type' => 'miniprogram',
'name' => 'wxa',
'url' => 'https://pro.we7.cc', //view、miniprogram类型必须，网页 链接，用户点击菜单可打开链接，不超过1024字节。 type为miniprogram时，不支持小程序的老版本客户端将打开本url
'appid' => 'wx286b93c16bbf93ab', //小程序的appid（仅认证公众号可配置）
'pagepath' => 'pages/we7team/index' //小程序的页面路径
),
array(
'type' => 'click',
'name' => '赞一下我们',
'key' => 'V1001_GOOD'
)
)
)，
array(
'name' => 'view_limited',
'type' => '图文消息',
'media_id' => 'MEDIA_ID2' //media_id类型和view_limited类型必须，调用新增永久素材接口返回的合法media_id
)
)
)
```
其他新增按钮类型的请求结构示例：
```
array(
'button' => array(
array(
'name' => '扫码',
'sub_button' => array(
array(
'type' => 'scancode_waitmsg',
'name' => '扫码带提示',
'key' => 'rselfmenu_0_0',
'sub_button' => array()
),
array(
'type' => 'scancode_push',
'name' => '扫码推事件',
'key' => 'rselfmenu_0_1',
'sub_button' => array()
)
)
),
array(
'name' => '发图',
'sub_button' => array(
array(
'type' => 'pic_sysphoto',
'name' => '系统拍照发图',
'key' => 'rselfmenu_1_0',
'sub_button' =>array()
),
array(
'type' => 'pic_photo_or_album',
'name' => '拍照或者相册发图',
'key' => 'rselfmenu_1_1',
'appid' => 'wx286b93c16bbf93ab',
'pagepath' => 'pages/we7team/index'
),
array(
'type' => 'pic_weixin',
'name' => '微信相册发图',
'key' => 'rselfmenu_1_2',
'sub_button' =>array()
)
)
),
array(
'name' => '发送位置',
'type' => 'location_select',
'key' => 'rselfmenu_2_0'
),
array(
'name' => '图片',
'type' => 'media_id',
'media_id' => 'MEDIA_ID1'
),
array(
'name' => '图文消息',
'type' => 'view_limited',
'media_id' => 'MEDIA_ID2'
)
)
)
```
### 返回值
#### error
可用is_error判断，详见《错误处理》
#### success
自定义菜单：NULL
个性化菜单：menu_id值（如：405321107）
### 示例
```
$account_api = WeAccount::create();
$result = $account_api->menuCreate($menu);
print_r($result);
```
menuDelete() - 自定义/个性化菜单删除接口
### 说明
```
menuDelete($menuid = 0)
```
### 参数
- **$menuid** int 菜单ID（若是个性化菜单）
### 返回值
#### error
可用is_error判断，详见《错误处理》
#### success
返回boolran值：true
### 示例
```
$account_api = WeAccount::create();
$result = $account_api->menuDelete($menu_id);
print_r($reault);
```
menuCurrentQuery() - 获取自定义菜单配置
### 说明
```
menuCurrentQuery()
```
### 参数
无
### 返回值
#### error
可用is_error判断，详见《错误处理》
#### success
```
array
(
'is_menu_open' => 1, //菜单是否开启，0代表未开启，1代表开启
'selfmenu_info' => array( //菜单信息
'button' => array( //菜单按钮
array(
'type' => 'click', //菜单的类型
'name' => '今日歌曲', //菜单名称
'key' => 'V1001_TODAY_MUSIC', //对于不同的菜单类型，value的值意义不同。官网上设置的自定义菜单： Text:保存文字到value； Img、voice：保存mediaID到value； Video：保存视频下载链接到value； News：保存图文消息到news_info，同时保存mediaID到value； View：保存链接到url。 使用API设置的自定义菜单： click、scancode_push、scancode_waitmsg、pic_sysphoto、pic_photo_or_album、 pic_weixin、location_select：保存值到key；view：保存链接到url
'sub_button' => array()
),
array(
'name' => '菜单',
'sub_button' => array(
array(
'type' => 'view', //菜单的类型
'name' => '搜索', //菜单名称
'url' => 'https://www.we7.cc',
'sub_button' => array()
),
array(
'type' => 'miniprogram', //菜单的类型
'name' => 'wxa', //菜单名称
'url' => 'https://pro.we7.cc',
'appid' => 'wx286b93c16bbf93ab',
'pagepath' => 'pages/we7team/index'
),
array(
'type' => 'click', //菜单的类型
'name' => '赞一下我们', //菜单名称
'key' => 'V1001_GOOD',
'sub_button' => array()
)
)
)
)
)
)
```
### 示例
```
$account_api = WeAccount::create();
$default_menu_info = $account_api->menuCurrentQuery();
print_r($default_menu_info);
```
menuQuery() - 自定义菜单查询
### 说明
```
menuQuery()
```
### 参数
无
### 返回值
#### error
可用is_error判断，详见《错误处理》
#### success
无个性化菜单时：
```
array(
'button' => array(
array(
'type' => 'click',
'name' => '今日歌曲',
'key' => 'V1001_TODAY_MUSIC',
'sub_button' => array()
),
array(
'name' => '菜单',
'sub_button' => array(
array(
'type' => 'view',
'name' => '搜索',
'url' => 'https://www.we7.cc',
'sub_button' => array()
),
array(
'type' => 'miniprogram',
'name' => 'wxa',
'url' => 'https://pro.we7.cc',
'appid' => 'wx286b93c16bbf93ab',
'pagepath' => 'pages/we7team/index'
),
array(
'type' => 'click',
'name' => '赞一下我们',
'key' => 'V1001_GOOD',
'sub_button' => array()
)
)
)
)
)
```
有个性化菜单时：
```
array(
'menu' => array(
'button' => array(
'type' => 'click',
'name' => '今日歌曲',
'key' => 'V1001_TODAY_MUSIC',
'sub_button' => array()
),
'menuid' => 208396938
),
'conditionalmenu' => array(
'button' => array(
array(
'type' => 'click',
'name' => '今日读书',
'key' => 'V1001_TODAY_READING',
'sub_button' => array()
),
array(
'name' => '菜单',
'sub_button' => array(
array(
'type' => 'view',
'name' => '搜索',
'url' => 'http://www.soso.com/',
'sub_button' => array()
),
array(
'type' => 'view',
'name' => '视频',
'url' => 'http://v.qq.com/',
'sub_button' => array()
),
array(
'type' => 'click',
'name' => '赞一下我们',
'key' => 'V1001_GOOD',
'sub_button' => array()
)
)
)
),
'matchrule' => array(
'group_id' => 2,
'sex' => 1,
'country' => '中国',
'province' => '广东',
'city' => '广州',
'client_platform_type' => 2
)
),
'menuid' => 208396993
)
注：menu为默认菜单，conditionalmenu为个性化菜单列表
```
### 示例
```
$account_api = WeAccount::create();
$result = $account_api->menuQuery();
print_r($result);
```
