mCataloger | Каталогизатор для удобной работы с папками и файлами в MODx

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

По этой (и не только) причине я решил что необходимо структурировать работу менеджеров в файловой системе. Задача стоит не только в изоляции менеджеров от важных папок, но и обеспечить полную автоматизацию, чтобы менеджер не замечал работу пакета и в то же время в файловой структуре был порядок. Поразмыслив над реализацией, я составил небольшой roadmap.

Road Map пакета

• Плагин работает только для контекста mgr.
• Плагин работает только для типов ресурсов, которые будут указаны в системной настройке mcataloger_class_keys.
• При удалении ресурса, удаляется и его папка со всем содержимым. Данная опция регулируется настройкой mcataloger_delete_folders.
• Для каждого пользователя нужно создать источник файлов, название источника должно полностью совпадать с username пользователя.
• В созданном источнике файлов, создаем 2 параметра:
  
  • sourceFilesPath — Путь уже существующей папки. Например assets/.
  
  
  • user_id — Идентификатор менеджера, для которого создается источник.
• Каждый менеджер должен работать только в своем источнике файлов, чтобы не мешать другим менеджерам. Посему для каждого менеджера нужно переопределить системную настройку default_media_source. В ней нужно указать источник файлов, который вы создали для пользователя.

Настройки mCataloger

• mcataloger_activate — Включает или отключает работу пакета.
• mcataloger_class_keys — Список class_key ресурсов через запятую, которые будут обрабатываться плагином. По умолчанию включены: modDocument,TicketsSection,Ticket.
• mcataloger_delete_folders — Если включить эту опцию, то при удалении ресурса будет удаляться папка, название которой совпадает с идентификатором ресурса. По умолчанию включена.
• mcataloger_managers_id — Список идентификаторов менеджеров через запятую, у которых будет свой источник файлов и для которых будет функционировать плагин.
• mcataloger_sources_name — Список названий источников файлов через запятую. Название источника файлов должно полностью совпадать с username пользователя (включая заглавные буквы), для которого этот источник будет установлен по умолчанию.

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

Минусы пакета

1. Находясь в папке ресурса, менеджер не сможет зайти в другие папки в файловой структуре (хотя с моей стороны это скорее плюс). Т.к. идет жесткая привязка id ресурса = папка с id ресурса.
2. Пакет завязан на id & username пользователя + источник файлов пользователя. Так что если изменить username пользователя, плагин перестанет для него работать.
3. Необходимо произвести настройки на уровне создать источник файлов, два параметра в нем, системную настройку пользователя и системную настройку mCataloger (возможно в будущем я автоматизирую это)

mCataloger можно бесплатно скачать только в modstore.pro.

P.S.
Пакет уже две недели находится на трех (клиентских) сайтах и никаких проблем не обнаружилось, так же пакет протестировали 4-е человека (помимо меня). Но тем не менее, пока что mCataloger находится в alpha версии.