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

Разделы с 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
    Наверх