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

Темы (список)


Описание forum.topic.list

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

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

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



Параметры

Поле Параметр Описание
Основные параметры
ID форума FID Указывается идентификатор форума, явно или в виде кода. По умолчанию поле содержит ={$_REQUEST["FID"]}.
Использовать обратную постраничку USE_DESC_PAGE [Y|N] При отмеченной опции будет использоваться обратная постраничная навигация для списка тем.
Шаблоны ссылок
Страница списка форумов URL_TEMPLATES_INDEX Указывается адрес страницы со списком форумов. По умолчанию поле содержит index.php. Такая страница может быть создана с помощью компонента Форумы (список).
Страница просмотра форумов группы URL_TEMPLATES_FORUMS Указывается адрес страницы просмотра списка форумов группы форумов. По умолчанию поле содержит forums.php?GID=#GID#.
Страница списка тем 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#.
Страница профиля пользователя URL_TEMPLATES_PROFILE_VIEW Указывается адрес страницы просмотра профиля пользователя. По умолчанию поле содержит profile_view.php?UID=#UID#. Такая страница может быть создана с помощью компонента Пользователь (профиль).
Страница списка скрытых сообщений URL_TEMPLATES_MESSAGE_APPR Указывается адрес страницы с неодобренными сообщениями форума. По умолчанию поле содержит message_appr.php?FID=#FID#. Такая страница может быть создана с помощью компонента Сообщения (проверка).
Страница создания новой темы URL_TEMPLATES_TOPIC_NEW Указывается адрес страницы создания новой темы. По умолчанию поле содержит topic_new.php?FID=#FID#. Такая страница может быть создана с помощью компонента Тема (создание).
Страница подписки URL_TEMPLATES_SUBSCR_LIST Указывается адрес страницы подписки на форум. По умолчанию поле содержит subscr_list.php?FID=#FID#. Такая страница может быть создана с помощью компонента Подписка (список).
Страница переноса тем URL_TEMPLATES_TOPIC_MOVE Указывается адрес страницы переноса темы форума. По умолчанию поле содержит topic_move.php?FID=#FID#&TID=#TID#. Такая страница может быть создана с помощью компонента Темы (перемещение).
Страница RSS URL_TEMPLATES_RSS Указывается адрес страницы RSS форума. По умолчанию поле содержит rss.php?TYPE=#TYPE#&MODE=#MODE#&IID=#IID#.
Настройки кеширования
Тип кеширования CACHE_TYPE Тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
Дополнительные настройки
Порядковый номер постраничной навигации PAGEN Параметр определяет порядковый номер постраничной навигации на странице.
Количество тем на одной странице TOPICS_PER_PAGE Указывается количество тем форума, отображаемых на одной странице. Все темы будут выведены с помощью постраничной навигации.
Количество сообщений на одной странице MESSAGES_PER_PAGE Указывается количество сообщений, отображаемых на одной странице. Все сообщения будут выведены с помощью постраничной навигации.
Формат показа даты DATE_FORMAT Указывается формат показа даты. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Формат показа даты и времени DATE_TIME_FORMAT Указывается формат показа даты и времени. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Название шаблона для вывода постраничной навигации PAGE_NAVIGATION_TEMPLATE Указывается название шаблона для вывода постраничной навигации. Если поле пусто, то используется шаблон по умолчанию.
Количество страниц в постраничной навигации PAGE_NAVIGATION_WINDOW Задается количество отображаемых в навигации ссылок на страницы. Если количество страниц превышает заданное число, то в навигацию будет добавлено многоточие.
Показывать навигацию SET_NAVIGATION [Y|N] При отмеченной опции в навигационной цепочке будет отражен переход на страницу списка тем форума.
Длина слова WORD_LENGTH Задается максимально допустимая длина словообразующих символов, следующих друг за другом. Если длина слова превысит указанное число, то символы слова будут разбавлены разрывами (при просмотре сообщений разрывы не отображаются).
Устанавливать заголовок страницы SET_TITLE [Y|N] При отмеченной опции в качестве заголовка страницы будет установлено название форума, список тем которого просматривается.
Дополнительный маркер для новых сообщений TMPLT_SHOW_ADDITIONAL_MARKER Задается текст надписи, отображаемый рядом с темой, в которой есть непрочитанные вами сообщения.
Показывать RSS SHOW_RSS [Y|N] При отмеченной опции на странице будет отображаться ссылка на RSS.
Не индексировать ссылку на профиль SEO_USER [Y|N] При отмеченной опции поисковые боты не смогут индексировать ссылки на профиль пользователя.


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

<?$APPLICATION->IncludeComponent("bitrix:forum.topic.list","",Array(
		"TMPLT_SHOW_ADDITIONAL_MARKER" => "",
		"SHOW_RSS" => "Y",
		"SEO_USER" => "Y",
		"FID" => $_REQUEST["FID"],
		"USE_DESC_PAGE" => "Y",
		"URL_TEMPLATES_INDEX" => "index.php",
		"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" => "message.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#",
		"URL_TEMPLATES_TOPIC_NEW" => "topic_new.php?FID=#FID#",
		"URL_TEMPLATES_SUBSCR_LIST" => "subscr_list.php?FID=#FID#",
		"URL_TEMPLATES_TOPIC_MOVE" => "topic_move.php?FID=#FID#&TID=#TID#",
		"URL_TEMPLATES_RSS" => "rss.php?TYPE=#TYPE#&MODE=#MODE#&IID=#IID#",
		"PAGEN" => "1",
		"TOPICS_PER_PAGE" => "10",
		"MESSAGES_PER_PAGE" => "10",
		"DATE_FORMAT" => "d.m.Y",
		"DATE_TIME_FORMAT" => "d.m.Y H:i:s",
		"PAGE_NAVIGATION_TEMPLATE" => "",
		"PAGE_NAVIGATION_WINDOW" => "11",
		"SET_NAVIGATION" => "Y",
		"WORD_LENGTH" => "50",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "0",
		"SET_TITLE" => "Y"
	),
);?>


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

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

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

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

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