Initial commit

Author: [email protected]

composer.json

@@ -0,0 +1,17 @@
+{
+  "name": "barnebys/mautic-api-helper",
+  "license": "MIT",
+  "type": "library",
+  "description": "",
+  "autoload": {
+    "psr-4": {
+      "BarnebysMautic\\": "src/"
+    }
+  },
+  "require": {
+    "php": ">=5.6",
+    "ext-curl": "*",
+    "psr/log": "~1.0",
+    "mautic/api-library": "2.10.0"
+  }
+}

src/Api.php

@@ -0,0 +1,97 @@
+<?php
+
+namespace BarnebysMautic;
+
+use BarnebysMautic\Exception\ContactNotFoundException;
+use Mautic\Api\Api as BaseApi;
+
+class Api
+{
+
+    private static $url;
+
+    public static function setBaseUrl($url)
+    {
+        self::$url = $url;
+    }
+
+    /**
+     * @return BaseApi
+     *
+     * @throws Exception\AuthInstanceException
+     */
+    private static function getApiInstance()
+    {
+        $auth = Auth::getInstance();
+
+        return new BaseApi($auth->getMauticAuth(), self::$url);
+    }
+
+    /**
+     * @param string $mail
+     * @return integer
+     *
+     * @throws ContactNotFoundException
+     * @throws Exception\AuthInstanceException
+     * @throws \Exception
+     */
+    public static function getContactIdByMail($mail)
+    {
+        $api = self::getApiInstance();
+
+        $parameters = [
+            'search' => $mail,
+            'limit' => 1
+        ];
+
+        $data = $api->makeRequest('contacts', $parameters);
+        $contacts = $data['contacts'];
+        if(sizeof($contacts) > 0){
+            return (int) current($contacts)['id'];
+        }
+
+        throw new ContactNotFoundException();
+    }
+
+    /**
+     * @param string $email
+     * @param integer $templateId
+     * @param array $tokens
+     * @param boolean $html
+     *
+     * @return array
+     *
+     * @throws ContactNotFoundException
+     * @throws Exception\AuthInstanceException
+     * @throws \Exception
+     */
+    public static function sendToLead($email, $templateId, array $tokens = [], $html = false)
+    {
+        return self::sendToContact($email, $templateId, $tokens, $html);
+    }
+
+    /**
+     * @param string $email
+     * @param integer $templateId
+     * @param array $tokens
+     * @param boolean $html
+     *
+     * @return array
+     *
+     * @throws ContactNotFoundException
+     * @throws Exception\AuthInstanceException
+     * @throws \Exception
+     */
+    public static function sendToContact($email, $templateId, array $tokens = [], $html = false)
+    {
+        $contactId = self::getContactIdByMail($email);
+
+        $api = self::getApiInstance();
+
+        $baseUrl = sprintf('contacts/%s/contact/%s/send', $templateId, $contactId);
+        $htmlUrl = sprintf('contacts/%s/contact/%s/send-content', $templateId, $contactId);
+
+        return $api->makeRequest($html === true ? $htmlUrl : $baseUrl, $tokens, 'POST');
+    }
+
+}

src/Auth.php

@@ -0,0 +1,89 @@
+<?php
+
+namespace BarnebysMautic;
+
+use BarnebysMautic\Exception\AuthInstanceException;
+use Mautic\Auth\ApiAuth;
+use Mautic\Auth\AuthInterface;
+
+class Auth
+{
+
+    /**
+     * @var self|null
+     */
+    private static $instance;
+
+    /**
+     * @return self
+     *
+     * @throws AuthInstanceException
+     */
+    public static function getInstance()
+    {
+        if (self::$instance == null)
+        {
+            throw new AuthInstanceException();
+        }
+
+        return self::$instance;
+    }
+
+    /**
+     * @param string $username
+     * @param string $password
+     */
+    public static function initializeHttpBasic($username, $password)
+    {
+        $auth = (new ApiAuth())->newAuth([
+            'userName'   => $username,
+            'password'   => $password
+        ], 'BasicAuth');
+
+
+        self::$instance = new self();
+        self::$instance->setMauticAuth($auth);
+    }
+
+    /**
+     * @param string $baseUrl
+     * @param string $clientKey
+     * @param string $clientSecret
+     * @param string $callback
+     */
+    public static function initializeOAuth2($baseUrl, $clientKey, $clientSecret, $callback)
+    {
+        $auth = (new ApiAuth())->newAuth([
+            'baseUrl'          => $baseUrl,
+            'version'          => 'OAuth2',
+            'clientKey'        => $clientKey,
+            'clientSecret'     => $clientSecret,
+            'callback'         => $callback
+        ], 'OAuth');
+
+        self::$instance = new self();
+        self::$instance->setMauticAuth($auth);
+    }
+
+    /**
+     * @var AuthInterface
+     */
+    private $mauticAuthInstance;
+
+    /**
+     * @param AuthInterface $auth
+     */
+    public function setMauticAuth(AuthInterface $auth)
+    {
+        $this->mauticAuthInstance = $auth;
+    }
+
+    /**
+     * @return AuthInterface
+     */
+    public function getMauticAuth()
+    {
+        return $this->mauticAuthInstance;
+    }
+
+}

src/Exception/AuthInstanceException.php

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

src/Exception/ContactNotFoundException.php

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

src/Exception/MauticApiException.php

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