ووردبريس

WordPress REST API: بناء واجهة رأس منفصل (Headless) في ٢٠٢٦

٢٧ يونيو ٢٠٢٦ 11 دقائق قراءة
معمارية WordPress Headless مع واجهة حديثة

الاستخدام "الرأس المنفصل" (Headless) لـ WordPress يعني الاحتفاظ بـ WordPress كنظام إدارة محتوى فقط، مع بناء الواجهة الأمامية بتقنية حديثة مثل Next.js أو TanStack Start. هذا يجمع بين سهولة CMS الشهير وأداء الويب الحديث.

لماذا Headless؟

  • أداء أعلى بكثير (ثوانٍ إلى ملّي ثوانٍ في زمن الاستجابة).
  • أمان أفضل — WordPress محجوب عن الجمهور.
  • حرية كاملة في تصميم الواجهة.
  • إمكانية بناء تطبيقات جوال بنفس API.

استخدام REST API

WordPress يوفّر /wp-json/wp/v2/ افتراضياً. أشهر النقاط: posts، pages، categories، media، وusers. مثال:

GET /wp-json/wp/v2/posts?per_page=10&_embed

المصادقة

للقراءة العامة لا تحتاج مصادقة. للكتابة استخدم Application Passwords المدمج في WordPress منذ الإصدار ٥.٦، أو JWT مع إضافة موثوقة.

حقول مخصصة (ACF)

فعّل خيار "Show in REST API" في إعدادات كل حقل. ستظهر الحقول تحت acfفي استجابة JSON.

بناء الواجهة

  • Next.js مع SSG لصفحات المدونة (سرعة عالية + SEO ممتاز).
  • Astro لمواقع محتوى غالباً ثابتة.
  • TanStack Start لتطبيقات ديناميكية مع SSR.

إعادة التوليد (Revalidation)

استخدم Webhooks من WordPress لتشغيل إعادة بناء الصفحات فور نشر محتوى جديد. Next.js يدعم on-demand revalidation.

SEO

اقرأ Yoast SEO أو Rank Math عبر REST API واعرض العلامات الوصفية في <head> مباشرة.

الاستضافة

WordPress على استضافة رخيصة (Cloudways/DigitalOcean $12)، والواجهة على Vercel أو Cloudflare Pages. التكلفة الإجمالية أقل من WordPress التقليدي على استضافة متميزة.

الخلاصة

Headless WordPress حل قوي عندما تحتاج مرونة تصميم متقدمة وأداء عالٍ، مع الاحتفاظ بتجربة تحرير مألوفة لفريق المحتوى.

أسئلة شائعة

هل تعمل إضافات WordPress كلها؟

لا. إضافات الواجهة الأمامية (Forms، Sliders) لن تعمل. البحث عن بدائل React ضروري.

ماذا عن التعليقات؟

استخدم Disqus أو Giscus بدلاً من نظام التعليقات المدمج.