Преминете към основното съдържание

Миграция към режим на външни потребители (Third-Party Mode)

Superdav AI Agent v1.12.0 променя начина, по който се обработват възможностите от трети страни (third-party abilities). Режимът на външни потребители вече е зададен по подразбиране на "auto", което позволява интегриране на нативния WordPress Abilities API в WordPress 7.0+ без ръчна настройка.

Какво се промени?​

Преди v1.12.0​

Възможностите от трети страни изискваха ръчна настройка:

  • Трябваше изрично да активирате "режим на външни потребители" (third-party mode)
  • Възможностите се зареждаха от персонализиран регистър
  • Интеграцията с WordPress Abilities API беше опционална
  • По подразбиране беше активен режимът "Legacy"

След v1.12.0​

Възможностите от трети страни работят автоматично:

  • Режимът на външни потребители е зададен по подразбиране на "auto"
  • Възможностите се интегрират нативно с WordPress Abilities API
  • Не е необходима ръчна настройка в WordPress 7.0+
  • Режимът "Legacy" все още е достъпен за по-стари версии на WordPress

Кои са засегнати?​

Нови инсталации (WordPress 7.0+)​

Не е необходима никаква мярка. Режимът на външни потребители е автоматично зададен на "auto", а възможностите работят от кутията.

Съществуващи инсталации​

Вашите настройки са запазени. Ако сте използвали:

  • Legacy mode: Продължавате в Legacy режим (без промяна)
  • Ръчен режим на външни потребители (Manual third-party mode): Продължавате в ръчен режим (без промяна)
  • Auto mode: Продължавате в auto режим (без промяна)

Версии на WordPress преди 7.0​

Legacy режим все още е достъпен. Ако използвате WordPress 6.x или по-ранна версия:

  • Режимът на външни потребители е зададен по подразбиране на "legacy"
  • Можете ръчно да активирате режима на външни потребители, ако желаете
  • Премигнете до WordPress 7.0+, за да използвате нативния Abilities API

Разбиране на режимните​

Auto Mode (Новото по подразбиране)​

Auto mode използва нативната интеграция с WordPress Abilities API:

  • Възможностите се регистрират чрез WordPress hooks
  • Пълна съвместимост с WordPress 7.0+ Abilities API
  • Автоматично откриване на възможности от трети страни
  • Не е необходима ръчна настройка

Кога да се използва: WordPress 7.0+ с възможности от трети страни

Manual Mode​

Manual mode изисква изрична конфигурация:

  • Вие посочвате кои възможности от трети страни трябва да се зареждат
  • Полезен за тестване или избирателно зареждане на възможности
  • Изисква редактиране на конфигурационни файлове
  • Поверен контрол, но и повече настройка

Кога да се използва: Тестване, избирателно зареждане на възможности или персонализирани конфигурации

Legacy Mode​

Legacy mode използва старата система за възможности от трети страни:

  • Персонализиран регистър на възможности (не WordPress Abilities API)
  • Работи с по-стари версии на WordPress (backward compatible)
  • Няма нативна интеграция с WordPress
  • Преминава в режим на избягване (deprecated), но все още е поддържан

Кога да се използва: WordPress 6.x или по-ранна версия, или когато е необходима съвместимост с Legacy режим

Проверка на текущия режим​

Чрез Admin панела​

  1. Отидете на WordPress Admin → Superdav AI Agent → Settings
  2. Потърсете настройката Third-Party Mode
  3. Ще видите текущия си режим и опции за промяна

Чрез кода​

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

Промяна на режима​

Преминаване към Auto Mode​

Ако сте в WordPress 7.0+ и искате да използвате auto режим:

  1. Отидете на Superdav AI Agent → Settings
  2. Намерете Third-Party Mode
  3. Изберете Auto (WordPress Abilities API)
  4. Натиснете Save

Superdav AI Agent автоматично ще открие и регистрира възможностите от трети страни.

Преминаване към Manual Mode​

Ако искате ръчно да контролирате кои възможности се зареждат:

  1. Отидете на Superdav AI Agent → Settings
  2. Намерете Third-Party Mode
  3. Изберете Manual
  4. Натиснете Save
  5. Редактирайте конфигурационния си файл, за да посочите кои възможности трябва да се зареждат

Преминаване към Legacy Mode​

Ако е необходима съвместимост с Legacy режим:

  1. Отидете на Superdav AI Agent → Settings
  2. Намерете Third-Party Mode
  3. Изберете Legacy
  4. Натиснете Save

Предимства на Auto Mode​

Автоматично откриване​

Възможностите се откриват автоматично от:

  • Инсталирани плагини (plugins)
  • Активната тема (theme)
  • Must-use плагини
  • Drop-in плагини

Не е необходима ръчна регистрация.

Нативна интеграция​

Възможностите се интегрират с WordPress Abilities API:

  • Съгласувано с ядрото на WordPress
  • Работи с WordPress admin
  • Съвместимо с други плагини, използващи Abilities API
  • Осигурява защита за бъдещето, когато WordPress се развива

Упростено управление​

  • Няма конфигурационни файлове, които да се редактират
  • Няма ръчна регистрация на възможности
  • Контролът върху видимостта на възможностите (Ability Visibility) работи автоматично
  • Уведомленията в админ панела ви предупреждават за некласифицирани възможности

По-добра производителност​

  • Възможностите се кешират
  • Се зареждат по нужда (lazy-loaded)
  • Оптимизирано за WordPress 7.0+

Път на миграцията​

Ако сте в WordPress 6.x​

  1. Премигнете до WordPress 7.0+ (когато сте готови)
  2. Актуализирайте Superdav AI Agent до v1.12.0+
  3. Променете режима на външни потребители на Auto (по избор; Legacy режим все още работи)
  4. Прегледайте видимостта на възможностите (ability visibility), за да гарантирате правилния контрол на достъпа

Ако сте в WordPress 7.0+​

  1. Актуализирайте Superdav AI Agent до v1.12.0+
  2. Проверете дали режимът на външни потребители е зададен на Auto (това трябва да е по подразбиране)
  3. Прегледайте видимостта на възможностите (ability visibility), за да гарантирате правилния контрол на достъпа
  4. Тествайте възможностите от трети страни, за да потвърдите, че работят

Отстраняване на неизправности​

Възможностите не се зареждат в auto режим​

  • Проверете дали сте в WordPress 7.0+
  • Проверете дали режимът на външни потребители е зададен на "Auto"
  • Проверете дали плагинът, предоставящ възможността, е активен
  • Проверете логовете за грешки на WordPress за грешки при регистрацията

Искам да запазя Legacy режим​

  • Отидете на Settings → Third-Party Mode
  • Изберете Legacy
  • Натиснете Save
  • Legacy режимът ще продължи да работи

Моите персонализирани възможности не се показват​

  • Проверете дали са регистрирани чрез WordPress hooks
  • Проверете дали правилно имплементират Abilities API
  • Прегледайте логовете за грешки на WordPress
  • Използвайте страницата Ability Visibility в админ панела, за да видите всички регистрирани възможности

Получавам известия "unclassified ability"​

  • Това е нормално за нови възможности от трети страни
  • Прегледайте и класифицирайте ги в известието в админ панела
  • Вижте Ability Visibility за подробности относно класификацията

Обратна съвместимост​

Съществуващи конфигурации​

Ако имате съществуващи конфигурации на възможности от трети страни:

  • Legacy mode: Вашата конфигурация продължава да работи
  • Manual mode: Вашата конфигурация продължава да работи
  • Auto mode: Вашата конфигурация е игнорирана (auto режим поема контрола)

За да запазите вашата персонализирана конфигурация, останете в Manual или Legacy режим.

График на преминаване в режим на избягване (Deprecation Timeline)​

  • v1.12.0: Legacy и Manual режими са пълно поддържани
  • v1.13.0+: Legacy режим може да показва известия за преминаване в режим на избягване
  • v2.0.0: Legacy режим може да бъде премахнат (TBD)

Най-добри практики​

За нови инсталации​

  • Използвайте Auto mode (това е по подразбиране)
  • Позволете Superdav AI Agent да открива възможностите автоматично
  • Използвайте Ability Visibility, за да контролирате достъпа

За съществуващи инсталации​

  • Премигнете до WordPress 7.0+, когато е възможно
  • Премигнете към Auto mode за опростено управление
  • Прегледайте и класифицирайте възможностите, използвайки Ability Visibility

За персонализирани възможности​

  • Регистрирайте възможностите чрез WordPress hooks (Abilities API)
  • Избягвайте персонализирани регистри на възможности
  • Тествайте в WordPress 7.0+ с Auto mode

Следващи стъпки​

  1. Проверете версията на WordPress: Уверете се, че сте в 7.0+ за Auto mode
  2. Прегледайте режима на външни потребители: Отидете в Settings и проверете текущия си режим
  3. Актуализирайте, ако е необходимо: Премигнете към Auto mode, ако сте в WordPress 7.0+
  4. Класифицирайте възможностите: Прегледайте и класифицирайте всички некласифицирани възможности
  5. Тествайте: Проверете дали възможностите от трети страни работят правилно
  • Ability Visibility: Контролирайте кои възможности са изложени къде
  • WordPress Abilities API: Научете за нативната регистрация на възможности в WordPress
  • Third-Party Ability Development: Създавайте възможности, които работят с Auto mode