Add

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

int
CSubscription::Add(
	array arFields,
	string SITE_ID = SITE_ID
);

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

Параметры

Требования к полям, передаваемым в arFields

• EMAIL - должно содержать правильный адрес e-mail (см. функцию check_email). Также выполняется проверка уникальности EMAIL.

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

В случае успешного добавления возвращается ID подписки. В противном случает возвращается false, и переменная класса LAST_ERROR содержит сообщение об ошибке (так же возбуждается исключение CMain::ThrowException).

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

//there must be at least one newsletter category
if(!is_array($RUB_ID) || count($RUB_ID) == 0)
	$strWarning .= "There must be at least one category."."<br>";

if($strWarning == "")
{
	$arFields = Array(
		"USER_ID" => ($USER->IsAuthorized()? $USER->GetID():false),
		"FORMAT" => ($FORMAT <> "html"? "text":"html"),
		"EMAIL" => $EMAIL,
		"ACTIVE" => "Y",
		"RUB_ID" => $RUB_ID
	);
	$subscr = new CSubscription;

	//can add without authorization
	$ID = $subscr->Add($arFields);
	if($ID>0)
		CSubscription::Authorize($ID);
	else
		$strWarning .= "Error adding subscription: ".$subscr->LAST_ERROR."<br>";
}