Develop

phpunit.xml.dist

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <phpunit backupGlobals="false"
          backupStaticAttributes="false"
-         bootstrap="vendor/autoload.php"
+         bootstrap="tests/bootstrap.php"
          colors="true"
          convertErrorsToExceptions="true"
          convertNoticesToExceptions="true"

src/Foundation/ServiceProviders/UserServiceProvider.php

@@ -26,6 +26,7 @@
 namespace EasyWeChat\Foundation\ServiceProviders;
 
 use EasyWeChat\User\Group;
+use EasyWeChat\User\Tag;
 use EasyWeChat\User\User;
 use Pimple\Container;
 use Pimple\ServiceProviderInterface;
@@ -53,7 +54,14 @@ public function register(Container $pimple)
            return new Group($pimple['access_token']);
         };
 
+        $tag = function ($pimple) {
+           return new Tag($pimple['access_token']);
+        };
+
         $pimple['user_group'] = $group;
         $pimple['user.group'] = $group;
+
+        $pimple['user_tag'] = $tag;
+        $pimple['user.tag'] = $tag;
     }
 }

src/User/Tag.php

@@ -0,0 +1,164 @@
+<?php
+
+/*
+ * This file is part of the overtrue/wechat.
+ *
+ * (c) overtrue <[email protected]>
+ *
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+/**
+ * Group.php.
+ *
+ * @author    overtrue <[email protected]>
+ * @copyright 2015 overtrue <[email protected]>
+ *
+ * @link      https://github.com/overtrue
+ * @link      http://overtrue.me
+ */
+namespace EasyWeChat\User;
+
+use EasyWeChat\Core\AbstractAPI;
+
+/**
+ * Class Tag.
+ */
+class Tag extends AbstractAPI
+{
+    const API_GET = 'https://api.weixin.qq.com/cgi-bin/tags/get';
+    const API_CREATE = 'https://api.weixin.qq.com/cgi-bin/tags/create';
+    const API_UPDATE = 'https://api.weixin.qq.com/cgi-bin/tags/update';
+    const API_DELETE = 'https://api.weixin.qq.com/cgi-bin/tags/delete';
+    const API_USER_TAGS = 'https://api.weixin.qq.com/cgi-bin/tags/getidlist';
+    const API_MEMBER_BATCH_TAG = 'https://api.weixin.qq.com/cgi-bin/tags/members/batchtagging';
+    const API_MEMBER_BATCH_UNTAG = 'https://api.weixin.qq.com/cgi-bin/tags/members/batchuntagging';
+    const API_USERS_OF_TAG = 'https://api.weixin.qq.com/cgi-bin/user/tag/get';
+
+    /**
+     * Create tag.
+     *
+     * @param string $name
+     *
+     * @return int
+     */
+    public function create($name)
+    {
+        $params = [
+                   'tag' => ['name' => $name],
+                  ];
+
+        return $this->parseJSON('json', [self::API_CREATE, $params]);
+    }
+
+    /**
+     * List all tags.
+     *
+     * @return array
+     */
+    public function lists()
+    {
+        return $this->parseJSON('get', [self::API_GET]);
+    }
+
+    /**
+     * Update a tag name.
+     *
+     * @param int    $tagId
+     * @param string $name
+     *
+     * @return bool
+     */
+    public function update($tagId, $name)
+    {
+        $params = [
+                   'tag' => [
+                               'id' => $tagId,
+                               'name' => $name,
+                              ],
+                  ];
+
+        return $this->parseJSON('json', [self::API_UPDATE, $params]);
+    }
+
+    /**
+     * Delete tag.
+     *
+     * @param int $tagId
+     *
+     * @return bool
+     */
+    public function delete($tagId)
+    {
+        $params = [
+                   'tag' => ['id' => $tagId],
+                  ];
+
+        return $this->parseJSON('json', [self::API_DELETE, $params]);
+    }
+
+    /**
+     * Get user tags.
+     *
+     * @param string $openId
+     *
+     * @return int
+     */
+    public function userTags($openId)
+    {
+        $params = ['openid' => $openId];
+
+        return $this->parseJSON('json', [self::API_USER_TAGS, $params]);
+    }
+
+    /**
+     * Get users from a tag.
+     *
+     * @param string $openId
+     *
+     * @return int
+     */
+    public function usersOfTag($tagId)
+    {
+        $params = ['tagid' => $tagId];
+
+        return $this->parseJSON('json', [self::API_USERS_OF_TAG, $params]);
+    }
+
+    /**
+     * Batch tag users.
+     *
+     * @param array $openIds
+     * @param int   $tagid
+     *
+     * @return bool
+     */
+    public function batchTagUsers(array $openIds, $tagId)
+    {
+        $params = [
+                   'openid_list' => $openIds,
+                   'tagid' => $tagId,
+                  ];
+
+        return $this->parseJSON('json', [self::API_MEMBER_BATCH_TAG, $params]);
+    }
+
+    /**
+     * Untag users from a tag.
+     *
+     * @param array $openIds
+     * @param int   $tagid
+     *
+     * @return bool
+     */
+    public function batchUntagUsers(array $openIds, $tagId)
+    {
+        $params = [
+                   'openid_list' => $openIds,
+                   'tagid' => $tagId,
+                  ];
+
+        return $this->parseJSON('json', [self::API_MEMBER_BATCH_UNTAG, $params]);
+    }
+}

tests/Broadcast/BroadcastBroadcastTest.php

@@ -11,7 +11,7 @@
 
 use EasyWeChat\Broadcast\Broadcast;
 
-class BroadcastBroadcastTest extends PHPUnit_Framework_TestCase
+class BroadcastBroadcastTest extends TestCase
 {
     public function getBroadcast()
     {

tests/Broadcast/BroadcastMessageBuilderTest.php

@@ -12,7 +12,7 @@
 use EasyWeChat\Broadcast\Broadcast;
 use EasyWeChat\Broadcast\MessageBuilder;
 
-class BroadcastMessageBuilderTest extends PHPUnit_Framework_TestCase
+class BroadcastMessageBuilderTest extends TestCase
 {
     /**
      * Test msgType().

tests/Broadcast/BroadcastTransformerTest.php

@@ -11,7 +11,7 @@
 
 use EasyWeChat\Broadcast\Transformer;
 
-class BroadcastTransformerTest extends PHPUnit_Framework_TestCase
+class BroadcastTransformerTest extends TestCase
 {
     /**
      * Test transform().

tests/Core/CoreAbstractAPITest.php

@@ -22,7 +22,7 @@ public function getHttpInstance()
     }
 }
 
-class CoreAbstractAPITest extends PHPUnit_Framework_TestCase
+class CoreAbstractAPITest extends TestCase
 {
     /**
      * Test __construct.

tests/Core/CoreAccessTokenTest.php

@@ -13,7 +13,7 @@
 use EasyWeChat\Core\AccessToken;
 use EasyWeChat\Core\Http;
 
-class CoreAccessTokenTest extends PHPUnit_Framework_TestCase
+class CoreAccessTokenTest extends TestCase
 {
     public function testGetToken()
     {

tests/Core/CoreHttpTest.php

@@ -14,7 +14,7 @@
     use GuzzleHttp\Client;
     use GuzzleHttp\Psr7\Response;
 
-    class CoreHttpTest extends PHPUnit_Framework_TestCase
+    class CoreHttpTest extends TestCase
     {
         public function testConstruct()
         {

tests/Encryption/EncryptionEncryptorTest.php

@@ -3,7 +3,7 @@
 use EasyWeChat\Encryption\Encryptor;
 use EasyWeChat\Support\XML;
 
-class EncryptionEncryptorTest extends PHPUnit_Framework_TestCase
+class EncryptionEncryptorTest extends TestCase
 {
     public function getEncryptor()
     {

tests/Foundation/ApplicationTest.php

@@ -15,7 +15,7 @@
 use Pimple\ServiceProviderInterface;
 use Symfony\Component\HttpFoundation\Request;
 
-class ApplicationTest extends PHPUnit_Framework_TestCase
+class ApplicationTest extends TestCase
 {
     /**
      * Test __construct().

tests/Js/JsJsTest.php

@@ -13,7 +13,7 @@
     use EasyWeChat\Core\Http;
     use EasyWeChat\Js\Js;
 
-    class JsJsTest extends PHPUnit_Framework_TestCase
+    class JsJsTest extends TestCase
     {
         public function getMockCache()
         {

tests/Material/MaterialMaterialTest.php

@@ -14,7 +14,7 @@
 use EasyWeChat\Message\Article;
 use GuzzleHttp\Psr7\Response;
 
-class MaterialMaterialTest extends PHPUnit_Framework_TestCase
+class MaterialMaterialTest extends TestCase
 {
     /**
      * Return mock http.

tests/Material/MaterialTemporaryTest.php

@@ -15,7 +15,7 @@
     use EasyWeChat\Material\Temporary;
     use Mockery\Mock;
 
-    class MaterialTemporaryTest extends PHPUnit_Framework_TestCase
+    class MaterialTemporaryTest extends TestCase
     {
         /**
          * Return mock http.

tests/Menu/MenuMenuTest.php

@@ -11,7 +11,7 @@
 
 use EasyWeChat\Menu\Menu;
 
-class MenuMenuTest extends PHPUnit_Framework_TestCase
+class MenuMenuTest extends TestCase
 {
     public function getMenu()
     {

tests/Message/MessageAbstractMessageTest.php

@@ -16,7 +16,7 @@ class FooMessage extends AbstractMessage
     protected $properties = ['foo', 'bar'];
 }
 
-class MessageAbstractMessageTest extends PHPUnit_Framework_TestCase
+class MessageAbstractMessageTest extends TestCase
 {
     /**
      * Test __get().

tests/Message/MessageArticleTest.php

@@ -11,7 +11,7 @@
 
 use EasyWeChat\Message\Article;
 
-class MessageArticleTest extends PHPUnit_Framework_TestCase
+class MessageArticleTest extends TestCase
 {
     /**
      * Test get attributes.

tests/Message/MessageImageTest.php

@@ -11,7 +11,7 @@
 
 use EasyWeChat\Message\Image;
 
-class MessageImageTest extends PHPUnit_Framework_TestCase
+class MessageImageTest extends TestCase
 {
     /**
      * Test media().

tests/Message/MessageMaterialTest.php

@@ -11,7 +11,7 @@
 
 use EasyWeChat\Message\Material;
 
-class MessageMaterialTest extends PHPUnit_Framework_TestCase
+class MessageMaterialTest extends TestCase
 {
     /**
      * Test get attributes.

tests/Message/MessageVideoTest.php

@@ -11,7 +11,7 @@
 
 use EasyWeChat\Message\Video;
 
-class MessageVideoTest extends PHPUnit_Framework_TestCase
+class MessageVideoTest extends TestCase
 {
     /**
      * Test media().

tests/Message/MessageVoiceTest.php

@@ -11,7 +11,7 @@
 
 use EasyWeChat\Message\Voice;
 
-class MessageVoiceTest extends PHPUnit_Framework_TestCase
+class MessageVoiceTest extends TestCase
 {
     /**
      * Test media().

tests/Notice/NoticeNoticeTest.php

@@ -12,7 +12,7 @@
 use EasyWeChat\Core\Exceptions\InvalidArgumentException;
 use EasyWeChat\Notice\Notice;
 
-class NoticeNoticeTest extends PHPUnit_Framework_TestCase
+class NoticeNoticeTest extends TestCase
 {
     public function getNotice($mockHttp = false)
     {

tests/POI/POIPOITest.php

@@ -11,7 +11,7 @@
 
 use EasyWeChat\POI\POI;
 
-class POIPOITest extends PHPUnit_Framework_TestCase
+class POIPOITest extends TestCase
 {
     public function getPOI()
     {

tests/Payment/PaymentAPITest.php

@@ -16,7 +16,7 @@
 use EasyWeChat\Support\XML;
 use Psr\Http\Message\ResponseInterface;
 
-class PaymentAPITest extends PHPUnit_Framework_TestCase
+class PaymentAPITest extends TestCase
 {
     /**
      * Build API instance.

tests/Payment/PaymentLuckyMoneyAPITest.php

@@ -14,7 +14,7 @@
 use EasyWeChat\Payment\Merchant;
 use EasyWeChat\Support\XML;
 
-class PaymentLuckyMoneyAPITest extends PHPUnit_Framework_TestCase
+class PaymentLuckyMoneyAPITest extends TestCase
 {
     public static function setUpBeforeClass()
     {