Вывести множественное свойство типа файл с названием и весом файла в Битрикс

В этой заметке расскажу как красиво вывести множественное свойство типа файл в инфоблоке 1С-Битрикс. С показом оригинального названия файла, его транслитированной версии, размера файла в килобайтах и, само собой, ссылкой на скачивание.

Исходные данные для вывода файлов

Итак, в инфоблоке каталога сайта имеем стандартное, множественное свойство "типа файл" с кодом "FILES".

Если мы его выведем, штатным способом, через вывод свойств- как оно задумано в Битрикс изначально. Выглядеть это будет не казисто и не интересно

Абсолютно не интересно и самое главное не информативно. В моем случае, в данное свойство загружаются документы. Причем они в разных форматах и разного размера. Пользователь должен видеть и название документа и его размер с форматом. Например вот так:

Выводим свойство файл через API Битрикс- получая все данные о файлах

Все достаточно просто, так как множественные свойства это обычные массивы. Мы можем получить все данные о каждом файле, просто зная код свойства, в моем случае "FILES". Выглядеть foreach будет следующим образом.

<?foreach($arResult["DISPLAY_PROPERTIES"]['FILES']['FILE_VALUE'] as $pid=>$arProperty):?>
	<?
	//echo '<pre>';print_r($arProperty);echo '</pre>';

	echo $arProperty['FILE_SIZE']; //размер файла в байтах
	echo $arProperty['FILE_NAME']; //Транслитированное название файла
	echo $arProperty['ORIGINAL_NAME']; //Оригинальное название файла
	echo $arProperty['SRC']; //Ссылка на скачивание
	>
<?endforeach?>

Расскоментировав строку
// echo '<pre>';print_r($arProperty);echo '</pre>';
Вы сможете увидеть все данные о каждом файле, доступные для вывода. По мимо основных, там есть и дата загрузки и тип файла.

В принципе и все. Конкретно в моем случае, в примере выше, результат вывода выглядет следующим образом:

<? foreach ($arResult["DISPLAY_PROPERTIES"]['FILES']['FILE_VALUE'] as $pid => $arProperty): ?>
	<a
	href="<? echo $arProperty['SRC']; ?>"
	title="Скачать <? echo $arProperty['FILE_NAME']; ?>">
		<strong>
			<? echo $arProperty['ORIGINAL_NAME']; ?>
			<span> —
				<?
				$strKb = $arProperty['FILE_SIZE']/1024;
				echo round($strKb) . ' Кб';
				?>
			</span>
		</strong>
		<i>
			<? echo $arProperty['FILE_NAME']; ?>
		</i>
	</a>
<? endforeach ?>

Несколько полезных моментов

Байты в килобаты (размер файла), я привратил, обычной php функцией округления в большую сторону round. Предварительно приведя байты в килобаты. просто разделив $arProperty['FILE_SIZE'] на 1024 (смотри в коде выше).

Иконки для разных типов файлов, назначил через CSS - тут простая стилизация. Зная расширение файла, а точнее расширенеие на которое заканчивается ссылка, просто прописал background для каждой разновидности ссылки. Вот так:

a[href$=".doc"],
a[href$=".docx"],
a[href$=".rtf"] {
    background: url("img/doc.png");
   
}

a[href$=".pdf"] {
    background: url("img/pdf.png");
}

a[href$=".xls"],
a[href$=".xlsx"] {
    background: url("img/exl.png");
}

Дополнено: вывод файла для catalog.element

Так как в компоненте и шаблоне catalog.element доступна информация, только для ID файла - те же самые данные (из текста выше), мы можем получить методом CFile::GetFileArray(). Просто передав в него ID файла.

Пример:

foreach ($arResult["PROPERTIES"]['FILES']['VALUE'] as $pid => $arProperty):
    $arFile = CFile::GetFileArray($arProperty);
    print_r($arFile);// Распечатка всего массива
endforeach