entity.php

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

<?php
namespace Bitrix\Landing\Binding;
 
use \Bitrix\Landing\Internals\BindingTable;
use \Bitrix\Landing\Landing;
use \Bitrix\Landing\Rights;
use \Bitrix\Landing\Site;
use \Bitrix\Main;
 
abstract class Entity
{
    const ENTITY_TYPE_SITE = 'S';

    const ENTITY_TYPE_LANDING = 'L';

    protected static $bindingType = null;

    protected $bindingId = null;

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

    private static function clearCache(): void
    {
        if (defined('BX_COMP_MANAGED_CACHE'))
        {
            \Bitrix\Landing\Manager::getCacheManager()->clearByTag(
                'intranet_menu_binding'
            );
        }
    }

    private function getBindingId($entityId, $entityType)
    {
        $res = BindingTable::getList([
            'select' => [
                'ID'
            ],
            'filter' => [
                '=BINDING_TYPE' => static::$bindingType,
                '=BINDING_ID' => $this->bindingId,
                '=ENTITY_TYPE' => $entityType,
                '=ENTITY_ID' => $entityId
            ]
        ]);
        if ($row = $res->fetch())
        {
            return $row['ID'];
        }
        else
        {
            return 0;
        }
    }

    private function addBinding($entityId, $entityType)
    {
        $res = BindingTable::add([
            'BINDING_TYPE' => static::$bindingType,
            'BINDING_ID' => $this->bindingId,
            'ENTITY_TYPE' => $entityType,
            'ENTITY_ID' => $entityId
        ]);
        if ($res->isSuccess())
        {
            return $res->getId();
        }
        else
        {
            return null;
        }
    }

    private function deleteBindingId($bindingId)
    {
        $res = BindingTable::delete($bindingId);
        $res->isSuccess();
    }

    private function bind($entityId, $entityType)
    {
        if (!$this->getBindingId($entityId, $entityType))
        {
            $this->clearCache();
            return $this->addBinding($entityId, $entityType) > 0;
        }
        else
        {
            return false;
        }
    }

    private function unbind($entityId, $entityType)
    {
        $bindingId = $this->getBindingId($entityId, $entityType);
        if ($bindingId)
        {
            $this->clearCache();
            $this->deleteBindingId($bindingId);
            return true;
        }
        else
        {
            return false;
        }
    }

    private static function getBindings($bindingId)
    {
        $items = [];
 
        // filter
        $filter = [
            '=BINDING_TYPE' => static::$bindingType,
            '=ENTITY_TYPE' => [
                self::ENTITY_TYPE_SITE,
                self::ENTITY_TYPE_LANDING
            ]
        ];
        if ($bindingId !== null)
        {
            $filter['=BINDING_ID'] = $bindingId;
        }
 
        // runtime fields
        $runtime = [];
        $runtime[] = new Main\Entity\ReferenceField(
            'SITE',
            'Bitrix\Landing\Internals\SiteTable',
            [
                '=this.ENTITY_ID' => 'ref.ID',
                '=this.ENTITY_TYPE' => [
                    '?', self::ENTITY_TYPE_SITE
                ]
            ]
        );
        $runtime[] = new Main\Entity\ReferenceField(
            'LANDING',
            'Bitrix\Landing\Internals\LandingTable',
            [
                '=this.ENTITY_ID' => 'ref.ID',
                '=this.ENTITY_TYPE' => [
                    '?', self::ENTITY_TYPE_LANDING
                ]
            ]
        );
 
        // selecting
        $urls = [
            self::ENTITY_TYPE_SITE => [],
            self::ENTITY_TYPE_LANDING => []
        ];
        $res = BindingTable::getList([
            'select' => [
                'ENTITY_ID',
                'ENTITY_TYPE',
                'BINDING_ID',
                'SITE_TITLE' => 'SITE.TITLE',
                'LANDING_TITLE' => 'LANDING.TITLE',
                'SITE_DELETED' => 'SITE.DELETED',
                'LANDING_DELETED' => 'LANDING.DELETED'
            ],
            'filter' => $filter,
            'runtime' => $runtime,
            'order' => [
                'ID' => 'desc'
            ]
        ]);
        while ($row = $res->fetch())
        {
            if (
                $row['SITE_DELETED'] == 'Y' ||
                $row['LANDING_DELETED'] == 'Y'
            )
            {
                continue;
            }
            $urls[$row['ENTITY_TYPE']][] = $row['ENTITY_ID'];
            $title = ($row['ENTITY_TYPE'] == self::ENTITY_TYPE_SITE)
                    ? $row['SITE_TITLE']
                    : $row['LANDING_TITLE'];
            if (!$title)
            {
                continue;
            }
            $items[] = [
                'ENTITY_ID' => $row['ENTITY_ID'],
                'ENTITY_TYPE' => $row['ENTITY_TYPE'],
                'BINDING_ID' => $row['BINDING_ID'],
                'TITLE' => $title,
                'PUBLIC_URL' => '',
            ];
        }
 
        // get urls
        if ($urls[self::ENTITY_TYPE_SITE])
        {
            $urls[self::ENTITY_TYPE_SITE] = Site::getPublicUrl(
                $urls[self::ENTITY_TYPE_SITE]
            );
        }
        if ($urls[self::ENTITY_TYPE_LANDING])
        {
            $landing = Landing::createInstance(0);
            $urls[self::ENTITY_TYPE_LANDING] = $landing->getPublicUrl(
                $urls[self::ENTITY_TYPE_LANDING]
            );
        }
 
        // rebuild for urls
        foreach ($items as &$item)
        {
            if (isset($urls[$item['ENTITY_TYPE']][$item['ENTITY_ID']]))
            {
                $item['PUBLIC_URL'] = $urls[$item['ENTITY_TYPE']][$item['ENTITY_ID']];
            }
        }
        unset($item);
 
        return $items;
    }

    public static function getList($code = null)
    {
        return self::getBindings($code);
    }

    public function bindSite(int $siteId): bool
    {
        $siteId = intval($siteId);
 
        $success = $this->bind($siteId, $this::ENTITY_TYPE_SITE);
 
        if ($success && method_exists($this, 'addSiteRights'))
        {
            $this->addSiteRights($siteId);
        }
 
        return $success;
    }

    public function rebindSite(int $siteId): bool
    {
        // this method only implements parent method currently
 
        if (method_exists($this, 'updateSiteRights'))
        {
            $this->updateSiteRights($siteId);
        }
 
        return true;
    }

    public function unbindSite(int $siteId): bool
    {
        $siteId = intval($siteId);
 
        $success = $this->unbind($siteId, $this::ENTITY_TYPE_SITE);
 
        if ($success && method_exists($this, 'removeSiteRights'))
        {
            $this->removeSiteRights($siteId);
        }
 
        return $success;
    }

    public function bindLanding(int $landingId): bool
    {
        $landingId = intval($landingId);
 
        $success = $this->bind($landingId, $this::ENTITY_TYPE_LANDING);
 
        if ($success && method_exists($this, 'addLandingRights'))
        {
            $this->addLandingRights($landingId);
        }
 
        return $success;
    }

    public function unbindLanding(int $landingId): bool
    {
        $landingId = intval($landingId);
 
        $success = $this->unbind($landingId, $this::ENTITY_TYPE_LANDING);
 
        if ($success && method_exists($this, 'removeLandingRights'))
        {
            $this->removeLandingRights($landingId);
        }
 
        return $success;
    }

    public static function onSiteChange(int $siteId): void
    {
        if (defined('BX_COMP_MANAGED_CACHE'))
        {
            $res = BindingTable::getList([
                'select' => [
                    'ID'
                ],
                'filter' => [
                    'ENTITY_ID' => $siteId,
                    '=ENTITY_TYPE' => self::ENTITY_TYPE_SITE
                ],
                'limit' => 1
            ]);
            if ($res->fetch())
            {
                self::clearCache();
            }
        }
    }
 
    public function isForbiddenBindingAction(): bool
    {
        return (
            !Rights::hasAdditionalRight('extension', 'knowledge', false, true)
            && Site\Type::getCurrentScopeId() !== 'GROUP'
        );
    }
}