Phone Flags
v1.4.8
v1.4.8
Jaarabonnement
Updated 25 aug. 2026
Phone Flags
Maakt van elk telefoonveld een input met landvlaggen, automatische opmaak en live validatie, zodat opgeslagen nummers altijd internationaal zijn.
Hyvä Compatibel
Magento 2.4.4
Magento 2.4.5
Magento 2.4.6
Magento 2.4.7
Mage-OS 2.0
Mage-OS 2.1
- Updates and support included for 12 months
- License key delivered immediately by email
- 30-day money-back guarantee
- Full documentation included
- Compatible with Hyvä themes
- Composer-ready installation
Phone Flags
Verzamel zuivere, internationale telefoonnummers zonder uw klanten ooit te vragen een landcode uit het hoofd te kennen. Deze module verandert elk telefoonveld in uw winkel — checkout, klantaccount, registratie, contactformulier — in een intuïtieve invoer met landenvlaggen, automatische opmaak en live validatie. Het resultaat: wat in uw database belandt is altijd bereikbaar, waar de klant ook woont.
Slecht ingevoerde nummers zijn een onderschatte oorzaak van mislukte leveringen, niet-afgeleverde Mondial Relay-pakketten en verspilde supporttijd. Door het formaat ondubbelzinnig te maken bij invoer, lost deze module het probleem aan de bron op in plaats van uw supportteam te laten opruimen.
Voor wie
- Cross-border handelaars wiens klanten uit meerdere landen komen en niet allemaal het internationale formaat kunnen kennen
- Winkels die vervoerder-integraties gebruiken (Mondial Relay, Bpost, DPD…) die afhankelijk zijn van een geldig nummer in het bestemmingsland
- B2C-handelaars die een vlotte, moderne checkout willen, op het niveau van wat klanten zien in hun bank- of reisapps
Belangrijkste voordelen
- Landenvlaggen in elk formulier — checkout shipping/billing, adresboek van het klantaccount, registratie en contactpagina. Een consistente UX over de hele winkel.
- Live opmaak en validatie — nummers worden geformatteerd tijdens het typen en gevalideerd op blur, met een duidelijke foutmelding als het nummer niet geldig is voor het gekozen land.
- Slimme landenlijst — pin uw voorkeurslanden bovenaan de dropdown, verberg irrelevante landen of beperk de lijst tot een specifieke set. Optionele GeoIP-detectie pre-selecteert het land van de bezoeker.
- Mondial Relay safeguard — toont een waarschuwing op de checkout wanneer het telefoonland niet overeenkomt met het verzendland, zodat het relaispunt de klant ook echt kan bereiken.
- Mobielvriendelijk — full-screen landenkiezer op mobiel, retina vlag-sprites, geen jQuery-afhankelijkheid.
- Plug & play — werkt op standaard Magento- en Hyvä-equivalente adresformulieren zonder ingrepen in het theme.
Compatibiliteit
- Magento 2.4.x / Mage-OS equivalent
- PHP 8.1, 8.2, 8.3
- Vereist
wimakeit/module-core3.0 of hoger - Werkt op Luma-frontends; Hyvä-projecten kunnen de JavaScript-helper hergebruiken
- Compatibel met Full Page Cache (validatie loopt client-side)
Installeer deze module via Composer. Zorg ervoor dat uw auth.json is geconfigureerd met uw Wimakeit-inloggegevens.
Terminal
$ composer require wimakeit/module-phone-flags:^1.4.8
$ bin/magento setup:upgrade
$ bin/magento setup:di:compileInstallation notes
The standard composer require + setup:upgrade + setup:di:compile flow applies. The points below cover what's specific to this module.
Required dependency
This module requires wimakeit/module-core 3.0 or later. Composer will pull it automatically from the Wimakeit registry as long as the registry is declared in your project's composer.json.
ACL permission
A single configuration ACL resource is registered, attached to the standard Stores → Configuration tree:
| Resource | Default |
|---|---|
Wimakeit_PhoneFlags::config | granted to Administrator role only |
Configuration
The module ships with safe defaults tuned for a Benelux audience. Go to Stores → Configuration → Wimakeit → Phone Flags only if you want to change them.
General settings
| Setting | Default |
|---|---|
| Enable Phone Flags | Yes |
| Default Country | BE |
| Preferred Countries (top of dropdown) | be, fr, nl, de, lu |
| Only Countries (whitelist) | empty (all countries) |
| Excluded Countries | empty |
| Show Dial Code Separately | No |
| National Mode | No |
| Auto Placeholder | polite |
Validation settings
| Setting | Default |
|---|---|
| Validate on Blur | Yes |
| Strict Mode (only valid characters accepted) | Yes |
GeoIP detection
| Setting | Default |
|---|---|
| Enable GeoIP Detection | No |
Enable GeoIP only if your hosting stack provides a country-resolution layer (Varnish + GeoIP module, Cloudflare headers, etc.). Without one, leave this off and rely on the Default Country.
Mondial Relay integration
| Setting | Default |
|---|---|
| Show Phone Mismatch Notice | Yes |
The notice only appears when a Mondial Relay shipping method is selected and the phone country differs from the shipping country. No action needed if you don't use Mondial Relay.
- Versie
- v1.4.8
- Licentie
- Jaarabonnement
- Ondersteuning
- 12 maanden
- Last updated
- 25 aug. 2026
- Magento
- Magento 2.4.4 Magento 2.4.5 Magento 2.4.6 Magento 2.4.7 Mage-OS 2.0 Mage-OS 2.1
- PHP
- PHP 8.1 PHP 8.2 PHP 8.3
- Hyvä
- Compatibel
- Pakket
-
wimakeit/module-phone-flags
Compatibility checker
Pick your stack to see if this module fits.
Compatible with your stack — ready to install.
Not compatible with this combination. Contact us for a custom build.
Compatibiliteit 4
Ja. Phone Flags is getest tegen Magento Open Source 2.4.4 → 2.4.7, Adobe Commerce op dezelfde lijn, en Mage-OS 2.0+ — op PHP 8.1, 8.2 en 8.3. Het tabblad Specificaties toont de geteste combinaties. Staat uw stack erbij, dan garanderen wij een schone installatie. Wimakeit is een Adobe-gecertificeerd Magento-bureau in Presles, Wallonië (tussen Charleroi en Namen), België — elke module wordt getest op dezelfde matrix die we naar onze enterprise-klanten in België, Frankrijk en Nederland uitrollen.
Ja — volledig. Phone Flags bevat een native Hyvä-compatibele frontend (Tailwind + Alpine.js) en integreert met Hyvä Checkout waar van toepassing. Geen extra fallback-module nodig. Elke Hyvä-gemarkeerde module wordt gebouwd door hetzelfde Wimakeit-team dat Hyvä-migraties in productie uitvoert.
Hyvä Storefront (Tailwind + Alpine.js, server-rendered) en Hyvä Checkout (React-gebaseerd, headless bovenop Magento) zijn twee aparte pakketten. Phone Flags bevat native Hyvä Storefront-compatibiliteit — de frontend wordt gerenderd via Hyvä-templates, zonder Luma-fallback. Hyvä Checkout-integratie wordt geleverd wanneer de module een raakvlak heeft met een checkout-stap (custom betaalinput, voorwaarden-checkbox, ...); anders draait de module server-side zonder Hyvä Checkout-aanpassing. Zie het tabblad Specificaties voor de exacte Hyvä-scope van deze module.
Ja. Phone Flags respecteert het standaard Magento-scope (default / website / store / store_view). Elke configuratie is overschrijfbaar per store view. Frontend-labels gebruiken de standaard Magento-vertaalbestanden — by-default in het Nederlands, Frans en Engels. Valuta's volgen uw Magento-valutaconfiguratie zonder extra werk. Een typische Wimakeit Magento-webshop draait een fr_BE / nl_BE / en_GB-triplet vanuit één backend — Phone Flags is klaar voor deze B2B / internationale setup.
Prijs & licentie 4
€79 — eenmalige betaling, eeuwigdurende licentie, geen abonnementskosten. Inclusief 1 jaar minor updates + e-mailsupport in Nederlands, Frans en Engels, 1 productie + 1 staging/dev-domein. Het verlengen van het supportvenster na jaar 1 is optioneel. Bureau- of multi-store-tarieven worden rechtstreeks onderhandeld via contact@wimakeit.com.
Ja. Phone Flags heeft een live demo op demo.wimakeit.be/module-phone-flags waar u admin en frontend kan verkennen met een echte installatie inclusief sample data. Voor langere evaluaties vraagt u een evaluatielicentie aan via ons contactformulier — de evaluatie dekt dezelfde scope als de betaalde licentie en wordt na aankoop omgezet in een permanente sleutel.
Wij beoordelen terugbetalingsverzoeken geval per geval. Levert de module niet wat aangekondigd? Mail contact@wimakeit.com vanaf het e-mailadres gekoppeld aan uw licentie. Het Wimakeit-terugbetalingsbeleid staat in de algemene voorwaarden en geldt voor elke module op deze marketplace.
Phone Flags wordt verspreid onder een commerciële proprietary licentie — geen MIT, GPL of andere open-source licentie. De PHP-broncode komt na
composer require in vendor/wimakeit/ terecht; u kan ze lezen, auditen en lokaal patchen voor uw eigen Magento-installatie. U mag de code NIET herverspreiden, sublicentiëren, op een publiek Composer-register publiceren of doorverkopen. Eén licentie = één productiedomein + één staging/dev-domein (zie de algemene voorwaarden voor de volledige EULA). Wimakeit-modules staan NIET op het publieke packagist.org — ze worden uitsluitend verspreid via het private Composer-register packages.wimakeit.be. Installatie & updates 6
Voer
composer require wimakeit/module-phone-flags:^1.4.6 uit, daarna bin/magento setup:upgrade, bin/magento setup:di:compile en tot slot bin/magento cache:flush. Het tabblad Installation op deze pagina lijst elke configuratiestap (ACL's, crons, defaultwaarden) — een deploy duurt minuten, geen uren. Hulp nodig? Wimakeit biedt Magento-installatiediensten vanuit ons Waalse kantoor (Presles, tussen Charleroi en Namen).
Stap 1: haal een token op via packages.wimakeit.be → Mijn account → Tokens. Stap 2: voeg in de root van uw project aan
auth.json toe: {"http-basic": {"packages.wimakeit.be": {"username": "UW-E-MAIL", "password": "UW-TOKEN"}}}. Stap 3: registreer het repo: composer config repositories.wimakeit composer https://packages.wimakeit.be. Stap 4: composer require wimakeit/module-phone-flags:^1.4.6. In CI/CD-pipelines injecteert u COMPOSER_AUTH als JSON-environment-variabele in plaats van auth.json te commit'en.
De meeste merchants zijn binnen 30 minuten live: composer install (1-2 min) → setup:upgrade + di:compile (5-10 min afhankelijk van de stack) → adminconfiguratie (5-15 min volgens het Installation-tabblad) → smoke test op een product of order. Reken meer tijd als u een custom theme heeft dat vergelijkbare templates overschrijft. Het Wimakeit-team heeft deze module geleverd aan B2B- en DTC-shops in heel België.
Phone Flags is ontworpen voor Magento 2.4.x / Mage-OS 2.0+ en heeft geen Magento 1-equivalent. Bij een migratie vanaf Magento 1 neemt het Wimakeit-team de audit, datamigratie en integratie van Phone Flags in de nieuwe backoffice voor zijn rekening, in het kader van een Magento-migratieproject. De overstap van Adobe Commerce naar Mage-OS is transparant voor Phone Flags: zelfde
composer require, zelfde modulecode, zelfde databaseschema — geen fork om te onderhouden, geen licentiewijziging.
Updates lopen via uw composer-dependency (exact dit pakket), gehost op het private Composer-register van Wimakeit op packages.wimakeit.be. Elke release wordt aangekondigd op het Changelog-tabblad + het Wimakeit-nieuws en volgt semver —
composer update blijft veilig binnen een major.
Alle .phtml-templates zijn overschrijfbaar vanuit uw theme: kopieer het bestand naar
app/design/frontend/{UwVendor}/{theme}/Wimakeit_{Module}/templates/ met hetzelfde relatieve pad. Blocks, ViewModels en Helpers worden overschreven via DI-preference in uw eigen custom module — declareer <preference for="Wimakeit\…\OriginalClass" type="UwVendor\Override\Class" /> in etc/di.xml. Layout-XML wordt uitgebreid (voorkeur) of overschreven op de standaard Magento-manier. Wimakeit-modules gebruiken nooit het keyword final op klassen die u redelijkerwijs zou willen override — overschrijven is een first-class scenario, geen hack. Support & beveiliging 3
Open een ticket via het contactformulier op wimakeit.be of mail
contact@wimakeit.com met modulenaam, versie, Magento/Mage-OS-versie en reproduceringsstappen. Fixes verschijnen in de volgende patch. Wimakeit-support antwoordt in het Nederlands, Frans en Engels op werkdagen (CET-uren).
Stuur security-rapporten privé naar
contact@wimakeit.com met het voorvoegsel [SECURITY] in het onderwerp — vermeld de module, versie en reproductiestappen. Bevestiging op werkdagen, vermelding in het Changelog op verzoek. Wimakeit is een Belgische BV (besloten vennootschap) onderworpen aan Belgisch en Europees recht inzake privacy en responsible disclosure.
Ja. Phone Flags bewaart uitsluitend data binnen zijn functionele scope, volgt nooit shoppers over verschillende sites, en doet by-default geen enkele externe call. Combineer met de Wimakeit GDPR-module voor cookiebanners en data-subject request forms conform Belgische, Franse en Nederlandse DPA-richtlijnen. De hostingpartners van Wimakeit (OVH Roubaix / Gravelines, Cblue Gembloux) houden alle klantdata binnen de EU.
Over Wimakeit 1
Wimakeit is een Adobe-gecertificeerd Magento-bureau in Presles, Wallonië (tussen Charleroi en Namen), België, dat sinds 2020 Magento- en Mage-OS-webshops bouwt voor klanten in BE / FR / NL. Elke module op deze marketplace draait in productie bij minstens één Wimakeit-klant (we eat our own dogfood). Directe lijn met de ontwikkelaars die de code hebben geschreven, meertalige support (NL / FR / EN), CET-werkuren, geen offshore. Bekijk onze referenties voor het soort Magento-projecten dat wij opleveren.
Iets gevonden dat niet in de FAQ staat?
Meld een bug of stel een vraag — het formulier is voor-ingevuld met deze module.
Changelog
Categories: Security, Feature, Fix, Perf, Admin, Deps.
[1.4.8] - 2026-06-05
Deps
- Marketing documentation refreshed to list PHP 8.4 in the supported PHP range.
[1.4.7] - 2026-06-05
Deps
- PHP 8.4 certified — constraint widened to
>=8.1 <8.5.
[1.4.6] - 2026-05-08
Admin
- Admin menu group standardized — module appears under a top-level Wimakeit_PhoneFlags entry with a Settings child that opens directly on the configuration section.
- Config section path renamed from
phoneflagstowimakeit_phone_flagsfor consistency with the other Wimakeit modules. A data patch migrates existingcore_config_datarows automatically onsetup:upgrade— no manual reconfiguration needed.
[1.4.5] - 2026-04-29
Deps
- Certified PHP 8.1 → 8.3 support. Composer
phpconstraint tightened to>=8.1 <8.4.
[1.4.4] - 2026-04-14
Admin
- Composer/Satis distribution archives now exclude internal files (
.gitlab-ci.yml,.claude/,docs/,.gitattributes).
[1.4.3] - 2026-04-14
Admin
- Configuration access refactored from
Helper\ConfigtoModel\Config(extendsAbstractConfigfromwimakeit/module-core) — typed getters and consistency with the other Wimakeit modules. The legacy helper is removed.
[1.4.2] - 2026-04-07
Feature
- Native Breeze frontend support. New
breeze_default.xmllayout registers Breeze JS bundles, ships Breeze-nativephone-init.jsandcustomer-address-phone.jswidgets, and adds Breeze-compatible LESS styles with the@criticalguard.
Deps
- Depends on
wimakeit/module-corefor shared config abstractions.
[1.4.1] - 2026-03-17
Admin
- Internal release pipeline consolidated (single auto-tag block).
[1.4.0] - 2026-01-25
Fix
- Flag images failing to load on stores with non-default
pub/staticpaths — asset import path corrected.
[1.3.0] - 2026-01-25
Fix
- Country-code import on customer save no longer fails when the address has no country selected.
[1.2.0] - 2026-01-25
Feature
- Customer account support — phone-flags input now renders on the customer address form (My Account → Address Book) in addition to checkout.
- Country sync — the selected country in the address auto-updates the flag/dial-code prefix without a page reload.
- Enhanced admin configuration — defaults for preferred country, allowed countries and dropdown behaviour are now exposed in the admin.
[1.0.0] - 2025-12-18
Feature
- Initial release of Wimakeit Phone Flags for Magento 2 / Mage-OS.
- Renders phone-number inputs with a flag-and-dial-code prefix on the checkout shipping/billing form (intl-tel-input behaviour, no third-party JS dependency).
- Validates the entered number against the chosen country's format on submit.
- Stores the E.164-formatted number alongside the entered value so downstream integrations (SMS, CRM) always get a usable number.
Een bug gevonden? Laat het ons weten.
Een kort formulier opent in een nieuw tabblad — de modulenaam en uw taal zijn al ingevuld. Beschrijf wat u probeerde, wat misging, en wij komen binnen één werkdag bij u terug.
Een bug melden voor Phone Flags
Module SKU: wimakeit-module-phone-flags · Taal: nl_NL
Hulp nodig?
Ons team helpt u graag met de integratie.