الربط
دليل ربط المواقع
تعتمد طريقة وصول التعديلات إلى موقعك على طريقة بنائه. ابدأ بموقع تجريبي وبيانات تجريبية، وتأكد من وجهة كل تعديل ومن نشره أو عدمه.
لست مطوّرًا؟ يشرح دليل الإعداد ربط Google وWordPress مع لقطات الشاشة.
التحضير المشترك
تتطلب واجهة API للمواقع المخصصة ومهام مسودات CMS خطة Growth أو Pro نشطة، وتحققًا مؤكدًا من ملكية الموقع، وموافقة المالك على كل تعديل. أكّد الملكية في شاشة Connections، ثم أنشئ مفتاحًا يستطيع تسجيل النتائج في شاشة API. لا يستطيع مفتاح API وحده الموافقة على التعديلات.
اربط كل عنوان URL لصفحة HTTPS وكل حقل تعديل، واحدًا واحدًا، بسجل CMS والحقل اللذين يظهران فعلًا في تلك الصفحة. قبل الإعداد، جهّز بيانات تجريبية وشخصًا مسؤولًا وإجراءات النشر لديك.
المواقع المخصصة
نفّذ المعالجة على خادم موقعك وفق مواصفات واجهة API للتعديلات. اجلب التعديلات الموافق عليها، وتحقق من العنوان والحقل مقابل قائمة سماح، واحفظ مسودة فقط عندما تطابق القيمة الحالية القيمة «قبل». أبلغ 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 بنقطة نهاية ومعرّف محتوى وحقل في 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
ضع في WEBFLOW_INTEGRATION_TOKEN رمزًا بصلاحية قراءة وكتابة CMS لموقع تجريبي. حدّد حقل PlainText قابلًا للتحرير في اللغة الأساسية عبر collectionId وitemId وfieldSlug. تحقق من أن القالب يعرض ذلك الحقل فعلًا. تُحفظ التغييرات في بيئة staging، والنشر خطوة منفصلة.
Contentful
في مساحة وبيئة تجريبيتين، ضع في CONTENTFUL_INTEGRATION_TOKEN رمز API إدارة يستطيع قراءة الإدخال المستهدف وتحريره. حدّد spaceId وenvironmentId وentryId وfieldId وlocale (مثل en-US). الحقول النصية الموجودة مدعومة، أما Rich Text فلا. تبقى تغييرات الإدخال المنشور غير منشورة حتى تنشرها بشكل منفصل.
Sanity
في مجموعة بيانات تجريبية، ضع في SANITY_INTEGRATION_TOKEN رمزًا يستطيع قراءة المسودة المستهدفة وتحريرها. حدّد projectId وdataset وdocumentId موجودًا يبدأ بـ drafts. وحقلًا نصيًا field. Portable Text غير مدعوم. راجع المحتوى في Studio وانشره بشكل منفصل إذا أردت إتاحته.
microCMS
جهّز واجهة قائمة ومحتوى غير منشور في خدمة تجريبية، وضع في MICROCMS_INTEGRATION_API_KEY مفتاحًا مقصورًا على GET وPATCH لتلك الواجهة. ضع draftKey الخاص بالمسودة في متغير البيئة الذي يحدده draftKeyEnv في الإعداد. حدّد serviceId وendpoint وid وحقلًا نصيًا field. لا يُدعم إلا المحتوى غير المنشور الموجود.
الاختبار والتشغيل
- باستخدام بيانات تجريبية، تأكد من تطابق العنوان والحقل والقيمة «قبل»، ثم عالج تعديلًا واحدًا فقط موافقًا عليه.
- تحقق من قيمة المسودة ونسختها في لوحة إدارة CMS، ومن أن الصفحة المنشورة لم تتغير. اختبر التحديثات المباشرة في WordPress على صفحة تجريبية.
- ابحث في أي عدم تطابق في القيمة «قبل» أو أي خطأ في الأذونات. إذا لم تعرف هل نجح الحفظ، فاستأنف بالسجل نفسه واقرأ مجددًا. لا تعد الإرسال عشوائيًا ولا تحذف السجل.
مع microCMS وShopify وWebflow، لا يمكن منع التعديلات المتزامنة بين الفحص الأخير والحفظ منعًا تامًا. أثناء الاختبار، تأكد من أن لا شخص آخر ولا مهمة أخرى تحرر السجل نفسه.