Cách kết nối ONLYOFFICE Docs và Strapi CMS

[theanh]

ONLYOFFICE Docs là một bộ ứng dụng văn phòng mã nguồn mở được phân phối theo GNU AGPL v3.0. Bộ ứng dụng này bao gồm các trình xem dựa trên web và trình chỉnh sửa cộng tác cho các tài liệu văn bản, bảng tính, bản trình bày, biểu mẫu có thể điền và tệp PDF. Định dạng cốt lõi được sử dụng là OOXML (DOCX, XLSX, PPTX).

Bộ ứng dụng văn phòng có thể tích hợp với nhiều dịch vụ đám mây khác nhau như khung CMS (WordPress, Strapi), nền tảng cộng tác (ONLYOFFICE Workspace, Nextcloud, Seafile, Confluence, Alfresco), trình theo dõi sự cố (Jira, Redmine), giải pháp học tập điện tử (Moodle, Chamilo, HumHub) và các giải pháp khác. Các nhà phát triển cũng có thể nhúng trình chỉnh sửa vào ứng dụng web của riêng họ.

Strapi là một CMS cộng tác mã nguồn mở được xây dựng trên Node.js giúp các nhà phát triển tạo ra các sản phẩm kỹ thuật số. Đây là hệ thống quản lý nội dung phụ trợ được xây dựng để phân phối nội dung đa nền tảng trên các trang web dành cho máy tính để bàn và thiết bị di động, ứng dụng, màn hình tương tác và các thành phần web. Với ONLYOFFICE Docs tích hợp, bạn có thể chỉnh sửa và cộng tác trên nội dung trực tiếp trong giao diện Strapi.

Trong hướng dẫn này, chúng ta sẽ tìm hiểu cách kết nối các phiên bản ONLYOFFICE Docs và Strapi bằng cách sử dụng plugin tích hợp (trình kết nối).

Lưu ý rằng ONLYOFFICE tương thích với Strapi v.4.0 trở lên.

Bước 1: Cài đặt ONLYOFFICE Docs​

Để có thể làm việc với các tài liệu văn phòng trong Strapi, bạn cần một phiên bản ONLYOFFICE Docs (Máy chủ tài liệu). Cách cài đặt được các nhà phát triển chính thức khuyến nghị là sử dụng Docker. Nó cho phép cài đặt phiên bản mới nhất của trình soạn thảo với tất cả các phụ thuộc bằng cách chạy lệnh sau:

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

Bạn có thể tìm thấy hướng dẫn chi tiết trong hướng dẫn HowtoForge này. Trong trường hợp bạn cần cài đặt ONLYOFFICE Docs trên Ubuntu cho kiến trúc ARM 64 bit, hãy tham khảo các hướng dẫn sau.

Bước 2: Cài đặt plugin tích hợp​

Thay thế dòng strapi::security trong tệp middleware Strapi strapi/config/middlewares.js để cho phép chèn khung bằng trình chỉnh sửa và tải api.js:

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

Nếu cấu hình như vậy đã tồn tại, chỉ cần thêm phần tử directives.

Khi đã sẵn sàng, hãy cài đặt plugin vào dự án Strapi của bạn:

npm install onlyoffice-strapi --save

Sau khi cài đặt, hãy xây dựng lại giao diện người dùng quản trị và khởi động lại Strapi run:

# using yarn
yarn build
yarn develop

# using npm
npm run build
npm run develop

Plugin tích hợp cũng có sẵn trong Thị trường Strapi chính thức.

Bước 3: Cấu hình plugin tích hợp​

Sau khi cài đặt plugin tích hợp, hãy cấu hình ONLYOFFICE Document Server thông qua Bảng điều khiển Strapi. Vào Cài đặt -> Cài đặt chung -> ONLYOFFICE. Chỉ định các tham số:

• Địa chỉ máy chủ tài liệu là URL của Máy chủ tài liệu ONLYOFFICE đã cài đặt.
• Khóa bí mật JWT của máy chủ tài liệu cho phép JWT bảo vệ tài liệu khỏi truy cập trái phép. Bạn cũng cần chỉ định cùng một khóa bí mật trong tệp cấu hình của ONLYOFFICE Document Server để kích hoạt xác thực.

Bước 4: Sử dụng ONLYOFFICE Docs trong Strapi​

Bạn có thể xem, chỉnh sửa và đồng tác giả các tài liệu văn bản, bảng tính và bản trình bày (DOCX, XLSX, PPTX) được thêm vào Thư viện phương tiện Strapi.

Trong số các tính năng cộng tác, có các tính năng sau: chế độ đồng chỉnh sửa theo thời gian thực và khóa đoạn văn, Theo dõi thay đổi, bình luận, trò chuyện tích hợp, cuộc gọi âm thanh và video thông qua plugin Jitsi cần được cài đặt riêng.

Có thể tìm thấy và sắp xếp các tài liệu có sẵn để xem/chỉnh sửa trên trang tệp ONLYOFFICE trong Strapi. Trình chỉnh sửa mở ra bằng cách nhấp vào tên tệp hoặc hành động Chỉnh sửa trong ONLYOFFICE.



Quyền truy cập được cung cấp theo cách sau:

• Mở tệp để chỉnh sửa: vai trò người dùng với cài đặt quyền Cập nhật (cắt, chi tiết, thay thế) + xóa.
• Mở tệp để xem: vai trò người dùng với cài đặt quyền Truy cập Thư viện phương tiện.

Vậy là xong! Bây giờ bạn có thể chỉnh sửa và cộng tác trên nội dung văn phòng trực tiếp trong Strapi của mình bằng ONLYOFFICE Docs.