tracker.php

См. документацию.

<?php
 
namespace Bitrix\Sender\Message;
 
use Bitrix\Main\Mail\Tracking;
use Bitrix\Main\SiteTable;
use Bitrix\Sender\Integration;
 
class Tracker
{
    public const TYPE_READ = 1;
    public const TYPE_CLICK = 2;
    public const TYPE_UNSUB = 3;

    protected $type;

    protected $moduleId;

    protected $fields = [];

    protected $uriParameters = [];

    protected $handlerUri;

    protected $linkDomain;

    protected $siteId;
 
    private $siteData;

    public function __construct($type)
    {
        $this->type = $type;
    }

    public function getModuleId()
    {
        return $this->moduleId;
    }

    public function setModuleId($moduleId)
    {
        $this->moduleId = $moduleId;
        return $this;
    }

    public function getSiteId()
    {
        return $this->moduleId;
    }

    public function setSiteId($siteId)
    {
        $this->siteId = $siteId;
        return $this;
    }

    public function getFields()
    {
        return $this->fields;
    }

    public function setFields($fields)
    {
        $this->fields = $fields;
        return $this;
    }

    public function addField($key, $value)
    {
        $this->fields[$key] = $value;
    }

    public function getUriParameters()
    {
        return $this->uriParameters;
    }

    public function setUriParameters($uriParameters)
    {
        $this->uriParameters = $uriParameters;
        return $this;
    }

    public function addUriParameter($key, $value)
    {
        $this->uriParameters[$key] = $value;
        return $this;
    }

    public function getHandlerUri()
    {
        if (!$this->handlerUri && Integration\Bitrix24\Service::isPortal())
        {
            return Integration\Bitrix24\Service::getTrackingUri(
                $this->type,
                (Integration\Bitrix24\Service::isCloud() ? null : $this->siteId) // $this->siteId is not used for cloud
            );
        }
 
        return $this->handlerUri;
    }

    public function setHandlerUri($handlerUri)
    {
        $this->handlerUri = $handlerUri;
        return $this;
    }

    public function getLinkDomain()
    {
        if ($this->linkDomain === null)
        {
            if (Integration\Bitrix24\Service::isCloud())
            {
                return '';
            }
            if ($this->siteId)
            {
                if ($this->siteData === null)
                {
                    $this->siteData = SiteTable::getById($this->siteId)->fetch();
                }
                if ($this->siteData && $this->siteData['SERVER_NAME'])
                {
                    return $this->siteData['SERVER_NAME'];
                }
            }
        }
 
        return $this->linkDomain;
    }

    public function setLinkDomain($linkDomain)
    {
        $this->linkDomain = $linkDomain;
        return $this;
    }

    public function getLink()
    {
        $link = '';
 
        $moduleId = $this->getModuleId();
        $fields = $this->getFields();
        if (!$moduleId || empty($fields))
        {
            return $link;
        }
 
        $uri = $this->getHandlerUri();
        switch ($this->type)
        {
            case self::TYPE_READ:
                $link = Tracking::getLinkRead($moduleId, $fields, $uri);
                break;
 
            case self::TYPE_CLICK:
                $link = Tracking::getLinkClick($moduleId, $fields, $uri);
                break;
 
            case self::TYPE_UNSUB:
                $link = Tracking::getLinkUnsub($moduleId, $fields, $uri);
                break;
        }
 
        return $link;
    }

    public function getArray()
    {
        return [
            'MODULE_ID' => $this->getModuleId(),
            'FIELDS' => $this->getFields(),
            'URL_PAGE' => $this->getHandlerUri(),
            'URL_PARAMS' => $this->getUriParameters(),
        ];
    }

    public function setArray(array $data)
    {
        if (isset($data['MODULE_ID']))
        {
            $this->setModuleId($data['MODULE_ID']);
        }
        if (isset($data['FIELDS']))
        {
            $this->setFields($data['FIELDS']);
        }
        if (isset($data['URL_PARAMS']))
        {
            $this->setUriParameters($data['URL_PARAMS']);
        }
        if (isset($data['URL_PAGE']))
        {
            $this->setHandlerUri($data['URL_PAGE']);
        }
 
        return $this;
    }
}