添加文档

Home.md

@@ -16,9 +16,13 @@
   + [多客服的消息转发](多客服的消息转发)
   + [网页授权](网页授权)
   + [自定义菜单](自定义菜单)
+  + [卡券](卡券)
+  + [门店](门店)
   + [JSSDK](JSSDK)
   + [二维码](二维码)
   + [短链接](短链接)
+  + [语文理解服务](语文理解服务)
+  + [数据统计查询服务](数据统计查询服务)
 
 - 其它
   + [错误处理](错误处理)

_Sidebar.md

@@ -13,9 +13,13 @@
   + [多客服的消息转发](多客服的消息转发)
   + [网页授权](网页授权)
   + [自定义菜单](自定义菜单)
+  + [卡券](卡券)
+  + [门店](门店)
   + [JSSDK](JSSDK)
   + [二维码](二维码)
   + [短链接](短链接)
+  + [语文理解服务](语文理解服务)
+  + [数据统计查询服务](数据统计查询服务)
 
 - 其它
   + [错误处理](错误处理)

升级日志.md

@@ -5,6 +5,8 @@
 - 【新增】二维码服务；
 - 【新增】异常消息添加中文错误消息；
 - 【新增】门店服务；
+- 【新增】语义理解服务；
+- 【新增】数据统计查询服务；
 - 【新增】素材添加完整 API 支持，支持永久素材等官方提供的所有功能；
 - 【变更】消息中图片等附件不再自动上传，之前 `media($path)` 不再接受本地文件路径，只接受上传后的 `media_id` 值，上传请先使用素材管理服务进行上传，便于素材管理；
 - 【变更】 `Wechat::service('cache')` 同样不存在了，更改为 new 服务(...), ex: `$userService = new Overtrue\Wechat\User($appId, $secret)`；

数据统计查询服务.md

@@ -0,0 +1,54 @@
+通过数据接口，开发者可以获取与公众平台官网统计模块类似但更灵活的数据，还可根据需要进行高级处理。
+
+本 SDK 由 `Overtrue\Wechat\Stats` 提供微信数据统计查询服务。
+
+> 1. 接口侧的公众号数据的数据库中仅存储了 **2014年12月1日之后**的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据；
+> 2. 请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。
+> 3. 额外注意，获取图文群发每日数据接口的结果中，只有**中间页阅读人数+原文页阅读人数+分享转发人数+分享转发次数+收藏次数 >=3** 的结果才会得到统计，过小的阅读量的图文消息无法统计。
+
+### 获取实例
+
+```php
+<?php
+
+use Overtrue\Wechat\Stats;
+
+$appId  = 'wx3cf0f39249eb0e60';
+$secret = 'f1c242f4f28f735d4687abb469072a29';
+
+$stats = new Stats($appId, $secret);
+```
+
+## API
+
+    $from   example: `2014-02-13` 获取数据的起始日期
+    $to     example: `2014-02-18` 获取数据的结束日期，`$to`允许设置的最大值为昨日
+
+    `$from` 和 `$to` 的差值需小于 “最大时间跨度”（比如最大时间跨度为 1 时，`$from` 和 `$to` 的差值只能为 0，才能小于 1 ），否则会报错
+
++ `array userSummary($from, $to)` 获取用户增减数据, 最大时间跨度：**7**;
++ `array userCumulate($from, $to)` 获取累计用户数据, 最大时间跨度：**7**;
++ `array articleSummary($from, $to)` 获取图文群发每日数据, 最大时间跨度：**1**;
++ `array articleTotal($from, $to)` 获取图文群发总数据, 最大时间跨度：**1**;
++ `array userReadSummary($from, $to)` 获取图文统计数据, 最大时间跨度：**3**;
++ `array userReadHourly($from, $to)` 获取图文统计分时数据, 最大时间跨度：**1**;
++ `array userShareSummary($from, $to)` 获取图文分享转发数据, 最大时间跨度：**7**;
++ `array userShareHourly($from, $to)` 获取图文分享转发分时数据, 最大时间跨度：**1**;
++ `array upstreamMesssageSummary($from, $to)` 获取消息发送概况数据, 最大时间跨度：**7**;
++ `array upstreamMesssageHourly($from, $to)` 获取消息分送分时数据, 最大时间跨度：**1**;
++ `array upstreamMesssageWeekly($from, $to)` 获取消息发送周数据, 最大时间跨度：**30**;
++ `array upstreamMesssageMonthly($from, $to)` 获取消息发送月数据, 最大时间跨度：**30**;
++ `array upstreamMesssageDistSummary($from, $to)` 获取消息发送分布数据, 最大时间跨度：**15**;
++ `array upstreamMesssageDistWeekly($from, $to)` 获取消息发送分布周数据, 最大时间跨度：**30**;
++ `array upstreamMesssageDistMonthly($from, $to)` 获取消息发送分布月数据, 最大时间跨度：**30**;
++ `array interfaceSummary($from, $to)` 获取接口分析数据, 最大时间跨度：**30**;
++ `array interfaceSummaryHourly($from, $to)` 获取接口分析分时数据, 最大时间跨度：**1**;
+
+example:
+
+```php
+$stats->userSummary('2014-12-07', '2014-12-08');
+
+```
+
+更多详细内容与协议说明，请查看微信官方文档：http://mp.weixin.qq.com/wiki/ **数据统计** 章节

语义理解服务.md

@@ -0,0 +1,79 @@
+微信开放平台语义理解接口调用（http请求）简单方便，用户无需掌握语义理解及相关技术，只需根据自己的产品特点，选择相应的服务即可搭建一套智能语义服务。
+
+本 SDK 由 `Overtrue\Wechat\Semantic` 提供微信语义理解服务。
+
+### 获取实例
+
+```php
+<?php
+
+use Overtrue\Wechat\Semantic;
+
+$appId  = 'wx3cf0f39249eb0e60';
+$secret = 'f1c242f4f28f735d4687abb469072a29';
+
+$semantic = new Semantic($appId, $secret);
+```
+
+
+## API
+
++ `Bag query($keyword, array | string $categories, $other = array())` 语义理解:
+
+  + `$keyword` 为关键字
+  + `$categories` 需要使用的服务类型，数组或者多个用 “，” 隔开字符吕，不能为空;
+  + `$other` 为其它属性：
+    + `latitude`  `float`  纬度坐标，与经度同时传入；与城市二选一传入
+    + `longitude`  `float`  经度坐标，与纬度同时传入；与城市二选一传入
+    + `city`   `string`  城市名称，与经纬度二选一传入
+    + `region` `string`  区域名称，在城市存在的情况下可省；与经纬度二选一传入
+    + `uid`  `string` 用户唯一id（非开发者id），用户区分公众号下的不同用户（建议填入用户openid），如果为空，则无法使用上下文理解功能。appid和uid同时存在的情况下，才可以使用上下文理解功能。
+
+> 注：单类别意图比较明确，识别的覆盖率比较大，所以如果只要使用特定某个类别，建议将category只设置为该类别。
+
+example:
+
+```php
+$result = $semantic->query('查一下明天从北京到上海的南航机票', "flight,hotel", array('city' => '北京', 'uid' => '123456'));
+// 查询参数：
+// {
+//    "query":"查一下明天从北京到上海的南航机票",
+//    "city":"北京",
+//    "category": "flight,hotel",
+//    "appid":"wxaaaaaaaaaaaaaaaa",
+//    "uid":"123456"
+// }
+```
+返回值示例：
+
+```json
+{
+    "errcode":0,
+    "query":"查一下明天从北京到上海的南航机票",
+    "type":"flight",
+    "semantic":{
+        "details":{
+            "start_loc":{
+                "type":"LOC_CITY",
+                "city":"北京市",
+                "city_simple":"北京",
+                "loc_ori":"北京"
+                },
+            "end_loc": {
+                "type":"LOC_CITY",
+                "city":"上海市",
+                "city_simple":"上海",
+                "loc_ori":"上海"
+              },
+            "start_date": {
+                "type":"DT_ORI",
+                "date":"2014-03-05",
+                "date_ori":"明天"
+              },
+           "airline":"中国南方航空公司"
+        },
+    "intent":"SEARCH"
+}
+```
+
+更多详细内容与协议说明，请查看微信官方文档：http://mp.weixin.qq.com/wiki/0/0ce78b3c9524811fee34aba3e33f3448.html