FCIBlockElement::GetElementGroups

Описание

Метод статический: Возвращает список групп (разделов) инфоблока, к которым принадлежит элемент с указанным идентификатором. Переопределяет базовый метод CIBlockElement::GetElementGroups и поддерживает мультиязычность: при передаче параметра $LANGUAGE_ID или по языку сайта возвращаются переведённые названия разделов.

Сигнатура метода

Code Copy code

CIBlockResult
FCIBlockElement::GetElementGroups(
 int $ID,
 bool $bElementOnly = false,
 array $arSelect = [],
 string $LANGUAGE_ID = LANGUAGE_ID
);

Параметры вызова

Параметр	Описание	С версии
ID	Идентификатор элемента инфоблока, для которого необходимо получить группы.	2.5.765
bElementOnly	Если `true` — возвращаются только группы, напрямую связанные с элементом. Если `false` — возвращаются также родительские группы по иерархии.	2.5.765
arSelect	Массив полей, которые необходимо выбрать у разделов. Например, `['ID', 'NAME']`.	2.5.765
LANGUAGE_ID	Код языка, на котором следует вернуть переведённые данные. Если не указан — используется текущий язык сайта.	2.5.765

Возвращаемое значение

Метод возвращает объект CIBlockResult, содержащий список разделов инфоблока, в которых размещён элемент. При передаче параметра $LANGUAGE_ID названия групп возвращаются на соответствующем языке (если переводы доступны). Используйте GetNext() для перебора.

Пример

Code Copy code

// Получаем группы элемента на английском языке
$elementID = 123;
$arSelect = ['ID', 'NAME'];
$LANG = 'en';

$res = FCIBlockElement::GetElementGroups($elementID, false, $arSelect, $LANG);

while ($arGroup = $res->GetNext()) {
    echo $arGroup["NAME"] . "<br>";
}

Примечание: Метод полезен при построении хлебных крошек, генерации ссылок и определении размещения элемента в структуре инфоблока. Поддержка мультиязычности упрощает вывод в различных языковых версиях сайта.

Описание метода CIBlockElement::GetElementGroups в официальной документации Битрикс

Количество показов: 556
Дата изменения: 23.06.2025 14:13:45