إنتقل إلى المحتوى الرئيسي

ترحيل وضع الطرف الثالث

أحدثت التحديثات في Superdav AI Agent v1.12.0 طريقة التعامل مع قدرات الطرف الثالث. أصبح وضع الطرف الثالث افتراضيًا هو "تلقائي" (auto)، مما يتيح دمج واجهة برمجة تطبيقات القدرات الأصلية لـ WordPress (WordPress Abilities API) في WordPress 7.0+ دون الحاجة إلى إعداد يدوي.

ما الذي تغير؟​

قبل الإصدار v1.12.0​

كانت قدرات الطرف الثالث تتطلب إعدادًا يدويًا:

  • كان عليك تفعيل "وضع الطرف الثالث" بشكل صريح.
  • كانت القدرات تُحمَّل من سجل مخصص.
  • كان التكامل مع واجهة برمجة تطبيقات القدرات الخاصة بـ WordPress اختياريًا.
  • كان الوضع القديم (Legacy mode) هو الوضع الافتراضي.

بعد الإصدار v1.12.0​

تعمل قدرات الطرف الثالث تلقائيًا:

  • أصبح وضع الطرف الثالث افتراضيًا هو "تلقائي" (auto).
  • تندمج القدرات بشكل أصلي مع واجهة برمجة تطبيقات القدرات الخاصة بـ WordPress.
  • لم يعد هناك حاجة لإعداد يدوي في WordPress 7.0+.
  • لا يزال الوضع القديم متاحًا لإصدارات WordPress الأقدم.

من يتأثر؟​

التثبيتات الجديدة (WordPress 7.0+)​

لا يتطلب أي إجراء. تم تعيين وضع الطرف الثالث تلقائيًا على "تلقائي" (auto)، وتعمل القدرات بشكل جاهز.

التثبيتات الحالية​

يتم الحفاظ على إعداداتك. إذا كنت تستخدم:

  • الوضع القديم (Legacy mode): ستبقى في الوضع القديم (لا تغيير).
  • وضع الطرف الثالث اليدوي (Manual third-party mode): ستبقى في الوضع اليدوي (لا تغيير).
  • الوضع التلقائي (Auto mode): ستستمر في استخدام الوضع التلقائي (لا تغيير).

إصدارات WordPress قبل 7.0​

لا يزال الوضع القديم متاحًا. إذا كنت تستخدم WordPress 6.x أو أقدم:

  • يصبح وضع الطرف الثالث افتراضيًا هو "الوضع القديم" (legacy).
  • يمكنك تفعيل وضع الطرف الثالث يدويًا إذا رغبت في ذلك.
  • قم بالترقية إلى WordPress 7.0+ لاستخدام واجهة برمجة تطبيقات القدرات الأصلية.

فهم الأوضاع​

الوضع التلقائي (Auto Mode) (الوضع الافتراضي الجديد)​

يستخدم الوضع التلقائي دمج واجهة برمجة تطبيقات القدرات الأصلية لـ WordPress:

  • يتم تسجيل القدرات عبر خطافات (hooks) WordPress.
  • توافق كامل مع واجهة برمجة تطبيقات القدرات لـ WordPress 7.0+.
  • اكتشاف تلقائي لقدرات الطرف الثالث.
  • لا يتطلب إعدادًا يدويًا.

متى يُستخدم: WordPress 7.0+ مع قدرات الطرف الثالث.

الوضع اليدوي (Manual Mode)​

يتطلب الوضع اليدوي إعدادًا صريحًا:

  • تحدد أي قدرات طرف ثالث تريد تحميلها.
  • مفيد للاختبار أو التحميل الانتقائي للقدرات.
  • يتطلب تعديل ملفات الإعدادات.
  • تحكم أكبر، ولكنه يتطلب إعدادًا أكثر.

متى يُستخدم: الاختبار، أو التحميل الانتقائي للقدرات، أو الإعدادات المخصصة.

الوضع القديم (Legacy Mode)​

يستخدم الوضع القديم نظام قدرات الطرف الثالث القديم:

  • سجل قدرات مخصص (وليس واجهة برمجة تطبيقات القدرات الخاصة بـ WordPress).
  • متوافق مع الإصدارات الأقدم من WordPress.
  • لا يوجد تكامل أصلي مع WordPress.
  • مُهمَل ولكنه لا يزال مدعومًا.

متى يُستخدم: WordPress 6.x أو أقدم، أو عندما تحتاج إلى توافق مع الوضع القديم.

التحقق من وضعك الحالي​

عبر لوحة الإدارة​

  1. اذهب إلى لوحة تحكم WordPress → Superdav AI Agent → الإعدادات
  2. ابحث عن إعداد وضع الطرف الثالث (Third-Party Mode).
  3. سترى وضعك الحالي وخيارات لتغييره.

عبر الكود​

$mode = get_option( 'superdav_third_party_mode' );
echo $mode; // 'auto', 'manual', or 'legacy'

تغيير وضعك​

التبديل إلى الوضع التلقائي (Auto Mode)​

إذا كنت تستخدم WordPress 7.0+ وترغب في استخدام الوضع التلقائي:

  1. اذهب إلى Superdav AI Agent → الإعدادات.
  2. ابحث عن وضع الطرف الثالث (Third-Party Mode).
  3. اختر تلقائي (Auto) (WordPress Abilities API).
  4. انقر على حفظ (Save).

سيقوم Superdav AI Agent باكتشاف وتسجيل قدرات الطرف الثالث تلقائيًا.

التبديل إلى الوضع اليدوي (Manual Mode)​

إذا كنت تريد التحكم يدويًا في القدرات التي يتم تحميلها:

  1. اذهب إلى Superdav AI Agent → الإعدادات.
  2. ابحث عن وضع الطرف الثالث (Third-Party Mode).
  3. اختر يدوي (Manual).
  4. انقر على حفظ (Save).
  5. قم بتعديل ملف الإعدادات الخاص بك لتحديد القدرات التي تريد تحميلها.

التبديل إلى الوضع القديم (Legacy Mode)​

إذا كنت بحاجة إلى التوافق مع الوضع القديم:

  1. اذهب إلى Superdav AI Agent → الإعدادات.
  2. ابحث عن وضع الطرف الثالث (Third-Party Mode).
  3. اختر قديم (Legacy).
  4. انقر على حفظ (Save).

مزايا الوضع التلقائي (Auto Mode)​

الاكتشاف التلقائي​

يتم اكتشاف القدرات تلقائيًا من:

  • الإضافات المثبتة.
  • القالب النشط.
  • إضافات Must-use.
  • إضافات Drop-in.

لا حاجة للتسجيل اليدوي.

التكامل الأصلي (Native Integration)​

تتكامل القدرات مع واجهة برمجة تطبيقات القدرات الخاصة بـ WordPress:

  • متسق مع نواة WordPress.
  • يعمل مع لوحة تحكم WordPress.
  • متوافق مع الإضافات الأخرى التي تستخدم واجهة برمجة تطبيقات القدرات.
  • مقاوم للمستقبل مع تطور WordPress.

إدارة مبسطة​

  • لا توجد ملفات إعدادات تحتاج إلى تعديل.
  • لا يوجد تسجيل يدوي للقدرات.
  • تعمل عناصر التحكم في وضوح القدرة (Ability Visibility) تلقائيًا.
  • تنبهك إشعارات لوحة الإدارة إلى القدرات غير المصنفة.

أداء أفضل​

  • يتم تخزين القدرات مؤقتًا (cached).
  • يتم تحميلها عند الحاجة (Lazy-loaded).
  • مُحسّن لـ WordPress 7.0+.

مسار الترحيل​

إذا كنت تستخدم WordPress 6.x​

  1. قم بالترقية إلى WordPress 7.0+ (عندما تكون جاهزًا).
  2. حدّث Superdav AI Agent إلى v1.12.0+.
  3. غيّر وضع الطرف الثالث إلى تلقائي (Auto) (اختياري؛ لا يزال الوضع القديم يعمل).
  4. راجع وضوح القدرة (ability visibility) لضمان ضوابط الوصول المناسبة.

إذا كنت تستخدم WordPress 7.0+​

  1. حدّث Superdav AI Agent إلى v1.12.0+.
  2. تحقق من تعيين وضع الطرف الثالث على تلقائي (Auto) (يجب أن يكون كذلك افتراضيًا).
  3. راجع وضوح القدرة (ability visibility) لضمان ضوابط الوصول المناسبة.
  4. اختبر قدرات الطرف الثالث للتأكد من أنها تعمل.

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

القدرات لا يتم تحميلها في الوضع التلقائي​

  • تحقق من أنك تستخدم WordPress 7.0+.
  • تأكد من تعيين وضع الطرف الثالث على "تلقائي" (Auto).
  • تحقق من أن الإضافة التي توفر القدرة نشطة.
  • تحقق من سجل أخطاء WordPress بحثًا عن أخطاء التسجيل.

أريد الاحتفاظ بالوضع القديم (Legacy mode)​

  • اذهب إلى الإعدادات (Settings) → وضع الطرف الثالث (Third-Party Mode).
  • اختر قديم (Legacy).
  • انقر على حفظ (Save).
  • سيستمر الوضع القديم في العمل.

قدراتي المخصصة لا تظهر​

  • تحقق من أنها مسجلة عبر خطافات (hooks) WordPress.
  • تأكد من أنها تطبق واجهة برمجة تطبيقات القدرات (Abilities API) بشكل صحيح.
  • راجع سجل أخطاء WordPress.
  • استخدم صفحة وضوح القدرة (Ability Visibility) في لوحة الإدارة لرؤية جميع القدرات المسجلة.

أتلقى إشعارات "قدرة غير مصنفة"​

  • هذا طبيعي للقدرات الجديدة للطرف الثالث.
  • راجعها وصنفها في إشعار لوحة الإدارة.
  • راجع وضوح القدرة (Ability Visibility) للحصول على تفاصيل حول التصنيف.

التوافق مع الوضع القديم (Backward Compatibility)​

الإعدادات الحالية​

إذا كانت لديك إعدادات قدرات طرف ثالث موجودة:

  • الوضع القديم (Legacy mode): يستمر إعدادك في العمل.
  • الوضع اليدوي (Manual mode): يستمر إعدادك في العمل.
  • الوضع التلقائي (Auto mode): يتم تجاهل إعدادك (يتولى الوضع التلقائي السيطرة).

للحفاظ على إعدادك المخصص، ابق في الوضع اليدوي أو الوضع القديم.

جدول التوقف عن الدعم​

  • v1.12.0: لا يزال الوضع القديم واليدوي مدعومين بالكامل.
  • v1.13.0+: قد يظهر الوضع القديم إشعارات التوقف عن الدعم.
  • v2.0.0: قد يتم إزالة الوضع القديم (سيتم التحديد لاحقًا).

أفضل الممارسات​

للتثبيتات الجديدة​

  • استخدم الوضع التلقائي (فهو الوضع الافتراضي).
  • اسمح لـ Superdav AI Agent باكتشاف القدرات تلقائيًا.
  • استخدم وضوح القدرة (Ability Visibility) للتحكم في الوصول.

للتثبيتات الحالية​

  • قم بالترقية إلى WordPress 7.0+ كلما أمكن.
  • التبديل إلى الوضع التلقائي لإدارة مبسطة.
  • مراجعة وتصنيف القدرات باستخدام وضوح القدرة (Ability Visibility).

للقدرات المخصصة​

  • سجل القدرات عبر خطافات (hooks) WordPress (واجهة برمجة تطبيقات القدرات).
  • تجنب سجلات القدرات المخصصة.
  • اختبر على WordPress 7.0+ باستخدام الوضع التلقائي.

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

  1. تحقق من إصدار WordPress الخاص بك: تأكد من أنك تستخدم 7.0+ للوضع التلقائي.
  2. راجع وضع الطرف الثالث الخاص بك: اذهب إلى الإعدادات وتحقق من وضعك الحالي.
  3. التحديث إذا لزم الأمر: انتقل إلى الوضع التلقائي إذا كنت تستخدم WordPress 7.0+.
  4. تصنيف القدرات: راجع وصنف أي قدرات غير مصنفة.
  5. الاختبار: تحقق من أن قدرات الطرف الثالث تعمل بشكل صحيح.
  • وضوح القدرة (Ability Visibility): التحكم في القدرات التي يتم عرضها وأين.
  • واجهة برمجة تطبيقات القدرات الخاصة بـ WordPress (WordPress Abilities API): تعرّف على تسجيل القدرات الأصلي في WordPress.
  • تطوير قدرات الطرف الثالث (Third-Party Ability Development): إنشاء قدرات تعمل مع الوضع التلقائي.