Forum Pro¶

Forum Pro — полноценная платформа для обсуждений, которая работает на вашем сайте Grav и не требует внешнего хостинга. Это не iframe, не виджет стороннего сервиса и не подписка. Страницы форума — обычные страницы Grav: они наследуют вашу тему, доступны по любому выбранному маршруту, индексируются поисковыми системами, а каждое сообщение хранится в базе данных, которой владеете вы.

Требования¶

Некоторые необязательные плагины расширяют возможности:

Ни один из них не обязателен. Forum Pro корректно работает и без них: без sync форум отображается на сервере обычным образом, без codesh блоки кода выводятся без подсветки и так далее.

Что входит в комплект¶

• Обсуждения с разделами, категориями, темами, ветками ответов, Markdown с @упоминаниями и цитатами, вложениями, реакциями, опросами, метками, принятыми ответами, закладками и полной историей изменений.
• Собственная система участников с регистрацией, подтверждением электронной почты, сбросом пароля, профилями, аватарами, рангами, значками, группами, званиями и списком участников. Учётные записи Grav подключаются автоматически.
• Модерация через роли модераторов с ограниченными правами, очередь проверки на самом форуме, массовую очередь в админке, предмодерацию по категориям, жалобы участников, блокировки с апелляциями и управлением контентом, журнал аудита и ежедневный дайджест.
• Защита от спама в три независимых этапа (эвристики, необязательный локальный ML-классификатор, необязательная ежечасная проверка ИИ), а также ограничения для новых учётных записей и невидимая captcha.
• Уведомления через колокольчик в интерфейсе с всплывающими сообщениями, уровни отслеживания для тем и разделов, а также письма, повторяющие уведомления колокольчика, с немедленной, ежедневной или еженедельной доставкой.
• Личные сообщения между участниками, один на один или в группах, с архивированием, блокировкой, массовой очисткой и отправкой жалоб.
• Поиск по опубликованным сообщениям с учётом прав доступа — через встроенный движок или YetiSearch Pro.
• Обновления в реальном времени через плагин sync, с push-уведомлениями Mercure или автоматическим переходом на опрос сервера.
• Комментарии к статьям, которые превращают любую страницу Grav в статью с комментариями, привязанную к реальной теме форума.
• Импорт из Discourse и XenForo, который переносит участников (с рабочими паролями), контент, историю и файлы одной командой.

С чего начать¶

1. Установка запускает форум, помогает выбрать базу данных и подключить его по нужному маршруту.
2. Конфигурация содержит полный справочник по всем блокам настроек.
3. Администрирование проводит по разделу Forum в Admin Next.

Если вы переносите существующее сообщество, перед началом прочитайте Миграцию из Discourse или Миграцию из XenForo. Импорт можно запускать повторно, но планировать переключение проще до начала, чем после.

В этом разделе¶

• Установка — установите Forum Pro, выберите и защитите базу данных, подключите форум по нужному маршруту и запустите фоновый процесс.
• Конфигурация — полный справочник настроек Forum Pro, блок за блоком, с указанием вкладки админки для каждого параметра.
• Администрирование — обзор раздела Forum в Admin Next, отчёт Forum Activity, виджет панели управления и права, которые им управляют.
• Участники и учётные записи — как работает система учётных записей Forum Pro, как подключаются учётные записи Grav и как связаны ранги, значки, группы, звания, аватары и профили.
• Модерация — роли модераторов с ограниченными правами, очередь проверки на форуме, предмодерация, жалобы участников, блокировки с управлением контентом, отмена действий, журнал аудита, юридические удержания и ежедневный дайджест.
• Защита от спама — трёхэтапная проверка спама (эвристики, локальный ML-классификатор, ежечасная проверка ИИ), ограничения для новых участников и невидимая captcha.
• Уведомления и электронная почта — колокольчик уведомлений, всплывающие сообщения, уровни отслеживания, настройки почты и дайджесты, очередь доставки и личные сообщения.
• Комментарии к статьям — превратите любую страницу Grav в статью с комментариями, обсуждение которой живёт на форуме, одним вызовом Twig и помощником для счётчика в списках.
• Поиск — встроенный полнотекстовый движок, движок YetiSearch Pro, фильтры результатов и ограничение по правам, а также перестроение индекса.
• Обновления в реальном времени — живые ответы, присутствие и индикаторы набора текста, каналы с учётом прав, push-уведомления Mercure или опрос сервера и навигация внутри страницы.
• Оформление — цепочка токенов дизайна, назначение акцентного цвета форума, определение тёмного режима, переопределение шаблонов, значки, доступность и SEO.
• Файловое хранилище — контентно-адресуемое хранилище blob-объектов для вложений и аватаров, переход на S3 или Cloudflare R2, доставка через CDN и команды синхронизации.
• Миграция из Discourse — импортируйте резервную копию Discourse в Forum Pro, перенесите файлы, спланируйте переключение DNS и настройте 301-редиректы со старых URL.
• Миграция из XenForo — импортируйте дамп базы данных XenForo 2 и папки с файлами в Forum Pro, сохраните рабочие пароли, сопоставьте реакции и настройте 301-редиректы со старых URL тем.
• Конфиденциальность и хранение — самостоятельное удаление участников, сроки хранения, анонимизация IP-адресов, юридические удержания и то, что именно удаляет фоновый процесс.
• Справочник CLI — все команды bin/plugin forum-pro, что они делают, когда их запускать и какие безопасны на работающем форуме.