crm.clientright.ru/modules/OnlyOfficeTemplates/INSTALL.md

Установка OnlyOfficeTemplates

Шаги

1. Скопировать файлы

   • modules/OnlyOfficeTemplates/ — целиком.
   • layouts/v7/modules/OnlyOfficeTemplates/ — целиком.
   • Файлы языков из languages/*/OnlyOfficeTemplates.php (ru_ru, en_us и при необходимости другие).

2. Настроить конфигурацию

   • Либо используйте существующий crm_extensions/file_storage/config.php (S3 будет взят оттуда).
   • Либо задайте в .env: S3_ACCESS_KEY, S3_SECRET_KEY, S3_ENDPOINT, S3_BUCKET.
   • Для конвертации в PDF задайте OOT_ONLYOFFICE_CONVERT_URL (например https://office.clientright.ru:9443/ConvertService.ashx).

3. Установить модуль в CRM

   • Из корня CRM выполните:

     php modules/OnlyOfficeTemplates/install.php
     

   • Либо зарегистрируйте модуль вручную в vtiger_tab и выполните SQL из schema.xml, затем вызовите $mod = new OnlyOfficeTemplates(); $mod->executeSql(); $mod->addLinksToEntityModules();

4. Добавить шаблоны

   • Через экшен UploadTemplate (POST с полями name, module_name и файлом file).
   • Либо вручную: загрузить DOCX в S3 в {OOT_S3_PREFIX}/templates/{id}/{filename}.docx и вставить запись в vtiger_oot_templates.

Проверка

• Откройте карточку любой записи модуля (например, Проект). В боковой панели должен появиться виджет «OnlyOffice Templates» со списком шаблонов (если они добавлены для этого модуля).
• Выберите шаблон, формат (PDF или DOCX), нажмите «Скачать» или «Сохранить в Документы».

Переменные окружения (кратко)

Переменная	Описание
S3_ACCESS_KEY, S3_SECRET_KEY, S3_ENDPOINT, S3_BUCKET	Доступ к S3
OOT_S3_PREFIX	Префикс папки модуля в S3 (по умолчанию crm2/OnlyOfficeTemplates)
OOT_ONLYOFFICE_CONVERT_URL	URL OnlyOffice Conversion API для DOCX→PDF
OOT_DOCUMENTS_S3_PREFIX	Префикс пути при сохранении в Документы