https://github.com/webarchitect609/bitrix-user-type

Битрикс - свои типы пользовательских свойств.
https://github.com/webarchitect609/bitrix-user-type

bitrix composer composer-library php

Last synced: 8 days ago
JSON representation

Битрикс - свои типы пользовательских свойств.

• Host: GitHub
• URL: https://github.com/webarchitect609/bitrix-user-type
• Owner: webarchitect609
• Created: 2018-04-04T16:49:06.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-09-03T12:41:07.000Z (4 months ago)
• Last Synced: 2024-10-04T00:35:38.749Z (3 months ago)
• Topics: bitrix, composer, composer-library, php
• Language: PHP
• Size: 74.2 KB
• Stars: 12
• Watchers: 5
• Forks: 5
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Awesome Lists containing this project

README

        
Набор типов пользовательских свойств, а также базовый функционал, призванный максимально упростить и 

ускорить разработку новых типов пользовательских свойств.  

**Пока нестабильная версия - будьте внимательны!**

Если вы хотите [создавать свои типы свойств элемента инфоблока, то вам нужен пакет webarchitect609/bitrix-iblock-property-type](https://packagist.org/packages/webarchitect609/bitrix-iblock-property-type)

Как использовать

----------------

1 Установить через composer 

`composer require webarchitect609/bitrix-user-type`

2 В init.php как можно раньше(выше) инициализировать используемые типы пользовательских свойств (подробнее - см.

"Известные проблемы" #1). Например, 

`\WebArch\BitrixUserPropertyType\IblockSectionLinkType::init();`

Либо воспользоваться менеджером:

```php

init();

```

3 Теперь можно создавать новые пользовательские поля, выбрав свойство нового типа!

Список пользовательских свойств пакета

--------------------------------------

* "Гиперссылка". Пользовательское свойство, реализующее валидную гиперссылку. `WebArch\BitrixUserPropertyType\HyperLinkType`

* "Привязка к разделу инфоблока(с окном поиска)". Позволяет удобно указать раздел, выбрав его из всплывающего окна. `WebArch\BitrixUserPropertyType\IblockSectionLinkType`

* "День недели". Позволяет реализовать привязку к дню недели (ISO-8601). `WebArch\BitrixUserPropertyType\WeekDayType`

* "Привязка к складу". Реализует привязку к складу по его XML_ID. `WebArch\BitrixUserPropertyType\StoreListType`

* "Привязка к местоположению". Реализует привязку к местоположению Bitrix по его коду.

 `WebArch\BitrixUserPropertyType\LocationType`

Как разработать свой тип свойства

---------------------------------

1 Наследовать свой тип от базовой реализации `\WebArch\BitrixUserPropertyType\Abstraction\UserTypeBase` или 

самостоятельно реализовать интерфейс `\WebArch\BitrixUserPropertyType\Abstraction\UserTypeInterface`.   

2 Определить обязательный статический метод `getDBColumnType()`, используя один из подходящих трейтов из namespace 

`WebArch\BitrixUserPropertyType\Abstraction\DbColumnType`

3 Определить другие обязательные методы, такие как `getBaseType()`, `getDescription()` и т.д., которые требует 

`\WebArch\BitrixUserPropertyType\Abstraction\UserTypeInterface`

4 При необходимости реализации других поддерживаемых методов следует рассмотреть и реализовать интерфейсы из namespace 

`\WebArch\BitrixUserPropertyType\Abstraction\Custom`

5 Инициализировать свой тип свойства в init.php

`MyUserType::init();`

6 Теперь можно создавать новые пользовательские поля, выбрав свойство нового типа!

Известные проблемы

------------------

##### #1 Ошибка "Bitrix\Main\SystemException: Unknown field definition `UF_YOUR_TYPE`" при работе с HL-блоками или общая ошибка неинициализации типа пользовательского свойства.

###### Возможная причина

Инициализация типа пользовательского свойства в `init.php` происходит позже, чем сборка сущности для любого HL-блока

`\Bitrix\Highloadblock\HighloadBlockTable::compileEntity()`, которая в свою очередь приводит к вызову

`\CUserTypeManager::GetUserType()` и набору кеша в `\CUserTypeManager::$arUserTypes`, который больше не обновлятся и в

который не попадают никакие вновь инициализированные типы пользовательских полей.

###### Способ устранения

Инициализация типов пользовательских свойств должна происходить раньше, чем самый первый вызов

`\Bitrix\Highloadblock\HighloadBlockTable::compileEntity()` или `\CUserTypeManager::GetUserType()`.