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

Форумы (список)


Описание forum.index

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

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

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



Параметры

Поле Параметр Описание
Основные параметры
Использовать обратную навигациюPAGER_DESC_NUMBERING[Y|N] При отмеченной опции будет использоваться обратная навигация. Для обратной навигации в системе происходит обратный отсчет страниц (последняя страница считается первой). Таким образом, постоянно меняется лишь последняя страница при добавлении нового элемента. Это верно, если новые элементы попадают всегда вверх списка (отсортированы по дате начала активности по убыванию).
ID группы форумов GID Указывается идентификатор группы форумов. Может быть задан неявно с помощью кода ={$_REQUEST["GID"]}.
Шаблоны ссылок
Страница просмотра форумов группы URL_TEMPLATES_FORUMS Указывается адрес страницы просмотра списка форумов некоторой группы.
Страница списка тем URL_TEMPLATES_LIST Указывается адрес страницы со списком тем форума. По умолчанию поле содержит list.php?FID=#FID#. Такая страница может быть создана с помощью компонента Темы (список).
Страница чтения темы URL_TEMPLATES_READ Указывается адрес страницы чтения темы форума. По умолчанию поле содержит read.php?FID=#FID#&TID=#TID#.
Страница чтения сообщения URL_TEMPLATES_MESSAGE Указывается адрес страницы просмотра сообщения форума. По умолчанию поле содержит read.php?FID=#FID#&TID=#TID#&MID=#MID#.
Страница профиля пользователя URL_TEMPLATES_PROFILE_VIEW Указывается адрес страницы просмотра профиля пользователя. По умолчанию поле содержит profile_view.php?UID=#UID#. Такая страница может быть создана с помощью компонента Пользователь (профиль).
Страница скрытых сообщений URL_TEMPLATES_MESSAGE_APPR Указывается адрес страницы с неодобренными сообщениями форума. По умолчанию поле содержит message_appr.php?FID=#FID#. Такая страница может быть создана с помощью компонента Сообщения (проверка).
Страница RSS URL_TEMPLATES_RSS Указывается адрес страницы RSS форума.
Настройки кеширования
Тип кеширования CACHE_TYPE Тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
Дополнительные настройки
Количество форумов на одной странице FORUMS_PER_PAGE Указывается количество форумов, отображаемых на одной странице. Все форумы будут выведены с помощью постраничной навигации.
Название шаблона для вывода постраничной навигации PAGE_NAVIGATION_TEMPLATE Задается название шаблона для вывода постраничной навигации. Если поле пусто, то используется шаблон по умолчанию.
Количество страниц в постраничной навигации PAGE_NAVIGATION_WINDOW Задается количество отображаемых в навигации ссылок на страницы. Если количество страниц превышает заданное число, то в навигацию будет добавлено многоточие.
Форум FID Указываются форумы, которые будут отображены в списке. Если не выбран ни один форум, то будут показаны все форумы.
Формат показа даты DATE_FORMAT Указывается формат показа даты. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Формат показа даты и времени DATE_TIME_FORMAT Указывается формат показа даты и времени. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Длина слова WORD_LENGTH Задается максимально допустимая длина словообразующих символов, следующих друг за другом. Если длина слова превысит указанное число, то символы слова будут разбавлены разрывами (при просмотре сообщений разрывы не отображаются).
Показывать навигацию (хлебные крошки) SET_NAVIGATION [Y|N] При отмеченной опции в навигационной цепочке будет отражен переход на страницу списка тем форума.
Устанавливать заголовок страницы SET_TITLE [Y|N] При отмеченной опции в качестве заголовка страницы будет установлено Форумы.
Дополнительный маркер для новых сообщений TMPLT_SHOW_ADDITIONAL_MARKER Задается текст надписи, отображаемый рядом с темой, в которой есть непрочитанные вами сообщения.
Показывать RSS SHOW_RSS [Y|N] При отмеченной опции на странице будет отображаться ссылка на RSS.
Настройки администратора
Отображать администратору выбранные форумы SHOW_FORUMS_LIST [Y|N] При отмеченной опции администратору будут показаны только те форумы, которые указаны в параметре FID.
Показывать администратору форумы других сайтов SHOW_FORUM_ANOTHER_SITE [Y|N] При отмеченной опции администратору будут показаны форумы других сайтов.


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

<?$APPLICATION->IncludeComponent("bitrix:forum.index","",Array(
		"TMPLT_SHOW_ADDITIONAL_MARKER" => "",
		"SHOW_RSS" => "Y",
		"URL_TEMPLATES_FORUMS" => "forums.php?GID=#GID#",
		"URL_TEMPLATES_LIST" => "list.php?FID=#FID#",
		"URL_TEMPLATES_READ" => "read.php?FID=#FID#&TID=#TID#",
		"URL_TEMPLATES_MESSAGE" => "read.php?FID=#FID#&TID=#TID#&MID=#MID#",
		"URL_TEMPLATES_PROFILE_VIEW" => "profile_view.php?UID=#UID#",
		"URL_TEMPLATES_MESSAGE_APPR" => "message_appr.php?FID=#FID#&TID=#TID#",
		"URL_TEMPLATES_RSS" => "rss.php?TYPE=#TYPE#&MODE=#MODE#&IID=#IID#",
		"GID" => $_REQUEST["GID"],
		"FORUMS_PER_PAGE" => "10",
		"PAGE_NAVIGATION_TEMPLATE" => "",
		"PAGE_NAVIGATION_WINDOW" => "",
		"FID" => Array(),
		"DATE_FORMAT" => "d.m.Y",
		"DATE_TIME_FORMAT" => "d.m.Y H:i:s",
		"WORD_LENGTH" => "50",
		"SHOW_FORUMS_LIST" => "Y",
		"SHOW_FORUM_ANOTHER_SITE" => "Y",
		"SET_NAVIGATION" => "Y",
		"SET_TITLE" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "0"
	),
);?>


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

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

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

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

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