API Битрикс

Группы пользователей — не только контейнер для прав доступа в интерфейсе, но и сущность, которой можно управлять программно: создавать новые группы динамически, настраивать их права из кода, автоматически включать пользователей в нужные группы по бизнес-логике. Разберём класс CGroup. Создание группы программно <?php $group = new CGroup; $groupId = $group->Add([ ‘ACTIVE’ => ‘Y’, ‘C_SORT’ => 100, ‘NAME’ => ‘VIP-клиенты’, ‘DESCRIPTION’ =>…

До появления удобной обёртки Bitrix\Main\Data\Cache в D7, ручное кеширование в Битриксе строилось на классе CPHPCache. Он до сих пор встречается в старом коде и в некоторых сценариях остаётся рабочим вариантом. Разберём его устройство и чем он отличается от современной обёртки. Базовое использование <?php $cache = new CPHPCache; $cacheTime = 3600; $cacheId = ‘my_data_’ . $categoryId; $cacheDir = ‘/my_module/category/’; if ($cache->InitCache($cacheTime,…

CIBlockElement::GetByID — самый частый способ получить один конкретный элемент инфоблока, когда его идентификатор уже известен: на странице детального просмотра товара, при обработке AJAX-запроса с ID в параметрах, при работе с элементом внутри обработчика события. Базовый вызов <?php $result = CIBlockElement::GetByID($elementId); if ($element = $result->GetNext()) { echo $element[‘NAME’]; echo $element[‘DETAIL_TEXT’]; } Метод возвращает объект результата даже для одного элемента — обращение…

Вывод полного дерева разделов каталога — меню категорий, фильтр в боковой панели, карта сайта — требует рекурсивного обхода структуры разделов инфоблока. Разберём, как правильно построить такое дерево через GetList, избегая типичной ловушки N+1 запросов. Наивный рекурсивный подход (неэффективный) <?php function getSectionsTreeNaive(int $iblockId, int $parentId = 0): array { $tree = []; $result = CIBlockSection::GetList( [‘SORT’ => ‘ASC’], [‘IBLOCK_ID’ => $iblockId,…

«Письмо не пришло» — жалоба, за которой может стоять с десяток разных причин: от неправильного шаблона до банальной попадания в спам. Разберём системный порядок диагностики недоставленных писем в 1С-Битрикс, от самого вероятного к менее очевидному. Шаг 1. Проверка очереди писем Первым делом стоит проверить раздел Сервисы → Почтовые события → Просмотр событий — если письмо вообще не появилось в списке…

Стандартных переменных штатных почтовых событий (заказ, регистрация) часто не хватает для нестандартной коммуникации — собственное событие с собственным набором полей закрывает эту потребность. Разберём, как зарегистрировать почтовое событие с произвольными переменными и передать в него нужные данные. Регистрация нового типа почтового события Собственное почтовое событие регистрируется через административную панель в разделе Сервисы → Почтовые события → Типы почтовых событий, где…

Защита изображений товаров от копирования конкурентами или продвижение бренда через логотип на каждой фотографии — типичная причина добавлять водяной знак при загрузке. Разберём, как реализовать автоматическое нанесение водяного знака на изображения в 1С-Битрикс. Обработчик события при сохранении файла <?php use Bitrix\Main\EventManager; EventManager::getInstance()->addEventHandler( ‘main’, ‘OnAfterFileSave’, function ($fileId) { $file = CFile::GetByID($fileId)->Fetch(); if (in_array($file[‘CONTENT_TYPE’], [‘image/jpeg’, ‘image/png’], true)) { addWatermark($file); } } );…

CUser::Update изменяет данные существующего пользователя из кода — и в этом же методе кроется распространённая проблема: он способен молча перезаписать поля, которые вы не собирались трогать, если структура передаваемого массива задумана неверно. Базовый вызов <?php $user = new CUser; $result = $user->Update($userId, [ ‘NAME’ => ‘Иван’, ‘LAST_NAME’ => ‘Петров’, ‘UF_PHONE’ => ‘+79001234567’, ]); if (!$result) { echo ‘Ошибка: ‘ ….

CFile::SaveFile ожидает массив в определённом формате — но не всегда исходные данные приходят готовым файлом с диска. Разберём CFile::MakeFileArray, который упрощает подготовку такого массива из пути или URL, избавляя от ручного формирования структуры вручную. Базовое использование с локальным путём <?php $fileArray = CFile::MakeFileArray(‘/path/to/local/image.jpg’); $fileId = CFile::SaveFile($fileArray, ‘catalog’); MakeFileArray берёт на себя формирование массива с нужными ключами (name, type, tmp_name, size)…

CUser::Add создаёт пользователя из кода — в обход штатной формы регистрации на сайте. Метод нужен при импорте базы клиентов, при создании учётной записи после оформления гостевого заказа или при синхронизации с внешней системой. Базовый вызов <?php $user = new CUser; $fields = [ ‘LOGIN’ => ‘ivan_petrov’, ‘EMAIL’ => ‘ivan@example.com’, ‘PASSWORD’ => ‘x7K9mPq2’, ‘CONFIRM_PASSWORD’ => ‘x7K9mPq2’, ‘NAME’ => ‘Иван’, ‘LAST_NAME’ =>…