Modern File Manager — современный мультимодульный файловый менеджер для OpenCart 2.3 - 3
Modern File Manager полностью преобразует стандартный файловый менеджер OpenCart: добавляет дерево каталогов, быстрый поиск, автокомплит, контекстное меню, копирование и перемещение файлов, Drag & Drop, удобные карточки и индивидуальные настройки для пользователей и групп.
Модуль не удаляет и не заменяет штатный файловый менеджер. Если расширение отключено или для администратора не найден подходящий профиль, OpenCart автоматически открывает стандартный менеджер файлов.
Современный и удобный интерфейс
Интерфейс файлового менеджера переработан с учётом ежедневной работы администраторов, контент-менеджеров и редакторов магазина.
| Возможность | Описание |
| Дерево каталогов | Навигация по папкам через jsTree в левой части файлового менеджера |
| Хлебные крошки | Показывают текущий путь и позволяют быстро перейти в родительский каталог |
| Плитка и список | Два режима отображения файлов и папок |
| Адаптивная сетка | Количество колонок, высота папок и файлов настраиваются отдельно |
| Миниатюры | Изображения показываются с превью, остальные типы файлов — с понятными иконками |
| Множественный выбор | Можно выбрать сразу несколько файлов и папок для групповой операции |
| Drag & Drop | Файлы можно перетащить прямо в открытую папку |
| Прогресс загрузки | Во время загрузки отображается процент выполнения |
| Запоминание папки | Менеджер может открывать последний использованный каталог |
| Запоминание вида | Режим «Плитка» или «Список» сохраняется отдельно для пользователя и профиля |
Поиск файлов и папок
Модуль содержит два независимых режима поиска.
| Режим | Как работает |
| Поиск в текущей папке | Показывает совпадения только внутри открытого каталога |
| Глобальный поиск | Ищет файлы и папки по всему корневому каталогу профиля |
| Автокомплит | Показывает результаты во время ввода запроса |
| Превью в подсказках | Для изображений показывается миниатюра, для папок и документов — соответствующая иконка |
| Переход в папку | При выборе папки в автокомплите менеджер сразу открывает её |
| Выбор файла | При выборе файла он сразу подставляется в поле OpenCart |
| Переход к результату | После глобального поиска можно открыть расположение найденного файла или папки |
| Ограничение сканирования | Количество просматриваемых объектов и результатов настраивается для защиты от лишней нагрузки |
Контекстное меню
Контекстное меню открывается правой кнопкой мыши и адаптируется к выбранному объекту.
| Объект | Доступные действия |
| Свободная область | Создать папку, загрузить файлы, вставить, обновить, изменить режим отображения |
| Папка | Открыть, перейти к расположению, вставить внутрь, копировать, вырезать, переименовать, удалить |
| Файл | Выбрать, перейти к расположению, открыть в новой вкладке, скачать, копировать, вырезать, переименовать, удалить |
| Несколько объектов | Копировать, вырезать или удалить выбранные файлы и папки |
| Дерево каталогов | Открыть каталог, создать вложенную папку, вставить объекты, обновить дерево |
Основные операции с файлами
- автоматическое создание уникального имени при копировании.
Горячие клавиши
| Ctrl+C | Копировать выбранные объекты |
| Ctrl+X | Вырезать выбранные объекты |
| Ctrl+V | Вставить объекты |
| F2 | Переименовать выбранный файл или папку |
| Delete | Удалить выбранные объекты |
| Правая кнопка мыши | Открыть контекстное меню |
Мультимодульность и профили доступа
Каждая копия модуля является отдельным профилем файлового менеджера. Для разных администраторов можно создать собственные корневые папки, ограничения, разрешённые типы файлов и набор доступных операций.
| Тип профиля | Назначение | Приоритет |
| Группа пользователей | Применяется ко всем администраторам выбранной группы | 1 — максимальный |
| Пользователь | Персональные настройки для конкретного администратора | 2 |
| Все пользователи | Общий резервный профиль | 3 |
Групповой профиль всегда имеет преимущество перед персональным. Персональный профиль имеет преимущество перед общим.
Если для одной группы или пользователя создано несколько активных профилей, используется числовой приоритет. Чем больше значение, тем выше приоритет. При одинаковом значении выбирается профиль, созданный раньше.
Примеры использования профилей
| Пользователь или группа | Пример настройки |
| Администраторы | Полный доступ ко всему каталогу image/catalog |
| Контент-менеджеры | Загрузка, создание папок и переименование без удаления |
| Редакторы блога | Доступ только к image/catalog/blog |
| Менеджеры товаров | Доступ только к image/catalog/products |
| Отдельный сотрудник | Персональная корневая папка, собственные расширения и лимиты |
Настройки файлов и MIME-типов
Список разрешённых расширений не зашит в контроллер. Все типы файлов и MIME-соответствия изменяются в настройках каждого профиля.
| Группа | Расширения по умолчанию |
| Изображения | JPG, JPEG, PNG, GIF, SVG, WEBP |
| Видео | MP4, WEBM, AVI, MOV, M4V, MKV, OGV |
| Документы | PDF, DOC, DOCX |
| Таблицы | XLS, XLSX, CSV |
| 3D-модели | STL |
Можно добавлять собственные расширения и MIME-типы без изменения PHP-файлов модуля.
Для каждого расширения допускается указать несколько MIME-типов:
jpg=image/jpeg,image/pjpeg
webp=image/webp
pdf=application/pdf
xlsx=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/zip
Контроль загрузки
- []белый список расширений;[]отдельная карта MIME-типов;[]строгая проверка MIME;[]настраиваемый максимальный размер файла;[]ограничение количества файлов за одну загрузку;[]ограничение количества результатов поиска;[]ограничение глубины сканирования каталога;[]проверка существования файла перед загрузкой;[]защита от выхода выше корневой папки;[]запрет переходов через ../;[]проверка разрешений администратора;[]опциональная транслитерация названий.
Настройка интерфейса
Каждый профиль может иметь собственное отображение файлового менеджера.
| Настройка | Описание |
| Дерево папок | Включение или отключение бокового дерева каталогов |
| Хлебные крошки | Отображение текущего пути |
| Скрытые файлы | Возможность показывать или скрывать объекты, начинающиеся с точки |
| Глобальный поиск | Включение поиска по всему корневому каталогу |
| Контекстное меню | Включение действий по правой кнопке мыши |
| Drag & Drop | Разрешение загрузки перетаскиванием |
| Ширина окна | Настраиваемая ширина модального окна |
| Высота окна | Настраиваемая высота рабочей области |
| Количество колонок | Количество карточек в строке на большом экране |
| Высота папки | Компактность карточек каталогов |
| Высота файла | Размер превью и карточек файлов |
| Путь к jsTree | Путь к библиотеке задаётся отдельно для каждого профиля |
Отдельное управление операциями
Администратор может включить или отключить каждую операцию независимо:
- []загрузка файлов;[]создание папок;[]переименование;[]удаление;[]копирование и перемещение;[]Drag & Drop;[]глобальный поиск;[]контекстное меню.
Например, для контент-менеджера можно разрешить загрузку изображений и создание каталогов, но полностью отключить удаление и перемещение.
Права пользователей
| Настройка | Назначение |
| Автоматическая выдача access | При сохранении профиля модуль может автоматически добавить выбранной группе право доступа к маршруту файлового менеджера |
| Проверка modify | Изменяющие операции можно выполнять только при наличии соответствующего права |
| Статус профиля | Отключённый профиль не участвует в выборе настроек |
| Корневая папка | Пользователь не сможет перейти выше назначенного каталога |
Интеграция с OpenCart
Модуль поддерживает стандартные способы открытия файлового менеджера OpenCart 3:
- []выбор основного изображения товара;[]выбор дополнительных изображений;[]поля target и thumb;[]CKEditor;[]быстрые редакторы, использующие стандартный вызов файлового менеджера;[]другие модули, открывающие common/filemanager стандартным способом.
Без замены стандартного файлового менеджера
Modern File Manager подключается через OCMOD и проверяет наличие активного профиля для текущего администратора.
| Ситуация | Результат |
| Найден активный профиль | Открывается Modern File Manager с настройками этого профиля |
| Профиль отключён | Он не участвует в выборе |
| Подходящего профиля нет | Открывается стандартный файловый менеджер OpenCart |
| Модуль отключён или удалён | OpenCart продолжает использовать штатный файловый менеджер |
Преимущества модуля
- -значительно ускоряет ежедневную работу с изображениями и документами;- не требует ручной замены системных файлов;- подходит для магазинов с несколькими администраторами;-позволяет ограничить каждого сотрудника собственной папкой;- снижает риск случайного удаления чужих файлов;- поддерживает изображения, документы, видео, таблицы и 3D-модели;- сохраняет привычный способ выбора изображений в OpenCart;- позволяет полностью управлять возможностями через настройки;- автоматически возвращается к стандартному менеджеру при отсутствии профиля;- поддерживает русский и английский интерфейс.
Установка
| 1 | Загрузить архив через установщик дополнений |
| 2 | Перейти в раздел модификаторов и нажать «Обновить» |
| 3 | Установить Modern File Manager в списке модулей |
| 4 | Создать первый профиль для пользователя, группы или всех администраторов |
| 5 | Очистить кеш Twig административной панели |
Требования
- - библиотека jsTree в административной части (идет вместе с модулем);- путь по умолчанию: admin/view/javascript/jstree/;- права на запись в используемые каталоги image/.
Важно
Перед установкой рекомендуется восстановить оригинальный admin/controller/common/filemanager.php, если он ранее изменялся вручную.