Как интегрировать ONLYOFFICE Docs с WordPress

ONLYOFFICE Docs — это офисный пакет с открытым исходным кодом, который включает в себя совместные редакторы для текстовых документов, электронных таблиц, презентаций и форм, а также просмотрщик PDF. Пакет распространяется на условиях лицензии AGPL v3.0. В качестве основного формата используется OOXML.

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

WordPress — это система управления контентом с открытым исходным кодом, используемая в качестве сервиса публикации для блогов и веб-сайтов. Вы можете расширить WordPress, используя множество доступных тем и плагинов, включая ONLYOFFICE. Это позволяет вставлять документы в записи для просмотра без необходимости их загрузки, а также совместно работать с офисными файлами из административной панели.

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

Предварительное условие: ONLYOFFICE совместим с WordPress версии 5.9.0 и выше.

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

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

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

Вы можете найти подробные инструкции в этом руководстве HowtoForge. В случае, если вам нужно установить ONLYOFFICE Docs на Ubuntu для архитектуры ARM 64-бит, обратитесь к этим инструкциям.

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

Интеграционный плагин ONLYOFFICE для WordPress бесплатен и распространяется под лицензией GNU GPL v2.0. Чтобы установить его, клонируйте основную ветку плагина:

cd wp-content/plugins  
git clone https://github.com/ONLYOFFICE/onlyoffice-wordpress

Перейдите в раздел Плагины в административной панели WordPress и активируйте плагин ONLYOFFICE.

Интеграционный плагин также доступен в официальном каталоге плагинов WordPress.

Шаг 3: Настройте экземпляр

Перейдите в административную панель WordPress, переключитесь на настройки ONLYOFFICE и укажите следующие параметры:

• Адрес сервиса редактирования документов. Это URL установленного ONLYOFFICE Document Server.
• JWT секретный ключ сервера документов. Он позволяет использовать JWT для защиты ваших документов от несанкционированного доступа. Вам нужно указать тот же секретный ключ в конфигурационном файле ONLYOFFICE Document Server для включения проверки.

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

Все загруженные файлы из раздела Медиа появляются на странице Файлы ONLYOFFICE в административной панели.

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

Соответствующий редактор ONLYOFFICE открывается в той же вкладке, когда вы нажимаете на имя файла. Все изменения сохраняются в том же файле после каждой сессии редактирования, когда все соавторы покидают документ.

Вы также можете добавить блок ONLYOFFICE при создании записи и загрузить новый файл или выбрать один из Медиа-библиотеки.

Добавленный файл отображается как логотип ONLYOFFICE с именем файла в текущей редактируемой записи. После публикации записи посетители сайта WordPress получают доступ к этому файлу для просмотра в встроенном режиме. Таким образом, они могут просмотреть вставленный файл без его загрузки.

Следующие форматы файлов поддерживаются для вставки и просмотра: doc, docx, docm, dot, dotx, dotm, odt, fodt, ott, rtf, txt, html, htm, mht, xml, pdf, djvu, fb2, epub, xps, xls, xlsx, xlsm, xlt, xltx, xltm, ods, fods, ots, csv, pps, ppsx, ppsm, ppt, pptx, pptm, pot, potx, potm, odp, fodp, otp.

Вот и все! Теперь вы можете работать с офисными файлами в WordPress, используя ONLYOFFICE Docs.