Модули документов

Здесь настраиваются модули печати документов — то, из чего платформа собирает PDF по заказам: шаблоны, поля, иногда дополнительные библиотеки. Покупатель на сайте этот экран не видит; зато от модуля зависит, появятся ли у вас типы документов, предпросмотр и сохранённые документы в заказе.

В панели управления вы можете:

• подтянуть новые папки модулей в список (Синхронизировать модули);
• установить модуль (подготовить его к работе на этом сайте);
• при необходимости удалить установку модуля;
• включить или выключить модуль и задать порядок в списке;
• открыть изменение записи и заполнить параметры, которые предусмотрел разработчик модуля.

Обзор работы с готовыми документами в заказе — в разделе Документы. Режим нумерации заказных PDF задаётся отдельно: Настройка документов.

Где находится

Дополнения → Модули документов

Вверху списка — кнопка «Синхронизировать модули». В таблице видны название, тип («Модуль документов»), версия, признаки Установлен и Активен, поле Сортировка (перетаскиванием можно менять порядок строк — как в интерфейсе списка).

Как добавить новый модуль документов

1. Получите пакет модуля — от партнёров PlatParts или от разработчиков; внутри должна быть отдельная папка с именем модуля.
2. Скопируйте её на сервер в каталог modules/Documents в корне сайта (рядом с другими папками modules, не внутрь ядра). Имя папки станет кодовым именем модуля в списке.
3. Убедитесь, что в корне папки модуля есть файл composer.json — без него синхронизация не подхватит модуль.
4. В панели нажмите «Синхронизировать модули» — появится уведомление, сколько модулей обновлено; новая строка должна отобразиться в таблице.
5. Нажмите «Установить» у нужной строки — система при необходимости дотянет зависимости из composer.json и пометит модуль как установленный.
6. Откройте модуль кнопкой «Изменить», включите «Активен», сохраните и заполните остальные поля по подсказкам.

Подсказка

Если файлы модуля на сервере заменили или обновили, снова нажмите «Синхронизировать модули», чтобы панель увидела актуальную версию из composer.json.

Внимание

Загружайте на сервер только доверенные архивы. Проверьте содержимое на посторонние скрипты перед распаковкой в modules/Documents.

Удаление модуля из интерфейса

Кнопка «Удалить» в строке снимает установку модуля в рамках этой панели (как отмечено в уведомлении об успехе). Папку на диске она сама не «стирает» — при необходимости файлы удаляют вручную на сервере после согласования с администратором.

Если что-то не работает

• После синхронизации модуля нет в списке — проверьте путь modules/Documents/ИмяПапки, наличие composer.json и права на чтение каталога веб-сервером.
• Установить не удаётся — откройте текст ошибки в уведомлении; частая причина — не установились зависимости из composer.json (нужны права на запуск установки пакетов с сервера).
• Документы в заказе не создаются, хотя модуль активен — проверьте типы документов, точку выдачи и реквизиты; см. Документы.

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