Недоступно в редакциях: Старт
Форум (комплексный компонент)
Комплексный компонент позволяет создать полноценный публичный интерфейс форума. Компонент стандартный и входит в дистрибутив модуля.
Описание 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