Поиск по сайту:

Как подключить ONLYOFFICE Docs и Strapi CMS

На этой странице

  1. Шаг 1. Установите ONLYOFFICE Docs
  2. Шаг 2. Установите подключаемый модуль интеграции
  3. Шаг 3. Настройте подключаемый модуль интеграции
  4. Шаг 4. Используйте ONLYOFFICE Docs в Strapi

ONLYOFFICE Docs — это офисный пакет с открытым исходным кодом, распространяемый по лицензии GNU AGPL v3.0. Он включает веб-просмотрщики и редакторы для совместной работы для текстовых документов, электронных таблиц, презентаций, заполняемых форм и файлов PDF. Используемый основной формат — OOXML (DOCX, XLSX, PPTX).

Офисный пакет можно интегрировать с различными облачными сервисами, такими как CMS-фреймворки (WordPress, Strapi), платформы для совместной работы (ONLYOFFICE Workspace, Nextcloud, Seafile, Confluence, Alfresco), средства отслеживания проблем (Jira, Redmine), решения для электронного обучения (Moodle, Chamilo, HumHub) и другие. Разработчики также могут встраивать редакторы в свои собственные веб-приложения.

Strapi — это CMS для совместной работы с открытым исходным кодом, построенная на Node.js, которая помогает разработчикам создавать цифровые продукты. Это внутренняя система управления контентом, созданная для кроссплатформенной доставки контента на настольные и мобильные веб-сайты, приложения, интерактивные дисплеи и веб-элементы. Благодаря интегрированному ONLYOFFICE Docs вы можете редактировать контент и совместно работать над ним прямо в интерфейсе Strapi.

В этом руководстве мы узнаем, как подключить экземпляры ONLYOFFICE Docs и Strapi с помощью подключаемого модуля интеграции (коннектора).

Обратите внимание, что ONLYOFFICE совместим со Strapi версии 4.0 и выше.

Шаг 1. Установите ONLYOFFICE Docs

Чтобы иметь возможность работать с офисными документами в Strapi, вам потребуется экземпляр ONLYOFFICE Docs (Document Server). Официально рекомендуемый разработчиками способ установки — использовать Docker. Это позволяет установить последнюю версию редакторов со всеми зависимостями, выполнив следующую команду:

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

Вы можете найти подробные инструкции в этой инструкции.

Шаг 2: Установите плагин интеграции

Замените строку strapi::security в файле промежуточного ПО Strapi strapi/config/middlewares.js, чтобы разрешить вставку фрейма с редактором и загрузку api.js:

{
  name: "strapi::security",
  config: {
    contentSecurityPolicy: {
      useDefaults: true,
      directives: {
        "script-src": ["'self'", "https:", "http:"],
        "frame-src": ["'self'", "https:", "http:"],
      },
    },
  },
},

Если такая конфигурация уже существует, добавьте только элемент директив.

Когда все будет готово, установите плагин в свой проект Strapi:

npm install onlyoffice-strapi --save

После установки перестройте пользовательский интерфейс администратора и перезапустите Strapi:

# using yarn
yarn build
yarn develop
# using npm
npm run build
npm run develop

Плагин интеграции также доступен на официальном Strapi Market.

Шаг 3. Настройте подключаемый модуль интеграции

После установки подключаемого модуля интеграции настройте Сервер документов ONLYOFFICE через панель инструментов Strapi. Перейдите в Настройки -> Глобальные настройки -> ONLYOFFICE. Укажите параметры:

  • Адрес сервера документов, который является URL-адресом установленного Сервера документов ONLYOFFICE.
  • Секретный ключ JWT сервера документов, который позволяет JWT защищать документы от несанкционированного доступа. Вам также необходимо указать тот же секретный ключ в файле конфигурации Сервера документов ONLYOFFICE, чтобы включить проверку.

Шаг 4. Используйте ONLYOFFICE Docs в Strapi

Вы можете просматривать, редактировать и совместно редактировать текстовые документы, электронные таблицы и презентации (DOCX, XLSX, PPTX), добавленные в медиатеку Strapi.

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

Документы, доступные для просмотра/редактирования, можно найти и отсортировать на странице файлов ONLYOFFICE в Strapi. Редактор открывается по клику на имени файла или по действию Редактировать в ONLYOFFICE.

Права доступа предоставляются следующим образом:

  • Открытие файлов для редактирования: роли пользователей с настройкой разрешения Обновить (обрезать, детализировать, заменить) + удалить.
  • Открытие файлов для просмотра: роли пользователей с настройкой разрешения Доступ к библиотеке мультимедиа.

Вот и все! Теперь вы можете редактировать офисный контент и совместно работать над ним прямо в Strapi с помощью ONLYOFFICE Docs.