Download the PHP package ge1i0n/bitrix-options without Composer
On this page you can find all versions of the php package ge1i0n/bitrix-options. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package bitrix-options
Bitrix Options - генератор форм настроек в административной панели Битрикс
Поддержка версий
BitrixOptions | mpm.options | php |
---|---|---|
1.0+ | 1.0+ | 7.0+ |
1.0+, 2.0+ | 2.0+ | 8.1+ |
Установка через маркетплейс
- Установить модуль mpm.options из маркетплейса bitrix.
- Создать файл настроек модуля (options.php или подобный)
- Подключить модуль и вызвать генератор формы, передав нужные параметры
Установка через composer
-
Установить пакет
ge1i0n/bitrix-options
- Создать файл настроек модуля (options.php или подобный)
- Подключить вызвать генератор, передав нужные параметры
Пример установки в свой модуль для маркетплейса
- Скопировать пакет к себе в модуль
- Зарегистрировать классы модуля в файле
include.php
, прописав вручную корректные пути к классам, или загрузив автолоадером. Зарегистрировать вручную можно например так:
🧩 Новые типы полей (v2.x)
Поле | Назначение |
---|---|
Date |
Поле Text с типом date |
Email |
Поле Text с типом email |
Heading |
Поле, выводящий заголовок |
Select |
Замена полям Dropdown и Multiselect |
Дополнительные, свои типы полей больше не нужно регистрировать отдельно, можете использовать их непосредственно в конструкторе формы.
Схема работы
На странице настроек необходимо вызвать генератор формы, в который передаётся id вашего модуля.
Вторым параметром в генератор формы передаётся массив табов на странице формы. Необходимо передать как минимум один таб, для корректной генерации и заполнения страницы.
В таб, вторым параметром передаётся массив полей для отображения. В отличие от первой версии пакета - порядок задаётся не полем сортировки, а непосредственно порядком передачи в массиве.
Типы полей
Общая информация
Все типы полей отображается через статичный метод make()
, в который передаётся один или два параметра - ключ в базе
данных и строка для вывода пояснения.
Для типов полей который выводят данные, но ничего не хранят, передаётся один параметр.
В случае передачи одного параметра в поля, которые отображают данные настроек ключ будет использован как строка
пояснения.
Также, все методы, которые наследуются от поля Text имеют общие Fluent методы. Они будут описаны только в текстовом
поле, повторяться не будут.
Заголовок
Новый тип поля, заменяющий группы полей в предыдущей версии модуля. Больше нет необходимости делать группировку, просто выведите заголовок в нужном месте, передав в него текст для вывода.
Предупреждение
Вывод информационного сообщения, с настраиваемым размером, расположением текста и иконкой. Поле можно модифицировать через текучий интерфейс, передав в методы Enum необходимых значений свойств. документации Bitrix
Текст
Вывод простого текстового поля - базовый компонент для большинства других полей. Поле можно модифицировать через текучий интерфейс, передав в методы Enum, необходимых значений, сами значения, а иногда и замыкания в зависимости от типа свойства.
Дата
Вывод поля для даты - текстовое поле, но с типом date.
Вывод поля для электронной почты - текстовое поле, но с типом email.
Number
Вывод поля для чисел - текстовое поле, но с типом number.
Имеет три дополнительных метода min()
, max()
, step()
.
Checkbox
Вывод переключателя, основан на текстовом поле.
Хранит значения в базе в формате Y
и N
, выводится в виде чекбокса.
ColorPicker
Вывод поля для выбора цвета, основано на текстовом поле.
Имеет два дополнительных метода cols()
, rows()
.
Обратите внимание - при сохранении страницы, но не выбранном цвете по-умолчанию будет всегда сохраняться чёрный цвет.
Textarea
Поле для ввода многострочного ввода данных, основано на текстовом поле. На данный момент реализованы все способы изменять состояния поля, но не все они ведут себя корректно.
Select
Селектор для выбора значений из списка, основано на текстовом поле.
Имеет три дополнительных метода options()
- для передачи опций выбора, size()
- для передачи атрибута size,
multiple()
- для включения множественного выбора.
HtmlEditor
Текстовый редактор, с возможностью переключаться между типами text, html и визуальный редактор.
Condition
Поле выбора условий, основанное на классе CCatalogCondTree.
📚 Дополнительно
- Документация по UI Bitrix: dev.1c-bitrix.ru
All versions of bitrix-options with dependencies
ext-mbstring Version *