Добро пожаловать в блог, где важны слова.
Тут я частенько публикую в открытым доступе полезные материаллы и готовые решения для повседневных задач по 1С-Битрикс и Битрикс24, а также затрагиваю темы всё что связано с сайтостроением
Как добавить свои параметры у компонентов 1С-Битрикс
17.02.2023
656

В файле .parameters.php содержится описание параметров для компонента. Данные файла выводятся в окне "Параметры компонента" в виде формы с полями.
Шаблон компонента залил на гитхаб https://github.com/vadimbitrix/.parameters.php
Структура файла с видеоролика.
if (!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true) die();
use \Bitrix\Main\Localization\Loc;
Loc::loadLanguageFile(__FILE__);
$arTemplateParameters = array(
"TEMPLATE_GROUPS" => Array(
"SLIDER" => Array(
"NAME" => Loc::getMessage('SLIDER'),
"SORT" => "100"
)
),
"SLIDER_ID" => Array(
"PARENT" => "SLIDER",
"NAME" => Loc::getMessage('SLIDER_ID'),
"TYPE" => "STRING",
"SORT" => "20",
),
"SLIDER_TIME" => Array(
"PARENT" => "SLIDER",
"NAME" => Loc::getMessage('SLIDER_TIME'),
"TYPE" => "STRING",
"SORT" => "20",
"DEFAULT" => "5000",
),
"SLIDER_AUTOPLAY" => Array(
"PARENT" => "SLIDER",
"NAME" => Loc::getMessage('SLIDER_AUTOPLAY'),
"TYPE" => "CHECKBOX",
"SORT" => "20",
"DEFAULT" => "N",
),
"SLIDER_DOTS" => Array(
"PARENT" => "SLIDER",
"NAME" => Loc::getMessage('SLIDER_DOTS'),
"TYPE" => "CHECKBOX",
"SORT" => "20",
"DEFAULT" => "N",
),
"SET_STATUS_404" => Array(
"HIDDEN" => "Y"
),
"SHOW_404" => Array(
"HIDDEN" => "Y"
),
"MESSAGE_404" => Array(
"HIDDEN" => "Y"
),
"NEWS_COUNT" => Array(
"PARENT" => "BASE",
"NAME" => Loc::getMessage('NEWS_COUNT')
)
);
Как видим в файле формируется массив $arTemplateParameters, в нем мы прописываем свои параметры, которые буду выводиться в рамке текущего шаблона "reviews" компонента.
Полный список настроек для параметра
"код параметра" => array(
"PARENT" => "Код группы", // если пустое - ставится ADDITIONAL_SETTINGS
"NAME" => "Название параметра на текущем языке", // рекомендуется подключение из lang файлов с помощью Loc::getMessage(),
"TYPE" => "Тип элемента управления, в котором будет устанавливаться параметр",
"REFRESH" => "Перегружать настройки или нет после выбора (N/Y)",
"MULTIPLE" => "Одиночное/Множественное значение (N/Y)",
"VALUES" => "Массив значений для списка ('TYPE' = 'LIST')",
"ADDITIONAL_VALUES" => "Показывать поле для значений, вводимых вручную (Y/N)",
"SIZE" => "Число строк для списка (если нужен не выпадающий список)",
"DEFAULT" => "Значение по умолчанию",
"COLS" => "Ширина поля в символах",
)
Ключ TYPE может принимать одно из следующих значений:
- LIST для списка
- STRING для поля ввода
- CHECKBOX для чекбокса
- CUSTOM для своих элементов управления