تكامل WordPress REST API

يشرح هذا الدليل كيفية استخدام OpenClaw Ultra لإدارة موقع WordPress الخاص بك — نشر المقالات، وإدارة منتجات WooCommerce، واختيار التصنيفات، وملء الوسوم — كل ذلك من خلال REST API الخاص بـ WordPress.

المتطلبات الأساسية

• موقع WordPress مستضاف ذاتياً (wordpress.org، وليس wordpress.com)
• إضافة Basic Auth مثبتة على موقع WordPress الخاص بك
• OpenClaw Ultra مثبت على سطح مكتب Windows الخاص بك

الخطوة 1: تثبيت إضافة Basic Auth

واجهة REST API الخاصة بـ WordPress تتطلب مصادقة. أسهل طريقة هي استخدام إضافة Basic Auth.

1. قم بتنزيل الإضافة من: https://github.com/WP-API/Basic-Auth
2. في لوحة تحكم WordPress، انتقل إلى الإضافات → إضافة جديد → رفع إضافة
3. قم برفع الملف Basic-Auth-master.zip الذي تم تنزيله
4. انقر على تفعيل

مصادقة بديلة

إذا كان الخادم الخاص بك يدعم OAuth أو كلمات مرور التطبيقات (WordPress 5.6+)، يمكنك استخدامها بدلاً من ذلك. يستخدم هذا الدليل Basic Auth للبساطة.

الخطوة 2: إنشاء ملف .env للبيانات الاعتمادية

قم بإنشاء ملف .env في مكان آمن على جهاز الكمبيوتر الخاص بك لتخزين بيانات اعتماد موقع WordPress.

قم بإنشاء ملف باسم wordpress.env بالمحتوى التالي:

WP_SITE_URL=https://yoursite.com
WP_USERNAME=your-admin-username
WP_APPLICATION_PASSWORD=your-password

حافظ على أمان ملف .env

لا تقم أبداً بإضافة ملف .env إلى نظام التحكم في الإصدارات أو مشاركته علناً. أضف *.env إلى ملف .gitignore الخاص بك.

الخطوة 3: تكوين OpenClaw Ultra لقراءة ملف .env

في OpenClaw Ultra، يمكنك استخدام مهارة File لقراءة ملف .env وتحميل البيانات الاعتمادية.

1. فتح OpenClaw Ultra
2. في الدردشة، اكتب:

اقرأ الملف الموجود في C:\path\to\wordpress.env وخزّن كل سطر كمتغير.

3. سيقوم OpenClaw Ultra بتحليل ملف .env وجعل القيم متاحة للطلبات اللاحقة.

الخطوة 4: نشر مقالة WordPress عبر REST API

يمكنك الآن استخدام OpenClaw Ultra لإنشاء ونشر مقالات WordPress تلقائياً.

مثال على التعليمات:

باستخدام REST API الخاص بـ WordPress على {WP_SITE_URL}/wp-json/wp/v2/posts،
قم بإنشاء مقالة جديدة بـ:
- Title: "My First Automated Post"
- Content: "This post was created by OpenClaw Ultra via the WordPress REST API."
- Status: publish
- Categories: Technology, AI
- Hashtags: #WordPress #Automation #OpenClaw

استخدم Basic Auth مع اسم المستخدم {WP_USERNAME} وكلمة المرور {WP_APPLICATION_PASSWORD}.

سيرسل OpenClaw Ultra طلب POST إلى نقطة نهاية REST API الخاصة بـ WordPress وينشر مقالتك.

مرجع نقاط نهاية API

الإجراء	Endpoint	Method
إنشاء مقالة	/wp-json/wp/v2/posts	POST
تحديث مقالة	/wp-json/wp/v2/posts/{id}	PUT
الحصول على مقالات	/wp-json/wp/v2/posts	GET
حذف مقالة	/wp-json/wp/v2/posts/{id}	DELETE

الخطوة 5: إدارة منتجات WooCommerce

إذا كان WooCommerce مثبتاً، يمكنك أيضاً إدارة المنتجات عبر REST API الخاص بـ WooCommerce.

مثال على التعليمات:

باستخدام REST API الخاص بـ WooCommerce على {WP_SITE_URL}/wp-json/wc/v3/products،
قم بإنشاء منتج جديد بـ:
- Name: "AI Automation Course"
- Type: simple
- Regular price: 49.99
- Description: "Learn how to automate your workflows with AI."
- Categories: Courses, Digital Products
- Stock: 100

استخدم Basic Auth مع اسم المستخدم {WP_USERNAME} وكلمة المرور {WP_APPLICATION_PASSWORD}.

نقاط نهاية API الخاصة بـ WooCommerce

الإجراء	Endpoint	Method
إنشاء منتج	/wp-json/wc/v3/products	POST
الحصول على منتجات	/wp-json/wc/v3/products	GET
تحديث منتج	/wp-json/wc/v3/products/{id}	PUT
حذف منتج	/wp-json/wc/v3/products/{id}	DELETE
الحصول على طلبات	/wp-json/wc/v3/orders	GET
إنشاء تصنيف	/wp-json/wc/v3/products/categories	POST

الخطوة 6: اختيار التصنيفات

قبل تعيين التصنيفات لمقالاتك، قد تحتاج إلى العثور على معرفات التصنيفات الموجودة.

تعليمات للحصول على التصنيفات:

باستخدام REST API الخاص بـ WordPress على {WP_SITE_URL}/wp-json/wp/v2/categories،
قم بسرد جميع التصنيفات في الموقع.

استخدم Basic Auth مع اسم المستخدم {WP_USERNAME} وكلمة المرور {WP_APPLICATION_PASSWORD}.

لإنشاء تصنيف جديد:

أنشئ تصنيفاً جديداً باسم "AI Tutorials" عبر:
POST {WP_SITE_URL}/wp-json/wp/v2/categories
مع اسم "AI Tutorials" ورابط slug "ai-tutorials".

استخدم Basic Auth مع اسم المستخدم {WP_USERNAME} وكلمة المرور {WP_APPLICATION_PASSWORD}.

الخطوة 7: ملء الوسوم تلقائياً

يمكنك أن تطلب من OpenClaw Ultra إنشاء وإضافة وسوم ذات صلة بمقالاتك.

مثال على التعليمات:

للمقالة بعنوان "My First Automated Post" على {WP_SITE_URL}،
قم بإنشاء 5 وسوم ذات صلة بناءً على محتواها وأضفها إلى المقالة.

استخدم REST API الخاص بـ WordPress لتحديث وسوم أو حقول المقالة المخصصة.
استخدم Basic Auth مع اسم المستخدم {WP_USERNAME} وكلمة المرور {WP_APPLICATION_PASSWORD}.

استكشاف الأخطاء وإصلاحها

خطأ 401 غير مصرح

• تأكد من تفعيل إضافة Basic Auth
• تحقق من صحة اسم المستخدم وكلمة المرور
• تأكد من أن موقع WordPress الخاص بك يستخدم HTTPS

404 نقطة النهاية غير موجودة

• تأكد من تفعيل الروابط الدائمة الجميلة في الإعدادات → الروابط الدائمة
• تحقق من إمكانية الوصول إلى REST API: {WP_SITE_URL}/wp-json/

403 ممنوع / محظور بواسطة Cloudflare

إذا حصلت على خطأ 403، فقد يكون Cloudflare يحظر طلب API. يحدث هذا لأن طلبات REST API الخاصة بـ WordPress من الأدوات الآلية قد يتم وضع علامة عليها كمشبوهة.

الحل — تعيين رأس User-Agent مخصص:

عند تقديم الطلبات عبر OpenClaw Ultra، قم بتعيين سلسلة User-Agent شائعة بشكل صريح حتى يعامل Cloudflare الطلب وكأنه قادم من متصفح حقيقي. على سبيل المثال:

User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36

في تعليمات OpenClaw Ultra الخاصة بك، قم بتضمين رأس User-Agent بهذه الطريقة:

POST {WP_SITE_URL}/wp-json/wp/v2/posts
Headers:
  User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36
  Authorization: Basic {base64-encoded-credentials}

Body:
  title: "My Post"
  content: "Post content"
  status: publish

نقطة نهاية WooCommerce غير متاحة

• تأكد من تثبيت وتفعيل إضافة WooCommerce
• واجهة API الخاصة بـ WooCommerce تتطلب WooCommerce 3.0+

الخطوات التالية

• استكشف نقاط نهاية REST API الأخرى الخاصة بـ WordPress
• أتمتة جداول نشر المحتوى
• بناء سير عمل كامل للمحتوى باستخدام OpenClaw Ultra

تابع مع أدلة التكامل الأخرى لتوسيع قدرات الأتمتة لديك.