Использование пользовательских свойств на примере дополнительных полей в подписке.

В качестве цели мы поставим такую задачу: подписчиком будет указываться пол и в зависимости от этого выбора в письме рассылки она или он получит "Уважаемая" или "Уважаемый" в качестве обращения.

Сначала скучная часть по настройке публичной части и размещению компонент подписки. В демо данных эта работа уже выполнена мастером создания сайта. И эту часть можно пропустить.

Предполагаем наличие "Персонального раздела" пользователя в папке /personal. Если это не ваш случай, то в последующих примерах надо будет внести соответствующие изменения.

В шаблоне сайта размещаем компонент формы подписки:

1. Открыть вкладку "Разработка" (/index.php?bitrix_include_areas=Y&bitrix_show_mode=configure).
2. Открыть шаблон сайта на редактирование - "Шаблон" - "Панель управления" - "Редактировать шаблон".
3. В шаблон добавляем код вывода списка рассылок для подписки:

   <?$APPLICATION->IncludeComponent(
   	"bitrix:subscribe.form",
   	"",
   	Array()
   );?>
   

4. "Сохранить".
5. "Разработка".
6. Находим компонент и в меню компонента выбираем "Редактировать параметры компонента".
7. Параметр "Страница редактирования подписки" задаем равным "#SITE_DIR#personal/subscribe/subscr_edit.php".
8. "Сохранить".

Компонент может "жаловаться" на отсутствие рубрик подписки. Создадим одну.

1. В административной части откроем страницу "Список рассылок" (/bitrix/admin/rubric_admin.php?lang=ru)
2. "Добавить".
3. Название "Новости сайта".
4. Другие поля по вкусу.
5. "Сохранить".

Возвращаемся в режим "Разработка" в публичной части сайта, переходим в "Персональный раздел" и сбрасываем кеш ("Обновить" или /personal/index.php?clear_cache=Y&bitrix_include_areas=Y&bitrix_show_mode=configure).

Создаем раздел управления подписками:

1. "Создать" - "раздел".
• "Имя папки" - subscribe;
• Заголовок раздела - Подписка;
• "Далее";
• "Готово";
2. Открывается визуальный редактор.
• Размещаем компонент "Страница рассылок" (bitrix:subscribe.index);
• "Страница редактирования подписки" - "#SITE_DIR#personal/subscribe/subscr_edit.php";
• "Сохранить";
3. "Создать" - "Страницу".
• Имя файла - subscr_edit.php;
• разотмечаем "добавить пункт меню";
• "Далее";
• "Готово";
4. Открывается визуальный редактор.
• Размещаем компонент "Страница редактирования подписки" (bitrix:subscribe.edit);
• "Сохранить";
5. Настройка модуля.
• Публичный раздел, где находится страница редактирования подписки "#SITE_DIR#personal/subscribe/";
• Использовать HTML редактор Да;
• Отправлять картинки в виде вложений в письмо - Да;
• "Сохранить";

Можно протестировать. Подписаться на рубрику, создать и отправить выпуск.

Переходим собственно к задаче. Во первых надо определиться с идентификатором сущности к которой будут привязываться значения дополнительных свойств. Пусть это будет MY_SUBSCRIPTION. В качестве уникального идентификатора объектов этой сущности будут выступать b_subscription.ID.

На админской странице bitrix/admin/userfield_admin.php?lang=ru щелкаем по кнопке "Добавить" и получаем форму создания нового поля.

1. Тип данных - Список
2. Объект - MY_SUBSCRIPTION
3. Код поля - UF_GENDER
4. Остальные поля - не трогаем
5. "Применить"
6. Переходим на вкладку "Список"
7. Задаем возможные значения - Женский и Мужской
8. "Применить"

Кастомизируем компонент subscribe.edit. Копируем его из /bitrix/components/bitrix в папку /bitrix/components/demo и заменяем вызов на странице /personal/subscribe/subscr_edit.php на demo:subscribe.edit.

Выводим значения пользовательских свойств подписки в форме. В файле component.php после

 $arResult["ALLOW_REGISTER"] = $bAllowRegister?"Y":"N"; 

добавляем чтение значений из базы данных

 $arResult["USER_PROPERTIES"] = $GLOBALS["USER_FIELD_MANAGER"]->GetUserFields(
	"MY_SUBSCRIPTION",
	$arResult["ID"],
	LANGUAGE_ID
); 

А в файле setting.php шаблона выводим прочитанное (оформлять по вкусу):

<table> 
<?foreach ($arResult["USER_PROPERTIES"] as $FIELD_NAME => $arUserField):?> 
	<tr> 
	<td><?echo $arUserField["EDIT_FORM_LABEL"]?>:</td> 
	<td><?$APPLICATION->IncludeComponent( 
		"bitrix:system.field.edit", 
		$arUserField["USER_TYPE"]["USER_TYPE_ID"], 
		array(
			"bVarsFromForm" => false,
			"arUserField" => $arUserField
		),
		null,
		array("HIDE_ICONS"=>"Y"));?></td> 
	</tr> 
<?endforeach;?> 
</table> 

Для сохранения значений в базе данных в файле component.php после строк

if($ID>0) 
{ 
	... 
	$res = $obSubscription->Update($ID, $arFields); 
	... 
} 
else 
{ 
	... 
	$ID = $obSubscription->Add($arFields); 
	... 
} 

добавляем код установки значений свойств

if($res && $ID > 0) 
{ 
	global $USER_FIELD_MANAGER; 
	$arUserFields = $USER_FIELD_MANAGER->GetUserFields("MY_SUBSCRIPTION"); 
	$arFields = array(); 
	foreach($arUserFields as $FIELD_ID => $arField) 
		$arFields[$FIELD_ID] = $_REQUEST[$FIELD_ID]; 
	$USER_FIELD_MANAGER->Update("MY_SUBSCRIPTION", $ID, $arFields); 
} 

Для красоты у данного поля в административной части можно указать:

1. Обязательное - Да
2. Подпись - Пол

Заводим новую подписку или открываем на редактирование уже существующую и указываем пол подписчика.

Теперь соглашаемся на использование "макроса" в выпуске. Пусть #GENDER_HELLO# будет заменяться на Уважаемая/Уважаемый в зависимости от пола.

Создаем обработчик события BeforePostingSendMail (http://www.1c-bitrix.ru/api_help/subscribe/events/beforepostingsendmail.php)

<? 
// файл /bitrix/php_interface/init.php 
// регистрируем обработчик 
AddEventHandler("subscribe", "BeforePostingSendMail", Array("MyClass", "BeforePostingSendMailHandler")); 
class MyClass 
{ 
	// создаем обработчик события "BeforePostingSendMail" 
	function BeforePostingSendMailHandler($arFields) 
	{ 
		$rs = CSubscription::GetByEmail($arFields["EMAIL"]); 
		if($ar = $rs->Fetch()) 
		{ 
			global $USER_FIELD_MANAGER; 
			$arUserFields = $USER_FIELD_MANAGER->GetUserFields("MY_SUBSCRIPTION", $ar["ID"]); 

			if($arUserFields["UF_GENDER"]["VALUE"] == 1) 
				$arFields["BODY"] = str_replace("#GENDER_HELLO#", "Уважаемая", $arFields["BODY"]); 
			elseif($arUserFields["UF_GENDER"]["VALUE"] == 2) 
				$arFields["BODY"] = str_replace("#GENDER_HELLO#", "Уважаемый", $arFields["BODY"]); 
			else 
				$arFields["BODY"] = str_replace("#GENDER_HELLO#", "", $arFields["BODY"]); 
		}
		else 
		{ 
			$arFields["BODY"] = str_replace("#GENDER_HELLO#", "", $arFields["BODY"]); 
		} 
		return $arFields; 
	} 
} 
?> 

Удачи в разработке!