PrepareSettings

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

string
CIBlockProperty*::PrepareSettings(
	array arFields
);

Метод возвращает либо массив с дополнительными настройками свойства, либо весь набор настроек, включая стандартные. Метод статический при использовании штатных свойств. У свойств, созданных клиентом, обязан быть статическим при использовании php7.

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

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

Строка или массив. Если метод возвращает весь набор настроек, то в этом случае дополнительные настройки передаются в ключе USER_TYPE_SETTINGS в виде массива.

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

• Свойства элементов инфоблока
• GetUserTypeDescription

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

Без модификации основных полей свойства

class CIBlockPropertyMyDateTime
{
	public static function PrepareSettings($arFields): array
	{
		$fields = [];
		if (isset($arFields['USER_TYPE_SETTINGS']) && is_array($arFields['USER_TYPE_SETTINGS']))
		{
			$fields = $arFields['USER_TYPE_SETTINGS'];
		}

		$width = (int)($fields['WIDTH'] ?? 0);
		if ($width <= 0)
		{
			$width = 100;
		}
		$height = (int)($fields['HEIGHT'] ?? 0);
		if ($height <= 0)
		{
			$height = 100;
		}
        
		return [
			'WIDTH' => $width,
			'HEIGHT' => $height
		];
	}
}

С модификацией основных полей:

class CIBlockPropertyMyDate
{
	public static function PrepareSettings($fields): array
	{
		$userSettings = [];
		if (isset($fields['USER_TYPE_SETTINGS']) && is_array($fields['USER_TYPE_SETTINGS']))
		{
			$userSettings = $fields['USER_TYPE_SETTINGS'];
		}

		$userSettings['WIDTH'] = (int)($userSettings['WIDTH'] ?? 0);
		if ($userSettings['WIDTH'] <= 0)
		{
			$userSettings['WIDTH'] = 100;
		}
		$userSettings['HEIGHT'] = (int)($userSettings['HEIGHT'] ?? 0);
		if ($userSettings['HEIGHT'] <= 0)
		{
			$userSettings['HEIGHT'] = 100;
		}

		$fields['MULTIPLE'] = 'N'; // запрещаем множественность свойства
		$fields['USER_TYPE_SETTINGS'] = $userSettings;

		return $fields;
	}
}