Документация для разработчиков
Темная тема

Add

Описание

int
CIBlockSection::Add(
	array arFields, 
	bool bResort = true,
	bool bUpdateSearch = true,
	bool bResizePictures = false
);

Метод добавляет новый раздел в информационный блок. Перед добавлением раздела вызываются обработчики события OnBeforeIBlockSectionAdd из которых можно изменить значения полей или отменить добавление раздела вернув сообщение об ошибке. После добавления раздела вызывается событие OnAfterIBlockSectionAdd. Нестатический метод.

Смотрите также

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

ПараметрОписание С версии
arFields Массив вида Array("поле"=>"значение", ...), содержащий значения полей раздела инфоблоков.

Пользовательские свойства UF_XXX можно тоже занести в массив и они будут добавляться.
bResort Флаг, указывающий пересчитывать ли правую и левую границы после изменения (поля LEFT_MARGIN и RIGHT_MARGIN).

Примечание: настоятельно рекомендуется не устанавливать значение false.
3.2.1
bUpdateSearch Флаг, указывающий, что раздел должен быть проиндексирован для поиска сразу же после сохранения. 4.0.6
bResizePictures Использовать настройки инфоблока для обработки изображений. По умолчанию настройки не применяются. Если этот параметр имеет значение true, то к полям PICTURE и DETAIL_PICTURE будут применены правила генерации и масштабирования в соответствии с настройками информационного блока. 9.0.4

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

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

Примеры использования

<?
$bs = new CIBlockSection;
$arFields = Array(
	"ACTIVE" => $ACTIVE,
	"IBLOCK_SECTION_ID" => $IBLOCK_SECTION_ID,
	"IBLOCK_ID" => $IBLOCK_ID,
	"NAME" => $NAME,
	"SORT" => $SORT,
	"PICTURE" => $_FILES["PICTURE"],
	"DESCRIPTION" => $DESCRIPTION,
	"DESCRIPTION_TYPE" => $DESCRIPTION_TYPE
);
if($ID > 0)
{
	$res = $bs->Update($ID, $arFields);
}
else
{
	$ID = $bs->Add($arFields);
	$res = ($ID>0);
}
if(!$res)
  echo $bs->LAST_ERROR;
?>


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Александр Фаст
Сообщение не промодерировано, возможны ошибки и неточности.
Цитата
пишет:
$ID - это что?
Это видимо вырезали из кода, где сначала проверяли, существует ли такой раздел
0
Константин Веремьев
Сообщение не промодерировано, возможны ошибки и неточности.
$ID - это что?
4
Дмитрий Воеводин
Если необходимо задать параметры SEO при создании раздела, то в массив $arFields нужно добавить:
Код
$arFields["IPROPERTY_TEMPLATES"] = array(    "SECTION_META_TITLE" => $arLevel["Title"],
    "SECTION_META_KEYWORDS" => $arLevel["Keywords"],
    "SECTION_META_DESCRIPTION" => $arLevel["Description"],
);
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх