Документация для разработчиков
Недоступно в редакциях: Старт

Темы (список внешний)

Компонент выводит список тем (для использования вне форума). Компонент стандартный и входит в дистрибутив модуля.

В визуальном редакторе компонент находится в Компоненты > Общение > Форум.

Компонент относится к модулю Форум.

Пример вызова компонента forum.topic.last

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

  • Основные параметры
  • Шаблоны ссылок
  • Настройки кеширования
  • Дополнительные настройки
  • Настройки вывода первого сообщения темы
  • Настройки постраничной навигации
  • Описание параметров

    Поле Параметр Описание
    Дополнительно
    Показывать навигацию SHOW_NAV Указывается способ отображения постраничной навигации по темам:
    • сверху (TOP);
    • снизу (BOTTOM).
    Если ничего не выбрано, то постраничная навигация выведена не будет.
    Показывать колонки SHOW_COLUMNS Параметр служит для выбора полей, которые будут выведены для каждой темы в виде таблицы. В публичной части редактора поля выбираются, удерживая CTRL. В коде задаются в виде массива, например:

    "SHOW_COLUMNS" => Array("USER_START_NAME","POSTS","LAST_POST_DATE"),
    Показывать сортировку SHOW_SORTING [Y|N] При отмеченной опции в публичной части будет доступна сортировка тем.
    Шаблон-разделитель для темы и форума SEPARATE Указывается шаблон-разделитель для темы и форума. Например, в форуме «#FORUM#».
    Основные параметры
    ID форума FID Указываются форумы, которые будут отображены в списке. Если не выбран ни один форум, то будут показаны все форумы.
    Поле для сортировки SORT_BY Указывается порядок сортировки тем в списке:
    • по заголовку - Заголовок (TITLE);
    • по автору - Автор (USER_START_NAME);
    • по количеству ответов - Ответы (POSTS);
    • по количеству просмотров - Прочитано (VIEWS);
    • по дате последнего сообщения - Последнее сообщение (LAST_POST_DATE).
    Направление сортировки SORT_ORDER Задается направление для сортировки тем:
    • ASCПо возрастанию;
    • DESCПо убыванию.
    Показывать вверху прикрепленные темы SORT_BY_SORT_FIRST [Y|N] При отмеченной опции прикрепленные темы будут показаны вверху списка.
    Шаблоны ссылок
    Страница списка форумов URL_TEMPLATES_INDEX Указывается адрес страницы со списком форумов. По умолчанию поле содержит index.php. Такая страница может быть создана с помощью компонента Форумы (список).
    Страница списка тем URL_TEMPLATES_LIST Указывается адрес страницы со списком тем форума. По умолчанию поле содержит list.php?FID=#FID#. Такая страница может быть создана с помощью компонента Темы (список).
    Страница чтения темы URL_TEMPLATES_READ Указывается адрес страницы чтения темы форума. По умолчанию поле содержит read.php?FID=#FID#&TID=#TID#&MID=#MID#. Такая страница может быть создана с помощью компонента Тема (чтение).
    Страница чтения сообщения URL_TEMPLATES_MESSAGE Указывается адрес страницы чтения сообщения форума. По умолчанию поле содержит message.php?FID=#FID#&TID=#TID#&MID=#MID#. Такая страница может быть создана с помощью компонента PM (чтение).
    Страница профиля пользователя URL_TEMPLATES_PROFILE_VIEW Указывается адрес страницы просмотра профиля пользователя. По умолчанию поле содержит profile_view.php?UID=#UID#. Такая страница может быть создана с помощью компонента Пользователь (профиль).
    Настройки кеширования
    Тип кеширования CACHE_TYPE Тип кеширования:
    • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
    • Y - Кешировать: для кеширования необходимо определить время кеширования;
    • N - Не кешировать: кеширования нет в любом случае.
    Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
    Дополнительные настройки
    Количество тем на одной странице TOPICS_PER_PAGE Указывается количество тем форума, отображаемых на одной странице. Все темы будут выведены с помощью постраничной навигации.
    Формат показа даты и времени DATE_TIME_FORMAT Указывается формат показа даты и времени. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
    Показывать форумы других сайтов SHOW_FORUM_ANOTHER_SITE [Y|N] При отмеченной опции администратору будут показаны форумы других сайтов.
    Устанавливать заголовок страницы SET_TITLE [Y|N] При отмеченной опции в качестве заголовка страницы будет установлено Список тем.
    Настройки вывода первого сообщения темы
    Сообщение темы SHOW_TOPIC_POST_MESSAGE Выбор сообщения, которое будет отображаться первым. Доступные опции:
    • не показывать
    • показывать первое сообщение темы При выборе данной опции станут доступны дополнительные поля:
      Максимальная длина сообщения TOPIC_POST_MESSAGE_LENGHT Задается максимальное число символов, используемых для написания сообщения.
      Размер рисунков в тексте сообщения (px) IMAGE_SIZE Задается сторона квадрата, в который с сохранением пропорций будет включено изображение.
      Позволить HTML-код ALLOW_HTML При выборе данной опции в сообщения можно будет вставить код html .
      Позволить ссылки ALLOW_ANCHOR При выборе данной опции в сообщения можно будет вставить ссылки.
      Позволить изображения ALLOW_IMG Разрешить использование изображений в тексте сообщения. Изображения располагаются на сторонних сайтах и подключаются на форуме (<img src=...>)
      Позволить видео ALLOW_VIDEO При выборе данной опции к сообщениям можно будет прикреплять видео.
      Позволить списки ALLOW_LIST При выборе данной опции к сообщениям можно будет прикреплять видео.
      Позволить цитирование ALLOW_QUOTE Возможность цитировать сообщение другого пользователя ().
      Позволить коды ALLOW_CODE Возможность использования кодов в сообщении (<code>).
      Позволить выравнивание ALLOW_ALIGN Разрешить использование выравнивания текста.
      Позволить таблицы ALLOW_TABLE Разрешить использование таблиц (<table>).
      Позволить шрифты ALLOW_FONT Возможность изменения цвета текста и шрифт (<font color=...>).
      Позволить смайлы ALLOW_SMILES Возможность использования смайлов в сообщении.
      Заменять символ перевода каретки на <br> ALLOW_NL2BR замена символа перевода каретки на <br> (Доступно только при отмеченной опции HTML-код).
    • показывать последнее сообщение темы При выборе данной опции станут доступны дополнительные поля:
      Максимальная длина сообщения TOPIC_POST_MESSAGE_LENGHT Задается максимальное число символов, используемых для написания сообщения.
      Размер рисунков в тексте сообщения (px) IMAGE_SIZE Задается сторона квадрата, в который с сохранением пропорций будет включено изображение.
      Позволить HTML-код ALLOW_HTML При выборе данной опции в сообщения можно будет вставить код html .
      Позволить ссылки ALLOW_ANCHOR При выборе данной опции в сообщения можно будет вставить ссылки.
      Позволить изображения ALLOW_IMG Разрешить использование изображений в тексте сообщения. Изображения располагаются на сторонних сайтах и подключаются на форуме (<img src=...>)
      Позволить видео ALLOW_VIDEO При выборе данной опции к сообщениям можно будет прикреплять видео.
      Позволить списки ALLOW_LIST При выборе данной опции к сообщениям можно будет прикреплять видео.
      Позволить цитирование ALLOW_QUOTE Возможность цитировать сообщение другого пользователя ().
      Позволить коды ALLOW_CODE Возможность использования кодов в сообщении (<code>).
      Позволить выравнивание ALLOW_ALIGN Разрешить использование выравнивания текста.
      Позволить таблицы ALLOW_TABLE Разрешить использование таблиц (<table>).
      Позволить шрифты ALLOW_FONT Возможность изменения цвета текста и шрифт (<font color=...>).
      Позволить смайлы ALLOW_SMILES Возможность использования смайлов в сообщении.
      Заменять символ перевода каретки на <br> ALLOW_NL2BR замена символа перевода каретки на <br> (Доступно только при отмеченной опции HTML-код).
    Настройки постраничной навигации
    Показывать навигацию SET_NAVIGATION [Y|N] При отмеченной опции в навигационной цепочке будет отражен переход на страницу списка тем форума.
    Использовать обратную навигацию PAGER_DESC_NUMBERING [Y|N] При отмеченной опции будет использоваться обратная навигация. Для обратной навигации в системе происходит обратный отсчет страниц (последняя страница считается первой). Таким образом, постоянно меняется лишь последняя страница при добавлении нового элемента. Это верно, если новые элементы попадают всегда вверх списка (отсортированы по дате начала активности по убыванию).
    Выводить всегда PAGER_SHOW_ALWAYS [Y|N] При отмеченной опции постраничная навигации будет выводиться, даже если все элементы помещаются на одной странице.
    Название категорий PAGER_TITLE Задается название категорий, по которым происходит перемещение при постраничной навигации (например, тема, сообщение и др.)
    Название шаблона PAGER_TEMPLATE Задается название шаблона для вывода постраничной навигации. Если поле пусто, то используется шаблон по умолчанию.


    Пользовательские комментарии

    Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

    Для этого нужно всего лишь авторизоваться на сайте

    Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

    Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
    © «Битрикс», 2001-2019, «1С-Битрикс», 2019
    Наверх