Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Дополнительные поля». Вы узнаете экспертные методики работы с дополнительные поля и научитесь избегать типичных ошибок начинающих разработчиков.
Дополнительные поля
Тут может не хватать некоторых данных — дополним в ближайшее время
- нужны правки под стандарт написания
- не указаны типы параметров
- не указана обязательность параметров
- не прописаны ссылки на несозданные ещё страницы
На чтение поля получаются через метод landing.site.getadditionalfields.
Предупреждение
Ниже указаны коды полей, которые для записи в сущность необходимо указывать в массиве с ключом ADDITIONAL. Например,
Ниже указаны коды полей, которые для записи в сущность необходимо указывать в массиве с ключом ADDITIONAL. Например,
ADDITIONAL_FIELDS: {UP_SHOW: 'Y'}.| Поле | Описание | Чтение | Запись |
|---|---|---|---|
THEME_CODEunknown | Цветовая палитра. Описание тем | Да | Да |
THEME_CODE_TYPOunknown | Настройки шрифтов. | Да | Да |
B24BUTTON_CODEunknown | Идентификатор виджета на сайт. Передается JS-путь до виджета. Например, https://cdn.bitrix24.com/crm/loader_2_ibikwq.js | Да | Да |
B24BUTTON_COLORunknown | Цвет виджета, может принимать значения: — site (использовать основной цвет сайта); — button (использовать цвет из настроек виджета). | Да | Да |
UP_SHOWunknown | Показывать ли кнопку Вверх: Y/N. | Да | Да |
Фоновая картинка
| Поле | Описание | Чтение | Запись |
|---|---|---|---|
BACKGROUND_USEunknown | Использовать функционал: Y/N | Да | Да |
BACKGROUND_PICTUREunknown | Путь до изображения. | Да | Да |
BACKGROUND_POSITIONunknown | Позиционирование: center (растянуть), repeat (замостить). | Да | Да |
BACKGROUND_COLORunknown | Цвет фона. | Да | Да |
Аналитика
| Поле | Описание | Чтение | Запись |
|---|---|---|---|
YACOUNTER_USEunknown | Использовать Яндекс.Метрику: Y/N. | Да | Да |
YACOUNTER_COUNTERunknown | Код счетчика Яндекс.Метрики. | Да | Да |
GACOUNTER_USEunknown | Использовать Google Analytics: Y/N. | Да | Да |
GACOUNTER_COUNTERunknown | Код счетчика Google Analytics. | Да | Да |
GACOUNTER_SEND_CLICKunknown | Отправлять данные о кликах по кнопкам и ссылкам в Google Analytics. | Да | Да |
GACOUNTER_SEND_SHOWunknown | Отправлять данные о просмотре блоков страницы в Google Analytics. | Да | Да |
GTM_USEunknown | Использовать Google Tag Manager. | Да | Да |
GTM_COUNTERunknown | Код Google Tag Manager. | Да | Да |
Карты
| Поле | Описание | Чтение | Запись |
|---|---|---|---|
GMAP_USEunknown | Использовать Google Карты: Y/N. | Да | Да |
GMAP_CODEunknown | Код Google Карты. | Да | Да |
Представление сайта
| Поле | Описание | Чтение | Запись |
|---|---|---|---|
VIEW_USEunknown | Использовать представление: Y/N. | Да | Да |
VIEW_TYPEunknown | Тип представления: — no (без представления), — ltr (отступ сверху и по бокам), — all (отступ со всех сторон). | Да | Да |
Robots.txt
| Поле | Описание | Чтение | Запись |
|---|---|---|---|
ROBOTS_USEunknown | Показывать свой Robots.txt: Y/N. | Да | Да |
ROBOTS_CONTENTunknown | Контент robots.txt | Да | Да |
Пользовательский HTML
| Поле | Описание | Чтение | Запись |
|---|---|---|---|
HEADBLOCK_USEunknown | Использовать: Y/N. | Да | Да |
HEADBLOCK_CODEunknown | Блок HEAD, произвольный html. | Да | Да |
Пользовательский CSS
| Поле | Описание | Чтение | Запись |
|---|---|---|---|
CSSBLOCK_USEunknown | Использовать: Y/N. | Да | Да |
CSSBLOCK_CODEunknown | Произвольный CSS-код. | Да | Да |
CSSBLOCK_FILEunknown | Ссылка на CSS-файл. | Да | Да |
💡 Экспертное мнение и рекомендации
Советы эксперта по интеграции:
- Всегда используйте кэширование при частых запросах к дополнительные поля, чтобы разгрузить базу данных.
- Соблюдайте стандарты PSR при написании обработчиков для «Дополнительные поля».
- Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
Написать во ВКонтакте
или на почту: gorandvas@yandex.ru
