Недоступно в редакциях: Старт			
									Форум (комплексный компонент)
Комплексный компонент позволяет создать полноценный публичный интерфейс форума. Компонент стандартный и входит в дистрибутив модуля.
Описание forum
В компоненте используется неотключаемая обратная навигация. Поэтому число списка тем может не совпадать с числом установленным в поле Количество тем на одной странице.
В визуальном редакторе компонент находится в Компоненты > Общение > Форум.
Компонент относится к модулю Форум.
Внимание! Компонент поддерживает два режима настройки: простой и расширенный. Расширенный предоставляет более обширные средства настройки.
Параметры. Простой режим
Параметры. Расширенный режим
| Поле | Параметр | Описание | |||||||||||||||||||||||||||||
| Настройки шаблона | |||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Темы | THEME | Выбирается одна из восьми доступных тем оформления шаблона. | |||||||||||||||||||||||||||||
| Показывать теги | SHOW_TAGS | [Y|N] При отмеченной опции будут отображаться теги форума. | |||||||||||||||||||||||||||||
| Как показывать имя пользователя (seo) | SEO_USER |  Выбор формы показа имени пользователя: 
  |  |||||||||||||||||||||||||||||
| Использовать внешний сервис для перевода названия темы (seo) | SEO_USE_AN_EXTERNAL_SERVICE | [Y|N] При отмеченной опции название темы будет переведено автоматически внешним сервером. | |||||||||||||||||||||||||||||
| Показывать список пользователей | SHOW_FORUM_USERS | [Y|N] При отмеченной опции в меню форума будет показываться ссылка Пользователи, ведущая на страницу со списком пользователей системы. | |||||||||||||||||||||||||||||
| Показывать ссылку "Подписка" в верхнем меню | SHOW_SUBSCRIBE_LINK | [Y|N] При отмеченной опции отображается ссылка "Подписка", ведущая на страницу управления подпиской на темы и сообщения. | |||||||||||||||||||||||||||||
| Показывать форму авторизации | SHOW_AUTH_FORM | [Y|N] Если опция отмечена, то отображаются ссылки "Войти" для неавторизованного пользователя и "Выйти" - для авторизованного. | |||||||||||||||||||||||||||||
| Показывать навигационную цепочку | SHOW_NAVIGATION | [Y|N] При отмеченной опции в навигационную цепочку включается название форума. | |||||||||||||||||||||||||||||
| Показывать легенду | SHOW_LEGEND | [Y|N] Отображается легенда на страницах просмотра форума и списков форумов для иконок "новых сообщений" и статусов тем. | |||||||||||||||||||||||||||||
| Показывать блоки статистики | SHOW_STATISTIC_BLOCK | [Y|N] При отмеченной опции в нижней части форума будут выводиться блоки:
  |  	|||||||||||||||||||||||||||||
| Показывать форумы для быстрого доступа | SHOW_FORUMS | [Y|N] При установленной опции появится окно с выпадающим списком форумов сайта для быстрого перехода между форумами. | |||||||||||||||||||||||||||||
| Всегда показывать первое сообщение темы (при отключенной опции будет использоваться значение из настроек форума) | SHOW_FIRST_POST | [Y|N] При перемещении по страницам темы всегда будет отображаться первое сообщение темы над сообщениями страницы. | |||||||||||||||||||||||||||||
| Показывать колонку "Автор" в списке тем | SHOW_AUTHOR_COLUMN | [Y|N] Отображается колонка с именем автора темы. Имя автора темы под названием темы исчезает. | |||||||||||||||||||||||||||||
| Дополнительный маркер для новых сообщений | TMPLT_SHOW_ADDITIONAL_MARKER | Задается текст надписи, отображаемый рядом с темой, в которой есть непрочитанные вами сообщения. | |||||||||||||||||||||||||||||
| Название шаблона для вывода постраничной навигации | PAGE_NAVIGATION_TEMPLATE | Указывается шаблон, используемый для постраничной навигации. Разработчик может сам создать собственный шаблон и разместить его в папке www\bitrix\templates\.default\components\bitrix\system.pagenavigation\forum\. |  	|||||||||||||||||||||||||||||
| Количество страниц в постраничной навигации | PAGE_NAVIGATION_WINDOW | Задается количество отображаемых в навигации ссылок на страницы. Если количество страниц превышает заданное число, то в навигацию будет добавлено многоточие. | |||||||||||||||||||||||||||||
| Использовать AJAX в диалогах | AJAX_POST | [Y|N] При отмеченной опции будет использоваться технология AJAX при добавлении, скрытии/показе и удалении сообщений на форуме. | |||||||||||||||||||||||||||||
| Длина фразы (если "0", то фраза не обрезается) | WORD_WRAP_CUT | Параметр предназначен для текста сообщения и только на индексной странице форума. Указывается действие со словом, длина которого превышает заявленную. 
        
  |  	|||||||||||||||||||||||||||||
| Длина слова | WORD_LENGTH | Задается максимально допустимая длина символов, следующих друг за другом. Если длина слова превысит указанное число, то символы слова будут разбавлены разрывами (при просмотре сообщений разрывы не отображаются). | |||||||||||||||||||||||||||||
| Настройки поиска | |||||||||||||||||||||||||||||||
| Искать без учета морфологии (при отсутствии результата поиска) | RESTART | [Y|N] Если опция отмечена, то будет отключен морфологический поиск (морфологический поиск предполагает поиск по полному совпадению слова с запросом). | |||||||||||||||||||||||||||||
| Отключить обработку слов как логических операторов | NO_WORD_LOGIC | [Y|N] При отмеченной опции слова (и, или, не) не будут использоваться как логические операторы. | |||||||||||||||||||||||||||||
| Основные параметры | |||||||||||||||||||||||||||||||
| Использовать простой режим настройки | USE_LIGHT_VIEW | [Y|N] При отмеченной опции используется простой режим настройки компонента, а в противном случае - расширенный. | |||||||||||||||||||||||||||||
| Показывать только выбранные форумы | FID | Указываются форумы, которые должны быть показаны. | |||||||||||||||||||||||||||||
| Показывать пользовательские поля в профиле | USER_PROPERTY | Указываются дополнительные пользовательские свойства, которые будут отображены в профиле пользователя форума. | |||||||||||||||||||||||||||||
| Показывать пользовательские поля сообщения | USER_FIELDS | Указываются пользовательские поля сообщения. | |||||||||||||||||||||||||||||
| Путь к файлу, содержащему "Помощь по форуму" (при пустом поле ввода будет использовано значение по умолчанию) | HELP_CONTENT | Указывается путь к файлу, содержащему помощь по форуму (при пустом поле ввода будет использовано значение по умолчанию). | |||||||||||||||||||||||||||||
| Путь к файлу, содержащему "Правила форума" (при пустом поле ввода будет использовано значение по умолчанию) | RULES_CONTENT | Указывается путь к файлу, содержащему правила форума (при пустом поле ввода будет использовано значение по умолчанию). | |||||||||||||||||||||||||||||
| Управление адресами страниц | |||||||||||||||||||||||||||||||
| Включить поддержку ЧПУ | SEF_MODE | [Y|N] При отмеченной опции будет включена поддержка ЧПУ. 
         Если режим поддержки ЧПУ включен, то необходимо настроить следующие параметры 
 Если режим поддержки ЧПУ выключен, то необходимо настроить параметр VARIABLE_ALIASES 
  |  	|||||||||||||||||||||||||||||
| Проверять корректность шаблонов пути | CHECK_CORRECT_PATH_TEMPLATES | [Y|N] При отмеченной опции выполняется проверка корректности путей, указанных в параметрах. При обнаружении ошибок происходит автоматическая замена используемого шаблон на шаблон по умолчанию. | |||||||||||||||||||||||||||||
| Настройки кеширования | |||||||||||||||||||||||||||||||
| Тип кеширования | CACHE_TYPE | Тип кеширования:
	    
  | 
	|||||||||||||||||||||||||||||
| Время кеширования (сек.) | CACHE_TIME | Время кеширования, указанное в секундах. | |||||||||||||||||||||||||||||
| Время кеширования списка пользователей на форуме (сек.) | CACHE_TIME_USER_STAT | Время кеширования списка пользователей, указанное в секундах. | |||||||||||||||||||||||||||||
| Время кеширования статистики (сек.) | CACHE_TIME_FOR_FORUM_STAT | Время кеширования кеширования статистики форума, указанное в секундах. | |||||||||||||||||||||||||||||
| Время кеширования RSS-ленты (сек.) | RSS_CACHE | Время кеширования ленты RSS, указанное в секундах. | |||||||||||||||||||||||||||||
| Дополнительные настройки | |||||||||||||||||||||||||||||||
| Количество форумов на одной странице | FORUMS_PER_PAGE | Указывается количество форумов, отображаемых на одной странице. | |||||||||||||||||||||||||||||
| Количество тем на одной странице | TOPICS_PER_PAGE | Указывается количество тем, отображаемых на одной странице. | |||||||||||||||||||||||||||||
| Количество сообщений на одной странице | MESSAGES_PER_PAGE | Указывается количество сообщений, отображаемых на одной странице. | |||||||||||||||||||||||||||||
| Путь к форме авторизации | PATH_TO_AUTH_FORM | Задается путь к форме авторизации. Если не задан, то будет использовано значение по умолчанию (/auth.php). | |||||||||||||||||||||||||||||
| Период для отображения статистики (сек.) | TIME_INTERVAL_FOR_USER_STAT | Указывается период времени в секундах, за который показывается статистика форума. | |||||||||||||||||||||||||||||
| Формат показа даты | DATE_FORMAT | Указывается формат показа даты. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date. | |||||||||||||||||||||||||||||
| Формат показа даты и времени | DATE_TIME_FORMAT | Указывается формат показа даты и времени. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date. | |||||||||||||||||||||||||||||
| Использовать указанный формат имени | USE_NAME_TEMPLATE | [Y|N] При отмеченной опции будет использоваться формат имени, указанный ниже. | |||||||||||||||||||||||||||||
| Формат имени | NAME_TEMPLATE | Указывается шаблон для отображения ФИО пользователя. По умолчанию - значение Формат сайта (т.е используются значение Формат имени, указанное в закладке Параметры страницы Редактирование сайта). Указав пункт другое->, можно задать свой шаблон. Допустимы шаблоны: #NAME# - имя, #LAST_NAME# - фамилия, #SECOND_NAME# - отчество, #NAME_SHORT#, #LAST_NAME_SHORT#, #SECOND_NAME_SHORT# - сокращенные до одной буквы имя, фамилия и отчество. | |||||||||||||||||||||||||||||
| Размер рисунков в сообщении (px) | IMAGE_SIZE | Задается сторона квадрата, в который с сохранением пропорций будет включено изображение. Указывается в пикселях. | |||||||||||||||||||||||||||||
| Как показывать прикрепленные рисунки (под сообщением) | ATTACH_MODE | Задается форма отображения прикрепленных рисунков (под сообщением).  Доступные формы:
  |  	|||||||||||||||||||||||||||||
| По умолчанию показывать невизуальный режим редактора | EDITOR_CODE_DEFAULT | [Y|N] При отмеченной опции при создании или редактировании сообщения будет включен режим показа BB-кодов. (Пример: [B]сообщение[/B] вместо сообщение). | |||||||||||||||||||||||||||||
| Могут отправлять письмо (e-mail) из профиля | SEND_MAIL | Указываются пользователи, которые могут отправлять письмо (e-mail) из профиля: 		 
        
  |  	|||||||||||||||||||||||||||||
| Дополнять навигацию (хлебные крошки) | SET_NAVIGATION | [Y|N] При отмеченной опции в навигационной цепочке будет отражен переход на страницу списка тем форума. | |||||||||||||||||||||||||||||
| Устанавливать заголовок страницы | SET_TITLE | [Y|N] При отмеченной опции в качестве заголовка страницы будет установлено Форумы. | |||||||||||||||||||||||||||||
| Устанавливать мета-тег 'Description' из первого сообщения темы | SET_DESCRIPTION | [Y|N] При отмеченной опции в коде страницы будет дописываться мета-тег 'Description' с содержанием первого сообщения темы. | |||||||||||||||||||||||||||||
| Устанавливать теги и описание темы в свойства страницы | SET_PAGE_PROPERTY | [Y|N] При отмеченной опции теги и описание темы будут установлена в качестве свойств страницы. | |||||||||||||||||||||||||||||
| Настройки администратора | |||||||||||||||||||||||||||||||
| Показывать администратору форумы других сайтов | SHOW_FORUM_ANOTHER_SITE | [Y|N] При отмеченной опции администратору будут показаны форумы других сайтов системы. | |||||||||||||||||||||||||||||
| Настройки RSS | |||||||||||||||||||||||||||||||
| Разрешить RSS | USE_RSS | [Y|N] При отмеченной опции становится возможным экспорт данных в формате RSS и появляются дополнительные поля настройки RSS. | |||||||||||||||||||||||||||||
| Использовать спецификации | RSS_TYPE_RANGE | Указываются форматы экспорта данных форума, которые необходимо отобразить: 	 
        
  |  	|||||||||||||||||||||||||||||
| Количество элементов для экспорта | RSS_COUNT | Указывается количество элементов для экспорта. | |||||||||||||||||||||||||||||
| Название ленты (при пустом поле ввода будет использовано значение по умолчанию) | RSS_TN_TITLE | Задается название ленты RSS (при пустом поле ввода будет использовано значение по умолчанию). | |||||||||||||||||||||||||||||
| Описание ленты (при пустом поле ввода будет использовано значение по умолчанию) | RSS_TN_DESCRIPTION | Задается описание ленты RSS (при пустом поле ввода будет использовано значение по умолчанию). | |||||||||||||||||||||||||||||
| Настройки опросов | |||||||||||||||||||||||||||||||
| Разрешить опросы | SHOW_VOTE | [Y|N] При отмеченной опции будет выведен опрос. Создание опроса доступно только при создании новой темы на форуме. При выборе данной опции станут доступны 
		
			дополнительные поля.
			
				
                    
                     
  |  	|||||||||||||||||||||||||||||
| Настройки рейтинга | |||||||||||||||||||||||||||||||
| Включить рейтинг | SHOW_RATING | Указывается включать ли вывод рейтинга:
                
  | Примечание: С версии 17.5.4 добавлена поддержка рейтингов с реакциями.  |  	||||||||||||||||||||||||||||
| Рейтинг | RATING_ID | Указывается какой будет использоваться рейтинг. | |||||||||||||||||||||||||||||
| Вид кнопок рейтинга | RATING_TYPE | Указывается тип кнопки рейтинга:
                
  |  	|||||||||||||||||||||||||||||
Примечание: Если в группе Управление адресами страниц в полях Страница чтения темы форума (read) и Страница чтения сообщения (message), а также в Шаблоне пути к сообщению на сайте, изменить переменную символьного идентификатора темы 
#TID# (#TOPIC_ID#) на #TITLE_SEO#, то при изменении названия темы форума в адресной строке браузера будет отображаться уже новый вариант ссылки, при этом этот адрес будет индексироваться.Пример вызова
<?$APPLICATION->IncludeComponent("bitrix:forum","",Array(
		"THEME" => "green",
		"SHOW_TAGS" => "Y",
		"SHOW_AUTH_FORM" => "Y",
		"SHOW_NAVIGATION" => "Y",
		"SHOW_SUBSCRIBE_LINK" => "Y",
		"SHOW_LEGEND" => "Y",
		"SHOW_STATISTIC_BLOCK" => array("STATISTIC", "BIRTHDAY", "USERS_ONLINE"),
		"SHOW_NAME_LINK" => "Y",
		"SHOW_FORUMS" => "Y",
		"SHOW_FIRST_POST" => "Y",
		"SHOW_AUTHOR_COLUMN" => "Y",
		"TMPLT_SHOW_ADDITIONAL_MARKER" => "",
		"SMILES_COUNT" => "100",
		"PATH_TO_SMILE" => "/bitrix/images/forum/smile/",
		"PATH_TO_ICON" => "/bitrix/images/forum/icon/",
		"PAGE_NAVIGATION_TEMPLATE" => "forum",
		"PAGE_NAVIGATION_WINDOW" => "5",
		"AJAX_POST" => "Y",
		"WORD_WRAP_CUT" => "23",
		"WORD_LENGTH" => "50",
		"SEO_USER" => "Y",
		"USE_LIGHT_VIEW" => "N",
		"SEF_MODE" => "Y",
		"CHECK_CORRECT_TEMPLATES" => "Y",
		"FID" => array("3", "4", "5"),
		"USER_PROPERTY" => array(),
		"FILES_COUNT" => "5",
		"HELP_CONTENT" => "",
		"RULES_CONTENT" => "",
		"FORUMS_PER_PAGE" => "20",
		"TOPICS_PER_PAGE" => "20",
		"MESSAGES_PER_PAGE" => "25",
		"PATH_TO_AUTH_FORM" => "",
		"TIME_INTERVAL_FOR_USER_STAT" => "10",
		"DATE_FORMAT" => "d.m.Y",
		"DATE_TIME_FORMAT" => "d.m.Y H:i:s",
		"IMAGE_SIZE" => "500",
		"EDITOR_CODE_DEFAULT" => "N",
		"SEND_MAIL" => "E",
		"SEND_ICQ" => "A",
		"SET_NAVIGATION" => "Y",
		"SET_TITLE" => "Y",
		"SET_DESCRIPTION" => "Y",
		"SET_PAGE_PROPERTY" => "Y",
		"SHOW_FORUM_USERS" => "Y",
		"USE_RSS" => "Y",
		"SHOW_FORUM_ANOTHER_SITE" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "3600",
		"CACHE_TIME_USER_STAT" => "60",
		"CACHE_TIME_FOR_FORUM_STAT" => "3600",
		"RSS_TYPE_RANGE" => array("RSS1", "RSS2", "ATOM"),
		"RSS_CACHE" => "1800",
		"RSS_COUNT" => "30",
		"RSS_TN_TITLE" => "",
		"RSS_TN_DESCRIPTION" => "",
		"SHOW_VOTE" => "Y",
		"VOTE_CHANNEL_ID" => "3",
		"VOTE_GROUP_ID" => array("1", "5"),
		"VOTE_COUNT_QUESTIONS" => "10",
		"VOTE_COUNT_ANSWERS" => "20",
		"VOTE_TEMPLATE" => "light",
		"VOTE_UNIQUE" => array("8"),
		"VOTE_UNIQUE_IP_DELAY" => "10 D",
		"SHOW_RATING" => "Y",
		"RATING_ID" => array("3", "4"),
		"RATING_TYPE" => "standart",
		"SEF_FOLDER" => "/communication/forum/",
		"SEF_URL_TEMPLATES" => Array(
			"index" => "index.php",
			"list" => "forum#FID#/",
			"read" => "forum#FID#/topic#TID#/",
			"message" => "messages/forum#FID#/topic#TID#/message#MID#/",
			"help" => "help/",
			"rules" => "rules/",
			"message_appr" => "message/approve/forum#FID#/topic#TID#/",
			"message_move" => "message/move/forum#FID#/topic#TID#/message#MID#/",
			"pm_list" => "pm/forlder#FID#/",
			"pm_edit" => "pm/folder#FID#/message#MID#/user#UID#/#mode#/",
			"pm_read" => "pm/folder#FID#/message#MID#/",
			"pm_search" => "pm/search/",
			"pm_folder" => "pm/folders/",
			"rss" => "rss/#TYPE#/#MODE#/#IID#/",
			"search" => "search/",
			"subscr_list" => "subscribe/",
			"active" => "topic/new/",
			"topic_move" => "topic/move/forum#FID#/topic#TID#/",
			"topic_new" => "topic/add/forum#FID#/",
			"topic_search" => "topic/search/",
			"user_list" => "users/",
			"profile" => "user/#UID#/edit/",
			"profile_view" => "user/#UID#/",
			"user_post" => "user/#UID#/post/#mode#/",
			"message_send" => "user/#UID#/send/#TYPE#/"
		),
		"VARIABLE_ALIASES" => Array(
			"index" => Array(),
			"list" => Array(),
			"read" => Array(),
			"message" => Array(),
			"help" => Array(),
			"rules" => Array(),
			"message_appr" => Array(),
			"message_move" => Array(),
			"pm_list" => Array(),
			"pm_edit" => Array(),
			"pm_read" => Array(),
			"pm_search" => Array(),
			"pm_folder" => Array(),
			"rss" => Array(),
			"search" => Array(),
			"subscr_list" => Array(),
			"active" => Array(),
			"topic_move" => Array(),
			"topic_new" => Array(),
			"topic_search" => Array(),
			"user_list" => Array(),
			"profile" => Array(),
			"profile_view" => Array(),
			"user_post" => Array(),
			"message_send" => Array(),
		)
	)
);?>
					© «Битрикс», 2001-2025, «1С-Битрикс», 2025