Adds support for Tags

Author: [email protected]

src/Api.php

@@ -2,7 +2,10 @@
 
 namespace BarnebysMautic;
 
+use BarnebysMautic\Exception\ContactCreateException;
+use BarnebysMautic\Tags;
 use BarnebysMautic\Exception\ContactNotFoundException;
+use BarnebysMautic\Exception\SegmentNotFoundException;
 use Mautic\Api\Api as BaseApi;
 
 class Api
@@ -106,7 +109,7 @@ public static function sendToContact($email, $templateId, array $tokens = [], $h
      * @throws Exception\AuthInstanceException
      * @throws \Exception
      */
-    public static function updateContact($email, $data = []) {
+    public static function updateContact($email, array $data) {
 
         $contactId = self::getContactIdByMail($email);
 
@@ -120,10 +123,11 @@ public static function updateContact($email, $data = []) {
     /**
      * @param $email
      * @param array $data
-     * @return mixed
+     * @return array
      * @throws Exception\AuthInstanceException
+     * @throws \Exception
      */
-    public static function createContact($email, $data = []) {
+    public static function createContact($email, array $data = []) {
 
         $api = self::getApiInstance();
 
@@ -132,7 +136,14 @@ public static function createContact($email, $data = []) {
             'ipAddress' => $_SERVER['REMOTE_ADDR']
         ], $data);
 
-        return $api->makeRequest('contacts/new', $data, 'POST');
+
+        $data = $api->makeRequest('contacts/new', $data, 'POST');
+
+        if (isset($data['contact']) && isset($data['contact']['id'])) {
+           return $data['contact']['id'];
+        }
+
+        throw new ContactCreateException();
     }
 
 }

src/Exception/ContactCreateException.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace BarnebysMautic\Exception;
+
+class ContactCreateException extends MauticApiException
+{
+
+}

src/Exception/SegmentNotFoundException.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace BarnebysMautic\Exception;
+
+class SegmentNotFoundException extends MauticApiException
+{
+
+}

src/Tags.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace BarnebysMautic;
+
+class Tags
+{
+
+    private $_tags = [];
+
+    /**
+     * @param $name
+     * @return $this
+     */
+    public function addTag($name) {
+        if (!in_array($name, $this->_tags)) {
+            $this->_tags[] = $name;
+        }
+
+        return $this;
+    }
+
+    /**
+     * @param $name
+     * @return $this
+     */
+    public function removeTag($name) {
+        if (in_array($name, $this->_tags)) {
+            unset($this->_tags[$name]);
+        }
+
+        $this->_tags[] = '-' . $name;
+
+        return $this;
+    }
+
+    /**
+     * @return array
+     */
+    public function toArray()
+    {
+        return ['tags' => $this->_tags];
+    }
+
+}