Документация ForumCraft

Что такое ForumCraft

ForumCraft — WordPress-платформа для классических форумов, Q&A, поддержки продукта, закрытых клубов и нишевых сообществ. Это не SaaS: темы, ответы, пользователи и настройки хранятся на вашем WordPress-сайте.

Системные требования

• WordPress 6.2 или новее.
• PHP 7.4 или новее.
• HTTPS рекомендуется для регистрации, восстановления пароля, WooCommerce и безопасной работы аккаунтов.
• Постоянные ссылки WordPress должны быть включены.
• WP-Cron рекомендуется для уведомлений, фоновых проверок и обслуживания.
• WooCommerce нужен только для автоматической продажи VIP, продвижения и рекламных пакетов. Без WooCommerce основные функции ForumCraft работают.

Что входит в покупку

После подтверждения оплаты в личном кабинете Streltsov Digital появляются:

• forumcraft-x.x.x.zip — WordPress-тема.
• forumcraft-community-x.x.x.zip — companion-плагин.
• Один лицензионный ключ формата FC-XXXX-XXXX-XXXX-XXXX.
• История доступных релизов и private updates.

Установка двух ZIP

1. Установите тему. WordPress → Внешний вид → Темы → Добавить тему → Загрузить тему → выберите forumcraft-...zip.
2. Активируйте ForumCraft. После активации внешний вид сайта переключится на ForumCraft.
3. Установите Community. WordPress → Плагины → Добавить плагин → Загрузить плагин → выберите forumcraft-community-...zip.
4. Активируйте Community. В левом меню появится раздел ForumCraft.
5. Откройте лицензию. ForumCraft → Лицензия и обновления → вставьте FC-* ключ → «Активировать».
6. Запустите мастер. ForumCraft → Быстрый старт.

Лицензия FC-*

Один ключ активирует ForumCraft Theme и ForumCraft Community на текущем домене.

1. Скопируйте ключ из личного кабинета Streltsov Digital.
2. Вставьте его в поле лицензии и нажмите «Активировать».
3. После активации проверьте тариф и число активных доменов.
4. Для переноса сайта сначала деактивируйте старый домен, затем активируйте новый.

• Unlimited должен отображаться как «без ограничений», а не как Business/10.
• На demo/dev-хостах может работать Development mode; реальный FC-* ключ всё равно имеет приоритет.
• При кратковременной недоступности сервера лицензий действует grace period.

Private updater

ForumCraft использует штатный механизм обновлений WordPress. Тема и Community проверяются отдельно, но получают доступ по одной лицензии.

1. Нажмите «Проверить обновления».
2. Если релиз доступен, обновите тему и Community из WordPress → Обновления или со страницы продукта.
3. После обновления убедитесь, что в Control Center версии совпадают.
4. При крупном обновлении сначала сделайте backup базы и файлов.

Быстрый старт

Мастер настраивает основную структуру за четыре шага.

1. Сценарий. Выберите «Поддержка продукта», «Технологическое сообщество», «Q&A / База знаний», «Игровое сообщество», «Локальное сообщество» или «Клуб автора / бренда».
2. Режим. Classic Forum, Q&A или Hybrid.
3. Доступ. Регистрация, email-уведомления, noindex-защита, cooldown и лимит ссылок новичков.
4. Дизайн и структура. Preset, цветовой режим, политика категорий и опциональный demo seeder.

Мастер не удаляет реальные темы или пользователей. При замене структуры удаляются только пустые стартовые категории; непустые сохраняются.

Control Center

Это основной экран владельца сообщества. Здесь видны темы, ответы, участники, разделы, жалобы, режим, регистрация, onboarding, дизайн, лицензия и версии компонентов.

Основные настройки сообщества

Здесь задаются название сообщества, короткое описание, режим работы и число тем на странице. Эти настройки относятся к форумному движку; публичное название бренда и тексты главной редактируются отдельно в «Брендинг и тексты».

Classic Forum / Q&A / Hybrid

Режим можно изменить в любой момент. Уже опубликованные темы сохраняют свой тип.

Категории и теги

Категории формируют основные разделы форума, теги — дополнительную классификацию тем.

• Создавайте отдельную категорию под устойчивую тему, а не под единичный вопрос.
• Для каждой категории можно задать режим доступа: Публичный / Только участникам / VIP.
• SEO Title, Description, Canonical, Noindex и SEO-текст категории задаются через SEO-поля категории.
• Теги по умолчанию можно закрыть от индексации, чтобы не создавать thin archives.

Служебные страницы

Community автоматически создаёт и хранит ID служебных страниц.

Если страница была удалена или rewrite сломался, используйте ForumCraft → Диагностика → Восстановить служебные страницы и rewrite.

Демо-контент

Demo Seeder нужен для быстрого просмотра интерфейса. Он создаёт демонстрационных участников, категории, темы и ответы только там, где соответствующих демо-сущностей ещё нет.

Design Studio

Design Studio меняет внешний вид без правки CSS/PHP. Настройки применяются и к теме, и к Community.

• Ширина контейнера: 1120 / 1240 / 1360 / 1480 px.
• Радиусы: 12 / 16 / 22 / 30 px.
• Карточки: Bordered / Soft Shadow / Glass / Flat.
• Hero: Grid Glow / Aurora / Minimal / Spotlight.
• Header: Solid / Floating / Minimal.
• Custom Palette: Accent, Accent 2, Background, Surface, Card, Text, Muted.

Пресеты и Light/Dark

Готовые пресеты: Midnight Mint, Blue Pulse, Graphite Gold, Violet Night, Soft Light, Arctic Glass.

Цветовой режим можно оставить «как в пресете», принудительно Dark/Light или брать системную тему пользователя. Переключатель в шапке можно отключить.

Брендинг и тексты

Покупатель может полностью заменить публичный бренд ForumCraft на бренд собственного проекта.

• Название бренда/сообщества и подпись под логотипом.
• Собственный логотип и favicon.
• Показывать/скрывать Powered by ForumCraft.
• Показывать/скрывать публичный credit Streltsov Digital.
• Главный hero, CTA, trust-пункты, секции, footer.
• Тексты форума, входа, регистрации и Центра продвижения.

Служебный бренд Streltsov Digital в wp-admin, лицензирование и private updater намеренно не переименовываются.

Главная страница

Редактируются eyebrow, H1, accent-часть заголовка, описание, обе CTA-кнопки и их URL, три trust-пункта, подписи статистики и секции «Возможности», «Живое сообщество», «Сценарии».

• Секции можно включать/выключать.
• Порядок секций можно менять без кода.
• 6 карточек возможностей и 4 сценария редактируются отдельно.
• По умолчанию статистика использует реальные данные. Demo numbers включаются отдельно.

Тексты форума и auth-экранов

В Public Content Control доступны ключевые публичные надписи: Forum hero, CTA, «Участники», live/active labels, placeholder поиска, категории, «Сейчас обсуждают», свежие темы, вкладки сортировки, тексты входа/регистрации и Центра продвижения.

Темы

Авторизованный участник нажимает «Создать тему», выбирает категорию, при Hybrid — тип темы, задаёт заголовок, текст и теги. Вложения добавляются в той же форме.

Администратор может использовать Control Center или штатный WordPress bulk-screen для массовых действий.

Ответы

Ответ публикуется прямо на странице темы. Под сообщениями доступны реакции, цитирование и модераторские действия. Для Q&A автор темы/модератор может отметить решение.

Rich Editor

Редактор одинаков для новой темы и ответа.

• Жирный, курсив, H3.
• Маркированный и нумерованный список.
• Цитата и inline code.
• Очистка форматирования.
• Анкорные ссылки: выделите текст → Ctrl+K или кнопка ссылки.
• Shortcuts Ctrl+B / Ctrl+I / Ctrl+K.
• Счётчик символов.

Пользовательский HTML очищается WordPress KSES; ссылки пользовательского контента получают безопасные rel-атрибуты.

Фото и вложения

По умолчанию разрешены JPG, PNG и WebP: до 6 изображений по 5 МБ. Администратор может отключить вложения или изменить лимиты.

• Поддерживается drag & drop.
• До публикации показывается предпросмотр, файл можно удалить из очереди.
• После публикации изображения выводятся галереей и открываются в lightbox.
• SVG и произвольные файлы не разрешены.
• При удалении темы/ответа связанные ForumCraft-вложения очищаются.

Q&A и лучший ответ

Q&A-тема отличается возможностью выбрать решение. Автор темы или модератор нажимает «Отметить решением». Ответ получает пометку «Лучший ответ», а тема — «Решено».

Для Q&A ForumCraft генерирует Schema QAPage; обычные темы используют DiscussionForumPosting.

Реакции и цитирование

Участники могут ставить реакцию на тему/ответ и цитировать сообщение. Цитата вставляется непосредственно в Rich Editor. Полученные реакции участвуют в профиле и достижениях.

Бесплатный bump темы

Автор может бесплатно поднять собственную открытую тему. По умолчанию — один раз в 24 часа; cooldown настраивается от 1 до 168 часов.

• Bump не создаёт новый ответ.
• Обновляется last activity, поэтому тема поднимается в обычной выдаче.
• Временно появляется badge «Поднята».
• Закрытые темы поднимать нельзя.
• Платное promoted-продвижение имеет более высокий приоритет.

Платное продвижение темы

Если владелец форума включил WooCommerce и назначил товар продвижения, автор темы получает возможность купить усиленное размещение. После оплаты promoted-статус назначается автоматически на заданный срок.

Администратор также может вручную включать Sponsored/Promoted в метабоксе темы и задавать срок/партнёрский URL.

Вход и регистрация

Участникам не нужен стандартный wp-login. ForumCraft создаёт собственные страницы входа, регистрации, восстановления пароля, onboarding и настроек аккаунта.

• Вход по username или email.
• Remember me.
• Возврат на исходную страницу после входа.
• Регистрация: имя, username, email, пароль, принятие правил.
• Honeypot и rate limit для формы регистрации.
• Обычным участникам можно скрыть admin bar и закрыть wp-admin.

Подтверждение email

Функция опциональная. При включении новый пользователь получает ссылку подтверждения с ограниченным сроком действия. До подтверждения нельзя создавать темы/ответы.

Onboarding нового участника

После первой авторизации новый пользователь может заполнить отображаемое имя, специализацию, город/страну, био, локальный аватар, выбрать интересующие категории, приватность и email-уведомления.

Выбранные категории автоматически подписываются. После завершения на форуме появляется welcome-панель с CTA создать тему, открыть профиль или настройки.

Профили

Публичный профиль доступен по адресу вида /forum/member/{user}/. В профиле выводятся avatar/cover, имя, роль, специализация, локация, био, Telegram/VK/сайт, статистика, Trust progress, активности и достижения.

Собственный профиль редактируется с фронтенда, без входа в wp-admin.

Приватность профиля

Пользователь также может отдельно управлять отображением локации и email-уведомлениями.

Trust и репутация

ForumCraft автоматически формирует уровни доверия по активности и репутации: Новичок → Участник → Проверенный → Эксперт → Модератор → Команда. В профиле показывается progress до следующего уровня.

На Trust влияют полезная активность: темы, ответы, лучший ответ, реакции и другие показатели сообщества. Служебные роли модератора/команды имеют повышенный уровень.

Достижения и badges

Профиль может показывать достижения вроде «Команда», «Первый старт», «Помощник», «Есть решение», «В центре внимания», «Полезный голос», «Проверенный», «Стаж», «Эксперт».

Дополнительные badges у аватара формируются по статусу: команда/модератор, VIP, эксперт/проверенный, спонсор. Одновременно выводится ограниченное число значков, чтобы интерфейс не превращался в набор бейджей.

Premium / VIP профиль

Владелец сам определяет, какие преимущества получает VIP: accent профиля, glow/рамка аватара, цвет имени, badges, подпись и внешняя ссылка.

• 6 accent-пресетов: Mint, Blue, Violet, Gold, Rose, Cyan.
• Подпись выводится под темами и ответами.
• Внешняя ссылка в подписи получает rel="ugc nofollow noopener".
• Максимальную длину подписи задаёт администратор.

Каталог участников

Страница `/forum/members/` поддерживает поиск и сортировку по активности/новизне. Карточки показывают роль, репутацию и переход в профиль. Приватные профили фильтруются в соответствии с выбранной видимостью.

Центр модерации

Центр собирает жалобы и журнал действий. Модераторские операции защищены capability-проверками и доступны только уполномоченным пользователям.

Действия с темой

• Закрыть / открыть тему.
• Закрепить / открепить.
• Перенести в другую категорию.
• Скрыть проблемный ответ.
• Отметить лучший ответ в Q&A.
• Назначить Sponsored / Promoted вручную.

Закреплённые темы имеют приоритет выше платного продвижения; promoted — выше обычных и бесплатно поднятых.

Жалобы

Участник может пожаловаться на тему или ответ. Жалоба попадает в очередь модерации. После обработки используйте журнал действий, чтобы сохранять прозрачную историю решений команды.

Роли и права

ForumCraft использует WordPress capabilities для администраторов/модераторов и собственные Trust/VIP состояния для публичного интерфейса. Обычных участников рекомендуется оставлять на роли Subscriber и не выдавать им доступ к wp-admin.

Антиспам

Базовые ограничения: cooldown между публикациями и лимит ссылок для новичка. По умолчанию пауза — 20 секунд, внешних ссылок для новичка — 1.

Не ставьте cooldown в 0 на открытом форуме без внешней антиспам-защиты. При массовом спаме дополнительно используйте CAPTCHA/WAF/Cloudflare на уровне сайта.

Центр уведомлений

В шапке авторизованного пользователя есть unread-счётчик. Внутренние уведомления создаются для новых ответов, @упоминаний, выбранного решения, подписчиков профиля и рекламных заявок/статусов.

Подписки

Пользователь может подписаться на тему или категорию. В onboarding выбранные интересующие категории подписываются автоматически. В админке отображается сводка подписок.

@упоминания

Используйте @username в теме или ответе. Упомянутый участник получает внутреннее уведомление; при включённой email-рассылке может получить и письмо.

Email-уведомления

Глобальный переключатель находится в ForumCraft → Уведомления / настройках модерации. Пользователь может отключить email в своём аккаунте.

SEO & Growth

Центр управляет мета-данными ForumCraft, Schema, sitemap и indexability. При обнаружении популярных SEO-плагинов собственные meta/OG не должны дублировать их вывод.

• Автоматические meta description и canonical.
• Open Graph и Twitter Card.
• Noindex для thin profiles, тегов, пустых категорий и filtered/search вариантов.
• Default social image.

SEO отдельной темы

Для темы доступны SEO Title, Meta Description, Canonical и Noindex. Используйте ручные поля только когда автоматического заголовка/описания недостаточно.

SEO категории

Для категории доступны SEO Title, Description, Canonical, Noindex и отдельный индексируемый SEO-текст под списком обсуждений. Это позволяет развивать категорию как полноценную посадочную страницу, а не только архив.

Schema.org

• QAPage — для Q&A-тем.
• DiscussionForumPosting — для обычных обсуждений.
• BreadcrumbList — навигационная цепочка.
• ProfilePage + Person — для доступных публичных профилей.

Sitemap и индексация

Темы и категории используют WordPress XML Sitemap. ForumCraft добавляет sitemap активных публичных профилей. Приватные профили исключаются. Теги можно noindex и исключать из sitemap.

Похожие обсуждения

Под темой ForumCraft выводит связанные обсуждения: сначала по общим категориям/тегам, затем fallback на популярные темы. Блок помогает навигации, глубине просмотра и внутренней перелинковке.

Центр монетизации

Можно одновременно использовать несколько моделей: реклама, VIP/Premium, закрытые категории, promoted/sponsored темы, affiliate links и WooCommerce.

Верхние KPI показывают VIP-участников, продвигаемые темы, показы/клики рекламы и affiliate clicks. При WooCommerce дополнительно учитывается доход ForumCraft-монетизации за сегодня, 30 дней и всё время начиная с версии, где включён этот учёт.

Рекламные места

Доступные слоты:

• Форум: верх.
• Форум: между блоками.
• Тема: сверху.
• Тема: после первого ответа.
• Тема: сайдбар.
• Профиль: сайдбар.
• Community: перед футером.

Для каждого слота можно использовать баннер + URL или admin HTML/JS, задать даты начала/окончания и состояние кампании. Вне активного периода реклама не выводится, клики не засчитываются.

Affiliate Link Manager

Создайте название, slug и Destination URL. ForumCraft формирует короткую ссылку вида /go/partner/ и считает клики.

• Ссылку можно включить/отключить, отредактировать или удалить.
• Отключённая ссылка не работает через redirect и shortcode.
• Shortcode: [forumcraft_affiliate slug="partner" text="Перейти"].
• Вывод получает rel="sponsored nofollow".

VIP / Premium

ForumCraft добавляет роль forumcraft_vip. VIP можно назначить вручную или автоматически после покупки WooCommerce-товара на заданный срок.

Премиальные преимущества настраиваются владельцем: accent профиля, avatar glow, цвет имени, badges, подпись, ссылка и другие видимые преимущества.

Закрытые разделы

Для каждой категории выбирается доступ:

Закрытые темы фильтруются из публичных списков и защищаются от прямого просмотра.

WooCommerce

WooCommerce опционален и отвечает только за оплату. ForumCraft отвечает за выдачу права/статуса после оплаты.

1. Установите и настройте WooCommerce и платёжный способ.
2. Создайте виртуальный товар для VIP и/или продвижения темы.
3. В ForumCraft → Монетизация выберите нужный товар из списка.
4. Задайте длительность VIP или продвижения.
5. Сделайте тестовый заказ и проверьте автоматическую выдачу права после оплаты.

Продажа рекламы участникам

Владелец указывает собственные контакты — Telegram и email для рекламы, публичный текст и правила показа CTA.

Можно настроить до четырёх рекламных предложений: рекламный баннер, партнёрская тема, продвижение темы и индивидуальное размещение. Для каждого задаются название, описание, тип, срок, отображаемая цена и WooCommerce-товар.

Центр продвижения участника

Страница доступна участнику из собственного профиля по кнопке «Продвижение ★» и из настроек аккаунта.

• Готовые рекламные пакеты.
• Контакты владельца форума.
• Бесплатный bump собственных тем.
• Платное продвижение тем.
• Форма рекламной заявки.
• Список собственных заявок, кампаний и статусов.

Страница закрыта от индексации и исключена из sitemap.

Рекламные заявки и workflow

Заявка может содержать формат, проект, сайт, target URL, тему, желаемые даты, Telegram/email, комментарий и баннер JPG/PNG/WebP до 5 МБ.

Статусы:

При свободном рекламном слоте, корректном баннере и target URL оплаченная баннерная заявка может запуститься автоматически. Если слот занят, она остаётся «Оплачено» для ручного запуска.

Перенос из bbPress и wpForo

1. Сделайте backup. Migration Center не удаляет источник, но импорт создаёт новые ForumCraft-сущности.
2. Выберите источник. bbPress или wpForo должен быть обнаружен на текущем сайте.
3. Dry run. Посмотрите число разделов, тем, ответов, уже импортированные элементы и предупреждения.
4. Запустите миграцию. Импорт идёт пакетами и сохраняет состояние.
5. Продолжите при необходимости. Страницу можно закрыть и вернуться позже.
6. Проверьте журнал. После завершения ForumCraft пересчитает reply count и last activity.

• Защита от дублей через source mapping.
• Переносятся иерархия разделов, темы, ответы, авторы WordPress, даты, теги, sticky/closed, просмотры и доступные Q&A/solution-данные.
• Для bbPress WordPress Media подключается без физического копирования файлов.
• Исходные данные Migration Center не удаляет.

Диагностика и Health

Экран локально проверяет состояние системы и показывает итоговый процент готовности.

• PHP и WordPress.
• HTTPS и постоянные ссылки.
• Uploads и memory.
• WP-Cron.
• ForumCraft Community.
• Служебные страницы.
• Лицензию и updater.
• Schema/data migrations.

System Info можно скопировать и приложить к обращению в поддержку. Кнопка восстановления создаёт недостающие служебные страницы и пересобирает rewrite.

Системные настройки

Этот раздел оставлен для редких технических параметров. Основные повседневные настройки вынесены в Control Center, Доступ, Редактор, Уведомления, Design Studio, SEO и Монетизацию.

Backup и безопасность

• Перед обновлением major/minor-релиза и миграцией делайте backup файлов и базы.
• Не редактируйте файлы родительской темы ForumCraft для клиентских доработок — обновление их перезапишет.
• Не храните license key, SMTP/API secrets или WooCommerce credentials в публичных темах/ответах.
• Оставляйте SVG и произвольные upload-типы выключенными, если они не нужны.
• HTML/JS рекламных слотов должен добавлять только доверенный администратор.
• Для публичного форума используйте HTTPS, SMTP и серверный WAF/rate limiting.

Типовые проблемы