Инсталация
Изисквания
heading.anchorLabel- Magento 2 / Mage-OS на PHP 8.3–8.5 (модулът ползва типизирани константи).
- Модул Webcode_RMA 2.x (
webcode/module-rma) и RMA модулът на Mage-OS (mage-os/module-rma^2.4) — задължителна оперативна основа. Easy Returns не е самостоятелен и не работи без тях. - Работещ cron на Magento — потвърждението за получаване се повтаря от cron, ако имейлът не тръгне при подаването.
- Стандартните модули на Magento, които модулът ползва (
Sales,Customer,Catalog,Eav,Quote,Tax,Store,Email,Config,Cron,Theme, reCAPTCHA) — всички са вrequireнаcomposer.jsonи са налични във всяка инсталация.
Зависимостите и редът на зареждане са декларирани в etc/module.xml чрез
sequence:
<sequence> <module name="Magento_Sales"/> <module name="Magento_Customer"/> <module name="Magento_Theme"/> <module name="MageOS_RMA"/> <module name="Webcode_RMA"/></sequence>Активиране
heading.anchorLabelcomposer require webcode/module-easy-returnsbin/magento module:enable Webcode_EasyReturnsbin/magento setup:upgradebin/magento setup:di:compile # при production режимbin/magento cache:flushПри setup:upgrade:
- декларативната схема (
etc/db_schema.xml) създава/обновява таблицатаwebcode_withdrawal_statement(snapshot на декларациите, UTC времеви маркери,acknowledged_atза изпратеното потвърждение,rma_errorпри неуспешна RMA заявка); - схемата добавя колона
rma_reason.easyreturns_image(снимка по причина); - data patch-овете добавят законовата причина
statutory_withdrawalв справочника на RMA (през репозиторито на MageOS), българския ѝ етикет за магазините наbg_BGи продуктовите атрибутиeasyreturns_returnableиeasyreturns_reason_required(група „Returns“).
Модулът носи собствени Tailwind темплейти за Hyvä и се регистрира за Tailwind
билда на темата (hyva_config_generate_before). Tailwind v4 темите четат
view/frontend/tailwind/module.css, v3 темите — tailwind-source.css. След
инсталация на Hyvä магазин прекомпилирайте CSS-а на темата.
След инсталация
heading.anchorLabel- Настройте секцията Sales → Easy Returns (EU Withdrawal) — виж Конфигурация. Изберете режима (или проверете държавата по подразбиране при „Автоматично“), причината и дните за доставка, въведете официалните празници.
- По желание: снимка по причина (Sales → RMA → Reasons → Photo) и „Can Be Returned = Не“ за продукти, които не се връщат.
- Уверете се, че RMA е конфигуриран (причини, одобрения, доставка, възстановяване), тъй като отказите се обработват през неговия процес.
- В законов режим допълнете общите условия / страницата за връщане: по чл. 47, ал. 1, т. 8 ЗЗП търговецът информира за наличието на функцията и къде е (footer, акаунт, изглед на поръчката), както и за продуктите, изключени от правото на отказ.
- Проверете входните точки и потвърдителния имейл — виж Употреба.
Webcode_RMA е задължителна основа и се изисква от Easy Returns — не се активира и не се ползва самостоятелно.