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

Лента


Описание 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
Наверх