Интеграция ONLYOFFICE Docs с Moodle

Схематичное изображение интеграции ONLYOFFICE с Moodle

О чём эта инструкция

ONLYOFFICE Docs — это бесплатный (open-source) офисный пакет с редакторами для текстов, таблиц, презентаций и форм, а также просмотрщиком и конвертером PDF. Формат по умолчанию — OOXML. Документы можно редактировать совместно в реальном времени, использовать отслеживание изменений, комментарии, чат и блокировку абзацев.

Moodle — это система управления обучением (LMS) с открытым исходным кодом на PHP. Интеграция ONLYOFFICE с Moodle позволяет добавлять активность «ONLYOFFICE» в курсы и давать возможность студентам и преподавателям просматривать и редактировать документы прямо в интерфейсе курса.

Этот материал подробно описывает установку и настройку, даёт рекомендации по безопасности и проверке работоспособности, а также содержит чеклисты для админа и преподавателя.

Что вам нужно перед началом

Сервер или VPS с доступом по SSH для запуска ONLYOFFICE Docs (Document Server) или доступ к уже готовому экземпляру.
Moodle (желательно версия 4.0 или выше для совместимости с плагином v3.0.0+).
Учётная запись администратора Moodle для установки и конфигурации плагина.
Базовые навыки работы с Docker и правами администратора на сервере.

Важно: минимальная поддерживаемая версия ONLYOFFICE Docs для работы с описываемым плагином — 4.2.7 и выше.

Основные преимущества интеграции

Редактирование DOCX/XLSX/PPTX и других форматов прямо в Moodle.
Совместная работа в реальном времени, параграфная блокировка и трекинг изменений.
Возможность встраивать редактор в сторонние веб-сервисы (API/iframe).
Гибкость прав доступа для разных ролей в курсе.

Шаг 1: Установка ONLYOFFICE Docs (Document Server)

Рекомендуемый способ установки — с помощью Docker. Это обеспечивает быстрый деплой со всеми зависимостями.

Запустите команду на сервере, где будет размещён Document Server:

sudo docker run -i -t -d -p 8080:80 --restart=always  
onlyoffice/documentserver

После запуска сервис будет доступен по порту 8080 (или другому, если вы перенастроите проброс портов). Подробную документацию по развёртыванию и настройке можно найти на официальном сайте проекта ONLYOFFICE.

Примечание по установке на Ubuntu 22.04: если вы ещё не знакомы с Moodle и Docker, ознакомьтесь с пошаговыми руководствами по установке на HowtoForge и официальный Docker Hub image.

Шаг 2: Установка плагина ONLYOFFICE в Moodle

Перейдите в панель администратора Moodle под учетной записью администратора.
Следуйте стандартной процедуре установки плагинов: загрузите плагин в директорию mod/onlyofficeeditor на сервере Moodle или установите через интерфейс.
В админке откройте: Администрирование сайта — Плагины — Установить плагины.
Нажмите «Установить плагины из каталога Moodle» и выберите версию плагина, совместимую с вашей версией Moodle. Нажмите «Установить», затем «Продолжить».
Подтвердите запрос на установку и проверьте отчёт проверки плагина.

Если установка выполняется вручную, убедитесь, что права на папки установлены корректно, и перезагрузите страницу администрирования Moodle для завершения установки.

Шаг 3: Конфигурация подключения к Document Server

На странице обзора плагинов найдите модуль ONLYOFFICE и нажмите Настройки.
В поле “Адрес сервиса редактирования документов” укажите URL вашего Document Server (например, https://docs.example.com или http://IP:8080).
При необходимости включите опцию “Принудительное сохранение” (Force Save) — это позволит вручную сохранять версии и ревизии документа на сервере.
JWT и безопасность: начиная с версии 7.2 ONLYOFFICE Docs поддерживает JWT по умолчанию. Секретный ключ может быть сгенерирован автоматически. Если вы хотите использовать собственный ключ, введите Document Server Secret в настройках плагина и укажите точно такой же секрет в конфиге ONLYOFFICE Docs.

Важно: если вы используете HTTPS и самоподписанные сертификаты, проверьте доверие сертификата на стороне Moodle или добавьте соответствующие исключения.

Шаг 4: Настройка интерфейса редактора

В настройках плагина доступны параметры интерфейса ONLYOFFICE:

Отключить или включить кнопки: Чат, Справка, Обратная связь и Поддержка.
Выбрать стиль заголовка панели инструментов: обычный/компактный и цветной/монохромный.

После внесения изменений сохраните настройки.

Настройки ONLYOFFICE в Moodle

Шаг 5: Создание и управление активностями в курсе

Войдите в нужный курс как преподаватель или администратор.
Добавьте новую активность “ONLYOFFICE” в раздел курса.
Выберите: загрузить существующий файл с компьютера или создать новый пустой документ.
Настройте название активности, описание и дополнительные параметры: разрешения на скачивание и печать, скрытие вкладки “Защита”, доступность модуля, идентификатор, ограничения доступа, условия завершения, теги и компетенции курса.
Определите, какие роли (учителя, студенты, гости) могут редактировать или только просматривать документ.

Создание активности ONLYOFFICE

Примеры настроек прав:

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

Шаг 6: Просмотр и редактирование прикреплённых файлов

В активности ONLYOFFICE можно:

Редактировать документы одновременно с другими участниками (со временем и по абзацам).
Создавать и заполнять формы, экспортировать их в PDF.
Использовать «Отслеживание изменений», комментарии и встроенный чат.

Формы в ONLYOFFICE

Поддерживаемые форматы для редактирования и просмотра:

Нативно редактируются: DOCX, XLSX, PPTX, DOCXF, OFORM, TXT, CSV.
PDF доступен для просмотра.
ODT, ODS, ODP, DOC, XLS, PPT, PPS, EPUB, RTF, HTML и HTM редактируются через конвертацию в OOXML.

Дополнительные возможности через плагины:

Перевод текста (DeepL, Apertium, Google).
Аудио/видеозвонки через Jitsi.
Вставка видео YouTube и сложных диаграмм.
Работа с библиографиями (Mendeley, Zotero).
Конвертация в HTML, проверка грамматики, поиск синонимов.

Можно использовать компактный редактор на странице курса для быстрого доступа к информации и блокам активности или полноэкранный режим для работы в расширенном интерфейсе.

Практические сценарии использования

Лабораторные отчёты и совместное редактирование студентами в реальном времени.
Создание шаблонов заданий с формами (OFORM) для автоматического заполнения.
Рабочие документы и презентации, доступные в курсе с версионностью.

Чеклист для администратора (роль: админ)

Убедиться, что Document Server доступен по сети из Moodle.
Запустить Document Server через Docker и зафиксировать URL.
Установить плагин ONLYOFFICE в Moodle и проверить совместимость версий.
Настроить JWT-секрет и синхронизировать конфигурацию на обеих сторонах.
Проверить работу HTTPS и валидность сертификатов.
Настроить резервное копирование и место хранения версий документов.

Чеклист для преподавателя (роль: преподаватель)

Создать активность ONLYOFFICE в курсе и прикрепить файл.
Настроить права доступа для студентов (просмотр/редактирование).
Проверить работу редактирования, комментариев и отслеживания изменений.
Ознакомить студентов с базовыми возможностями редактора.

Критерии приёмки

Document Server отвечает по указанному URL и возвращает страницу приветствия или API-ответ.
Плагин установлен в Moodle без ошибок в отчёте проверки.
При создании активности документ открывается в редакторе ONLYOFFICE и сохраняется на сервере.
Параллельное редактирование несколькими пользователями работает корректно (обновления видны у всех).

Мини-методология тестирования

Развернуть тестовый курс в Moodle и создать активность ONLYOFFICE.
Добавить документ DOCX и открыть его как преподаватель.
Открыть тот же документ как студент в отдельном браузере — проверить параллельные правки.
Проверить экспорт/сохранение в PDF и скачивание файла.
Проверить сохранение версий при включённом Force Save.

Матрица совместимости и миграции

Moodle 4.0 — плагин v3.0.0 и выше — поддерживается.
ONLYOFFICE Docs 4.2.7+ — минимальная поддерживаемая версия.
HTTPS рекомендуется для продакшена; если используется HTTP, ограничьте доступ через VPN или внутреннюю сеть.

Безопасность и конфиденциальность

JWT: включите и используйте сложный секрет для подписи токенов.
Шифрование: используйте HTTPS между Moodle и Document Server в продакшен среде.
Доступ: ограничьте публичный доступ к Document Server при возможности, разрешив подключение только с Moodle и доверенных IP.
Хранение: проверьте, где хранятся временные файлы и ревизии, и настройте политику их удаления и бэкапов.

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

Частые проблемы и способы устранения

Document Server недоступен — проверьте, запущен ли контейнер Docker и проброшены ли порты.
Ошибки JWT — проверьте совпадение секретных ключей и формат токена.
Проблемы с сертификатами — добавьте CA в доверенные или используйте корректный SSL-сертификат.
Конвертация старых форматов — при необходимости вручную сконвертируйте файлы в DOCX/XLSX/PPTX для лучшей совместимости.

Терминология в одну строку

Document Server: сервер ONLYOFFICE, который обрабатывает отображение и редактирование документов.
JWT: JSON Web Token, механизм для подписи и верификации запросов между Moodle и Document Server.
Активность: элемент Moodle курса, например “ONLYOFFICE”, где прикреплён документ.

Шаблон принятия в эксплуатацию

Выполнить чеклист админа.
Провести тестирование с одним курсом и двумя ролями (преподаватель + студент).
Подготовить инструкции для преподавателей.
Перевести в рабочую среду после успешных тестов и бэкапов.

Когда интеграция не подходит или ограничена

В организациях с жёсткими требованиями к хранению данных, где внешние сервисы недопустимы, потребуется локальный Document Server с ограниченным доступом.
Если в учебном процессе используются экзотические форматы документов, требующие тонкой пост-обработки, может потребоваться дополнительная проверка совместимости.

Короткая инструкция для объявления преподавателям (100–200 слов)

Добавлен новый инструмент для работы с документами прямо в курсах Moodle — ONLYOFFICE. Теперь вы можете создавать, редактировать и совместно работать над документами (DOCX/XLSX/PPTX), заполнять формы и экспортировать их в PDF без покидания курса. Для работы достаточно открыть активность “ONLYOFFICE” в разделе курса. Настройки прав позволяют контролировать, кто редактирует, а кто только просматривает. Администратор настроил защиту соединения и JWT-аутентификацию. Если возникнут вопросы — обратитесь в службу поддержки ИТ.

Итог

Интеграция ONLYOFFICE Docs с Moodle даёт образовательным организациям гибкий инструмент для создания и совместной обработки учебных материалов. Следуйте шагам установки, настройте безопасность (JWT/HTTPS), протестируйте параллельное редактирование и подготовьте инструкции для преподавателей и студентов.

Important: перед развёртыванием в продакшене выполните тесты в отдельной среде и настройте резервное копирование документов.

Notes: при использовании облачных или внешних Document Server учитывайте регуляторные ограничения по хранению персональных данных.