Пользовательские свойства

1C-Битрикс: Управление сайтом

Пользовательские свойства модуля информационных блоков позволяют изменять представление (формы ввода и т.п.) стандартных свойств расширяя их возможности. Фактически такое свойство представляет собой набор обработчиков событий вызываемых при построении административного интерфейса, публичной части сайта или API функций.

При первом обращении к методам пользовательских свойств вызываются обработчики события OnIBlockPropertyBuildList. Строится список свойств и при необходимости вызываются их методы.

Примеры конкретной реализации свойств можно посмотреть в файлах модуля информационных блоков classes/general/prop_*.php

Методы класса

Метод	Описание
GetUserTypeDescription	Описание свойства
CheckFields	Проверка правильности значения
GetLength	Проверка длинны значения
ConvertToDB	Сохранение в БД
ConvertFromDB	Извлечение из БД
GetPropertyFieldHtml	Отображение в форме редактирования
GetAdminListViewHTML	Показ в списке
GetPublicViewHTML	Отображение в публичной части
GetPublicEditHTML	Редактирование в публичной части
GetSearchContent	Индексация значений
PrepareSettings	Сохранение настроек
GetSettingsHTML	Редактирование настроек

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

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

Добавлять комментарии могут только зарегистрированные пользователи. Сообщения для просмотра появляются после модерации.

EvGenius 17.02.2009 10:37:11

Часто возникает необходимость привязывать пользовательские свойства к комментариям блогов, форумов или любым другим объектам, которые по умолчанию не поддерживают пользовательские свойства. В таких случаях может помочь использование недокументированных возможностей системы.
Поясним на примере комментариев блога. Создаем с помощью админки пользовательское свойство нужного типа (Настройки->Настройки продукта->Пользовательские поля). Заполняем все, как обычно, но в поле "Объект" указываем "BLOG_COMMENT" (или любое другое придуманное имя объекта, лишь бы оно было уникально).
Для считывания и записи значений пользовательских свойств можно использовать следующие функции:

Код

function GetUserField ($entity_id, $value_id, $property_id) 
{ 
      $arUF = $GLOBALS["USER_FIELD_MANAGER"]->GetUserFields ($entity_id, $value_id); 
      return $arUF[$property_id]["VALUE"]; 
} 

function SetUserField ($entity_id, $value_id, $uf_id, $uf_value) 
{ 
   return $GLOBALS["USER_FIELD_MANAGER"]->Update ($entity_id, $value_id, 
      Array ($uf_id => $uf_value)); 
}

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

Код
SetUserField ("BLOG_COMMENT", $CommentID, "UF_RATING", $Rating);

Код
echo "Рейтинг комментария: ".GetUserField ("BLOG_COMMENT", $CommentID, "UF_RATING");

Данный подход, конечно, не так удобен, как использование функций GetList для объектов с "врожденной" поддержкой кастомных свойств. Однако, он позволяет максимально быстро и просто использовать в самописных компонентах и модулях пользовательские свойства для произвольных объектов.

0 Maxim Smirnov 20.03.2009 11:17:15
Комментарий выше относится к пользовательским типам главного модуля.

Евгений Петухов 29.03.2009 07:07:44

Если необходимо добавить пользовательское свойство к разделу инфоблока через механизм Битрикс-API, нужно использовать следующий код с вариациями:

Код

$arFields = Array(
"ENTITY_ID" => "IBLOCK_2_SECTION",
"FIELD_NAME" => "UF_TITLE",
"USER_TYPE_ID" => "string",
"EDIT_FORM_LABEL" => Array("ru"=>"заголовок", "en"=>"title")
);
$obUserField  = new CUserTypeEntity;
$obUserField->Add($arFields);

FIELD_NAME - обязательное поле и должно быть заполнено строго в верхнем регистре, иначе словите ошибку.
Возможные типы пользовательских полей (USER_TYPE_ID):
"enumeration"->Список
"double"->Число
"boolean"->Да/Нет
"string"->Строка
"file"->Файл
"datetime"->Дата/Время
"iblock_section"->Привязка к разделам инф. блоков
"integer"->Целое число
Список полей для каждого из этих типов можно сверить с формой редактирования в панели управления (смотрим подсказку и name="" в исходном HTML-коде).

Пользовательские свойства(6.0.0)

Методы класса

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