Similar Threads 1.0.6

[ssmol] Similar Threads — лёгкое дополнение для XenForo, которое находит тематически связанные обсуждения, показывает их на странице темы и предлагает совпадения ещё во время ввода заголовка новой публикации.

Дополнение использует штатную поисковую систему XenForo, учитывает права пользователя и не создаёт отдельные таблицы или тяжёлые SQL-запросы по заголовкам.

Основные возможности​

• Блок «Похожее» на странице просмотра темы.
• Размещение после первого сообщения или после формы быстрого ответа.
• Отдельный виджет для боковой панели темы.
• В боковом виджете выводится одна карточка в строке.
• Количество карточек виджета настраивается отдельно.
• Адаптивная сетка основного блока: 3 или 4 карточки в строке.
• Компактный режим списка.
• Обложки тем из вложений первого сообщения.
• Автоматическая заглушка, если у темы нет изображения.
• Мгновенные подсказки при создании новой темы.
• Поддержка полной и быстрой формы создания темы.
• Ограничение результатов по возрасту.
• Поиск только в текущем разделе или по всему форуму.
• Исключение выбранных разделов из поиска.
• Отдельные права для групп пользователей и узлов.
• Настраиваемое количество результатов, задержка подсказок и время кеширования.
• Блок и виджет полностью скрываются, если ничего похожего не найдено.
• Совместимость с закреплённым первым сообщением дополнения Ssmol/RecipeForums.

Преимущества​

Низкая нагрузка​

Дополнение не выполняет поиск вида LIKE '%заголовок%' непосредственно по таблице xf_thread. Вместо этого используется настроенный поисковый индекс XenForo:

• стандартный MySQL Full-Text;
• XenForo Enhanced Search.

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

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

Полное соблюдение прав доступа​

Перед показом каждого результата дополнительно проверяется Thread::canView(). Пользователь не увидит темы из закрытых разделов или содержимое, к которому у него нет доступа.

Кешируются только идентификаторы результатов. Права и доступность темы проверяются заново при каждом обращении.

Без лишней инфраструктуры​

Дополнение не создаёт:

• собственных таблиц базы данных;
• отдельного индекса похожести;
• периодических задач;
• фоновых заданий;
• прямых SQL-запросов к заголовкам тем.

Безопасные живые подсказки​

Запросы подсказок:

• выполняются только методом POST;
• защищены CSRF-механизмом XenForo;
• отправляются после настраиваемой задержки;
• отменяются при продолжении ввода;
• ограничиваются по частоте при наличии кеш-провайдера.

Совместимость со стилями​

Интерфейс построен на стандартных классах и LESS-переменных XenForo. Карточки автоматически адаптируются к ширине экрана, светлым и тёмным вариациям оформления.

Файлы ядра XenForo не изменяются.

Требования​

• XenForo 2.3.11 или новее в линейке 2.3.
• PHP 8.0 или новее.
• Рабочий поисковый backend XenForo.
• Право пользователя на поиск и просмотр похожих тем.

Установка​

1. Загрузите содержимое каталога upload в корень XenForo.
2. Установите дополнение [ssmol] Similar Threads в панели управления.
3. Импортируйте русский языковой XML в существующий русский язык.
4. Настройте права групп пользователей или отдельных узлов.
5. Выберите внешний вид, позицию блока и параметры поиска.
6. При необходимости создайте виджет Похожее в позиции Просмотр темы: Боковая панель.