Недоступно в редакциях: Старт
Форум (комплексный компонент)
Комплексный компонент позволяет создать полноценный публичный интерфейс форума. Компонент стандартный и входит в дистрибутив модуля.
Описание 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
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.