Към съдържанието

Инсталация

Изисквания

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.anchorLabel
Terminal window
composer require webcode/module-easy-returns
bin/magento module:enable Webcode_EasyReturns
bin/magento setup:upgrade
bin/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
  1. Настройте секцията Sales → Easy Returns (EU Withdrawal) — виж Конфигурация. Изберете режима (или проверете държавата по подразбиране при „Автоматично“), причината и дните за доставка, въведете официалните празници.
  2. По желание: снимка по причина (Sales → RMA → Reasons → Photo) и „Can Be Returned = Не“ за продукти, които не се връщат.
  3. Уверете се, че RMA е конфигуриран (причини, одобрения, доставка, възстановяване), тъй като отказите се обработват през неговия процес.
  4. В законов режим допълнете общите условия / страницата за връщане: по чл. 47, ал. 1, т. 8 ЗЗП търговецът информира за наличието на функцията и къде е (footer, акаунт, изглед на поръчката), както и за продуктите, изключени от правото на отказ.
  5. Проверете входните точки и потвърдителния имейл — виж Употреба.

Webcode_RMA е задължителна основа и се изисква от Easy Returns — не се активира и не се ползва самостоятелно.