Skip to main content

Migration to Third-Party Mode

Superdav AI Agent v1.12.0 شێوازی کارکردنی تواناکانی تری (third-party) دەگۆڕێت. مۆدی تری ئێستا بە پێی خودی (auto) دەستپێدەکات، ئەمەش ڕێگە دەدات بۆ یەکگرتووکردنی APIی Abilitiesی وۆرسپرید لە وۆرسپرید 7.0 و بەرزتران بەبێ پێویستی تنظیماری دەستکاریکراو.

چی گۆڕاوە؟​

پێش v1.12.0​

تواناکانی تری پێویست بوون بە ڕێکخستنی دەستکاریکراو:

  • پێویست بوو کە "مۆدی تری تری" (third-party mode) بە شێوەیەکی ڕوون چالاک بکرێت
  • تواناکان لە تۆمارێکی تایبەت دابھاتوو بوون
  • یەکگرتووکردنەوە لەگەڵ WordPress Abilities API ئاسایی بوو پۆلسیار بوو
  • مۆدی کۆن (legacy mode) بە پێی خودی دەستپێدەکرد

دوای v1.12.0​

تواناکانی تری بە شێوەیەکی ئۆتۆماتیک کار دەکەن:

  • مۆدی تری ئێستا بە "auto" دەستپێدەکات
  • تواناکان بە شێوەیەکی سروشتی لەگەڵ WordPress Abilities API یەکگرتوو دەبن
  • پێویستی بە هیچ ڕێکخستنێکی دەستکاریکراو نییە لە وۆرسپرید 7.0 و بەرزتراندا
  • مۆدی کۆن 여전히 بۆ وەرگرتنی وۆرسپریدەکانی پێشتر بێت هەیە

کی کاریگەری دەکات؟​

جێبەجێکردنی نوێ (WordPress 7.0+)​

هیچ کارێک پێویست نییە. مۆدی تری ئێستا بە ئۆتۆماتیک بۆ "auto" دیار دەکرێت، و تواناکان بە شێوەیەکی سروشتی کار دەکەن.

جێبەجێکردنی ئێستا (Existing Installations)​

تنظیمەکانت پارێزراون. ئەگەر تۆ لە کاردانەوەی ئەم شێوازەدا بوویت:

  • مۆدی کۆن (Legacy mode): تۆ بە مۆدی کۆن دەمێنیتەوە (گۆڕان نییە)
  • مۆدی تری دەستکاریکراو: تۆ بە مۆدی دەستکاریکراو دەمێنیتەوە (گۆڕان نییە)
  • مۆدی ئۆتۆماتیک (Auto mode): تۆ بە مۆدی ئۆتۆماتیک بەردەوام دەبێیت (گۆڕان نییە)

وەرگرتنی وۆرسپریدەکانی پێش 7.0​

مۆدی کۆن 여전히 هەیە. ئەگەر لەسەر WordPress 6.x یان پێشتر بیت:

  • مۆدی تری ئێستا بە "legacy" دەستپێدەکات
  • دەتوانیت مۆدی تری تری بە شێوەیەکی دەستکاریکراو چالاک بکەیت ئەگەر دەتەوێت
  • بۆ بەکارهێنانی APIی Abilitiesی سروشتی، بگۆڕان بۆ WordPress 7.0+

تێگەیشتن لە مۆدەکاندا​

مۆدی ئۆتۆماتیک (Auto Mode) (پێشنی نوێ)​

مۆدی ئۆتۆماتیک بەکارهێنانی یەکگرتووکردنەوەی سروشتی WordPress Abilities API دەکات:

  • تواناکان لە ڕێگەی hookەکانی WordPress تۆمار دەکرێن
  • کامڵ توافق (compatibility) لەگەڵ WordPress 7.0 و بەرزتراندا بۆ Abilities API
  • گەڕانەوەی ئۆتۆماتیک بۆ تواناکانی تری
  • پێویستی بە هیچ ڕێکخستنێکی دەستکاریکراو نییە

Kêta ku bikar e: WordPress 7.0+ bi hara xwezîyên sêyên cinî (third-party)

Modela Manavur (Manual Mode)​

Modela manavur پێویستی بە ڕێکخستنی دیاریکراو هەیە:

  • تۆ دەتوانی دیاری بکە چ جۆرە تواناکانی سێیەکانی تری لودر بکە
  • بۆ تاقیکردنەوە یان لودرکردنی تواناکانی دیاریکراو بەکار دێت
  • پێویستی بە دەستکاری فایلەکانی ڕێکخستن هەیە
  • کۆنترۆڵێکی زیاتر دەبێت، بەڵام سیستەمەکەی زیاتر دەبێت

کەدا بکاربهێنرێت: تاقیکردنەوە، لودرکردنی تواناکانی دیاریکراو یان ڕێکخستنەکانی تایبەت

Modela کۆن (Legacy Mode)​

Modela کۆن لە سیستەمی کۆن و تواناکانی سێیەکانی تری بەکارهێنانی:

  • تۆمارکردنی توانای تایبەت (ناتوانێت API ی WordPress Abilities بکەیت)
  • پشتیوانی بۆ وەرگرتنی وەرگرتنی پێشترترین وەرگرتنی WordPress
  • هیچ یەکگرتوویی ناوخۆیی لەگەڵ WordPress نییە
  • کۆنکاراتووە بەڵام هێشتا پشتگیریکراوە

کەدا بکاربهێنرێت: WordPress 6.x یان پێشتر، یان کاتێک پێویستت بە پشتیوانی کۆن هەیە

چاودێریکردنی مۆدێل ئێستای تۆ​

لە ڕێگەی پۆینتی ئیدارە (Admin Panel)​

  1. بگواشبە WordPress Admin → Superdav AI Agent → Settings
  2. لێی بگەڕێ بۆ ڕێکخستنی Third-Party Mode
  3. مۆدێلی ئێستای تۆ و هەڵبژاردنەکانی گۆڕینییدا دەبینیت

لە ڕێگەی کۆد (Via Code)​

$mode = get_option( 'superdav_third_party_mode' );
echo $mode; // 'auto', 'manual', یان 'legacy'

گۆڕینی مۆدێلەکەت​

گواستنەوە بۆ Mode Auto (Auto Mode)​

ئەگەر لە WordPress 7.0+ بیت و دەتەوێت بەکاریی Mode Auto بەکاربهێنیت:

  1. بگواشبە Superdav AI Agent → Settings
  2. لێی بگەڕێ بۆ Third-Party Mode
  3. هەڵبژێرە Auto (WordPress Abilities API)
  4. Save بکە

Superdav AI Agent بە شێوەیەکی ئۆتۆماتیک تواناکانی سێی تری دەدۆزێتەوە و تۆمار دەکات.

گواستنەوە بۆ Mode Manual (Manual Mode)​

ئەگەر دەتەوێت خۆت کۆنترۆڵ بکەیت چ جۆرە توانایەک لودر بکرێت:

  1. بگواشبە Superdav AI Agent → Settings
  2. لێی بگەڕێ بۆ Third-Party Mode
  3. هەڵبژێرە Manual
  4. Save بکە
  5. فایلێکی ڕێکخستنی خۆت دەستکاری بکە بۆ دیاریکردنی ئەو توانایانەی کە دەتەوێت لودر بکرێن

گواستنەوە بۆ Mode Legacy (Legacy Mode)​

ئەگەر پێویستت بە پشتیوانی کۆن هەیە:

١. سەردنی Superdav AI Agent گەڕانید → Settings (تنظیمات) ٢. Third-Party Mode (حالت س trey-پارتی) رو پیدا کن ٣. Legacy (پیروی/قدیمی) رو انتخاب کن ٤. روی Save (ذخیره) کلیک کن

مزایای حالت Auto Mode (خودکار)​

کشف خودکار قابلیت‌ها​

قابلیت‌ها به صورت خودکار از موارد زیر پیدا میشن:

  • پلاگین‌های نصب شده
  • تم فعال
  • پلاگین‌های ضروری (Must-use plugins)
  • پلاگین‌های Drop-in

نیازی به ثبت دستی نیست.

یکپارچگی بومی (Native Integration)​

قابلیت‌ها با WordPress Abilities API یکپارچه میشن:

  • با هسته اصلی وردپرس سازگار است
  • با پنل مدیریت وردپرس کار می‌کند
  • با سایر پلاگین‌هایی که از Abilities API استفاده می‌کنند سازگار است
  • در آینده هم آماده است چون وردپرس در حال تکامل است.

مدیریت ساده‌تر​

  • نیازی به ویرایش فایل‌های پیکربندی نیست
  • نیازی به ثبت دستی قابلیت نیست
  • تنظیمات دید قابلیت‌ها (Ability Visibility controls) به صورت خودکار کار می‌کنند
  • اعلان‌های پنل مدیریت شما را از قابلیت‌های دسته‌بندی نشده مطلع می‌کنند.

عملکرد بهتر​

  • قابلیت‌ها کش می‌شوند (cached)
  • فقط در زمان نیاز بارگذاری می‌شوند (Lazy-loaded on demand)
  • برای وردپرس ۷.۰ و بالاتر بهینه شده است.

مسیر مهاجرت (Migration Path)​

اگر روی WordPress 6.x هستید​

۱. به WordPress 7.0+ ارتقا دهید (وقتی آماده بودید) ۲. Superdav AI Agent را به نسخه v1.12.0+ به‌روزرسانی کنید ۳. حالت third-party mode را به Auto تغییر دهید (اختیاری؛ حالت legacy همچنان کار می‌کند) ۴. دید قابلیت‌ها (ability visibility) رو بررسی کنید تا مطمئن شوید کنترل دسترسی درست تنظیم شده است.

اگر روی WordPress 7.0+ هستید​

۱. Superdav AI Agent را به نسخه v1.12.0+ به‌روزرسانی کنید ۲. تأیید کنید که حالت third-party mode روی Auto تنظیم شده باشد (به صورت پیش‌فرض باید اینطور باشد) ۳. دید قابلیت‌ها رو بررسی کنید تا مطمئن شوید کنترل دسترسی درست اعمال شده است. ۴. قابلیت‌های third-party را تست کنید تا مطمئن شوید کار می‌کنند.

عیب‌یابی (Troubleshooting)​

قابلیت‌ها در حالت auto mode بارگذاری نمی‌شوند​

  • تأیید کنید که روی WordPress 7.0+ هستید
  • بررسی کنید که حالت third-party mode روی "Auto" تنظیم شده باشد
  • تأیید کنید که پلاگینی که این قابلیت را فراهم می‌کند فعال است
  • لاگ‌های خطا (error logs) وردپرس را برای خطاهای ثبت (registration errors) چک کنید.

من می‌خواهم از حالت legacy استفاده کنم​

  • به Settings → Third-Party Mode بروید
  • Legacy (پیروی/قدیمی) رو انتخاب کنید
  • روی Save کلیک کنید
  • حالت legacy همچنان کار خواهد کرد.

تواناکانی تایبەکانی خۆم نیشان ناکرێت​

  • د ډاډ ترلاسه کړئ چې دوی له لارې چې په WordPress hooks کې ثبت شوي دي
  • وګورئ چې تاسو یې Abilities API بهلانه پیاده کړی دی
  • لوګहरूको WordPress خطا (error logs) بیاکتنه وکړئ
  • د Ability Visibility администраټ صفحه کارولای شي چې ټول ثبت شوي تواناکان و ګورئ

زه "unclassified ability" اطلاعاتي ترلاسه کوم​

  • دا د نوی درې درې طرفه تواناکانو لپاره معمول دی
  • په admin notice کې دوی بیاکتنه وکړئ او класиفای کړئ
  • د کلاسifying (classification) جزئیات د Ability Visibility لرو وګورئ

پښتو ساتل (Backward Compatibility)​

اوسني تنظیمات​

که تاسو اوس هم درې درې طرفه تواناکانو اصلي تنظیمات لرئ:

  • Legacy mode: ستاسو تنظیم یې کار کوي
  • Manual mode: ستاسو تنظیم یې کار کوي
  • Auto mode: ستاسو تنظیم وي منغله (auto mode به اوږدوي)

که تاسو خپل ځانګړي تنظیم ساتلی غواړئ، په Manual یا Legacy mode کې پاتې شئ.

د منقصه وخت پلان (Deprecation Timeline)​

  • v1.12.0: Legacy او Manual modes لاهمي دعمونه لري
  • v1.13.0+: Legacy mode ممکن منقصه اطلاعاړې ښکاره کړي
  • v2.0.0: Legacy mode ممکن منغله شي (تیین کیږي)

غوره عملونه (Best Practices)​

د نوي تثبیتونو لپاره​

  • Auto mode کار وا관계 کړئ (دا پیشټ دی)
  • اجازه ورکړئ چې Superdav AI Agent تواناکان بهلانه و ګورئ
  • د ورته رسېدونکو (access) کنټرول لپاره Ability Visibility کار وا관계 کړئ

د اوسني تثبیتونو لپاره​

  • که ممکن وي، تر WordPress 7.0+ ارتقاء وکړئ
  • ساده مدیریت لپاره Auto mode ته بدل کړئ
  • د تواناکانو بیاکتنه او کلاسifying لپاره Ability Visibility کار وا관계 کړئ

د ځانګړو تواناکانو لپاره​

  • تواناکان له لارې چې په WordPress hooks کې ثبت شوي دي (Abilities API) ثبت کړئ
  • ځانګړي ability registries څخه ډډه وکړئ
  • تر WordPress 7.0+ Auto mode سره آزمویني وکړئ

تګلارې (Next Steps)​

١. بررسی نسخه وردپرس خود: مطمئن شوید که از ۷.۰ به بالا استفاده می‌کنید تا حالت اتوماتیک (Auto mode) کار کند. ٢. بررسی حالت شخص ثالث (third-party mode): به تنظیمات بروید و حالت فعلی خود را چک کنید. ٣. در صورت نیاز به‌روزرسانی: اگر از وردپرس ۷.۰ به بالا استفاده می‌کنید، به حالت اتوماتیک تغییر دهید. ٤. طبقه‌بندی قابلیت‌ها: هر قابلیت دسته‌بندی نشده‌ای را بررسی و طبقه‌بندی کنید. ٥. تست: تأیید کنید که قابلیت‌های شخص ثالث شما به درستی کار می‌کنند.

موضوعات مرتبط​

  • نمایش قابلیت (Ability Visibility): کنترل کنید کدام قابلیت‌ها کجا نمایش داده می‌شوند.
  • API قابلیت وردپرس (WordPress Abilities API): درباره ثبت قابلیت‌های بومی وردپرس بیاموزید.
  • توسعه قابلیت شخص ثالث (Third-Party Ability Development): قابلیت‌هایی بسازید که با حالت اتوماتیک کار کنند.