การเชื่อมต่อ
คู่มือเชื่อมต่อเว็บไซต์
การแก้ไขไปถึงเว็บไซต์อย่างไรขึ้นอยู่กับวิธีสร้างเว็บไซต์ เริ่มจากเว็บไซต์ทดสอบและข้อมูลทดสอบ และตรวจว่าการแก้ไขแต่ละรายการไปที่ใดและถูกเผยแพร่หรือไม่
ไม่ใช่นักพัฒนา? คู่มือการตั้งค่าอธิบายการเชื่อมต่อ Google และ WordPress พร้อมภาพหน้าจอ
การเตรียมร่วม
API สำหรับเว็บไซต์ที่พัฒนาเองและงานฉบับร่างใน CMS ต้องมีแพ็กเกจ Growth หรือ Pro ที่ใช้งานอยู่ การยืนยันความเป็นเจ้าของเว็บไซต์ที่ยืนยันแล้ว และการอนุมัติการแก้ไขแต่ละรายการโดยเจ้าของ ยืนยันความเป็นเจ้าของที่หน้าจอ Connections แล้วสร้างคีย์ที่บันทึกผลได้ที่หน้าจอ API คีย์ API อย่างเดียวอนุมัติการแก้ไขไม่ได้
จับคู่ URL ของหน้า HTTPS และฟิลด์ที่แก้ไขแต่ละรายการ กับเรคคอร์ดและฟิลด์ใน CMS ที่แสดงบนหน้านั้นจริงทีละรายการ ก่อนตั้งค่า ให้เตรียมข้อมูลทดสอบ ผู้รับผิดชอบ และขั้นตอนการเผยแพร่
เว็บไซต์ที่พัฒนาเอง
พัฒนาการประมวลผลบนเซิร์ฟเวอร์ของเว็บไซต์ตามข้อกำหนด API การแก้ไข ดึงการแก้ไขที่อนุมัติแล้ว ตรวจ URL และฟิลด์กับรายการที่อนุญาต และบันทึกฉบับร่างเฉพาะเมื่อค่าปัจจุบันตรงกับค่า “ก่อน” แล้วรายงานเวอร์ชันที่บันทึกและผลกลับไปที่ API
ฟิลด์ที่รองรับคือ title, description, h1 และ body เช่น จับคู่ title ของ https://example.com/about กับชื่อของเรคคอร์ด “เกี่ยวกับเรา” ของคุณ การเผยแพร่ทำแยกต่างหากหลังมีคนตรวจ
WordPress
เชื่อมต่อเว็บไซต์จากหน้าจอ Connections เตรียมรหัสผ่านแอปพลิเคชันของผู้ใช้ WordPress ที่แก้ไขโพสต์และหน้าที่เกี่ยวข้องได้ และทดลองกับหน้าทดสอบก่อน จำกัดเฉพาะสิทธิ์แก้ไขที่จำเป็น และเพิกถอนรหัสผ่านที่ไม่ใช้แล้ว ขั้นตอนพร้อมภาพหน้าจออยู่ที่เชื่อมต่อ WordPress
การนำไปใช้กับหน้าที่เผยแพร่แล้วจะอัปเดตเนื้อหาที่เผยแพร่โดยตรง การกระทำอย่าง Use this edit คือการอนุมัติให้เขียน ไม่รองรับการสร้างฉบับร่างแยก สำหรับตัวสร้างหน้าและฟิลด์ที่แก้ไม่ได้ ให้คัดลอกข้อความแล้วนำไปใช้เอง
งานฉบับร่างใน CMS
สำหรับ microCMS, Shopify, Webflow, Contentful และ Sanity มีตัวอย่างงานฉบับร่างที่รันฝั่งคุณ ต้องใช้ Node.js 22.13 ขึ้นไป และบันทึก SQLite ส่วนตัวบนดิสก์ถาวร ส่งข้อมูลลับของ CMS เป็นตัวแปรสภาพแวดล้อมจากที่เก็บข้อมูลลับของเซิร์ฟเวอร์คุณเอง และห้ามใส่ในเบราว์เซอร์ ไฟล์ตั้งค่า หรือล็อก Get1pct ไม่เก็บข้อมูลลับ CMS ของคุณและไม่รันงานเหล่านี้แทนคุณ
ตอนนี้เป็นการพัฒนาเพื่อทดสอบ ทั้งห้าระบบได้ยืนยันในสภาพแวดล้อมจริงแล้วว่าบันทึกฉบับร่าง อ่านกลับ และผลของการรันซ้ำได้ โดยใช้เนื้อหาที่ยังไม่เผยแพร่ในสภาพแวดล้อมทดสอบเฉพาะ การตรวจครอบคลุมเฉพาะรายการทดสอบเหล่านั้น สำหรับ Shopify ตรวจชื่อสินค้าแล้ว แต่ยังไม่ได้ทดสอบฟิลด์ SEO กับ API จริง
ตัวอย่างด้านล่างจับคู่ URL และฟิลด์ของ Get1pct กับ endpoint, ID เนื้อหา และฟิลด์ของ microCMS เปลี่ยนค่าให้ตรงกับสภาพแวดล้อมทดสอบของคุณ
{
"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"
}
}]
}ตัวแปรสภาพแวดล้อมร่วมคือ GET1PCT_API_ORIGIN, GET1PCT_PROJECT_ID, GET1PCT_API_KEY, GET1PCT_CMS_CONFIG และ GET1PCT_CMS_JOURNAL ข้อมูลรับรองของแต่ละ CMS ใส่ในตัวแปรด้านล่าง
Shopify
สร้างแอปใน Dev Dashboard แล้วรับโทเค็นเซิร์ฟเวอร์ด้วย client credentials grant ใช้ร้านค้าสำหรับพัฒนาที่ไม่เผยแพร่ พร้อมสินค้า DRAFT ที่ยังไม่เผยแพร่ ใส่โทเค็นที่มี read_products และ write_products ใน SHOPIFY_INTEGRATION_TOKEN และกำหนด shop (เช่น example.myshopify.com) และ productId (เช่น gid://shopify/Product/123) title และ description ตรงกับฟิลด์ SEO และ h1 ตรงกับชื่อสินค้า ไม่รองรับเนื้อหาหลัก
Webflow
ใส่โทเค็นที่มีสิทธิ์อ่านและเขียน CMS ของเว็บไซต์ทดสอบใน WEBFLOW_INTEGRATION_TOKEN กำหนดฟิลด์ PlainText ที่แก้ไขได้ในภาษาหลักด้วย collectionId, itemId และ fieldSlug ตรวจว่าเทมเพลตแสดงฟิลด์นั้นจริง การเปลี่ยนแปลงบันทึกใน staging และการเผยแพร่เป็นอีกขั้นตอนหนึ่ง
Contentful
ในสเปซและสภาพแวดล้อมทดสอบ ใส่โทเค็น management API ที่อ่านและแก้ไขรายการเป้าหมายได้ใน CONTENTFUL_INTEGRATION_TOKEN กำหนด spaceId, environmentId, entryId, fieldId และ locale (เช่น en-US) รองรับฟิลด์ข้อความที่มีอยู่ แต่ไม่รองรับ Rich Text การเปลี่ยนแปลงรายการที่เผยแพร่แล้วจะยังไม่เผยแพร่จนกว่าคุณจะเผยแพร่แยก
Sanity
ใน dataset ทดสอบ ใส่โทเค็นที่อ่านและแก้ไขฉบับร่างเป้าหมายได้ใน SANITY_INTEGRATION_TOKEN กำหนด projectId, dataset, documentId ที่มีอยู่และขึ้นต้นด้วย drafts. และฟิลด์สตริง field ไม่รองรับ Portable Text ตรวจเนื้อหาใน Studio และเผยแพร่แยกหากต้องการให้แสดงจริง
microCMS
เตรียม list API และเนื้อหาที่ยังไม่เผยแพร่ในบริการทดสอบ แล้วใส่คีย์ที่จำกัดเฉพาะ GET และ PATCH ของ API นั้นใน MICROCMS_INTEGRATION_API_KEY ใส่ draftKey ของฉบับร่างในตัวแปรสภาพแวดล้อมที่ draftKeyEnv ในการตั้งค่าระบุ กำหนด serviceId, endpoint, id และฟิลด์ข้อความ field รองรับเฉพาะเนื้อหาที่ยังไม่เผยแพร่ที่มีอยู่แล้ว
การทดสอบและการใช้งาน
- ใช้ข้อมูลทดสอบตรวจว่า URL ฟิลด์ และค่า “ก่อน” ตรงกัน แล้วประมวลผลการแก้ไขที่อนุมัติแล้วเพียงรายการเดียว
- ตรวจค่าและเวอร์ชันของฉบับร่างในหน้าผู้ดูแล CMS และตรวจว่าหน้าที่เผยแพร่ไม่เปลี่ยน ทดสอบการอัปเดต WordPress โดยตรงกับหน้าทดสอบ
- ตรวจหาสาเหตุเมื่อค่า “ก่อน” ไม่ตรงหรือมีข้อผิดพลาดด้านสิทธิ์ หากไม่แน่ใจว่าบันทึกสำเร็จหรือไม่ ให้ทำต่อด้วยบันทึกเดิมแล้วอ่านกลับ อย่าส่งซ้ำโดยไม่ตรวจ และอย่าลบบันทึก
กับ microCMS, Shopify และ Webflow ไม่สามารถป้องกันการแก้ไขพร้อมกันระหว่างการตรวจครั้งสุดท้ายกับการบันทึกได้ทั้งหมด ระหว่างทดสอบ ตรวจให้แน่ใจว่าไม่มีคนหรืองานอื่นแก้ไขเรคคอร์ดเดียวกัน