Документация для разработчиков
Темная тема

Лента


Описание news.line

Одностраничный компонент, осуществляющий вывод списка элементов инфоблоков с датой и заголовком со ссылкой на страницу с подробной информацией. Компонент стандартный и входит в дистрибутив модуля.

В визуальном редакторе компонент расположен по пути: Контент > Статьи и новости > Лента.

Компонент относится к модулю Информационные блоки.



Параметры

Поле Параметр Описание
Основные параметры
Тип информационного блока (используется только для проверки) IBLOCK_TYPE Указывается один из созданных в системе типов информационного блока.
Код информационного блока IBLOCKS Для выбранного типа инфоблока указывается идентификатор информационного блока, новости из которого будут выводиться.
Количество новостей на странице NEWS_COUNT Указывается количество новостей, отображаемых на одной странице.
Источник данных
Поля FIELD_CODE Данные элемента, которые могут выводиться в ленте новостей. (Требуется кастомизация шаблона.)
  • ID – ID;
  • CODE – символьный код;
  • XML_ID – XML_ID;
  • NAME – название;
  • TAGS – теги;
  • SORT – сортировка;
  • PREVIEW_TEXT – текст анонса;
  • PREVIEW_PICTURE – картинка анонса;
  • DETAIL_TEXT – детальный текст;
  • DETAIL_PICTURE – детальная картинка.
  • DATE_ACTIVE_FROM – начало активности (дата);
  • ACTIVE_FROM – начало активности (время);
  • DATE_ACTIVE_TO – окончание активности (дата);
  • ACTIVE_TO – окончание активности (время);
  • SHOW_COUNTER – количество показов;
  • SHOW_COUNTER_START – дата первого показа;
  • IBLOCK_TYPE_ID – тип информаионного блока;
  • IBLOCK_ID – ID информационного блока;
  • IBLOCK_CODE – символьный код информационного блока;
  • IBLOCK_NAME – название информационного блока;
  • IBLOCK_EXTERNAL_ID – внешний код информационного блока;
  • DATE_CREATE – дата создания;
  • CREATED_BY – кем создан (ID);
  • CREATED_USER_NAME – дата изменения;
  • MODIFIED_BY – кем изменен (ID);
  • USER_NAME – кем изменен (имя).
Поле для первой сортировки новостей SORT_BY1 Поле для первой сортировки новостей:
  • ID – по идентификатору;
  • NAME – по заголовку;
  • ACTIVE_FORM – по дате начала активности;
  • SORT – по индексу сортировки;
  • TIMESTAMP_X – по дате последнего изменения.
Выбрав пункт (другое)->, можно сформировать свой вариант поля для первой сортировки новостей.
Направление для первой сортировки новостей SORT_ORDER1 Задается направление для первой сортировки новостей:
  • ASCПо возрастанию;
  • DESCПо убыванию.
Поле для второй сортировки новостей SORT_BY2 Поле для второй сортировки новостей:
  • ID – по идентификатору;
  • NAME – по заголовку;
  • ACTIVE_FORM – по дате начала активности;
  • SORT – по индексу сортировки;
  • TIMESTAMP_X – по дате последнего изменения.
Выбрав пункт (другое)->, можно сформировать свой вариант поля для второй сортировки новостей.
Направление для второй сортировки новостей SORT_ORDER2 Задается направление для второй сортировки новостей:
  • ASCПо возрастанию;
  • DESCПо убыванию.
Шаблоны ссылок
URL, ведущий на страницу с содержимым элемента раздела DETAIL_URL Задается адрес, ведущий на страницу с детальной информацией элемента раздела (по умолчанию - из настроек инфоблока).
Настройки кеширования
Тип кеширования CACHE_TYPE Тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
Учитывать права доступа CACHE_GROUPS [Y|N] При отмеченной опции будут учитываться права доступа при кешировании.
Дополнительные настройки
Формат показа даты ACTIVE_DATE_FORMAT Указывается формат показа даты. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.


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

<?$APPLICATION->IncludeComponent("bitrix:news.line","",Array(
		"IBLOCK_TYPE" => "news",
		"IBLOCKS" => Array("3"),
		"NEWS_COUNT" => "20",
		"FIELD_CODE" => Array("ID", "CODE"),
		"SORT_BY1" => "ACTIVE_FROM",
		"SORT_ORDER1" => "DESC",
		"SORT_BY2" => "SORT",
		"SORT_ORDER2" => "ASC",
		"DETAIL_URL" => "news_detail.php?ID=#ELEMENT_ID#",
		"ACTIVE_DATE_FORMAT" => "d.m.Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "300",
		"CACHE_GROUPS" => "Y"
	)
);?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024