Order Attributes - Hyvä

Collect the extra information you need at checkout — purchase order numbers, delivery instructions, cost centres, or a required document upload — directly on a Hyvä storefront. This module is the Hyvä companion for Wimakeit Order Attributes: the core module handles the data layer (EAV attributes, admin grid and order view, PDF output, the file upload endpoint), and this package wires those fields into the Hyvä checkout so your customers can actually fill them in.

It renders an Alpine-driven section showing the attributes you configured in the core module, then injects the captured values straight into the order payload — no Knockout, no RequireJS, no duplicated business logic. The styling matches the Wimakeit_CheckoutHyva visual language, so the fields feel native rather than bolted on.

Who it's for

• Merchants running a Hyvä storefront who already use, or plan to use, Wimakeit Order Attributes
• B2B sellers that need purchase order references, cost centres, or VAT details captured at checkout
• Shops requiring a customer-supplied document (file upload) before an order can be placed
• Teams that want the same order-attributes data layer across Luma and Hyvä without forking business logic

Key benefits

• Native Hyvä integration — an Alpine-driven <section> renders your configured fields directly in the Hyvä checkout, with no RequireJS or Knockout dependency.
• Reliable data capture — a fetch-patching bridge injects the values into paymentMethod.extension_attributes.order_attributes, so they land on the order exactly like the core module expects.
• No duplicated logic — the upload endpoint, plugins, and observers all come from the core module; this package is purely the storefront layer.
• Consistent styling — CSS aligned with Wimakeit_CheckoutHyva so the fields match the rest of your Hyvä checkout out of the box.
• Shared configuration — every field, label, and rule is managed in the core module; nothing new to learn or maintain here.
• Text and file fields — supports both text inputs and the required document upload handled by the core upload endpoint.

Compatibility

• Magento 2.4.x / Mage-OS equivalent
• PHP 8.1, 8.2, 8.3
• Hyvä theme 1.x
• Requires wimakeit/module-order-attributes 1.x (the data layer)
• Requires wimakeit/module-checkout 1.x