PHPackages                             zwernemann/module-withdrawal-hyva - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. zwernemann/module-withdrawal-hyva

ActiveMagento2-module[Utility &amp; Helpers](/categories/utility)

zwernemann/module-withdrawal-hyva
=================================

Hyva Theme compatibility for zwernemann/module-withdrawal

v1.3.0(1mo ago)0882[1 issues](https://github.com/Zwernemann/magento2-withdrawl-hyva/issues)OSL-3.0HTMLPHP &gt;=7.4

Since Apr 29Pushed 1mo agoCompare

[ Source](https://github.com/Zwernemann/magento2-withdrawl-hyva)[ Packagist](https://packagist.org/packages/zwernemann/module-withdrawal-hyva)[ RSS](/packages/zwernemann-module-withdrawal-hyva/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

Magento 2 Withdrawal – Hyvä Compatibility Module
================================================

[](#magento-2-withdrawal--hyvä-compatibility-module)

A companion module for [Zwernemann\_Withdrawal](https://github.com/Zwernemann/magento2-withdrawl) that replaces all frontend templates with Hyvä-compatible equivalents built on **Tailwind CSS** and **Alpine.js**.

---

Base Module
-----------

[](#base-module)

The [magento2-withdrawl](https://github.com/Zwernemann/magento2-withdrawl) module implements the EU statutory right of withdrawal for Magento 2 stores. It covers the full workflow from the customer's initial request to the merchant's administrative handling.

### Features of the base module

[](#features-of-the-base-module)

**Customer side**

- Withdrawal button in the order history list and on the order detail page
- Dedicated withdrawal detail page showing order summary, ordered items, and the applicable deadline
- Guest customer support via a separate order search form
- Automatic confirmation email after a withdrawal has been submitted

**Merchant side**

- Admin grid listing all withdrawal requests with filtering and sorting
- Configurable withdrawal period (default: 14 days from shipment date)
- Automatic order comments on withdrawal submission
- Customisable transactional email templates
- REST API endpoint for programmatic access

**Technical**

- Supports Magento 2.4.6 – 2.4.8-p1
- Full translations for German and English (97 strings)
- CSRF protection on all forms
- ACL-based backend permissions

---

This Module – Hyvä Compatibility
--------------------------------

[](#this-module--hyvä-compatibility)

The default Magento frontend (Luma) uses RequireJS, Knockout.js, and LESS for its UI stack. [Hyvä Themes](https://hyva.io) replaces this stack with **Tailwind CSS** and **Alpine.js**, which means standard Luma templates are incompatible and render unstyled or broken in a Hyvä storefront.

This companion module solves that by providing a dedicated set of templates that follow Hyvä conventions – no Knockout, no RequireJS, no LESS.

### What is replaced / added

[](#what-is-replaced--added)

TemplateDescription`withdrawal/view.phtml`Withdrawal detail page with order summary table, deadline display, and an Alpine.js confirmation modal before form submission`withdrawal/success.phtml`Success confirmation page with order reference and navigation links`order/history/withdrawal_button.phtml`Table cell for the order history list – shows the withdraw button, a "submitted" notice, or an "expired" notice depending on the order state`order/history/column_header.phtml`Column header cell for the withdrawal column in the order history table`guest/search.phtml`Guest order search form with Alpine.js form-state handling and HTML5 validation`button.phtml`Standalone button component linking to the withdrawal view### Key implementation details

[](#key-implementation-details)

- **Tailwind CSS** utility classes are used throughout for layout, typography, colour, and spacing – no custom LESS or CSS is added.
- **Alpine.js** handles interactive elements such as the confirmation modal (`x-data="{ showConfirm: false }"`) and submit-button disabling during form submission.
- CSRF form keys are included in every form, identical to the base module.
- Both logged-in customers and guests are fully supported.

---

Requirements
------------

[](#requirements)

DependencyVersionPHP&gt;= 7.4Magento2.4.6 – 2.4.8-p4zwernemann/module-withdrawal&gt;= 1.0.0hyva-themes/magento2-theme-module\*---

Installation
------------

[](#installation)

```
composer require zwernemann/module-withdrawal-hyva
php bin/magento module:enable Zwernemann_WithdrawalHyva
php bin/magento setup:upgrade
php bin/magento cache:flush
```

---

Usage
-----

[](#usage)

No additional configuration is required. Once enabled, the module's templates automatically take precedence over the base module's templates when a Hyvä theme is active. All configuration options from the base module remain available under **Stores → Configuration → Sales → Withdrawal**.

---

Contributing
------------

[](#contributing)

Contributions and bug reports are welcome. Please open an issue or pull request in this repository.

---

License
-------

[](#license)

[Open Software License 3.0 (OSL-3.0)](https://opensource.org/licenses/OSL-3.0)

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance88

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

59d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ab806201fa0b72cada23b094f57e8d6e96aca483badab47bf710dfd2f2e19f4b?d=identicon)[Zwernemann](/maintainers/Zwernemann)

---

Top Contributors

[![Zwernemann](https://avatars.githubusercontent.com/u/52236002?v=4)](https://github.com/Zwernemann "Zwernemann (4 commits)")

---

Tags

consumer-rightsecommerceeu-compliancehyva-modulemagento2magento2-module-free

### Embed Badge

![Health badge](/badges/zwernemann-module-withdrawal-hyva/health.svg)

```
[![Health](https://phpackages.com/badges/zwernemann-module-withdrawal-hyva/health.svg)](https://phpackages.com/packages/zwernemann-module-withdrawal-hyva)
```

###  Alternatives

[jajuma/awesomehyva

This Magento 2 extension allows using Font Awesome 5 icons with Hyvä Themes

1352.7k](/packages/jajuma-awesomehyva)[elgentos/vat-switcher

Vat switcher to let customer decide on how to show their prices

1512.0k](/packages/elgentos-vat-switcher)[elgentos/magento2-hyva-cro-semi-sticky-header

Changes the Hyvä header to a semi-sticky header (dissapears down and reappears up)

162.1k](/packages/elgentos-magento2-hyva-cro-semi-sticky-header)[basecom/magento2-speculation-rules-toolbox

Magento2 module to provide extensive functionality for speculation rules

171.1k](/packages/basecom-magento2-speculation-rules-toolbox)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
