تخطَّ إلى المحتوى
Delivery API
قبل أن تخطط اعتمادًا على أي ميزة، اطلع على حالة القدرات.

الأدلةالمحتوى

المعاينة والنشر والتراجع

المسودات، والمعاينة في تصميمك الفعلي، والمراجعات غير القابلة للتغيير، والنشر المجدول، والتراجع.

تُرجمت هذه الصفحة من الإنجليزية. وفي حال وجود أي اختلاف، تسري النسخة الإنجليزية. اقرأ بالإنجليزية

كل تغيير في Studio يكون مسودة أولًا. لا تعيد Delivery API المنشورة المسودات أبدًا، فلا يمكن أن تتسرب إلى موقعك بالخطأ.

يستطيع المحررون رؤية المسودة بثلاث طرق:

  • Website view في محرر الصفحات يعرض موقعك الفعلي في إطار بجانب الحقول.
  • Full-screen preview وpop-out يعرضان المسودة بأحجام شاشات مختلفة.
  • Preview on website يفتح مسار المعاينة في موقعك برابط لمرة واحدة صالح لمدة 15 دقيقة.

تحتاج المعاينة إلى مسار معاينة في موقعك (انظر ربط موقع Next.js) وتعمل في التطوير فقط. تُقدَّم المسودات دائمًا مع noindex ولا تُخزَّن مؤقتًا أبدًا.

يستطيع المحررون اختياريًا النقر على قسم في الصفحة المعاينة لتحديده في Studio. في معاينة المسودات فقط، يقوم موقعك بما يلي:

  1. يضع data-atlas-section-id="<section id>" على عنصر كل قسم؛
  2. يرسل { type: 'atlas:ready' } إلى النافذة الأم عندما يعمل داخل إطار؛
  3. عند النقر، يمنع التنقل ويرسل { type: 'atlas:select', sectionId }؛
  4. يرسم إطارًا حول القسم المسمّى في { type: 'atlas:highlight', sectionId }.

اقبل الرسائل من أصل Studio فقط، وأرسل الرسائل إلى أصل Studio فقط. لا شيء من هذا يعمل خارج المعاينة.

ينشئ النشر مراجعة غير قابلة للتغيير. يراها موقعك عند طلبه التالي، أو فورًا عند استخدام webhooks. قبل النشر، يسرد Studio أي مشكلات في النشر (مثل حقل مطلوب تُرك فارغًا)، ولا يمكن نشر الصفحة إلى أن تُعالَج.

تدعم المجموعات التحريرية (الأخبار، المقالات) أيضًا النشر المجدول والمعرّفات النصية (slugs) وخلاصة RSS.

  • في التطوير، استعد مراجعة سابقة لصفحة وانشرها من جديد.
  • في الإنتاج، ارجع إلى إصدار سابق. وهذا يتطلب صلاحية التراجع.

التراجع نفسه حدث جديد مسجَّل. لا يُحذف شيء.