Cách kết nối Tài liệu ONLYOFFICE và Strapi CMS
ONLYOFFICE Docs là bộ ứng dụng văn phòng mã nguồn mở được phân phối theo GNU AGPL v3.0. Nó bao gồm người xem dựa trên web và người chỉnh sửa cộng tác cho 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ể được tích hợp với các 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 vấn đề (Jira, Redmine), giải pháp học tập điện tử (Moodle, Chamilo, HumHub) và những người khác. Các nhà phát triển cũng có thể nhúng các trình chỉnh sửa vào các ứ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ố. Nó là một hệ thống quản lý nội dung back-end được xây dựng để phân phối nội dung đa nền tảng trên các trang web, ứng dụng, màn hình tương tác và phần tử web trên máy tính để bàn và thiết bị di động. Với Tài liệu ONLYOFFICE được 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 của 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 Tài liệu ONLYOFFICE
Để 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 của Tài liệu ONLYOFFICE (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 chỉnh sửa với tất cả các phần phụ thuộc 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 Tài liệu ONLYOFFICE 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 Strapi middlewares strapi / config / middlewares.js để cho phép chèn khung bằng trình chỉnh sửa và tải api.js:
{
tên: "strapi :: security",
cấu hình: {
contentSecurityPolicy: {
useDefaults: true,
chỉ thị: {
"script-src": ["'self'", "https:", "http:"],
"frame-src": ["'self'", "https:", "http:"],
},
},
},
},
Nếu cấu hình như vậy đã tồn tại, chỉ thêm phần tử chỉ thị.
Sau khi đã sẵn sàng, hãy cài đặt plugin trong 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 quá trình chạy Strapi:
# 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: Định cấu hình plugin tích hợp
Sau khi bạn đã cài đặt plugin tích hợp, hãy định cấu hình Máy chủ tài liệu ONLYOFFICE thông qua Bảng điều khiển Strapi. Vào Cài đặt -> Cài đặt chung -> CHỈ LÀM VIỆC. 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 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 bị 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 Máy chủ Tài liệu ONLYOFFICE để kích hoạt xác thực.
Bước 4: Sử dụng Tài liệu ONLYOFFICE 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ó những 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, nhận xét, 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ác tài liệu có sẵn để xem / chỉnh sửa có thể được tìm thấy và sắp xếp 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 cập nhật (cắt, chi tiết, thay thế) + xóa quyền.
- 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.
Đó là tất cả! Giờ đây, 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 Tài liệu ONLYOFFICE.