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