Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Виджет в календаре CALENDAR_GRIDVIEW». Вы узнаете экспертные методики работы с виджет календаре и научитесь избегать типичных ошибок начинающих разработчиков.
Виджет в календаре CALENDAR_GRIDVIEW
> Scope: calendar
Вы можете добавлять свой пункт в списке видов отображения календаря.
!Виджет в виде пункта в списке видов отображения календаря
Код конкретного места встройки виджета указывается в параметре PLACEMENT метода placement.bind.
Встройка не будет отображаться в интерфейсе, пока установка приложения не завершена. Проверьте установку приложения
Куда встраивается виджет
| Код встройки | Место |
|---|---|
CALENDAR_GRIDVIEW | Пункт в списке видов отображения календаря |
Что получает обработчик
Данные передаются в виде POST-запроса {.b24-info}
Array
(
[DOMAIN] => xxx.bitrix24.com
[PROTOCOL] => 1
[LANG] => en
[APP_SID] => b4f4b92b5178b5a5276e181ca09d25a7
[AUTH_ID] => be56ba6600705a0700005a4b00000001f0f107e5806d5fe9a98e02021a72e57645f86a
[AUTH_EXPIRES] => 3600
[REFRESH_ID] => aed5e16600705a0700005a4b00000001f0f107a80816604b24a8719792ac2a21d629b5
[member_id] => da45a03b265edd8787f8a258d793cc5d
[status] => L
[PLACEMENT] => CALENDAR_GRIDVIEW
[PLACEMENT_OPTIONS] => {"viewRangeFrom":"2024-08-12","viewRangeTo":"2024-08-18"}
)
PLACEMENT_OPTIONS
Значением PLACEMENT_OPTIONS является JSON-строка, содержащая массив из одного и более ключей.
| Параметр | Описание |
|---|---|
viewRangeFromdate | Начало диапазона дат, отображаемых сейчас в календаре. Может быть использован для получения списка событий для отображения в виджете с помощью метода calendar.event.get. |
viewRangeTodate | Конец диапазона дат, отображаемых сейчас в календаре. Может быть использован для получения списка событий для отображения в виджете с помощью метода calendar.event.get. |
- [](../calendar/calendar-grid-veiw)
- [](./placement-bind)
- [](./ui-interaction/index)
- [](./ui-interaction/crm-card)
- [](../../settings/interactivity/index)
- [](./open-application)
- [](./open-path)
💡 Экспертное мнение и рекомендации
Практические рекомендации:
- При написании кастомных компонентов для «Виджет в календаре CALENDAR_GRIDVIEW» всегда разделяйте бизнес-логику и представление (шаблон).
- Используйте отладку SQL-запросов через конструкцию
$wpdb->last_queryили стандартный трекер Битрикса, чтобы контролировать нагрузку.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru