كل المقالاتالتكاملات

إعداد تكامل مدونة Next.js من ألف

استخدم تكامل مدونة Next.js عندما تريد نشر مقالات ألف على موقعك دون كشف مفتاح API داخل كود المتصفح.

ففريق منتج ألف٥ دقائق قراءة
إعداد تكامل مدونة Next.js من ألف
01

أنشئ التكامل داخل ألف

افتح الإعدادات، ثم التكاملات، واختر Next.js Blog. أنشئ التكامل وانسخ مفتاح API من نافذة النجاح قبل إغلاقها.

احفظ المفتاح في بيئة النشر باسم BLOG_API_KEY أو أي اسم خاص بالخادم يتوقعه عميل المدونة. لا تستخدم بادئة NEXT_PUBLIC_ لأنها ستجعل السر يظهر في كود المتصفح.

02

ثبّت عميل المدونة في تطبيق Next.js

انسخ عميل مدونة ألف ومسارات المدونة إلى مشروع App Router، أو طبّق النمط نفسه داخل مدونتك الحالية. الحد المهم هو أن طلبات المقالات تعمل فقط في Server Components أو route handlers أو أدوات الخادم.

وجّه العميل إلى رابط API الخاص بألف، ومرر مفتاح API كرمز Bearer، واعرض HTML الخاص بالمقال داخل صفحة المقال المعروضة من الخادم فقط.

03

انشر مسارات SEO

وفّر فهرساً للمدونة، ومسار مقال مثل /blog/[slug]، ومدخلاً في sitemap للمقالات المنشورة. إذا كانت المقالات تستخدم صوراً بعيدة، اسمح بمضيفي الصور داخل next.config.js أو استخدم طريقة عرض صور تناسب إعدادك.

استخدم التخزين المؤقت لقوائم المقالات وصفحات المقالات حتى يحصل الزوار على صفحات سريعة وتبقى ألف مصدر المحتوى المنشور. أعد النشر أو أضف revalidation عند الطلب إذا احتاج الفريق إلى ظهور التحديثات فوراً.

استخدم هذه القائمة

أنشئ تكامل Next.js Blog من شاشة التكاملات في ألف.

احفظ المفتاح الناتج في متغير بيئة خاص بالخادم فقط.

اجلب المقالات من Server Components أو route handlers أو أدوات الخادم فقط.

أضف مسارات فهرس المدونة والمقال وsitemap إلى الموقع العام.

تأكد من السماح بصور المقالات في إعدادات صور Next.js.

الخلاصة

يكون التكامل آمناً عندما لا يصل المفتاح إلى JavaScript في المتصفح وتُعرض كل صفحة مقال عامة من قراءات جهة الخادم.

حوّل هذا المقال إلى خطة ظهور

استخدم ألف لتدقيق موقعك، واكتشاف فجوات المحتوى، وإنشاء ملخصات قابلة للتنفيذ.

ابدأ مجاناً

المزيد من المدونة