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

Новости

2.1.1 — 2026-11-11

heading.anchorLabel

Спрямо 2.1.0.

Бележки

heading.anchorLabel
  • Артикули с изтекъл срок за връщане. От mage-os/module-rma 2.5 срокът тече от датата на пратката и артикулите с изтекъл срок остават в списъка като недопустими. Формите за нова заявка (Luma и Hyvä) вече ги показват като неактивна карта с причината под името. С 2.1.0 такъв артикул изглеждаше избираем, а сървърът го пропускаше без съобщение.
  • Преводи. Български редове за новите надписи на mage-os/module-rma 2.5: „Отказ от покупката“, „Откази и връщания“, „Потвърждавам отказа“, „Срокът за връщане изтече на …“ и новия коментар на настройката Return Period (Days).
  • Съвместимост. Работи и с 2.4, и с 2.5 на mage-os/module-rma; изискването остава ^2.4. Няма BC промяна.

Внимание при деплой

heading.anchorLabel
  • Static: стилове/JS/шаблони във view/*/web (или requirejs-config.js) са променени — при деплоя setup:static-content:deploy.

При деплой

heading.anchorLabel
  • Потвърждавам автоматичното предупреждение: променени са view/frontend/web/js/rma-create.js и view/frontend/web/css/source/_module.less, тоест трябва static content deploy.
  • На Hyvä теми — rebuild на CSS-а, ако класовете opacity-50 и bg-gray-50 не са в компилирания файл на темата.
  • cache:flush. Няма промяна в схемата, DI или конструктори, тъй че generated/ не се чисти заради този релийз.

Известен проблем

heading.anchorLabel
  • Какво не е проверено. Hyvä картите не са гледани в браузър и реална заявка с артикул с изтекъл срок не е подавана срещу mage-os/module-rma 2.5.1. Проверено е с рендер тест на Luma картите с данни във формата на 2.4 и 2.5, с unit и integration тестовете и с CI на трите зависими модула.
  • Срокът на Mage-OS вече важи и за заявки, създадени от код. От 2.5 rma/general/return_period (30 дни по подразбиране, от датата на всяка пратка) се проверява вътре в RmaSubmitService::saveItems(). Засяга Webcode_EasyReturns, когато неговият срок е по-дълъг — решава се в неговия релийз.
  • Hyvä: заглавието на страницата идва от Mage-OS („Отказ от покупката“), а заглавието във формата остава „Заявка за връщане“.

Комити (2)

heading.anchorLabel
  • b2c33aa CLAUDE.md: локалният MageOS_RMA е git клонинг на upstream, вече на 2.5.1
  • 497d855 MageOS_RMA 2.5: артикули с изтекъл срок във формите, преводи на новите надписи

2.1.0 — 2026-10-15

heading.anchorLabel

Спрямо 2.0.3.

Новости

heading.anchorLabel
  • Стойности по store view за справочниците — формите на RMA Reasons, Statuses, Resolution Types и Item Conditions получават превключвател на scope като при продукта. В store view Label, Active, Sort Order и Approve Automatically (+ полета от други модули, напр. Photo на Easy Returns) имат собствена стойност с Use Default Value; Code е глобален. Разделът „Store View Specific Labels“ на Mage-OS е заменен.
  • Формите за връщане във витрината (причини, причини по позиция) и одобрението по причина ползват стойностите на store view-то.
  • Миниатюри в Attachments — изображенията, прикачени към заявката, се виждат като миниатюри; клик показва снимката в голям размер в модален прозорец, името на файла я тегли.

За разработчици

heading.anchorLabel
  • Webcode\RMA\Model\LookupScope (getValue(), getStoreValues(), save()) + таблица webcode_rma_lookup_store_value; собствено поле по store view — аргумент extraFields в di.xml.
  • Записът в store view никога не пипа стойностите на самия запис (без store_id записът се отказва).

Внимание при деплой

heading.anchorLabel
  • DI: di.xml е променен — при деплоя се чисти generated/.
  • Схема: db_schema е променена — setup:upgrade пипа жива база.
  • Static: стилове/JS/шаблони във view/*/web (или requirejs-config.js) са променени — при деплоя setup:static-content:deploy.

Комити (3)

heading.anchorLabel
  • 35d28b7 Release 2.1.0
  • f62e3b9 fix(phpcs): без self-closing
    в attachment-preview.js
  • 1f131d7 Стойности по store view за справочниците и миниатюри на снимките в Attachments

2.0.3 — 2026-10-12

heading.anchorLabel

Спрямо 2.0.2.

Бележки

heading.anchorLabel
  • Българските етикети стигат и до магазини, станали bg_BG след инсталацията. В 2.0.2 data patch-ът попълваше етикетите на статусите, причините, видовете решения и състоянията само за магазините, които са на bg_BG в момента на setup:upgrade. На чиста инсталация локалът още е en_US, затова етикетите оставаха на английски. Сега се попълват и при смяна на локала в Stores → Configuration → General → Locale Options и при създаване на нов store view.
  • Добавят се само липсващите етикети: ръчно зададен етикет остава, собствени записи не се пипат. Грешка при попълването се записва в лога и не спира записа на настройките или на магазина.
  • Смяна на локала с bin/magento config:set не задейства попълването. След нея запазете веднъж Locale Options в админа или въведете етикетите ръчно.

При деплой

heading.anchorLabel
  • Нови класове и наблюдатели (Model\BulgarianLookupLabels, Observer\AddBulgarianLookupLabels), сменен конструктор на data patch-а — чисти се generated/ и cache:flush.
  • Без схема и без нов data patch; на заварен магазин нищо не се променя.

Комити (1)

heading.anchorLabel
  • 2bf04ed rma-6: български етикети и за магазини, станали bg_BG след инсталацията

2.0.2 — 2026-10-08

heading.anchorLabel

Спрямо 2.0.1.

Бележки

heading.anchorLabel
  • Статусите, причините, видовете решения и състоянията на артикула излизат на български. Етикетите им са записи в базата, не низове за превод, затова bg_BG.csv от 2.0.1 не ги покриваше. Български магазин показваше „Approved“, „Defective/Does not Work Properly“, „Repair“, „Opened“. Нов data patch AddBulgarianLookupLabels слага български етикет по магазин за 24-те стандартни кода, включително нашите „Сумата е възстановена“ / „Сумата е частично възстановена“.
  • Добавя само липсващите етикети: ръчно зададен етикет („Етикети по магазин“ в админа) остава. Непознати (собствени) кодове не пипа. Законовият отказ от договора (statutory_withdrawal) е на EasyReturns и не е тук.

При деплой

heading.anchorLabel
  • Data patch — изпълнява се срещу живата база при setup:upgrade. Само добавя редове в rma_*_label, нищо не трие и не променя.
  • Важи за магазините, които СА на bg_BG в момента на setup:upgrade. На чисто setup:install локалът още е en_US и patch-ът не прави нищо — тогава етикетите се попълват от админа.
  • cache:flush след това.

Комити (1)

heading.anchorLabel
  • 668eefd rma-6: български етикети за статусите, причините, решенията и състоянията

2.0.1 — 2026-10-08

heading.anchorLabel

Спрямо 2.0.0.

Бележки

heading.anchorLabel
  • MageOS_RMA излиза на български. MageOS няма bg_BG.csv, затова в български магазин формите за връщане, „Моите връщания“, изгледът на заявката, админът, настройките и трите имейла (нова заявка към клиента и към админа, смяна на статус) бяха на английски. Добавени са 209 превода в i18n/bg_BG.csv на Webcode_RMA. Magento слива речниците на всички модули, затова те важат и за низовете на MageOS.
  • Нарочно без превод: родовите думи, чийто превод зависи от рода или контекста (Active, Unknown, Available, Ordered, Select, N/A, ID, max, Not found). Ред за тях би ги превел за целия магазин.

При деплой

heading.anchorLabel
  • Само превод: cache:flush. За JS низовете (Luma create формата) — нов static deploy за bg_BG или изтриване на js-translation.json за локала.
  • Стойностите от базата (статуси, причини, решения, състояния на артикула) остават на английски, докато не им се попълнят „Етикети по магазин“ в админа (Връщания → Причини / Статуси / Видове решения / Състояния).

Комити (1)

heading.anchorLabel
  • 9cd34c0 rma-6: bg_BG превод за низовете на MageOS_RMA

2.0.0 — 2026-10-05

heading.anchorLabel

Спрямо 1.0.1.

Внимание при деплой

heading.anchorLabel
  • DI: di.xml е променен — при деплоя се чисти generated/.
  • Схема: db_schema е променена — setup:upgrade пипа жива база.
  • Setup: data/schema patch — изпълнява се срещу жива база при setup:upgrade.
  • Static: стилове/JS/шаблони във view/*/web (или requirejs-config.js) са променени — при деплоя setup:static-content:deploy.
  • Зависимости: require в composer.json: добавен mage-os/module-rma (^2.4); добавен magento/module-backend (*); добавен magento/module-customer (*); добавен magento/module-sales (*); добавен webcode/module-base (*).

Комити (5)

heading.anchorLabel
  • 058dbf1 Release 2.0.0
  • 049e28b rma-6: карти по артикул във формите за връщане (Luma + Hyvä)
  • c22bec3 rma-4: integration тестове за надбавката
  • 512ca9b rma-4: Webcode_RMA 2.0 — надбавка върху MageOS_RMA
  • 02235ab rma-3: conflict с mage-os/module-rma — 1.x не може да живее с MageOS_RMA

Бележки

heading.anchorLabel

2.0 е надбавка към RMA модула на Mage-OS (mage-os/module-rma ^2.4, MIT; работи и на Magento Open Source). Процесът на връщане — формите за клиент и гост, „Моите връщания“, админ гридът и формата, статусите, причините, коментарите, файловете, имейлите, REST и GraphQL — е на Mage-OS. Webcode_RMA добавя:

  • одобрение по причина — превключвател „Approve Automatically“ на всяка причина (Sales → RMA → RMA Reasons); заявка, чиято причина и причините на всички артикули са с включен превключвател, се одобрява веднага (истинска смяна на статус, тръгва rma_approved_after);
  • причина за всеки артикул — в create формите (клиент, гост, админ), в админ „Requested Items“ и в изгледа на клиента;
  • карта за всеки артикул във формите (снимка, цена, наличност; Luma и Hyvä);
  • възстановяване на сума — бутон „Създай кредитно известие“ към нативния New Memo с попълнени количества; след refund статус „Сумата е възстановена“ / „Сумата е частично възстановена“ с отделни имейл шаблони (със сумата);
  • товарителница за връщане — Webcode\RMA\Api\ReturnLabelRepositoryInterface, сваляне от админа и от логнат клиент.

⚠️ BC-break спрямо 1.x

heading.anchorLabel
  • 2.0 не надгражда 1.x: собствените таблици, контролери, админ, имейли и API на 1.x (Webcode\RMA\Api\RequestRepositoryInterface, RequestService, OrderLookupService, webcode_rma_request_status_change…) са махнати. Миграция на данни няма. Магазин с данни в 1.x остава на ^1.0 (клон 1.x).
  • Консюмърите трябва да са на 2.x: Webcode_RMACarrier (magento2/rma-carrier!8) и Webcode_EasyReturns (magento2/easy-returns!7).

При деплой

heading.anchorLabel
  • setup:upgrade (схема + data patch за двата нови статуса), чистене на generated/, setup:static-content:deploy.
  • Hyvä: прекомпилирайте Tailwind на темата — модулът се регистрира за build-а, но класовете на картите ги няма, докато темата не се билдне.
  • Включете RMA (Stores → Configuration → Sales → RMA - Return Management, по подразбиране изключен). Ако магазинът ползва собствени статуси на поръчките (напр. payment_accepted), добавете ги в Allowed Order Statuses — сравнението е по статус, не по state.

Известни проблеми

heading.anchorLabel
  • В тестовете веднъж (от пет) refund не смени статуса на RMA; не се възпроизведе, причината не е установена. Integration тестът RmaAddOnTest покрива частичния и пълния refund.
  • RMA, създадена от админа директно като Approved, не задейства товарителница в RMACarrier.

1.0.1 — 2026-09-30

heading.anchorLabel

Спрямо 1.0.0.

Комити (7)

heading.anchorLabel
  • daf6271 refactor: текущата RMA заявка само през Model\CurrentRequest (rma-1)
  • 5fd0d99 ci: махни изводимите ключове и застоелия MATRIX
  • ea02d89 Свържи rmaRequestFactory към property-то, което блокът наистина чете
  • 83f9287 CI: DEPENDENTS — пълен обратен списък на консюмърите
  • ecb6d93 Declare comment in @translate so field comments are collectable
  • ab2329e fix: PHPCS съответствие (Magento2 standard)
  • fa0b851 fix(ci): стандартен module pipeline (include + vars)

Бележки

heading.anchorLabel
  • Текущата RMA заявка идва от едно място — Webcode\RMA\Model\CurrentRequest (rma-1). Блоковете на изгледа не четат регистъра сами; проектен код трябва да инжектира CurrentRequest вместо да чете ключа current_rma_request.
  • Контролерът на изгледа регистрира заявката — блоковете вече не зависят от реда, в който layout-ът ги строи.

При деплой

heading.anchorLabel
  • Нови незадължителни конструкторски аргументи в блоковете и контролера — изчисти generated/. Наследници, строени позиционно, продължават да работят.

1.0.0 — 2026-07-25

heading.anchorLabel

Release 1.0.0