diff --git a/卡券.md b/卡券.md index 8b534cb..3be4c5e 100644 --- a/卡券.md +++ b/卡券.md @@ -31,6 +31,11 @@ $card = new Card($appId, $secret); + `boolean disable($code, $cardId = null)` 废弃卡券，失效，将用户的卡券设置为失效状态； + `string getRealCode($encryptedCode)` code 解码； +### 相关文档 + ++ [门店管理](门店管理) 创建卡券的时候需要门店 ++ [颜色列表](颜色列表) 创建卡券的时候需要用到颜色列表 + 特殊卡券： + `boolean memberCardActivate($cardId, array $data)` 激活/绑定会员卡： diff --git a/模板消息.md b/模板消息.md new file mode 100644 index 0000000..9899bf8 --- /dev/null +++ b/模板消息.md @@ -0,0 +1,125 @@ +模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷卡通知，商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。 + +关于使用规则，请注意： + + 1. 所有服务号都可以在功能->添加功能插件处看到申请模板消息功能的入口，但只有认证后的服务号才可以申请模板消息的使用权限并获得该权限； + 2. 需要选择公众账号服务所处的2个行业，每月可更改1次所选行业； + 3. 在所选择行业的模板库中选用已有的模板进行调用； + 4. 每个账号可以同时使用15个模板。 + 5. 当前每个模板的日调用上限为 10 万次【2014年11月18日将接口调用频率从默认的日1万次提升为日10万次，可在MP登录后的开发者中心查看】。 + +关于接口文档，请注意： + + 1. 模板消息调用时主要需要模板 ID 和模板中各参数的赋值内容； + 2. 模板中参数内容必须以 ".DATA" 结尾，否则视为保留字； + 3. 模板保留符号 "{{ }}"。 + +本 SDK 中由 `Overtrue\Wechat\Notice` 类完成模板消息的功能。 + +## 获取实例 + +```php +send($to, $templateId, array $data, $url, $color); +``` + + +链式调用方法: + + 设置模板ID：template / templateId / uses + 设置接收者openId: to / receiver + 设置模板头部颜色：color / topColor + 设置详情链接：url / link / linkTo + 设置模板数据：data / with + + 以上方法都支持 `withXXX` 与 `andXXX` 形式链式调用 + +```php +$messageId = $notice->uses($templateId)->andUrl($url)->withColor($color)->data($data)->send(); +// 或者 +$messageId = $notice->to($userOpenId)->url($url)->template($templateId)->andData($data)->send(); +// 或者 +$messageId = $notice->withTo($userOpenId)->withUrl($url)->withTemplate($templateId)->withData($data)->send(); +// 或者 +$messageId = $notice->to($userOpenId)->color('#ff0000')->url($url)->withTemplateId($templateId)->send(); +// ... ... +``` + +example: + +```php +$userId = 'OPENID'; +$templateId = 'ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY'; +$url = 'http://overtrue.me'; +$color = '#FF0000'; +$data = array( + "first" => "恭喜你购买成功！", + "keynote1" => "巧克力", + "keynote2" => "39.8元", + "keynote3" => "2014年9月16日", + "remark" => "欢迎再次购买！", + ); + +$messageId = $notice->uses($templateId)->withUrl($url)->andData($data)->andReceiver($userId)->send(); +``` + +### 模板数据 + +为了方便大家开发，我们拓展支持以下格式的模板数据，其它格式的数据可能会导致接口调用失败： + +- 所有数据项颜色一样的（这是方便的一种方式）: + + ```php + $data = array( + "first" => "恭喜你购买成功！", + "keynote1" => "巧克力", + "keynote2" => "39.8元", + "keynote3" => "2014年9月16日", + "remark" => "欢迎再次购买！", + ); + ``` + 默认颜色为'#173177', 你可以通过 `defaultColor($color)` 来修改 + +- 独立设置每个模板项颜色的： + + + 简便型： + + ```php + $data = array( + "first" => array("恭喜你购买成功！", '#555555'), + "keynote1" => array("巧克力", "#336699"), + "keynote2" => array("39.8元", "FF0000"), + "keynote3" => array("2014年9月16日", "#888888"), + "remark" => array("欢迎再次购买！", "#5599FF"), + ); + ``` + + 复杂型（也是微信官方唯一支持的方式，估计没有人想这么用）： + + ```php + $data = array( + "first" => array("value" => "恭喜你购买成功！", "color" => '#555555'), + "keynote1" => array("value" => "巧克力", "color" => "#336699"), + "keynote2" => array("value" => "39.8元","color" => "FF0000"), + "keynote3" => array("value" => "2014年9月16日", "color" => "#888888"), + "remark" => array("value" => "欢迎再次购买！", "color" => "#5599FF"), + ); + ``` +关于模板消息的使用请参考：http://mp.weixin.qq.com/wiki/17/304c1885ea66dbedf7dc170d84999a9d.html \ No newline at end of file diff --git a/网页授权.md b/网页授权.md index 0d4b234..cb49cad 100644 --- a/网页授权.md +++ b/网页授权.md @@ -1,5 +1,3 @@ -网页授权在本 SDK 中由 `Overtrue\Wechat\Auth` 提供服务。 - ```php authorized() || Session::get('logged_open_id')) { } ``` -### 在 Laravel 里使用 - -在 Laravel 里的跳转请使用 `url` 而不要使用 `redirect`, 因为 控制器方法必须返回字符串或者实现了 `__toString()` 的对象： - -```php -return Redirect::to($wechat->auth->url($to, 'snsapi_base', 'STATE')); -======= - $auth->redirect($to); -} -``` - ### 在 [Laravel](http://laravel.com) 里使用 在 Laravel 里的跳转请使用 `url` 而不要使用 `redirect`, 因为在 Laravel 控制器方法必须返回字符串或者实现了 `__toString()` 的对象： diff --git a/门店管理.md b/门店管理.md index 0784542..a932daa 100644 --- a/门店管理.md +++ b/门店管理.md @@ -1,7 +1,15 @@ -## 获取门店服务实例 + +## 获取实例 ```php -$store = $wechat->store; + "https://XXX.com"), ), "recommend" => "麦辣鸡腿堡套餐,麦乐鸡,全家桶", - "special" => "免费 wifi,外卖服务", + "special" => "免费 wifi,外卖服务", "introduction" => "麦当劳是全球大型跨国连锁餐厅,1940 年创立于美国,在世界上大约拥有 3 万间分店。主要售卖汉堡包,以及薯条、炸鸡、汽水、冰品、沙拉、水果等 快餐食品", "open_time" => "8:00-20:00", "avg_price" => 35, @@ -60,14 +68,14 @@ example: ```php $info = $store->get(271262077); var_dump($info->business_name); // 麦当劳 -var_dump($info->introduction); // 麦当劳是全球大型跨国连锁餐厅... +var_dump($info->introduction); // 麦当劳是全球大型跨国连锁餐厅... var_dump($info->toArray());// array('business_name' => '麦当劳', 'branch_name' => '艺苑路店', ...); ``` ## 获取门店列表 ```php -$store->all($begin = 0, $limit = 10);// begin:0, limit:10 +$store->lists($begin = 0, $limit = 10);// begin:0, limit:10 ``` - `$begin` 就是查询起点，`MySQL` 里的 `offset`； @@ -76,8 +84,8 @@ $store->all($begin = 0, $limit = 10);// begin:0, limit:10 example: ```php -$stores = $store->all(0, 2);// 取2条记录 -// +$stores = $store->lists(0, 2);// 取2条记录 +// //[ // { // "sid": "100", @@ -101,7 +109,7 @@ $stores = $store->all(0, 2);// 取2条记录 商户可以通过该接口,修改门店的服务信息,包括:图片列表、营业时间、推荐、特色服务、简 介、人均价格、电话 7 个字段。目前基础字段包括(名称、坐标、地址等不可修改)。 ```php -$store->update($storeId, $data); +$store->update($storeId, $data); ``` - `$storeId` 为门店ID diff --git a/颜色列表.md b/颜色列表.md new file mode 100644 index 0000000..96ab7b6 --- /dev/null +++ b/颜色列表.md @@ -0,0 +1,44 @@ +创建卡券的时候需要用到颜色列表 + +本 SDK 中上传素材通过 `Overtrue\Wechat\Color` 提供素材管理服务。 + +### 获取实例 + +```php +lists()` 获取所有支持的颜色列表（内部有缓存一天） + +example: + +```json + +[ + {"name":"Color010","value":"#55bd47"}, + {"name":"Color020","value":"#10ad61"}, + {"name":"Color030","value":"#35a4de"}, + {"name":"Color040","value":"#3d78da"}, + {"name":"Color050","value":"#9058cb"}, + {"name":"Color060","value":"#de9c33"}, + {"name":"Color070","value":"#ebac16"}, + {"name":"Color080","value":"#f9861f"}, + {"name":"Color081","value":"#f08500"}, + {"name":"Color090","value":"#e75735"}, + {"name":"Color100","value":"#d54036"}, + {"name":"Color101","value":"#cf3e36"} +] +``` + +### 相关文档 + ++ [颜色列表](颜色列表) 创建卡券的时候需要用到颜色列表 \ No newline at end of file