statusbase.php

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

<?php
 
namespace Bitrix\Sale;
 
use Bitrix\Main;
use Bitrix\Sale\Internals\StatusTable;
use Bitrix\Sale\Internals\StatusLangTable;
use Bitrix\Main\UserGroupTable;
use Bitrix\Main\SystemException;
use Bitrix\Main\Localization\Loc;
 
Loc::loadMessages(__FILE__);

abstract class StatusBase
{
    const TYPE = '';

    public static function getList(array $parameters = array())
    {
        if (static::TYPE !== '')
        {
            if (!isset($parameters['filter']))
            {
                $parameters['filter'] = ['=TYPE' => static::TYPE];
            }
            else
            {
                $parameters['filter'] = [
                    '=TYPE' => static::TYPE,
                    $parameters['filter']
                ];
            }
        }
 
        return StatusTable::getList($parameters);
    }

    protected static function getUserGroups($userId)
    {
        global $USER;
 
        if ($userId == $USER->GetID())
        {
            $groups = $USER->GetUserGroupArray();
        }
        else
        {
            static $cacheGroups;
 
            if (isset($cacheGroups[$userId]))
            {
                $groups = $cacheGroups[$userId];
            }
            else
            {
                // TODO: DATE_ACTIVE_FROM >=< DATE_ACTIVE_TO
                $result = UserGroupTable::getList(array(
                    'select' => array('GROUP_ID'),
                    'filter' => array('USER_ID' => $userId)
                ));
 
                $groups = array();
                while ($row = $result->fetch())
                    $groups []= $row['GROUP_ID'];
 
                $cacheGroups[$userId] = $groups;
            }
        }
 
        return $groups;
    }

    public static function canGroupDoOperations($groupId, $fromStatus, array $operations)
    {
        if (!$operations)
        {
            throw new SystemException('provide at least one operation', 0, __FILE__, __LINE__);
        }
 
        if (!is_array($groupId))
        {
            $groupId = array($groupId);
        }
 
        if (in_array('1', $groupId, true) || \CMain::GetUserRight('sale', $groupId) >= 'W') // Admin
        {
            return true;
        }
 
        $operations = static::convertNamesToOperations($operations);
 
        $result = static::getList(array(
            'select' => array(
                'NAME' => 'Bitrix\Sale\Internals\StatusGroupTaskTable:STATUS.TASK.Bitrix\Main\TaskOperation:TASK.OPERATION.NAME',
            ),
            'filter' => array(
                '=ID' => $fromStatus,
                '=Bitrix\Sale\Internals\StatusGroupTaskTable:STATUS.GROUP_ID' => $groupId,
                '=Bitrix\Sale\Internals\StatusGroupTaskTable:STATUS.TASK.Bitrix\Main\TaskOperation:TASK.OPERATION.NAME' => $operations,
            ),
        ));
 
        while ($row = $result->fetch())
        {
            if (($key = array_search($row['NAME'], $operations)) !== false)
            {
                unset($operations[$key]);
            }
        }
 
        return !$operations;
    }

    public static function getAllowedUserStatuses($userId, $fromStatus)
    {
        return static::getAllowedGroupStatuses(static::getUserGroups($userId), $fromStatus);
    }

    protected static function getAllowedGroupStatuses($groupId, $fromStatus)
    {
        static $cacheAllowStatuses = array();
 
        if (! is_array($groupId))
            $groupId = array($groupId);
 
        $cacheKey = md5(join('|', $groupId) . "_".(is_array($fromStatus) ? join('|', $fromStatus) : $fromStatus));
 
        if (in_array('1', $groupId, true) || \CMain::GetUserRight('sale', $groupId) >= 'W') // Admin
        {
            if (!array_key_exists($cacheKey, $cacheAllowStatuses))
            {
                $result = static::getList(array(
                    'select' => array(
                        'ID',
                        'NAME' => 'Bitrix\Sale\Internals\StatusLangTable:STATUS.NAME'
                    ),
                    'filter' => array(
                        '=TYPE' => static::TYPE,
                        '=Bitrix\Sale\Internals\StatusLangTable:STATUS.LID' => LANGUAGE_ID),
                    'order'  => array(
                        'SORT'
                    ),
                ));
 
                while ($row = $result->fetch())
                {
                    $cacheAllowStatuses[$cacheKey][$row['ID']] = $row['NAME'];
                }
            }
        }
        else
        {
            if (!array_key_exists($cacheKey, $cacheAllowStatuses))
            {
                $cacheAllowStatuses[$cacheKey] = array();
 
                $dbRes = static::getList(array( // check if group can change from status
                    'select' => array('ID'),
                    'filter' => array(
                        '=ID' => $fromStatus,
                        '=TYPE' => static::TYPE,
                        '=Bitrix\Sale\Internals\StatusGroupTaskTable:STATUS.GROUP_ID' => $groupId,
                        '=Bitrix\Sale\Internals\StatusGroupTaskTable:STATUS.TASK.Bitrix\Main\TaskOperation:TASK.OPERATION.NAME' => 'sale_status_from',
                    ),
                    'limit' => 1,
                ));
 
                if ($dbRes->fetch())
                {
                    $result = static::getList(array(
                        'select' => array('ID', 'NAME' => 'Bitrix\Sale\Internals\StatusLangTable:STATUS.NAME'),
                        'filter' => array(
                            '=TYPE' => static::TYPE,
                            '=Bitrix\Sale\Internals\StatusLangTable:STATUS.LID' => LANGUAGE_ID,
                            '=Bitrix\Sale\Internals\StatusGroupTaskTable:STATUS.GROUP_ID' => $groupId,
                            '=Bitrix\Sale\Internals\StatusGroupTaskTable:STATUS.TASK.Bitrix\Main\TaskOperation:TASK.OPERATION.NAME' => 'sale_status_to',
                        ),
                        'order' => array('SORT'),
                    ));
 
                    while ($row = $result->fetch())
                    {
                        $cacheAllowStatuses[$cacheKey][$row['ID']] = $row['NAME'];
                    }
                }
            }
        }
 
        return $cacheAllowStatuses[$cacheKey] ?? [];
    }

    private static function convertNamesToOperations($names)
    {
        $operations = array();
 
        foreach ($names as $name)
        {
            $operations[] = 'sale_status_'.mb_strtolower($name);
        }
 
        return $operations;
    }

    public static function getAllStatuses()
    {
        static $statusList = [];
 
        if (!isset($statusList[static::TYPE]))
        {
            $statusList[static::TYPE] = [];
 
            $result = static::getList([
                'select' => ['ID'],
                'filter' => ['=TYPE' => static::TYPE],
                'order'  => ['SORT' => 'ASC']
            ]);
 
            while ($row = $result->fetch())
            {
                $statusList[static::TYPE][$row['ID']] = $row['ID'];
            }
        }
 
        return $statusList[static::TYPE];
    }

    public static function getAllStatusesNames($lang = null)
    {
        $parameters = [
            'select' => ["ID", "NAME" => 'Bitrix\Sale\Internals\StatusLangTable:STATUS.NAME'],
            'filter' => [
                '=TYPE' => static::TYPE,
            ],
            'order'  => ['SORT' => 'ASC']
        ];
 
        if ($lang !== null)
        {
            $parameters['filter']['=Bitrix\Sale\Internals\StatusLangTable:STATUS.LID'] = $lang;
        }
        elseif (defined("LANGUAGE_ID"))
        {
            $parameters['filter']['=Bitrix\Sale\Internals\StatusLangTable:STATUS.LID'] = LANGUAGE_ID;
        }
 
        static $allStatusesNames = [];
 
        if (!isset($allStatusesNames[static::TYPE]))
        {
            $allStatusesNames[static::TYPE] = [];
 
            $result = static::getList($parameters);
            while ($row = $result->fetch())
            {
                $allStatusesNames[static::TYPE][$row['ID']] = $row['NAME'];
            }
        }
 
        return $allStatusesNames[static::TYPE];
    }

    public static function getStatusesUserCanDoOperations($userId, array $operations)
    {
        return static::getStatusesGroupCanDoOperations(static::getUserGroups($userId), $operations);
    }

    public static function getStatusesGroupCanDoOperations($groupId, array $operations)
    {
        static $cacheStatuses = array();
 
        if (!is_array($groupId))
            $groupId = array($groupId);
 
        $cacheHash = md5(static::TYPE."|".join('_', $groupId)."|".join('_', $operations));
 
        if (!empty($cacheStatuses[$cacheHash]))
        {
            return $cacheStatuses[$cacheHash];
        }
 
        if (in_array('1', $groupId, true) || \CMain::GetUserRight('sale', $groupId) >= 'W') // Admin
        {
            $statuses = static::getAllStatuses();
        }
        else
        {
            $statuses = static::getStatusesByGroupId($groupId, $operations);
        }
 
        $cacheStatuses[$cacheHash] = $statuses;
 
        return $statuses;
    }

    private static function getStatusesByGroupId(array $groupId, array $operations = array())
    {
        $operations = static::convertNamesToOperations($operations);
 
        $parameters = array(
            'select' => array(
                'ID',
                'OPERATION' => 'Bitrix\Sale\Internals\StatusGroupTaskTable:STATUS.TASK.Bitrix\Main\TaskOperation:TASK.OPERATION.NAME',
            ),
            'filter' => array(
                '=TYPE' => static::TYPE,
                '=Bitrix\Sale\Internals\StatusGroupTaskTable:STATUS.GROUP_ID' => $groupId,
            ),
            'order'  => array('SORT'),
        );
 
        if (!empty($operations))
        {
            $parameters['filter']['=Bitrix\Sale\Internals\StatusGroupTaskTable:STATUS.TASK.Bitrix\Main\TaskOperation:TASK.OPERATION.NAME'] = $operations;
        };
 
        $statuses = array();
        $dbRes = static::getList($parameters);
        while ($row = $dbRes->fetch())
        {
            if ((string)$row['OPERATION'] === '')
            {
                continue;
            }
 
            $statuses[$row['ID']] = $row['ID'];
        }
 
        return $statuses;
    }

    public static function getInitialStatus()
    {
        throw new Main\NotImplementedException();
    }

    public static function getFinalStatus()
    {
        throw new Main\NotImplementedException();
    }

    public static function install(array $data)
    {
        if (! ($statusId = $data['ID']) || ! is_string($statusId))
        {
            throw new SystemException('invalid status ID', 0, __FILE__, __LINE__);
        }
 
        if ($languages = $data['LANG'])
        {
            unset($data['LANG']);
 
            if (!is_array($languages))
            {
                throw new SystemException('invalid status LANG', 0, __FILE__, __LINE__);
            }
        }
 
        $data['TYPE'] = static::TYPE;
 
        // install status if it is not installed
 
        if (! StatusTable::getById($statusId)->fetch())
        {
            StatusTable::add($data);
        }
 
        // install status languages if they are not installed
 
        if ($languages)
        {
            $installedLanguages = [];
 
            $result = StatusLangTable::getList([
                'select' => [
                    'LID',
                ],
                'filter' => [
                    '=STATUS_ID' => $statusId,
                ],
            ]);
 
            while ($row = $result->fetch())
            {
                $installedLanguages[$row['LID']] = true;
            }
 
            foreach ($languages as $language)
            {
                if (!is_array($language))
                {
                    throw new SystemException('invalid status language', 0, __FILE__, __LINE__);
                }
 
                if (!isset($installedLanguages[$language['LID']]))
                {
                    $language['STATUS_ID'] = $statusId;
 
                    StatusLangTable::add($language);
                }
            }
        }
    }
}