From 91a309af8aa3246b7be77b042b3837f1754345aa Mon Sep 17 00:00:00 2001
From: landofcoder <landofcoder@gmail.com>
Date: Tue, 23 Nov 2021 10:56:52 +0700
Subject: [PATCH 1/5] test

---
 Controller/Cart/Loadquote.php              | 11 ++++++-----
 Queue/Processor/AbandonedCartProcessor.php | 11 +++++++----
 2 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/Controller/Cart/Loadquote.php b/Controller/Cart/Loadquote.php
index b379dfc..1b41b0f 100644
--- a/Controller/Cart/Loadquote.php
+++ b/Controller/Cart/Loadquote.php
@@ -98,7 +98,7 @@ public function __construct(
         Publisher $publisher,
         Contact $mauticContact
     ) {
-    
+
         $this->pageFactory      = $pageFactory;
         $this->_quote           = $quote;
         $this->_customerSession = $customerSession;
@@ -123,8 +123,9 @@ public function execute()
             $quote->getResource()->load($quote, $params['id']);
             $magentoStoreId = $quote->getStoreId();
             $configSecretKey = $this->_helper->getConfig(\Lof\Mautic\Helper\Data::MODULE_ABANDONEDCART_TOKEN);
+            $tokenNew = $configSecretKey ? md5($configSecretKey.$params['id']) : "";
 
-            if (!isset($params['token']) || $params['token'] != $configSecretKey) {
+            if (!isset($params['token']) || ($tokenNew && $params['token'] != $tokenNew)) {
                 // @error
                 $this->_message->addErrorMessage(__("You can't access this cart"));
                 $url = $this->_urlHelper->getUrl(
@@ -158,7 +159,7 @@ public function execute()
                 if ($emailAddress = $quote->getCustomerEmail()) {
                     $this->processUpdateContactTag($emailAddress, $quote->getStoreId());
                 }
-                
+
                 if (!$quote->getCustomerId()) {
                     $this->_checkoutSession->setQuoteId($quote->getId());
                     $this->_redirect($url);
@@ -185,7 +186,7 @@ public function execute()
 
     /**
      * process update contact tags
-     * 
+     *
      * @param string $email
      * @param int|string|null $storeId
      * @return bool
@@ -208,4 +209,4 @@ protected function processUpdateContactTag($email, $storeId = null)
         }
         return true;
     }
-}
\ No newline at end of file
+}
diff --git a/Queue/Processor/AbandonedCartProcessor.php b/Queue/Processor/AbandonedCartProcessor.php
index d478753..55c60e1 100644
--- a/Queue/Processor/AbandonedCartProcessor.php
+++ b/Queue/Processor/AbandonedCartProcessor.php
@@ -77,13 +77,13 @@ public function process()
                 $this->_processAbandoned($storeId);
             }
         }
-        
+
         return;
     }
 
     /**
      * Process abandoned cart
-     * 
+     *
      * @param int $storeId
      * @return void
      */
@@ -99,6 +99,9 @@ protected function _processAbandoned($storeId)
             $this->customergroups = [];
         }
         $diff = $this->helperData->getConfig(Data::MODULE_DIFF_DATE, $storeId);
+        if (!$diff) { //Disable feature when diff date number is empty
+            return;
+        }
         $expr = sprintf('DATE_SUB(now(), %s)', $this->_getIntervalUnitSql($diff, 'DAY'));
         $from = new \Zend_Db_Expr($expr);
 
@@ -119,7 +122,7 @@ protected function _processAbandoned($storeId)
 
         try {
             foreach ($collection as $quote) {
-                $tokenNew = $token;//.md5(rand(0, 9999999));
+                $tokenNew = md5($token.$quote->getEntityId());
                 $url = $this->_storeManager->getStore($storeId)->getBaseUrl(\Magento\Framework\UrlInterface::URL_TYPE_LINK) . 'mautic/cart/loadquote?id=' . $quote->getEntityId() . '&token=' . $tokenNew;
 
                 $customData = [
@@ -142,7 +145,7 @@ protected function _processAbandoned($storeId)
         } catch (\Exception $e) {
             //log exception at here
         }
-        
+
         return;
     }
 

From f9fd5e555a47a6304135a76b2415cdbe540f8eba Mon Sep 17 00:00:00 2001
From: landofcoder <landofcoder@gmail.com>
Date: Tue, 23 Nov 2021 11:14:12 +0700
Subject: [PATCH 2/5] updated readme

---
 Queue/Processor/AbandonedCartProcessor.php |   3 +++
 README.md                                  |   5 +++++
 assets/12_abandoned_cart.png               | Bin 0 -> 62231 bytes
 3 files changed, 8 insertions(+)
 create mode 100644 assets/12_abandoned_cart.png

diff --git a/Queue/Processor/AbandonedCartProcessor.php b/Queue/Processor/AbandonedCartProcessor.php
index 55c60e1..5651861 100644
--- a/Queue/Processor/AbandonedCartProcessor.php
+++ b/Queue/Processor/AbandonedCartProcessor.php
@@ -90,6 +90,9 @@ public function process()
     protected function _processAbandoned($storeId)
     {
         $this->firstdate        = $this->helperData->getConfig(Data::MODULE_FIRST_DATE, $storeId);
+        if (!$this->firstdate) {
+            $this->firstdate = $this->_getSuggestedZeroDate();
+        }
         $this->customergroups        = $this->helperData->getConfig(Data::MODULE_ABANDONED_CUSTOMER_GROUP, $storeId);
         $token        = $this->helperData->getConfig(Data::MODULE_ABANDONEDCART_TOKEN, $storeId);
 
diff --git a/README.md b/README.md
index 810e7c9..9d2f05a 100644
--- a/README.md
+++ b/README.md
@@ -112,6 +112,7 @@
 
 Require setup and config RabbitMQ for Magento 2 [RabbitMQ Configrable Guide](https://blog.landofcoder.com/how-to-set-up-and-configure-rabbitmq-with-magento-2/)
 
+
 The module support there consummers:
 
 ```
@@ -121,6 +122,10 @@ mautic_review_save
 mautic_subscriber_save
 ```
 
+- Abandoned Cart Tags:
+![Abandoned Cart Tags Settings](./assets/12_abandoned_cart.png)
+the feature will run on each 5 minutes (cron job) find abandoned cart on reports which have last updated date <= Diff date number, and match customer groups (option), and updated date greater than first date (option). If found abandoned cart, it will add mautic contact with tag: AbandonedCart 
+
 ## Compatible Modules
 
 - [Magento 2 GDPR Compatible](https://github.com/landofcoder/module-magento2-mautic-gdpr)
diff --git a/assets/12_abandoned_cart.png b/assets/12_abandoned_cart.png
new file mode 100644
index 0000000000000000000000000000000000000000..4118aa50466a5440c439f978e2ffeaf99146c77d
GIT binary patch
literal 62231
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
SAnZMHLPx^@Tz2nq=>Gu5xDzb^

literal 0
HcmV?d00001


From a1508f1670625de37c4f3d3b7a639f18c20dae01 Mon Sep 17 00:00:00 2001
From: landofcoder <landofcoder@gmail.com>
Date: Thu, 25 Nov 2021 15:19:38 +0700
Subject: [PATCH 3/5] updated readme

---
 README.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 9d2f05a..7e04247 100644
--- a/README.md
+++ b/README.md
@@ -47,9 +47,17 @@
 - Support trigger events after save to sync data to Mautic
 - Support Console commands for Sync processing: Export customers, Export Orders, Export Reviews, Export Subscribers
 - Asynchronous Data Export: Support queue and cron job for calling Mautic APIs 
-- Includes abandon card tags (Comming Soon)
+- Includes abandon card tags
 - Review reminder tags (Comming Soon)
 
+## TO DO
+- Review reminder tags (Comming Soon)
+- Contact Segment (Comming soon)
+    + Add contact to a segment. Support common segment by reports: Best Customers, Big Spenders, Lost Cheap Customers, Lost Customers, Low Spenders, Loyal Customers, Mid Spenders, New Customers, One Time Purchase Customers, Two Time Purchase Customers, Three Time Purchase Customers.
+    + Remove contact from a segment
+- Campaign Contact (Comming soon)
+- Company Contact (Comming soon)
+
 ## Installation
 \* = in production please use the `--keep-generated` option
 

From ecc01f711420f5b66db50a962e6953e4ad1214b1 Mon Sep 17 00:00:00 2001
From: Panda Thuan <thuan.luuquang@gmail.com>
Date: Thu, 25 Nov 2021 16:10:12 +0700
Subject: [PATCH 4/5] added segments processor

---
 .../Segments/BestCustomersProcessor.php       | 77 +++++++++++++++++++
 .../Segments/BigSpendersProcessor.php         | 77 +++++++++++++++++++
 .../Segments/LostCheapCustomersProcessor.php  | 77 +++++++++++++++++++
 .../Segments/LostCustomersProcessor.php       | 77 +++++++++++++++++++
 .../Segments/LowSpendersProcessor.php         | 77 +++++++++++++++++++
 .../Segments/LoyalCustomersProcessor.php      | 77 +++++++++++++++++++
 .../Segments/MidSpendersProcessor.php         | 77 +++++++++++++++++++
 .../Segments/NewCustomersProcessor.php        | 77 +++++++++++++++++++
 .../OneTimePurchaseCustomersProcessor.php     | 77 +++++++++++++++++++
 .../ThreeTimePurchaseCustomersProcessor.php   | 77 +++++++++++++++++++
 .../TwoTimePurchaseCustomersProcessor.php     | 77 +++++++++++++++++++
 11 files changed, 847 insertions(+)
 create mode 100644 Queue/Processor/Segments/BestCustomersProcessor.php
 create mode 100644 Queue/Processor/Segments/BigSpendersProcessor.php
 create mode 100644 Queue/Processor/Segments/LostCheapCustomersProcessor.php
 create mode 100644 Queue/Processor/Segments/LostCustomersProcessor.php
 create mode 100644 Queue/Processor/Segments/LowSpendersProcessor.php
 create mode 100644 Queue/Processor/Segments/LoyalCustomersProcessor.php
 create mode 100644 Queue/Processor/Segments/MidSpendersProcessor.php
 create mode 100644 Queue/Processor/Segments/NewCustomersProcessor.php
 create mode 100644 Queue/Processor/Segments/OneTimePurchaseCustomersProcessor.php
 create mode 100644 Queue/Processor/Segments/ThreeTimePurchaseCustomersProcessor.php
 create mode 100644 Queue/Processor/Segments/TwoTimePurchaseCustomersProcessor.php

diff --git a/Queue/Processor/Segments/BestCustomersProcessor.php b/Queue/Processor/Segments/BestCustomersProcessor.php
new file mode 100644
index 0000000..b44167e
--- /dev/null
+++ b/Queue/Processor/Segments/BestCustomersProcessor.php
@@ -0,0 +1,77 @@
+<?php
+
+namespace Lof\Mautic\Queue\Processor\Segments;
+
+use Magento\Framework\Api\SearchCriteriaBuilder;
+use Magento\Framework\Api\SortOrderBuilder;
+use Magento\Framework\Event\ManagerInterface;
+use Magento\Store\Model\StoreManager;
+use Magento\Reports\Model\ResourceModel\Quote\CollectionFactory;
+use Lof\Mautic\Model\Mautic\Contact;
+use Lof\Mautic\Helper\Data;
+use Lof\Mautic\Model\Mautic\AbstractApi;
+use Lof\Mautic\Queue\MessageQueues\Order\Publisher;
+use Lof\Mautic\Queue\Processor\AbstractQueueProcessor;
+
+/**
+ * Class BestCustomersProcessor
+ * Find best customers from reports and add to segement name "Best Customers"
+ */
+class BestCustomersProcessor extends AbstractQueueProcessor
+{
+    /**
+     * @var array
+     */
+    protected $customergroups = [];
+
+    /**
+     * @var string|null
+     */
+    protected $firstdate = null;
+
+    /**
+    * @var Publisher
+    */
+    private $publisher;
+
+    /**
+     * @var CollectionFactory
+     */
+    protected $collectionFactory;
+
+    /**
+     * @var StoreManager
+     */
+    protected $_storeManager;
+
+
+    /**
+     * CategoryImport constructor.
+     *
+     * @param Contact $mauticContact
+     * @param Data $helperData
+     * @param CollectionFactory $collectionFactory
+     * @param Publisher $publisher
+     * @param StoreManager $storeManager
+     */
+    public function __construct(
+        Contact $mauticContact,
+        Data $helperData,
+        CollectionFactory $collectionFactory,
+        Publisher $publisher,
+        StoreManager $storeManager
+    ) {
+        parent::__construct($mauticContact, $helperData);
+        $this->collectionFactory = $collectionFactory;
+        $this->publisher = $publisher;
+        $this->_storeManager    = $storeManager;
+    }
+
+    /**
+     * @return void
+     */
+    public function process()
+    {
+        //Write code at here
+    }
+}
diff --git a/Queue/Processor/Segments/BigSpendersProcessor.php b/Queue/Processor/Segments/BigSpendersProcessor.php
new file mode 100644
index 0000000..087ebb8
--- /dev/null
+++ b/Queue/Processor/Segments/BigSpendersProcessor.php
@@ -0,0 +1,77 @@
+<?php
+
+namespace Lof\Mautic\Queue\Processor\Segments;
+
+use Magento\Framework\Api\SearchCriteriaBuilder;
+use Magento\Framework\Api\SortOrderBuilder;
+use Magento\Framework\Event\ManagerInterface;
+use Magento\Store\Model\StoreManager;
+use Magento\Reports\Model\ResourceModel\Quote\CollectionFactory;
+use Lof\Mautic\Model\Mautic\Contact;
+use Lof\Mautic\Helper\Data;
+use Lof\Mautic\Model\Mautic\AbstractApi;
+use Lof\Mautic\Queue\MessageQueues\Order\Publisher;
+use Lof\Mautic\Queue\Processor\AbstractQueueProcessor;
+
+/**
+ * Class BigSpendersProcessor
+ * Find best customers from reports and add to segement name "Best Customers"
+ */
+class BigSpendersProcessor extends AbstractQueueProcessor
+{
+    /**
+     * @var array
+     */
+    protected $customergroups = [];
+
+    /**
+     * @var string|null
+     */
+    protected $firstdate = null;
+
+    /**
+    * @var Publisher
+    */
+    private $publisher;
+
+    /**
+     * @var CollectionFactory
+     */
+    protected $collectionFactory;
+
+    /**
+     * @var StoreManager
+     */
+    protected $_storeManager;
+
+
+    /**
+     * CategoryImport constructor.
+     *
+     * @param Contact $mauticContact
+     * @param Data $helperData
+     * @param CollectionFactory $collectionFactory
+     * @param Publisher $publisher
+     * @param StoreManager $storeManager
+     */
+    public function __construct(
+        Contact $mauticContact,
+        Data $helperData,
+        CollectionFactory $collectionFactory,
+        Publisher $publisher,
+        StoreManager $storeManager
+    ) {
+        parent::__construct($mauticContact, $helperData);
+        $this->collectionFactory = $collectionFactory;
+        $this->publisher = $publisher;
+        $this->_storeManager    = $storeManager;
+    }
+
+    /**
+     * @return void
+     */
+    public function process()
+    {
+        //Write code at here
+    }
+}
diff --git a/Queue/Processor/Segments/LostCheapCustomersProcessor.php b/Queue/Processor/Segments/LostCheapCustomersProcessor.php
new file mode 100644
index 0000000..c363870
--- /dev/null
+++ b/Queue/Processor/Segments/LostCheapCustomersProcessor.php
@@ -0,0 +1,77 @@
+<?php
+
+namespace Lof\Mautic\Queue\Processor\Segments;
+
+use Magento\Framework\Api\SearchCriteriaBuilder;
+use Magento\Framework\Api\SortOrderBuilder;
+use Magento\Framework\Event\ManagerInterface;
+use Magento\Store\Model\StoreManager;
+use Magento\Reports\Model\ResourceModel\Quote\CollectionFactory;
+use Lof\Mautic\Model\Mautic\Contact;
+use Lof\Mautic\Helper\Data;
+use Lof\Mautic\Model\Mautic\AbstractApi;
+use Lof\Mautic\Queue\MessageQueues\Order\Publisher;
+use Lof\Mautic\Queue\Processor\AbstractQueueProcessor;
+
+/**
+ * Class LostCheapCustomersProcessor
+ * Find best customers from reports and add to segement name "Best Customers"
+ */
+class LostCheapCustomersProcessor extends AbstractQueueProcessor
+{
+    /**
+     * @var array
+     */
+    protected $customergroups = [];
+
+    /**
+     * @var string|null
+     */
+    protected $firstdate = null;
+
+    /**
+    * @var Publisher
+    */
+    private $publisher;
+
+    /**
+     * @var CollectionFactory
+     */
+    protected $collectionFactory;
+
+    /**
+     * @var StoreManager
+     */
+    protected $_storeManager;
+
+
+    /**
+     * CategoryImport constructor.
+     *
+     * @param Contact $mauticContact
+     * @param Data $helperData
+     * @param CollectionFactory $collectionFactory
+     * @param Publisher $publisher
+     * @param StoreManager $storeManager
+     */
+    public function __construct(
+        Contact $mauticContact,
+        Data $helperData,
+        CollectionFactory $collectionFactory,
+        Publisher $publisher,
+        StoreManager $storeManager
+    ) {
+        parent::__construct($mauticContact, $helperData);
+        $this->collectionFactory = $collectionFactory;
+        $this->publisher = $publisher;
+        $this->_storeManager    = $storeManager;
+    }
+
+    /**
+     * @return void
+     */
+    public function process()
+    {
+        //Write code at here
+    }
+}
diff --git a/Queue/Processor/Segments/LostCustomersProcessor.php b/Queue/Processor/Segments/LostCustomersProcessor.php
new file mode 100644
index 0000000..e477574
--- /dev/null
+++ b/Queue/Processor/Segments/LostCustomersProcessor.php
@@ -0,0 +1,77 @@
+<?php
+
+namespace Lof\Mautic\Queue\Processor\Segments;
+
+use Magento\Framework\Api\SearchCriteriaBuilder;
+use Magento\Framework\Api\SortOrderBuilder;
+use Magento\Framework\Event\ManagerInterface;
+use Magento\Store\Model\StoreManager;
+use Magento\Reports\Model\ResourceModel\Quote\CollectionFactory;
+use Lof\Mautic\Model\Mautic\Contact;
+use Lof\Mautic\Helper\Data;
+use Lof\Mautic\Model\Mautic\AbstractApi;
+use Lof\Mautic\Queue\MessageQueues\Order\Publisher;
+use Lof\Mautic\Queue\Processor\AbstractQueueProcessor;
+
+/**
+ * Class LostCustomersProcessor
+ * Find best customers from reports and add to segement name "Best Customers"
+ */
+class LostCustomersProcessor extends AbstractQueueProcessor
+{
+    /**
+     * @var array
+     */
+    protected $customergroups = [];
+
+    /**
+     * @var string|null
+     */
+    protected $firstdate = null;
+
+    /**
+    * @var Publisher
+    */
+    private $publisher;
+
+    /**
+     * @var CollectionFactory
+     */
+    protected $collectionFactory;
+
+    /**
+     * @var StoreManager
+     */
+    protected $_storeManager;
+
+
+    /**
+     * CategoryImport constructor.
+     *
+     * @param Contact $mauticContact
+     * @param Data $helperData
+     * @param CollectionFactory $collectionFactory
+     * @param Publisher $publisher
+     * @param StoreManager $storeManager
+     */
+    public function __construct(
+        Contact $mauticContact,
+        Data $helperData,
+        CollectionFactory $collectionFactory,
+        Publisher $publisher,
+        StoreManager $storeManager
+    ) {
+        parent::__construct($mauticContact, $helperData);
+        $this->collectionFactory = $collectionFactory;
+        $this->publisher = $publisher;
+        $this->_storeManager    = $storeManager;
+    }
+
+    /**
+     * @return void
+     */
+    public function process()
+    {
+        //Write code at here
+    }
+}
diff --git a/Queue/Processor/Segments/LowSpendersProcessor.php b/Queue/Processor/Segments/LowSpendersProcessor.php
new file mode 100644
index 0000000..d1b63c0
--- /dev/null
+++ b/Queue/Processor/Segments/LowSpendersProcessor.php
@@ -0,0 +1,77 @@
+<?php
+
+namespace Lof\Mautic\Queue\Processor\Segments;
+
+use Magento\Framework\Api\SearchCriteriaBuilder;
+use Magento\Framework\Api\SortOrderBuilder;
+use Magento\Framework\Event\ManagerInterface;
+use Magento\Store\Model\StoreManager;
+use Magento\Reports\Model\ResourceModel\Quote\CollectionFactory;
+use Lof\Mautic\Model\Mautic\Contact;
+use Lof\Mautic\Helper\Data;
+use Lof\Mautic\Model\Mautic\AbstractApi;
+use Lof\Mautic\Queue\MessageQueues\Order\Publisher;
+use Lof\Mautic\Queue\Processor\AbstractQueueProcessor;
+
+/**
+ * Class LowSpendersProcessor
+ * Find best customers from reports and add to segement name "Best Customers"
+ */
+class LowSpendersProcessor extends AbstractQueueProcessor
+{
+    /**
+     * @var array
+     */
+    protected $customergroups = [];
+
+    /**
+     * @var string|null
+     */
+    protected $firstdate = null;
+
+    /**
+    * @var Publisher
+    */
+    private $publisher;
+
+    /**
+     * @var CollectionFactory
+     */
+    protected $collectionFactory;
+
+    /**
+     * @var StoreManager
+     */
+    protected $_storeManager;
+
+
+    /**
+     * CategoryImport constructor.
+     *
+     * @param Contact $mauticContact
+     * @param Data $helperData
+     * @param CollectionFactory $collectionFactory
+     * @param Publisher $publisher
+     * @param StoreManager $storeManager
+     */
+    public function __construct(
+        Contact $mauticContact,
+        Data $helperData,
+        CollectionFactory $collectionFactory,
+        Publisher $publisher,
+        StoreManager $storeManager
+    ) {
+        parent::__construct($mauticContact, $helperData);
+        $this->collectionFactory = $collectionFactory;
+        $this->publisher = $publisher;
+        $this->_storeManager    = $storeManager;
+    }
+
+    /**
+     * @return void
+     */
+    public function process()
+    {
+        //Write code at here
+    }
+}
diff --git a/Queue/Processor/Segments/LoyalCustomersProcessor.php b/Queue/Processor/Segments/LoyalCustomersProcessor.php
new file mode 100644
index 0000000..d9fa041
--- /dev/null
+++ b/Queue/Processor/Segments/LoyalCustomersProcessor.php
@@ -0,0 +1,77 @@
+<?php
+
+namespace Lof\Mautic\Queue\Processor\Segments;
+
+use Magento\Framework\Api\SearchCriteriaBuilder;
+use Magento\Framework\Api\SortOrderBuilder;
+use Magento\Framework\Event\ManagerInterface;
+use Magento\Store\Model\StoreManager;
+use Magento\Reports\Model\ResourceModel\Quote\CollectionFactory;
+use Lof\Mautic\Model\Mautic\Contact;
+use Lof\Mautic\Helper\Data;
+use Lof\Mautic\Model\Mautic\AbstractApi;
+use Lof\Mautic\Queue\MessageQueues\Order\Publisher;
+use Lof\Mautic\Queue\Processor\AbstractQueueProcessor;
+
+/**
+ * Class LoyalCustomersProcessor
+ * Find best customers from reports and add to segement name "Best Customers"
+ */
+class LoyalCustomersProcessor extends AbstractQueueProcessor
+{
+    /**
+     * @var array
+     */
+    protected $customergroups = [];
+
+    /**
+     * @var string|null
+     */
+    protected $firstdate = null;
+
+    /**
+    * @var Publisher
+    */
+    private $publisher;
+
+    /**
+     * @var CollectionFactory
+     */
+    protected $collectionFactory;
+
+    /**
+     * @var StoreManager
+     */
+    protected $_storeManager;
+
+
+    /**
+     * CategoryImport constructor.
+     *
+     * @param Contact $mauticContact
+     * @param Data $helperData
+     * @param CollectionFactory $collectionFactory
+     * @param Publisher $publisher
+     * @param StoreManager $storeManager
+     */
+    public function __construct(
+        Contact $mauticContact,
+        Data $helperData,
+        CollectionFactory $collectionFactory,
+        Publisher $publisher,
+        StoreManager $storeManager
+    ) {
+        parent::__construct($mauticContact, $helperData);
+        $this->collectionFactory = $collectionFactory;
+        $this->publisher = $publisher;
+        $this->_storeManager    = $storeManager;
+    }
+
+    /**
+     * @return void
+     */
+    public function process()
+    {
+        //Write code at here
+    }
+}
diff --git a/Queue/Processor/Segments/MidSpendersProcessor.php b/Queue/Processor/Segments/MidSpendersProcessor.php
new file mode 100644
index 0000000..6a1403f
--- /dev/null
+++ b/Queue/Processor/Segments/MidSpendersProcessor.php
@@ -0,0 +1,77 @@
+<?php
+
+namespace Lof\Mautic\Queue\Processor\Segments;
+
+use Magento\Framework\Api\SearchCriteriaBuilder;
+use Magento\Framework\Api\SortOrderBuilder;
+use Magento\Framework\Event\ManagerInterface;
+use Magento\Store\Model\StoreManager;
+use Magento\Reports\Model\ResourceModel\Quote\CollectionFactory;
+use Lof\Mautic\Model\Mautic\Contact;
+use Lof\Mautic\Helper\Data;
+use Lof\Mautic\Model\Mautic\AbstractApi;
+use Lof\Mautic\Queue\MessageQueues\Order\Publisher;
+use Lof\Mautic\Queue\Processor\AbstractQueueProcessor;
+
+/**
+ * Class MidSpendersProcessor
+ * Find best customers from reports and add to segement name "Best Customers"
+ */
+class MidSpendersProcessor extends AbstractQueueProcessor
+{
+    /**
+     * @var array
+     */
+    protected $customergroups = [];
+
+    /**
+     * @var string|null
+     */
+    protected $firstdate = null;
+
+    /**
+    * @var Publisher
+    */
+    private $publisher;
+
+    /**
+     * @var CollectionFactory
+     */
+    protected $collectionFactory;
+
+    /**
+     * @var StoreManager
+     */
+    protected $_storeManager;
+
+
+    /**
+     * CategoryImport constructor.
+     *
+     * @param Contact $mauticContact
+     * @param Data $helperData
+     * @param CollectionFactory $collectionFactory
+     * @param Publisher $publisher
+     * @param StoreManager $storeManager
+     */
+    public function __construct(
+        Contact $mauticContact,
+        Data $helperData,
+        CollectionFactory $collectionFactory,
+        Publisher $publisher,
+        StoreManager $storeManager
+    ) {
+        parent::__construct($mauticContact, $helperData);
+        $this->collectionFactory = $collectionFactory;
+        $this->publisher = $publisher;
+        $this->_storeManager    = $storeManager;
+    }
+
+    /**
+     * @return void
+     */
+    public function process()
+    {
+        //Write code at here
+    }
+}
diff --git a/Queue/Processor/Segments/NewCustomersProcessor.php b/Queue/Processor/Segments/NewCustomersProcessor.php
new file mode 100644
index 0000000..f97db3e
--- /dev/null
+++ b/Queue/Processor/Segments/NewCustomersProcessor.php
@@ -0,0 +1,77 @@
+<?php
+
+namespace Lof\Mautic\Queue\Processor\Segments;
+
+use Magento\Framework\Api\SearchCriteriaBuilder;
+use Magento\Framework\Api\SortOrderBuilder;
+use Magento\Framework\Event\ManagerInterface;
+use Magento\Store\Model\StoreManager;
+use Magento\Reports\Model\ResourceModel\Quote\CollectionFactory;
+use Lof\Mautic\Model\Mautic\Contact;
+use Lof\Mautic\Helper\Data;
+use Lof\Mautic\Model\Mautic\AbstractApi;
+use Lof\Mautic\Queue\MessageQueues\Order\Publisher;
+use Lof\Mautic\Queue\Processor\AbstractQueueProcessor;
+
+/**
+ * Class NewCustomersProcessor
+ * Find best customers from reports and add to segement name "Best Customers"
+ */
+class NewCustomersProcessor extends AbstractQueueProcessor
+{
+    /**
+     * @var array
+     */
+    protected $customergroups = [];
+
+    /**
+     * @var string|null
+     */
+    protected $firstdate = null;
+
+    /**
+    * @var Publisher
+    */
+    private $publisher;
+
+    /**
+     * @var CollectionFactory
+     */
+    protected $collectionFactory;
+
+    /**
+     * @var StoreManager
+     */
+    protected $_storeManager;
+
+
+    /**
+     * CategoryImport constructor.
+     *
+     * @param Contact $mauticContact
+     * @param Data $helperData
+     * @param CollectionFactory $collectionFactory
+     * @param Publisher $publisher
+     * @param StoreManager $storeManager
+     */
+    public function __construct(
+        Contact $mauticContact,
+        Data $helperData,
+        CollectionFactory $collectionFactory,
+        Publisher $publisher,
+        StoreManager $storeManager
+    ) {
+        parent::__construct($mauticContact, $helperData);
+        $this->collectionFactory = $collectionFactory;
+        $this->publisher = $publisher;
+        $this->_storeManager    = $storeManager;
+    }
+
+    /**
+     * @return void
+     */
+    public function process()
+    {
+        //Write code at here
+    }
+}
diff --git a/Queue/Processor/Segments/OneTimePurchaseCustomersProcessor.php b/Queue/Processor/Segments/OneTimePurchaseCustomersProcessor.php
new file mode 100644
index 0000000..126362e
--- /dev/null
+++ b/Queue/Processor/Segments/OneTimePurchaseCustomersProcessor.php
@@ -0,0 +1,77 @@
+<?php
+
+namespace Lof\Mautic\Queue\Processor\Segments;
+
+use Magento\Framework\Api\SearchCriteriaBuilder;
+use Magento\Framework\Api\SortOrderBuilder;
+use Magento\Framework\Event\ManagerInterface;
+use Magento\Store\Model\StoreManager;
+use Magento\Reports\Model\ResourceModel\Quote\CollectionFactory;
+use Lof\Mautic\Model\Mautic\Contact;
+use Lof\Mautic\Helper\Data;
+use Lof\Mautic\Model\Mautic\AbstractApi;
+use Lof\Mautic\Queue\MessageQueues\Order\Publisher;
+use Lof\Mautic\Queue\Processor\AbstractQueueProcessor;
+
+/**
+ * Class OneTimePurchaseCustomersProcessor
+ * Find best customers from reports and add to segement name "Best Customers"
+ */
+class OneTimePurchaseCustomersProcessor extends AbstractQueueProcessor
+{
+    /**
+     * @var array
+     */
+    protected $customergroups = [];
+
+    /**
+     * @var string|null
+     */
+    protected $firstdate = null;
+
+    /**
+    * @var Publisher
+    */
+    private $publisher;
+
+    /**
+     * @var CollectionFactory
+     */
+    protected $collectionFactory;
+
+    /**
+     * @var StoreManager
+     */
+    protected $_storeManager;
+
+
+    /**
+     * CategoryImport constructor.
+     *
+     * @param Contact $mauticContact
+     * @param Data $helperData
+     * @param CollectionFactory $collectionFactory
+     * @param Publisher $publisher
+     * @param StoreManager $storeManager
+     */
+    public function __construct(
+        Contact $mauticContact,
+        Data $helperData,
+        CollectionFactory $collectionFactory,
+        Publisher $publisher,
+        StoreManager $storeManager
+    ) {
+        parent::__construct($mauticContact, $helperData);
+        $this->collectionFactory = $collectionFactory;
+        $this->publisher = $publisher;
+        $this->_storeManager    = $storeManager;
+    }
+
+    /**
+     * @return void
+     */
+    public function process()
+    {
+        //Write code at here
+    }
+}
diff --git a/Queue/Processor/Segments/ThreeTimePurchaseCustomersProcessor.php b/Queue/Processor/Segments/ThreeTimePurchaseCustomersProcessor.php
new file mode 100644
index 0000000..ada2ef2
--- /dev/null
+++ b/Queue/Processor/Segments/ThreeTimePurchaseCustomersProcessor.php
@@ -0,0 +1,77 @@
+<?php
+
+namespace Lof\Mautic\Queue\Processor\Segments;
+
+use Magento\Framework\Api\SearchCriteriaBuilder;
+use Magento\Framework\Api\SortOrderBuilder;
+use Magento\Framework\Event\ManagerInterface;
+use Magento\Store\Model\StoreManager;
+use Magento\Reports\Model\ResourceModel\Quote\CollectionFactory;
+use Lof\Mautic\Model\Mautic\Contact;
+use Lof\Mautic\Helper\Data;
+use Lof\Mautic\Model\Mautic\AbstractApi;
+use Lof\Mautic\Queue\MessageQueues\Order\Publisher;
+use Lof\Mautic\Queue\Processor\AbstractQueueProcessor;
+
+/**
+ * Class ThreeTimePurchaseCustomersProcessor
+ * Find best customers from reports and add to segement name "Best Customers"
+ */
+class ThreeTimePurchaseCustomersProcessor extends AbstractQueueProcessor
+{
+    /**
+     * @var array
+     */
+    protected $customergroups = [];
+
+    /**
+     * @var string|null
+     */
+    protected $firstdate = null;
+
+    /**
+    * @var Publisher
+    */
+    private $publisher;
+
+    /**
+     * @var CollectionFactory
+     */
+    protected $collectionFactory;
+
+    /**
+     * @var StoreManager
+     */
+    protected $_storeManager;
+
+
+    /**
+     * CategoryImport constructor.
+     *
+     * @param Contact $mauticContact
+     * @param Data $helperData
+     * @param CollectionFactory $collectionFactory
+     * @param Publisher $publisher
+     * @param StoreManager $storeManager
+     */
+    public function __construct(
+        Contact $mauticContact,
+        Data $helperData,
+        CollectionFactory $collectionFactory,
+        Publisher $publisher,
+        StoreManager $storeManager
+    ) {
+        parent::__construct($mauticContact, $helperData);
+        $this->collectionFactory = $collectionFactory;
+        $this->publisher = $publisher;
+        $this->_storeManager    = $storeManager;
+    }
+
+    /**
+     * @return void
+     */
+    public function process()
+    {
+        //Write code at here
+    }
+}
diff --git a/Queue/Processor/Segments/TwoTimePurchaseCustomersProcessor.php b/Queue/Processor/Segments/TwoTimePurchaseCustomersProcessor.php
new file mode 100644
index 0000000..aa4332d
--- /dev/null
+++ b/Queue/Processor/Segments/TwoTimePurchaseCustomersProcessor.php
@@ -0,0 +1,77 @@
+<?php
+
+namespace Lof\Mautic\Queue\Processor\Segments;
+
+use Magento\Framework\Api\SearchCriteriaBuilder;
+use Magento\Framework\Api\SortOrderBuilder;
+use Magento\Framework\Event\ManagerInterface;
+use Magento\Store\Model\StoreManager;
+use Magento\Reports\Model\ResourceModel\Quote\CollectionFactory;
+use Lof\Mautic\Model\Mautic\Contact;
+use Lof\Mautic\Helper\Data;
+use Lof\Mautic\Model\Mautic\AbstractApi;
+use Lof\Mautic\Queue\MessageQueues\Order\Publisher;
+use Lof\Mautic\Queue\Processor\AbstractQueueProcessor;
+
+/**
+ * Class TwoTimePurchaseCustomersProcessor
+ * Find best customers from reports and add to segement name "Best Customers"
+ */
+class TwoTimePurchaseCustomersProcessor extends AbstractQueueProcessor
+{
+    /**
+     * @var array
+     */
+    protected $customergroups = [];
+
+    /**
+     * @var string|null
+     */
+    protected $firstdate = null;
+
+    /**
+    * @var Publisher
+    */
+    private $publisher;
+
+    /**
+     * @var CollectionFactory
+     */
+    protected $collectionFactory;
+
+    /**
+     * @var StoreManager
+     */
+    protected $_storeManager;
+
+
+    /**
+     * CategoryImport constructor.
+     *
+     * @param Contact $mauticContact
+     * @param Data $helperData
+     * @param CollectionFactory $collectionFactory
+     * @param Publisher $publisher
+     * @param StoreManager $storeManager
+     */
+    public function __construct(
+        Contact $mauticContact,
+        Data $helperData,
+        CollectionFactory $collectionFactory,
+        Publisher $publisher,
+        StoreManager $storeManager
+    ) {
+        parent::__construct($mauticContact, $helperData);
+        $this->collectionFactory = $collectionFactory;
+        $this->publisher = $publisher;
+        $this->_storeManager    = $storeManager;
+    }
+
+    /**
+     * @return void
+     */
+    public function process()
+    {
+        //Write code at here
+    }
+}

From 42871d6d4bd97aee4c90e918b858f697dff522f0 Mon Sep 17 00:00:00 2001
From: Panda Thuan <thuan.luuquang@gmail.com>
Date: Thu, 25 Nov 2021 16:38:29 +0700
Subject: [PATCH 5/5] added queue for segment add and remove contacts

---
 Queue/MessageQueues/SegmentAdd/Publisher.php    | 13 +++++++++++++
 Queue/MessageQueues/SegmentRemove/Publisher.php | 13 +++++++++++++
 etc/communication.xml                           |  2 ++
 etc/queue_consumer.xml                          |  4 ++++
 etc/queue_publisher.xml                         |  8 ++++++++
 etc/queue_topology.xml                          |  8 ++++++++
 6 files changed, 48 insertions(+)
 create mode 100644 Queue/MessageQueues/SegmentAdd/Publisher.php
 create mode 100644 Queue/MessageQueues/SegmentRemove/Publisher.php

diff --git a/Queue/MessageQueues/SegmentAdd/Publisher.php b/Queue/MessageQueues/SegmentAdd/Publisher.php
new file mode 100644
index 0000000..22f8caf
--- /dev/null
+++ b/Queue/MessageQueues/SegmentAdd/Publisher.php
@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+namespace Lof\Mautic\Queue\MessageQueues\SegmentAdd;
+
+use Lof\Mautic\Queue\MessageQueues\AbstractPublisher;
+
+class Publisher extends AbstractPublisher
+{
+    /**
+     * {@inheritdoc}
+     */
+    protected $_topic_name = 'mautic.magento.segment.add';
+}
diff --git a/Queue/MessageQueues/SegmentRemove/Publisher.php b/Queue/MessageQueues/SegmentRemove/Publisher.php
new file mode 100644
index 0000000..39f88c1
--- /dev/null
+++ b/Queue/MessageQueues/SegmentRemove/Publisher.php
@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+namespace Lof\Mautic\Queue\MessageQueues\SegmentRemove;
+
+use Lof\Mautic\Queue\MessageQueues\AbstractPublisher;
+
+class Publisher extends AbstractPublisher
+{
+    /**
+     * {@inheritdoc}
+     */
+    protected $_topic_name = 'mautic.magento.segment.remove';
+}
diff --git a/etc/communication.xml b/etc/communication.xml
index d4cb719..db01713 100644
--- a/etc/communication.xml
+++ b/etc/communication.xml
@@ -5,4 +5,6 @@
     <topic name="mautic.magento.review.save" request="string"/>
     <topic name="mautic.magento.subscriber.save" request="string"/>
     <topic name="mautic.magento.contact.delete" request="string"/>
+    <topic name="mautic.magento.segment.add" request="string"/>
+    <topic name="mautic.magento.segment.remove" request="string"/>
 </config>
diff --git a/etc/queue_consumer.xml b/etc/queue_consumer.xml
index 4b330d5..26a75ff 100644
--- a/etc/queue_consumer.xml
+++ b/etc/queue_consumer.xml
@@ -13,4 +13,8 @@
     <consumer name="mautic_subscriber_save" queue="mautic_subscriber_save" connection="amqp" handler="Lof\Mautic\Queue\MessageQueues\Consumer::processMessage"/>
 
     <consumer name="mautic_contact_delete" queue="mautic_contact_delete" connection="amqp" handler="Lof\Mautic\Queue\MessageQueues\ContactDelete\Consumer::processMessage"/>
+
+    <consumer name="mautic_segment_add" queue="mautic_segment_add" connection="amqp" handler="Lof\Mautic\Queue\MessageQueues\SegmentAdd\Consumer::processMessage"/>
+
+    <consumer name="mautic_segment_remove" queue="mautic_segment_remove" connection="amqp" handler="Lof\Mautic\Queue\MessageQueues\SegmentRemove\Consumer::processMessage"/>
 </config>
diff --git a/etc/queue_publisher.xml b/etc/queue_publisher.xml
index eb2ffbb..2faca49 100644
--- a/etc/queue_publisher.xml
+++ b/etc/queue_publisher.xml
@@ -19,4 +19,12 @@
     <publisher topic="mautic.magento.contact.delete">
         <connection name="amqp" exchange="mautic.magento.contact.delete" />
     </publisher>
+
+    <publisher topic="mautic.magento.segment.add">
+        <connection name="amqp" exchange="mautic.magento.segment.add" />
+    </publisher>
+
+    <publisher topic="mautic.magento.segment.remove">
+        <connection name="amqp" exchange="mautic.magento.segment.remove" />
+    </publisher>
 </config>
diff --git a/etc/queue_topology.xml b/etc/queue_topology.xml
index d05f75f..3ab8b40 100644
--- a/etc/queue_topology.xml
+++ b/etc/queue_topology.xml
@@ -26,4 +26,12 @@
     <exchange name="mautic.magento.contact.delete" type="topic" connection="amqp">
         <binding id="mautic_contact_delete" topic="mautic.magento.contact.delete" destinationType="queue" destination="mautic_contact_delete"/>
     </exchange>
+
+    <exchange name="mautic.magento.segment.add" type="topic" connection="amqp">
+        <binding id="mautic_segment_add" topic="mautic.magento.segment.add" destinationType="queue" destination="mautic_segment_add"/>
+    </exchange>
+
+    <exchange name="mautic.magento.segment.remove" type="topic" connection="amqp">
+        <binding id="mautic_segment_remove" topic="mautic.magento.segment.remove" destinationType="queue" destination="mautic_segment_remove"/>
+    </exchange>
 </config>