D.C Style - Forum Statistics 1.0.0

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


Функции.

Типы контента и параметры сортировки​

Темы (8 типов вкладок)

• Последние темы
• Последние отвеченные темы
• Случайные потоки
• Самые просматриваемые темы
• Наиболее часто задаваемые вопросы
• Неотвеченные темы
• Популярные темы
• Наиболее часто обсуждаемые темы

Участники (3 типа вкладок)

• Новые участники
• Наиболее интерактивные участники
• Лучшие участники

Ресурсы (6 типов вкладок) — требуется XenForo Resource Manager (XFRM)

• Новейшие ресурсы
• Последние обновленные ресурсы
• Наиболее просматриваемые ресурсы
• Наиболее скачиваемые ресурсы
• Наиболее популярные ресурсы
• Ресурсы с наивысшим рейтингом

Авторы ресурсов (1 вкладка) — требуется XFRM

• Авторы лучших ресурсов, отсортированные по 5 параметрам: количество ресурсов, количество загрузок, рейтинг отзывов, количество просмотров и средний рейтинг.

Медиафайлы (6 типов вкладок) — требуется XenForo Media Gallery (XFMG)

• Последние новости СМИ
• Самые просматриваемые медиафайлы
• Самые комментируемые СМИ
• СМИ, вызвавшие наибольшую реакцию
• СМИ с самым высоким рейтингом
• Случайные медиафайлы

Медиа-альбомы (4 типа вкладок) — требуется XFMG

• Последние альбомы
• Самые просматриваемые альбомы
• Альбомы с наибольшим количеством комментариев
• Самые большие альбомы

Режимы компоновки​

Три режима компоновки для размещения на любой странице:

• Tabbed — Интерфейс с вкладками и отложенной загрузкой контента. Идеально подходит для размещения в верхней части списка форумов или на отдельной странице.
• Компактный — Упрощенный, структурированный интерфейс, предназначенный для размещения в боковой панели.
• Grid — CSS-сетка с карточкой-заголовком, настраиваемыми столбцами (2-4 на настольных компьютерах, 1-2 на планшетах) и адаптивными контрольными точками.

Виджет и отдельная страница​

• Поставляется как стандартный виджет XenForo — разместите его в любом месте, где это позволяет система виджетов.
• Включает в себя отдельную страницу по адресу /forum-stats/ с постраничной навигацией «Посмотреть все» для каждой вкладки.

Функции администратора​

• Перетаскивание вкладок для изменения порядка их отображения — визуально переставляйте вкладки из панели администратора.
• Настройки для каждой вкладки — ограничение количества элементов, время жизни кэша (TTL), фильтр по временному периоду (все время / последние 24 часа / 7 дней / 30 дней и т. д.), область действия форума или категории, фильтрация по тегам и видимость групп пользователей.
• Карточка панели администратора — это карточка со статистикой, встроенная в главную страницу панели администратора, отображающая текущие показатели (количество тем и участников сегодня/на этой неделе, самая активная тема и участник).
• Ручное перестроение кэша — кнопка для принудительного обновления всех кэшированных данных одним нажатием.

Производительность и кэширование​

• Кэширование на основе SimpleCache с настраиваемым временем жизни (TTL) для каждой вкладки.
• Аннулирование кэша на основе событий — кэш автоматически перестраивается при изменении потоков, пользователей, ресурсов или медиафайлов, с встроенным регулированием для предотвращения массового сброса данных.
• Для обеспечения безопасности планировщик задач (Cron) перезапускается каждые 30 минут.
• Ленивая загрузка вкладок — при первоначальной отрисовке загружаются данные только из текущей активной вкладки; переключение вкладок запускает AJAX-запрос.

Разрешения и видимость​

• Глобальное разрешение canView определяет, может ли группа пользователей вообще видеть блок статистики.
• Функция видимости вкладок для разных групп пользователей позволяет показывать разные вкладки разным аудиториям.
• Вкладки, созданные на основе тем обсуждения, учитывают права доступа на уровне узлов XenForo — участники никогда не видят темы с форумов, к которым у них нет доступа.

UX и Frontend​

• Отслеживание непрочитанных сообщений — новые элементы, появившиеся с момента последнего посещения пользователя, выделяются с помощью localStorage.
• AJAX-пагинация с возможностью загрузки дополнительных разделов — позволяет просматривать содержимое любой вкладки без полной перезагрузки страницы.
• Адаптивный дизайн — подстраивается под мобильные устройства, планшеты и настольные компьютеры с помощью специальных контрольных точек.
• Без jQuery — полностью создано на чистом JavaScript, полностью совместимо с XenForo 2.3+.

Установки

Требования​

• XenForo 2.3.0 или более поздняя версия
• PHP 8.0+
• (Необязательно) XenForo Resource Manager (XFRM) — для вкладок «Ресурсы» и «Автор ресурсов».
• (Необязательно) Медиагалерея XenForo (XFMG) — для просмотра медиафайлов и вкладок с альбомами.

Шаги​

1. Установите дополнение — в панели администратора перейдите в раздел «Дополнения» > «Установить/обновить из архива» (или используйте «Установить из каталога», если вы загрузили его вручную). Также можно установить через командную строку:
   php cmd.php xf:addon-install DC/ForumStats
2. Разместите виджет — перейдите в Панель администратора > Внешний вид > Виджеты и добавьте новый виджет. Выберите [D.C Style] Forum Statistics в качестве определения виджета, выберите желаемое положение (например, Список форумов: Над содержимым) и настройте режим компоновки и параметры сетки.
3. Настройка вкладок — Перейдите в Панель администратора > D.C Style - Forum Statistics -> Manage tabs, чтобы управлять вкладками статистики. Добавляйте, изменяйте порядок, включайте/отключайте и настраивайте параметры каждой вкладки, включая ограничения на количество элементов, продолжительность кэширования, период времени, область действия контента и видимость для групп пользователей.
4. Настройка прав доступа — В панели администратора > Пользователи > Права доступа групп пользователей предоставьте группам пользователей, которые должны видеть блокировку, разрешение «Can view forum statistics» .

Всё готово. Блок статистики начнёт заполняться немедленно, используя кэшированные данные, с автоматическим обновлением каждые 30 минут и при соответствующих изменениях контента.