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

Add

Описание и параметры

int
CForumNew::Add(
	array arFields
);

Создает новый форум с параметрами, указанными в массиве arFields. Возвращает код созданного форума. Метод статический.

Параметры функции

ПараметрОписание
arFields Массив вида Array(field1=>value1[, field2=>value2 [, ..]]), где

field - название поля;
value - значение поля.

Поля перечислены в списке полей форума. Обязательные поля должны быть заполнены.

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

Возвращает код созданного форума. В случае ошибки добавления возвращает False.

Параметр GROUP_ID задает права доступа группам пользователей к создаваемому форуму. Ключ массива - ID группы пользователей, значение - один из следующих вариантов:
A - нет доступа
E - чтение
I - ответ
M - новая тема
Q - модерирование
U - редактирование
Y - полный доступ.

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

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

<?
CModule::IncludeModule("forum");
$arFields = Array(
	"NAME" => "Название форума", 
	"DESCRIPTION" => "Описание форума (м.б. пустым, м.б. html-код)",
	"FORUM_GROUP_ID" => 0,
	"GROUP_ID" => array(1 => "Y", 2 => "I"), 
	"SITES" => array(), // заполняется ниже
	"ACTIVE" => "Y", 
	"MODERATION" => "N",
	"INDEXATION" => "Y",
	"SORT" => 150,
	"ASK_GUEST_EMAIL" => "N",
	"USE_CAPTCHA" => "N",
	"ALLOW_HTML" => "N",
	"ALLOW_ANCHOR" => "Y",
	"ALLOW_BIU" => "Y",
	"ALLOW_IMG" => "Y",
	"ALLOW_VIDEO" => "Y",
	"ALLOW_LIST" => "Y",
	"ALLOW_QUOTE" => "Y",
	"ALLOW_CODE" => "Y",
	"ALLOW_FONT" => "Y",
	"ALLOW_SMILES" => "Y",
	"ALLOW_UPLOAD" => "Y", 
	"ALLOW_UPLOAD_EXT" => "",
	"ALLOW_TOPIC_TITLED" => "N", 
	"EVENT1" => "forum"
);
   
$db_res = CSite::GetList($lby="sort", $lorder="asc");
while ($res = $db_res->Fetch()):
	$arFields["SITES"][$res["LID"]] = "/".$res["LID"]."/forum/#FORUM_ID#/#TOPIC_ID#/";
endwhile;
$res = CForumNew::Add($arFields);
if (intVal($res) > 0):
	echo "New Forum ID: ".$res;
else:
	$e = $GLOBALS['APPLICATION']->GetException();
	if ($e && $str = $e->GetString()):
		echo "Error: ".$str;
	else:
		echo "Unknown Error";
	endif;
endif;
?>
Короткий пример добавления форума c обязательными полями:
 
<?
CModule::IncludeModule("forum");
$arFields = Array(
	"NAME" => "Имя форума",
	"GROUP_ID" => array(1 => "Y", 2 => "I"), 
	"SITES" => array(
		"ru" => "/url/"
	)
);
$res = CForumNew::Add($arFields);
?>


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх