Плагин "Сетевые диски (SMB)"
Добавлено: 17 авг 2026, 11:23
Коротко: приложенные к записям файлы больше не лежат
в uploads.
В базе Руководителя хранится только ссылка — подключение, папка и имя файла.
Сам файл всё время находится на вашей samba-шаре, там же, где его видят люди из проводника.
Возможности:
1. «Хранить или привязывать файлы на файловой шаре»
Плагин добавляет новый тип поля — «Файл на сетевом диске (SMB)». Работает тремя
способами на выбор: шара, смонтированная к серверу (mount -t cifs, fstab, UNC под
Windows), расширение PHP smbclient или консольная утилита smbclient. Достаточно
одного.
Рекомендую смонтированную папку: быстрее всех и правами рулит операционная
система, а не PHP.
2. «Открывается окошко со списком файлов, пользователь выбирает, какой файлик из какой
папки прилинковать»
В форме записи кнопка «Выбрать файл на сетевом диске» открывает
окно с содержимым шары: навигация по папкам, хлебные крошки, галочки на файлах,
кнопка «Прикрепить выбранные». Файлы не копируются и не перемещаются — сохраняется
только путь. Уже прикреплённые помечаются, повторно выбрать нельзя.
3. «Либо создать новый файл, но уже с нужным именем и в нужной папке»
В том же окне есть загрузка файла в текущую папку и создание папок. При загрузке
можно сразу задать имя, под которым файл ляжет на шару. Если файл с таким именем уже
есть — к имени добавляется номер, ничего не перезатирается. На диске www-сервера
файл не остаётся вообще.
4. «Руководитель хранит только линки, которые отлично бекапятся в маленький SQL»
Три служебные таблицы, в них строки вида «подключение + папка + имя».
SQL-дамп остаётся маленьким, а файлы бекапятся вместе с шарой средствами инфраструктуры.
5. «Юзверям удобно зайти в нужную папку по самбе и увидеть там все файлики проекта»
Под каждым файлом в записи выводится полный сетевой путь \\server\share\папка\файл.doc —
можно скопировать и открыть напрямую. Скачать через саму CRM тоже можно, файл при этом
отдаётся потоком с шары.
6. «Удалить или переименовать может только сисадмин и www-сервер»
Со стороны плагина:
удаление файла с шары по умолчанию выключено, включается отдельной галочкой в поле
и отдельным правом группы доступа, и даже тогда работает только для файлов, которые
загрузили через CRM. Файл, который просто выбрали на шаре, плагин не удалит никогда.
--------------------------------------------------------------------------------
ЧТО ЕЩЁ УМЕЕТ
--------------------------------------------------------------------------------
- Несколько подключений: разные шары для разных сущностей и отделов.
- Папка по умолчанию с подстановками: {entity_id}, {field_id}, {item_id}, {Y}, {m}, {d}.
Например «Договоры/{Y}/{item_id}» — у каждого договора своя папка, создаётся сама
при первой загрузке файла. Можно запретить пользователю выходить выше неё.
- Права по группам доступа, отдельно на каждое подключение: просмотр шары, загрузка
файлов, создание папок, открепление, удаление с шары. Плюс «папка группы» — например,
отдел продаж видит только своё поддерево.
- Фильтр типов файлов: чёрный список на уровне подключения (по умолчанию все исполняемые
типы) и белый список на уровне поля. Ограничение размера загружаемого файла.
- Проверка подключения одной кнопкой: показывает, доступна ли шара и что в ней лежит.
Ошибки записи пишутся в log/smb.txt.
- Русский и английский интерфейс.
- При удалении записи ссылки чистятся автоматически, при копировании записи — не
дублируются.
в uploads.
В базе Руководителя хранится только ссылка — подключение, папка и имя файла.
Сам файл всё время находится на вашей samba-шаре, там же, где его видят люди из проводника.
Возможности:
1. «Хранить или привязывать файлы на файловой шаре»
Плагин добавляет новый тип поля — «Файл на сетевом диске (SMB)». Работает тремя
способами на выбор: шара, смонтированная к серверу (mount -t cifs, fstab, UNC под
Windows), расширение PHP smbclient или консольная утилита smbclient. Достаточно
одного.
Рекомендую смонтированную папку: быстрее всех и правами рулит операционная
система, а не PHP.
2. «Открывается окошко со списком файлов, пользователь выбирает, какой файлик из какой
папки прилинковать»
В форме записи кнопка «Выбрать файл на сетевом диске» открывает
окно с содержимым шары: навигация по папкам, хлебные крошки, галочки на файлах,
кнопка «Прикрепить выбранные». Файлы не копируются и не перемещаются — сохраняется
только путь. Уже прикреплённые помечаются, повторно выбрать нельзя.
3. «Либо создать новый файл, но уже с нужным именем и в нужной папке»
В том же окне есть загрузка файла в текущую папку и создание папок. При загрузке
можно сразу задать имя, под которым файл ляжет на шару. Если файл с таким именем уже
есть — к имени добавляется номер, ничего не перезатирается. На диске www-сервера
файл не остаётся вообще.
4. «Руководитель хранит только линки, которые отлично бекапятся в маленький SQL»
Три служебные таблицы, в них строки вида «подключение + папка + имя».
SQL-дамп остаётся маленьким, а файлы бекапятся вместе с шарой средствами инфраструктуры.
5. «Юзверям удобно зайти в нужную папку по самбе и увидеть там все файлики проекта»
Под каждым файлом в записи выводится полный сетевой путь \\server\share\папка\файл.doc —
можно скопировать и открыть напрямую. Скачать через саму CRM тоже можно, файл при этом
отдаётся потоком с шары.
6. «Удалить или переименовать может только сисадмин и www-сервер»
Со стороны плагина:
удаление файла с шары по умолчанию выключено, включается отдельной галочкой в поле
и отдельным правом группы доступа, и даже тогда работает только для файлов, которые
загрузили через CRM. Файл, который просто выбрали на шаре, плагин не удалит никогда.
--------------------------------------------------------------------------------
ЧТО ЕЩЁ УМЕЕТ
--------------------------------------------------------------------------------
- Несколько подключений: разные шары для разных сущностей и отделов.
- Папка по умолчанию с подстановками: {entity_id}, {field_id}, {item_id}, {Y}, {m}, {d}.
Например «Договоры/{Y}/{item_id}» — у каждого договора своя папка, создаётся сама
при первой загрузке файла. Можно запретить пользователю выходить выше неё.
- Права по группам доступа, отдельно на каждое подключение: просмотр шары, загрузка
файлов, создание папок, открепление, удаление с шары. Плюс «папка группы» — например,
отдел продаж видит только своё поддерево.
- Фильтр типов файлов: чёрный список на уровне подключения (по умолчанию все исполняемые
типы) и белый список на уровне поля. Ограничение размера загружаемого файла.
- Проверка подключения одной кнопкой: показывает, доступна ли шара и что в ней лежит.
Ошибки записи пишутся в log/smb.txt.
- Русский и английский интерфейс.
- При удалении записи ссылки чистятся автоматически, при копировании записи — не
дублируются.