mhinspeya/module-checkout-address

Splits checkout street address into Street, House Number, and Address Suffix fields and filters payment methods by shipping method.

1.0.0 2026-06-26 10:23 UTC

Requires

• php: >=7.3
• mhinspeya/backend-mod: ^1.0

Suggests

• mhinspeya/backend-mod: Support Configuration

OSL-3.0

• MHinspeya

• magento
• magento 2
• MHinspeya

README

Magento 2 module that customises the checkout address forms and filters available payment methods based on the selected shipping method.

Compatibility

Magento	PHP
2.4.4 – 2.4.8	8.2 · 8.3 · 8.4

Features

Street Address Splitting

The default Magento street address field is replaced with three dedicated sub-fields on both the shipping and billing address forms:

Field	Data Scope	Required	Max Length
Street	street[0]	Yes	255
House Number	street[1]	Yes	10
Address Suffix	street[2]	No	255

Field Reordering

The following fields are reordered for a more logical European address layout:

Field	Sort Order
Company	59
Street (group)	60
Postcode	65
City	70–75

Payment Method Filtering

The MethodList plugin filters available payment methods based on the active shipping method:

Shipping Method	Payment Method Hidden
tablerate_bestway	checkmo (Check / Money Order)
(none selected)	checkmo (Check / Money Order)
flatrate_flatrate	banktransfer (Bank Transfer)

Installation

Composer (recommended)

composer require mhinspeya/module-checkout-address
bin/magento module:enable MHinspeya_CheckoutAddress
bin/magento setup:upgrade
bin/magento cache:flush

Manual

1. Copy the module files to app/code/MHinspeya/CheckoutAddress/
2. Run:

   bin/magento module:enable MHinspeya_CheckoutAddress
   bin/magento setup:upgrade
   bin/magento cache:flush
   

Module Structure

MHinspeya/CheckoutAddress/
├── composer.json
├── registration.php
├── changelog.txt
├── etc/
│   ├── module.xml          — Module declaration with sequence dependencies
│   ├── di.xml              — Plugin registrations
│   └── acl.xml             — ACL resource definitions
├── i18n/
│   └── de_DE.csv           — German translations
├── Model/
│   └── Checkout/
│       └── LayoutProcessorPlugin.php   — Splits street fields & reorders address form
└── Plugin/
    └── Model/
        └── MethodList.php              — Filters payment methods by shipping method

Plugin Details

LayoutProcessorPlugin

• Type: After-plugin on Magento\Checkout\Block\Checkout\LayoutProcessor::process()
• Registered in: etc/di.xml as rewrite-street
• Scope: Both shipping and all billing address forms (iterates over all payment method forms)

MethodList

• Type: After-plugin on Magento\Payment\Model\MethodList::getAvailableMethods()
• Registered in: etc/di.xml as override_method
• Sort Order: 10

Translations

The following strings are translatable via __():

Key	de_DE
Street	Straße
House number	Hausnummer
Address suffix	Adresszusatz

License

Proprietary — © MHinspeya