Skip to content

Latest commit

 

History

History
100 lines (68 loc) · 3.59 KB

File metadata and controls

100 lines (68 loc) · 3.59 KB
Язык
English
Русский
中文

📤 Upload Plus — плагин продвинутой загрузки файлов и изображений для NodeBB

Upload Plus расширяет стандартный механизм загрузки файлов NodeBB:

  • сохраняет файлы в иерархические подпапки (hash или дата) для комфортной работы при миллионах загрузок;
  • при желании автоматически конвертирует изображения в WebP;
  • опционально переименовывает файлы в случайные имена, предотвращая конфликты и повышая приватность;
  • полностью локализован на русский, английский и китайский.

⚙️ Установка

cd /path/to/nodebb
npm install nodebb-plugin-upload-plus

В админ-панели:
ACP → Plugins → Activate → Upload Plus


🔧 Настройка

После активации перейдите:
ACP → Plugins → Upload Plus

Параметр Возможные значения По умолчанию
Стратегия путей hash — подпапки по хешу имени
date — YYYY/MM/DD
hash
Глубина каталогов 2 или 3 уровня (только для hash) 2
Конвертировать в WebP on / off off
Случайное имя файла on / off off

📁 Как строятся пути

Стратегия пример
none uploads/files/filename.ext
hash 2 uploads/files/a1/b2/filename.ext
hash 3 uploads/files/a1/b2/c3/filename.ext
date uploads/files/2024/09/02/filename.ext

Хеш формируется на основе SHA-256 имени файла → первые 2 или 3 символа используются как имена папок.


🔀 Случайное имя файла

  • Переименовывает загруженные файлы в случайные имена при загрузке.
  • Новое имя формируется как SHA-256(метка_времени + оригинальное_имя).ext.
  • Расширение исходного файла сохраняется.
  • Предотвращает конфликты имён файлов и повышает приватность пользователей.

🖼️ Конвертация в WebP

  • Срабатывает только для изображений.
  • Рядом с оригиналом создаётся filename.webp.
  • Качество WebP: 83 %.
  • Клиенту возвращается URL именно .webp-файла.

🌐 Локализация

Плагин поставляется с переводами:

  • English (en-GB)
  • Русский (ru)
  • 中文 (zh-CN)

Язык админки подхватывается из настроек NodeBB.


🛠️ Разработка / форк

git clone https://github.com/mysteren/nodebb-plugin-upload-plus.git
cd nodebb-plugin-upload-plus
npm install
npm link            # в папке nodebb

📄 Лицензия

MIT © 2025 Upload Plus Contributors