Tích hợp
Hướng dẫn tích hợp trang web
Cách thay đổi đến được trang web tùy vào cách trang web được xây dựng. Hãy bắt đầu với trang web và dữ liệu thử, xác nhận mỗi thay đổi đi đâu và có được xuất bản hay không.
Không phải lập trình viên? Hướng dẫn thiết lập giải thích cách kết nối Google và WordPress có ảnh chụp.
Chuẩn bị chung
API cho trang web tự xây dựng và tác vụ bản nháp CMS cần gói Growth hoặc Pro đang hoạt động, việc xác minh quyền sở hữu trang web đã được xác nhận, và chủ sở hữu duyệt từng thay đổi. Xác nhận quyền sở hữu ở màn hình Connections, rồi tạo khóa có thể ghi kết quả ở màn hình API. Chỉ riêng khóa API thì không duyệt được thay đổi.
Ánh xạ từng URL trang HTTPS và từng trường thay đổi tới bản ghi và trường CMS thực sự hiển thị trên trang đó. Trước khi thiết lập, hãy chuẩn bị dữ liệu thử, người phụ trách và quy trình xuất bản.
Trang web tự xây dựng
Triển khai xử lý trên máy chủ trang web theo đặc tả API thay đổi. Lấy các thay đổi đã duyệt, kiểm tra URL và trường với danh sách cho phép, và chỉ lưu bản nháp khi giá trị hiện tại khớp với giá trị “trước”. Báo lại cho API phiên bản đã lưu và kết quả.
Các trường được hỗ trợ là title, description, h1 và body. Ví dụ, ánh xạ title của https://example.com/about tới tiêu đề bản ghi “Giới thiệu” của bạn. Việc xuất bản làm riêng, sau khi có người kiểm tra.
WordPress
Kết nối trang web từ màn hình Connections. Chuẩn bị mật khẩu ứng dụng cho người dùng WordPress có quyền sửa các bài viết và trang liên quan, và thử trước trên trang thử nghiệm. Chỉ cấp quyền sửa cần thiết và thu hồi mật khẩu không còn dùng. Các bước có ảnh chụp nằm ở Kết nối WordPress.
Áp dụng vào trang đã xuất bản sẽ cập nhật trực tiếp nội dung đang hiển thị. Thao tác như Use this edit chính là sự chấp thuận để ghi. Không hỗ trợ tạo bản nháp riêng. Với page builder và trường không sửa được, hãy sao chép nội dung và áp dụng thủ công.
Tác vụ bản nháp CMS
Với microCMS, Shopify, Webflow, Contentful và Sanity có các tác vụ bản nháp mẫu chạy ở phía bạn. Chúng cần Node.js 22.13 trở lên và nhật ký SQLite riêng trên ổ đĩa lưu trữ lâu dài. Truyền bí mật CMS qua biến môi trường từ kho bí mật của máy chủ bạn, và không bao giờ đặt chúng trong trình duyệt, tệp cấu hình hay log. Get1pct không giữ bí mật CMS của bạn và không chạy các tác vụ này thay bạn.
Hiện đây là bản triển khai thử nghiệm. Với cả năm hệ thống, việc lưu bản nháp, đọc lại và kết quả khi chạy lại đã được xác nhận trong môi trường thật, với nội dung chưa xuất bản trong môi trường thử nghiệm riêng. Việc kiểm tra chỉ bao gồm các mục thử đó. Với Shopify, tên sản phẩm đã được kiểm tra; các trường SEO chưa được thử với API thật.
Ví dụ dưới đây ánh xạ một URL và trường Get1pct tới endpoint, ID nội dung và trường của microCMS. Hãy thay các giá trị cho phù hợp với môi trường thử của bạn.
{
"projectId": "test-project-id",
"provider": "microcms",
"options": { "serviceId": "example-sandbox" },
"targets": [{
"page": "https://example.com/about",
"field": "title",
"target": {
"endpoint": "draft-fixtures", "id": "about", "field": "title",
"draftKeyEnv": "MICROCMS_DRAFT_KEY_ABOUT"
}
}]
}Các biến môi trường chung là GET1PCT_API_ORIGIN, GET1PCT_PROJECT_ID, GET1PCT_API_KEY, GET1PCT_CMS_CONFIG và GET1PCT_CMS_JOURNAL. Thông tin xác thực của từng CMS đặt trong các biến bên dưới.
Shopify
Tạo ứng dụng trong Dev Dashboard và lấy token máy chủ bằng client credentials grant. Dùng cửa hàng phát triển không xuất bản, với sản phẩm DRAFT chưa xuất bản. Đặt token có read_products và write_products vào SHOPIFY_INTEGRATION_TOKEN, và khai báo shop (ví dụ example.myshopify.com) và productId (ví dụ gid://shopify/Product/123). title và description tương ứng với trường SEO, h1 với tên sản phẩm; không hỗ trợ nội dung thân.
Webflow
Đặt vào WEBFLOW_INTEGRATION_TOKEN một token có quyền đọc và ghi CMS của trang web thử. Khai báo trường PlainText có thể sửa ở ngôn ngữ chính bằng collectionId, itemId và fieldSlug. Kiểm tra mẫu thực sự hiển thị trường đó. Thay đổi được lưu ở staging; xuất bản là một bước riêng.
Contentful
Trong space và environment thử, đặt vào CONTENTFUL_INTEGRATION_TOKEN một token management API có thể đọc và sửa mục đích. Khai báo spaceId, environmentId, entryId, fieldId và locale (ví dụ en-US). Hỗ trợ trường văn bản có sẵn; không hỗ trợ Rich Text. Thay đổi trên mục đã xuất bản vẫn ở trạng thái chưa xuất bản cho đến khi bạn xuất bản riêng.
Sanity
Trong dataset thử, đặt vào SANITY_INTEGRATION_TOKEN một token có thể đọc và sửa bản nháp đích. Khai báo projectId, dataset, một documentId có sẵn bắt đầu bằng drafts. và trường chuỗi field. Không hỗ trợ Portable Text. Kiểm tra nội dung trong Studio và xuất bản riêng nếu muốn hiển thị.
microCMS
Chuẩn bị list API và nội dung chưa xuất bản trong một dịch vụ thử, rồi đặt vào MICROCMS_INTEGRATION_API_KEY một khóa chỉ được GET và PATCH trên API đó. Đặt draftKey của bản nháp vào biến môi trường mà draftKeyEnv trong cấu hình chỉ định. Khai báo serviceId, endpoint, id và trường văn bản field. Chỉ hỗ trợ nội dung chưa xuất bản đã có sẵn.
Thử nghiệm và vận hành
- Với dữ liệu thử, xác nhận URL, trường và giá trị “trước” khớp nhau, rồi chỉ xử lý một thay đổi đã duyệt.
- Kiểm tra giá trị và phiên bản bản nháp trong trang quản trị CMS, và xác nhận trang đang hiển thị không thay đổi. Thử cập nhật WordPress trực tiếp trên trang thử nghiệm.
- Tìm nguyên nhân mọi trường hợp lệch giá trị “trước” hoặc lỗi quyền. Nếu không biết lần lưu có thành công không, hãy tiếp tục với cùng nhật ký và đọc lại. Đừng gửi lại một cách mù quáng hay xóa nhật ký.
Với microCMS, Shopify và Webflow, không thể ngăn hoàn toàn việc sửa đồng thời giữa lần kiểm tra cuối và lúc lưu. Trong khi thử, hãy đảm bảo không có người hay tác vụ nào khác sửa cùng bản ghi.