Инсталация

Изисквания

Magento 2 / Adobe Commerce с работещ PHP (по проектния базов стек на Webcode).
Стандартните модули Magento_Sales, Magento_Customer и Magento_Catalog — декларирани като sequence в etc/module.xml, така че се зареждат преди RMA.
Само magento/framework е composer зависимост — RMA е самостоятелен и не изисква друг Webcode модул.

Зависимостите са декларирани в composer.json:

"require": {
    "magento/framework": "*"
}

Инсталиране

composer require webcode/module-rma

Активирайте модула и приложете setup промените:

bin/magento module:enable Webcode_RMA
bin/magento setup:upgrade
bin/magento setup:di:compile   # при production режим
bin/magento cache:flush

При setup:upgrade декларативната схема (etc/db_schema.xml) създава трите таблици на модула:

rma_entity — заявките за връщане (RMA номер, поръчка, клиент/гост, статус, куриер, товарителница, tracking);
rma_item — редовете на заявката (поръчков артикул, заявено/одобрено количество, причина);
rma_image — прикачените снимки към заявка.

Виж За разработчици за пълния data модел.

Фронтенд теми

Модулът поддържа Hyvä — темплейтите и layout-ите за Hyvä са декларирани в etc/hyva-themes.xml (гост, клиентски акаунт, продуктова заявка). При Luma се използват стандартните .phtml темплейти на модула.

След инсталация

Включете и настройте RMA (статуси, дни, причини, имейли) — виж Конфигурация.
Проверете, че админ менюто Sales → RMA Requests е достъпно (ACL ресурс Webcode_RMA::rma_requests).
По желание инсталирайте спътниковите модули Webcode_EasyReturns и/или Webcode_RMACarrier.