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

Разделы с TOP'ом фотографий

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

В визуальном редакторе компонент расположен по пути: Контент > Фотогалерея > Разделы с TOP'ом фотографий.

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

Пример вызова компонента photo.sections.top

Секции настроек компонента:

  • Основные параметры
  • Источник данных
  • Внешний вид
  • Шаблоны ссылок
  • Настройки кеширования
  • Описание параметров

    Поле Параметр Описание
    Основные параметры
    Тип инфоблока IBLOCK_TYPE Указывается один из созданных в системе типов информационного блока.
    Инфоблок IBLOCK_ID Для выбранного типа инфоблока указывается идентификатор информационного блока, фотографии из которого будут выводиться.
    Источник данных
    Поля разделов SECTION_FIELDS Указываются поля раздела, которые будут отображены на странице TOP'а элементов. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив:
    Array("ID","CODE",""),
    При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже (т.е. если задан пустой массив) ничего отображаться не будет.
    Свойства раздела SECTION_USER_FIELDS Указываются свойства раздела, которые будут отображены на странице. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив. При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже, свойства не будут выведены.
    По какому полю сортируем разделы SECTION_SORT_FIELD Указывается поле, по которому будет происходить сортировка разделов в TOP’е элементов:
    • SORT - по индексу сортировки;
    • TIMESTAMP_X - по дате изменения;
    • NAME - по названию;
    • ID - по идентификатору;
    • DEPTH_LEVEL - по уровню вложенности папки.
    Можно указать код любого другого поля.
    Порядок сортировки разделов SECTION_SORT_ORDER Задается порядок сортировки разделов:
    • ASCПо возрастанию;
    • DESCПо убыванию.
    По какому полю сортируем фотографии ELEMENT_SORT_FIELD Указывается поле, по которому будет происходить сортировка фотографий внутри каждого раздела:
    • SHOWS – по количеству просмотров в среднем;
    • SORT – по индексу сортировки;
    • TIMESTAMP_X – по дате последнего изменения;
    • NAME – по названию;
    • ID – по идентификатору;
    • ACTIVE_FROM – по дате активности с;
    • ACTIVE_TO – по дате активности по.
    Порядок сортировки фотографий в разделе ELEMENT_SORT_ORDER Задается порядок сортировки фотографий в разделе:
    • ASCПо возрастанию;
    • DESCПо убыванию.
    Имя выходящего массива для фильтрации FILTER_NAME Задается имя переменной, в которой передается массив параметров из фильтра. Служит для определения выходящих из фильтра элементов. Поле может быть оставлено пустым, тогда используется значение по умолчанию.
    Поля FIELD_CODE Указываются поля, которые будут отображены на странице TOP'а элементов. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив:
    Array("NAME","PREVIEW_TEXT","PREVIEW_PICTURE","DETAIL_TEXT",""),
    При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже (т.е. если задан пустой массив), на странице списка будут выведены поля по умолчанию.
    Свойства PROPERTY_CODE Указываются свойства, которые будут отображены на странице TOP'а элементов. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив. При выборе пункта (не выбрано)-> и без указания вычисления полей в строках ниже, на странице детального просмотра свойства не будут выведены.
    Внешний вид
    Максимальное количество выводимых разделов SECTION_COUNT Задается максимальное количество выводимых разделов.
    Максимальное количество фотографий, выводимых в каждом разделе ELEMENT_COUNT Задается максимальное количество фотографий, выводимых в TOP’е элементов в каждом разделе.
    Количество фотографий, выводимых в одной строке таблицы LINE_ELEMENT_COUNT Указывается количество фотографий, выводимых в одной строке таблицы.
    Шаблоны ссылок
    URL, ведущий на страницу с содержимым раздела SECTION_URL Указывается адрес страницы с содержимым раздела.
    URL, ведущий на страницу с содержимым элемента раздела DETAIL_URL Указывается адрес страницы с содержимым элемента раздела.
    Настройки кеширования
    Тип кеширования CACHE_TYPE Тип кеширования:
    • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
    • Y - Кешировать: для кеширования необходимо определить время кеширования;
    • N - Не кешировать: кеширования нет в любом случае.
    Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
    Кешировать при установленном фильтре CACHE_FILTER [Y|N] При отмеченной опции каждый результат, полученный из фильтра, будет кешироваться.
    Учитывать права доступа CACHE_GROUPS [Y|N] При отмеченной опции будут учитываться права доступа при кешировании.


    © «Битрикс», 2001-2019, «1С-Битрикс», 2019
    Наверх