Skip to main content

انتقال به حالت ثالث (Third-Party Mode Migration)

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

چی گۆڕاوە؟​

پێش v1.12.0​

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

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

دوای v1.12.0​

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

  • Third-party mode بە پێی پیش‌دۆزەوە "auto" دەستپێدەکات
  • تواناکان بە شێوەیەکی سروشتی لەگەڵ WordPress Abilities API یەکدەگرن
  • بۆ WordPress 7.0 و بەرزتر پێویستی بە ڕێکخستنی دەستکرد نییە
  • Legacy mode 여전히 بۆ ئەو وەرگرتەی WordPressانە کە پێشتر بوون بەکار دێت، بەکار دەهێنرێت

کیان affected (کێ دەگۆڕێت؟)​

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

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

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

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

  • Legacy mode: تۆ وەک لە Legacy mode دەمێنیتەوە (گۆڕان نییە)
  • Manual third-party mode: تۆ وەک لە Manual mode دەمێنیتەوە (گۆڕان نییە)
  • Auto mode: تۆ بە Auto mode بەردەوام دەبێیت (گۆڕان نییە)

وەرگرتەی WordPress پێش 7.0​

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

  • Third-party mode بە پێی پیش‌دۆزەوە "legacy" دەستپێدەکات
  • دەتوانیت بە دەستی چالاک بکەیت third-party mode ئەگەر دەتەوێت
  • بۆ بەکارهێنانی Abilities API ی سروشتی، به‌روزرسیک نێری WordPress 7.0+ بکە.

تێگەیشتن لە Mode'ەکاندا (Understanding the Modes)​

Auto Mode (پیش‌دۆزەوەی نوێ)​

Auto mode بەکاردێت بۆ یەکگرتوویی سروشتی لەگەڵ WordPress Abilities API:

  • تواناکان بە ڕێگەی WordPress hooks تۆمار دەکرێن
  • یەکگرتوویی تەواو لەگەڵ Abilities API ی WordPress 7.0 و بەرزترەکاندا
  • دۆزینەوەی ئۆتۆماتیکی تواناکانی تری (third-party abilities)
  • پێویستی بە ڕێکخستنی دەستکرد نییە

چنان که استفاده کنید: وردپرس ۷.۰+ با قابلیت‌های شخص ثالث

حالت دستی (Manual Mode)​

حالت دستی نیاز به تنظیمات مشخص دارد:

  • شما تعیین می‌کنید کدام قابلیت‌های شخص ثالث را بارگذاری کنید
  • برای تست کردن یا بارگذاری انتخابی قابلیت‌ها مفید است
  • نیاز به ویرایش فایل‌های پیکربندی دارد
  • کنترل بیشتری دارید، اما تنظیمات بیشتری لازم است

چنان که استفاده کنید: برای تست کردن، بارگذاری انتخابی قابلیت‌ها، یا تنظیمات سفارشی

حالت قدیمی (Legacy Mode)​

حالت قدیمی از سیستم قدیمی قابلیت‌های شخص ثالث استفاده می‌کند:

  • رجیستری قابلیت سفارشی (نه WordPress Abilities API)
  • با نسخه‌های قدیمی‌تر وردپرس سازگار است
  • هیچ یکپارچه‌سازی بومی با وردپرس ندارد
  • منسوخ شده اما همچنان پشتیبانی می‌شود

چنان که استفاده کنید: برای وردپرس ۶.x یا قدیمی‌تر، یا زمانی که به سازگاری قدیمی نیاز دارید

بررسی حالت فعلی خود​

از طریق پنل مدیریت (Admin Panel)​

۱. به WordPress Admin → Superdav AI Agent → Settings بروید ۲. دنبال تنظیم Third-Party Mode بگردید ۳. حالت فعلی و گزینه‌های تغییر آن را خواهید دید

از طریق کد (Code)​

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

تغییر حالت خود​

تغییر به حالت اتوماتیک (Auto Mode)​

اگر روی وردپرس ۷.۰+ هستید و می‌خواهید از حالت اتوماتیک استفاده کنید:

۱. به Superdav AI Agent → Settings بروید ۲. دنبال Third-Party Mode بگردید ۳. گزینه Auto (WordPress Abilities API) را انتخاب کنید ۴. روی Save کلیک کنید

Superdav AI Agent به طور خودکار قابلیت‌های شخص ثالث را کشف و ثبت خواهد کرد.

تغییر به حالت دستی (Manual Mode)​

اگر می‌خواهید کنترل دستی بر این کار داشته باشید که کدام قابلیت‌ها بارگذاری شوند:

۱. به Superdav AI Agent → Settings بروید ۲. دنبال Third-Party Mode بگردید ۳. گزینه Manual را انتخاب کنید ۴. روی Save کلیک کنید ۵. فایل پیکربندی خود را ویرایش کنید تا مشخص کنید کدام قابلیت‌ها بارگذاری شوند

تغییر به حالت قدیمی (Legacy Mode)​

اگر به سازگاری قدیمی نیاز دارید:

١. به Superdav AI Agent بروید ← Settings (تنظیمات) ٢. Third-Party Mode (حالت شخص ثالث) را پیدا کنید ٣. Legacy (قدیمی) را انتخاب کنید ٤. روی Save (ذخیره) کلیک کنید

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

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

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

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

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

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

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

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

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

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

عملکرد بهتر​

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

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

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

۱. به WordPress 7.0+ ارتقا دهید (وقتی آماده بودید) ۲. Superdav AI Agent را به نسخه v1.12.0+ به‌روزرسانی کنید ۳. حالت شخص ثالث را به Auto تغییر دهید (اختیاری؛ حالت Legacy همچنان کار می‌کند) ۴. دید قابلیت‌ها را بررسی کنید تا مطمئن شوید کنترل دسترسی درست است.

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

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

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

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

  • تأیید کنید که روی وردپرس ۷.۰+ هستید.
  • بررسی کنید که حالت شخص ثالث روی "Auto" تنظیم شده باشد.
  • تأیید کنید که افزونه‌ای که این قابلیت را فراهم می‌کند فعال است.
  • لاگ‌های خطا (error logs) وردپرس را برای خطاهای ثبت بررسی کنید.

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

  • به Settings ← Third-Party Mode بروید
  • Legacy را انتخاب کنید
  • روی Save کلیک کنید
  • حالت Legacy همچنان کار خواهد کرد.

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

  • دڵنیابن کە ئەوان بە ڕێگەی WordPress hooks تۆمار کراون (registered)
  • چاک بکە کە لەسەر Abilities API بە شێوەیەکی دروست جێبەجێ دەکرێن (implement)
  • تۆڕی هەڵگرتنی هەڵەی WordPress (WordPress error logs) دا چاودێری بکە
  • لە بەشی admin Ability Visibilityدا بۆ دۆزینەوەی هەموو توانیاساتی تۆمارکراوەکان

من ئاگاداری "ability"ی نیشان دەبینم​

  • ئەمە ئاساییە بۆ توانیاساتی سێیەمی نوێ (third-party abilities)
  • لە ئاگاداری adminدا چاک بکە و جۆرییان دیاری بکە (classify)
  • بۆ وردەکاری زیاتر لەسەر جۆرتان، Ability Visibility دا ببینە

ڕەتکردنەوەی پێشتر (Backward Compatibility)​

ڕێکخستنەکان کە پێشتر هەبووین (Existing Configurations)​

ئەگەر ڕێکخستنی توانیاساتی سێیەمی پێشترت هەیە:

  • Legacy mode: ڕێکخستنی تۆ بەردەوام دەبێت
  • Manual mode: ڕێکخستنی تۆ بەردەوام دەبێت
  • Auto mode: ڕێکخستنی تۆ لەدەست دەچێت (auto mode دەگرێتەوە)

ئەگەر دەتەوێت ڕێکخستنی تایبەتی خۆت پارێزراوە، لە Manual یان Legacy مۆددا بمێنە.

کاتی کۆنکردنەوەی کارکردن (Deprecation Timeline)​

  • v1.12.0: Legacy و Manual modes بە تەواوی پشتگیریک دەبن
  • v1.13.0+: Legacy mode ڕەنگە ئاگاداری کۆنکردنەوەی کارکردن نیشان بدات
  • v2.0.0: Legacy mode ڕەنگە لەناوچێت (لە ماوەی دیار دەکرێت)

باشترین شێوازی کارکردن (Best Practices)​

بۆ دامەزراندنی نوێکان (For New Installations)​

  • Auto mode بەکاربهێنە (ئەمە مۆدی پیش‌دەکەوتووە)
  • بڕیار بدات کە Superdav AI Agent توانیاساتی خۆی بە شێوەیەکی ئۆتۆماتیک دۆزێتەوە
  • لەگەڵ Ability Visibility بەکاری بهێنە بۆ کۆنترۆڵی دەستپێکردن (access control)

بۆ دامەزراندنی ئێستا (For Existing Installations)​

  • کاتێک ئەگەری هەیە، بگۆڕە بۆ WordPress 7.0+
  • بۆ بەڕێوەبردنی سادەت، بگۆڕە بۆ Auto mode
  • لەسەر Ability Visibility چاک بکە و جۆرتان دیاری بکە

بۆ توانیاساتی تایبەت (For Custom Abilities)​

  • توانیاسات بە ڕێگەی WordPress hooks تۆمار بکە (Abilities API)
  • لە تۆڕی توانیاساتی تایبەتی خۆت بەکار نهارە (Avoid custom ability registries)
  • لەسەر WordPress 7.0+ و بە Auto mode تاقیکردنەوە بکە

هەنگاوەکانی داهات (Next Steps)​

۱. پرسیان پورت وورپریز خود را چک کنید: برای حالت اتوماتیک (Auto mode) مطمئن شوید که نسخه ۷.۰ یا بالاتر دارید. ۲. حالت سوم شخص خود را بررسی کنید: به تنظیمات بروید و حالت فعلی خود را چک کنید. ۳. در صورت نیاز به‌روزرسانی کنید: اگر از وردپرس ۷.۰ یا بالاتر استفاده می‌کنید، به حالت اتوماتیک (Auto mode) تغییر دهید. ۴. قابلیت‌ها را طبقه‌بندی کنید: هر قابلیت‌های دسته‌بندی نشده را مرور و طبقه‌بندی کنید. ۵. آزمایش کنید: مطمئن شوید که قابلیت‌های سوم شخص شما به درستی کار می‌کنند.

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