Phone Flags
v1.4.8
v1.4.8
Abonnement annuel
Mis à jour le 25 août 2026
Phone Flags
Transforme chaque champ téléphone en input à drapeaux, avec formatage automatique et validation en direct, pour des numéros toujours au format international.
Compatible Hyvä
Magento 2.4.4
Magento 2.4.5
Magento 2.4.6
Magento 2.4.7
Mage-OS 2.0
Mage-OS 2.1
- Mises à jour et support inclus pendant 12 mois
- Clé de licence livrée immédiatement par email
- Garantie satisfait ou remboursé 30 jours
- Documentation complète incluse
- Compatible avec les thèmes Hyvä
- Installation prête pour Composer
Phone Flags
Collectez des numéros de téléphone internationaux propres sans jamais demander à vos clients de connaître l'indicatif de leur pays. Ce module transforme chaque champ téléphone de votre boutique — checkout, espace client, inscription, formulaire de contact — en une saisie intuitive avec drapeaux pays, mise en forme automatique et validation en temps réel. Résultat : ce qui arrive dans votre base de données est toujours joignable, où que vive le client.
Les numéros mal saisis sont une cause sous-estimée d'échecs de livraison, de colis Mondial Relay non distribués et de temps de support gaspillé. En rendant le format non-ambigu à la saisie, ce module résout le problème à la source au lieu de demander à votre équipe support de nettoyer après coup.
À qui ça s'adresse
- Marchands cross-border dont les clients viennent de plusieurs pays et ne peuvent pas tous connaître le format international
- Boutiques utilisant des intégrations transporteurs (Mondial Relay, Bpost, DPD…) qui dépendent d'un numéro valide dans le pays de destination
- Marchands B2C qui veulent un checkout fluide et moderne, à la hauteur de l'expérience que les clients voient sur leurs apps bancaires ou de voyage
Bénéfices clés
- Drapeaux pays dans chaque formulaire — checkout (shipping/billing), carnet d'adresses du compte client, inscription et page contact. Une UX cohérente sur toute la boutique.
- Mise en forme et validation en direct — les numéros sont formatés à la frappe et validés au blur, avec un message d'erreur clair si le numéro n'est pas valide pour le pays sélectionné.
- Liste pays intelligente — épinglez vos pays préférés en haut du dropdown, masquez les pays non pertinents ou restreignez la liste à un set précis. La détection GeoIP optionnelle pré-sélectionne le pays du visiteur.
- Garde-fou Mondial Relay — affiche un avertissement au checkout quand le pays du téléphone ne correspond pas au pays de livraison, pour que le point relais puisse effectivement joindre le client.
- Adapté au mobile — sélecteur pays en plein écran sur mobile, sprites de drapeaux retina, aucune dépendance à jQuery.
- Plug & play — fonctionne sur les formulaires d'adresse Magento standard et équivalents Hyvä sans intervention sur le thème.
Compatibilité
- Magento 2.4.x / équivalent Mage-OS
- PHP 8.1, 8.2, 8.3
- Nécessite
wimakeit/module-core3.0 ou supérieur - Fonctionne sur les frontends Luma ; les projets Hyvä peuvent réutiliser le helper JavaScript
- Compatible avec le Full Page Cache (validation côté client)
Installez ce module via Composer. Assurez-vous que votre auth.json est configuré avec vos identifiants Wimakeit.
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.
- Version
- v1.4.8
- Licence
- Abonnement annuel
- Support
- 12 mois
- Dernière mise à jour
- 25 août 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ä
- Compatible
- Package
-
wimakeit/module-phone-flags
Vérifier la compatibilité
Indiquez votre stack pour vérifier la compatibilité du module.
Compatible avec votre stack — prêt à installer.
Non compatible avec cette combinaison. Contactez-nous pour une version sur mesure.
Compatibilité 4
Oui. Phone Flags est testé sur Magento Open Source 2.4.4 → 2.4.7, Adobe Commerce sur la même ligne, et Mage-OS 2.0+ — en PHP 8.1, 8.2 et 8.3. L'onglet « Spécifications » liste les combinaisons testées. Si votre stack y figure, l'installation est garantie. Wimakeit est une agence Magento certifiée Adobe basée à Presles, en Wallonie (entre Charleroi et Namur) — chaque module est validé sur la même matrice que celle livrée à nos clients enterprise en Belgique, France et Pays-Bas.
Oui — complètement. Phone Flags embarque un frontend natif compatible Hyvä (Tailwind + Alpine.js) et s'intègre avec Hyvä Checkout le cas échéant. Aucun module de compatibilité supplémentaire requis. Chaque module estampillé Hyvä est développé par la même équipe Wimakeit qui réalise les migrations Hyvä pour nos clients en production.
Hyvä Storefront (Tailwind + Alpine.js, rendu serveur) et Hyvä Checkout (React, headless au-dessus de Magento) sont deux packages distincts. Phone Flags embarque une compatibilité Hyvä Storefront native — son frontend est rendu via les templates Hyvä, sans fallback Luma. L'intégration Hyvä Checkout est livrée quand le module a un touchpoint d'étape checkout (input de paiement custom, case CGV, etc.) ; sinon le module tourne côté serveur sans customisation Hyvä Checkout nécessaire. Voir l'onglet Spécifications pour le scope Hyvä exact de ce module.
Oui. Phone Flags respecte le scope Magento standard (default / website / store / store_view). Chaque configuration est surchargeable par store view. Les libellés frontend utilisent les fichiers de traduction Magento standard — livrés en français, anglais et néerlandais d'origine. Les devises suivent la configuration Magento standard, sans câblage supplémentaire. Un store Magento Wimakeit type fait tourner un triplet fr_BE / nl_BE / en_GB depuis un seul back-office — Phone Flags est prêt pour ce setup B2B / international.
Tarification & licence 4
79 € — paiement unique, licence perpétuelle, pas de frais récurrents. Inclut 1 an de mises à jour mineures + support email en français, anglais et néerlandais, 1 domaine production + 1 domaine staging/dev. Le renouvellement du support après 1 an est optionnel. Tarifs agence ou multi-store négociés directement à contact@wimakeit.com.
Oui. Phone Flags dispose d'une démo en ligne sur demo.wimakeit.be/module-phone-flags où vous pouvez explorer l'admin et le frontend avec une installation réelle pré-remplie de données. Pour une évaluation plus longue, demandez une licence d'évaluation via notre formulaire de contact — l'évaluation couvre la même scope que la licence payante et se convertit en clé permanente à l'achat.
Nous étudions les demandes de remboursement au cas par cas. Si le module ne livre pas ce qui est annoncé, envoyez un email à contact@wimakeit.com depuis l'adresse liée à votre licence. La politique de remboursement Wimakeit est publiée sur la page Conditions Générales et s'applique à tous les modules de cette marketplace.
Phone Flags est distribué sous licence commerciale propriétaire — pas MIT, pas GPL, pas open source. Le code PHP est livré dans
vendor/wimakeit/ après composer require, donc vous pouvez le lire, l'auditer, et le patcher localement pour votre propre installation Magento. Vous ne pouvez PAS le redistribuer, le sous-licencier, le publier sur un registre Composer public, ou le revendre. 1 licence = 1 domaine production + 1 domaine staging/dev (voir les Conditions Générales pour l'EULA complet). Les modules Wimakeit ne sont PAS sur le packagist.org public — ils sont distribués exclusivement via le registre Composer privé packages.wimakeit.be. Installation & mises à jour 6
Lancez
composer require wimakeit/module-phone-flags:^1.4.6, puis bin/magento setup:upgrade, bin/magento setup:di:compile, et enfin bin/magento cache:flush. L'onglet « Installation » de cette page liste chaque étape de configuration (ACLs, crons, valeurs par défaut) — un déploiement prend quelques minutes, pas des heures. Besoin d'aide ? Wimakeit propose des prestations d'installation Magento depuis notre bureau wallon (Presles, entre Charleroi et Namur).
Étape 1 : récupérez un token sur packages.wimakeit.be → Mon compte → Tokens. Étape 2 : à la racine de votre projet, ajoutez à
auth.json : {"http-basic": {"packages.wimakeit.be": {"username": "VOTRE-EMAIL", "password": "VOTRE-TOKEN"}}}. Étape 3 : enregistrez le repo : composer config repositories.wimakeit composer https://packages.wimakeit.be. Étape 4 : composer require wimakeit/module-phone-flags:^1.4.6. Dans les pipelines CI/CD, injectez COMPOSER_AUTH en variable d'environnement JSON pour éviter de commiter auth.json.
La plupart des marchands sont en ligne en 30 minutes : composer install (1-2 min) → setup:upgrade + di:compile (5-10 min selon la taille de la stack) → configuration admin (5-15 min en suivant l'onglet Installation) → smoke test sur un produit ou une commande. Comptez plus de temps si vous avez un thème custom qui override des templates similaires. L'équipe Wimakeit a livré ce module sur de nombreuses boutiques B2B et DTC en Belgique.
Phone Flags est conçu pour Magento 2.4.x / Mage-OS 2.0+ et n'a pas d'équivalent Magento 1. Lors d'une migration depuis Magento 1, l'équipe Wimakeit prend en charge l'audit, la migration de données et l'intégration de Phone Flags dans le nouveau back-office, dans le cadre d'un projet de migration Magento. Passer d'Adobe Commerce à Mage-OS est transparent pour Phone Flags : même
composer require, même code module, même schéma de base — pas de fork à maintenir, pas de changement de licence.
Les mises à jour passent par votre dépendance composer (ce package exact), hébergée sur le registre Composer privé Wimakeit packages.wimakeit.be. Chaque release est annoncée sur l'onglet Changelog + les actualités Wimakeit et suit le versioning sémantique —
composer update reste sûr à l'intérieur d'une version majeure.
Tous les templates .phtml sont overridables depuis votre thème : copiez le fichier dans
app/design/frontend/{VotreVendor}/{theme}/Wimakeit_{Module}/templates/ en respectant le même chemin relatif. Blocks, ViewModels et Helpers s'override via DI preference dans votre propre module custom — déclarez <preference for="Wimakeit\…\OriginalClass" type="VotreVendor\Override\Class" /> dans etc/di.xml. Le XML layout s'étend (préféré) ou s'override de manière standard Magento. Les modules Wimakeit n'utilisent jamais le keyword final sur les classes que vous pourriez raisonnablement vouloir override — surcharger est un scénario de premier ordre, pas un hack. Support & sécurité 3
Ouvrez un ticket via le formulaire de contact wimakeit.be ou envoyez un email à
contact@wimakeit.com avec le nom du module, sa version, votre version Magento/Mage-OS et les étapes pour reproduire. Les correctifs sont livrés dans le prochain patch. Le support Wimakeit répond en français, anglais et néerlandais en jours ouvrables (horaires CET).
Envoyez les rapports privés à
contact@wimakeit.com avec le préfixe [SECURITY] dans l'objet — précisez le module, la version et les étapes de reproduction. Accusé de réception en jours ouvrables, mention dans le Changelog sur souhait du déclarant. Wimakeit est une SRL belge (société à responsabilité limitée) soumise au droit belge et européen sur la vie privée et la divulgation responsable.
Oui. Phone Flags ne stocke que les données nécessaires à son périmètre fonctionnel, ne suit jamais les acheteurs entre les sites, et ne fait aucun appel tiers par défaut. Combinez-le avec le module RGPD Wimakeit pour publier les bandeaux cookies et les formulaires de demande d'accès aux données conformes aux guidances DPA belge, française et néerlandaise. Les hébergeurs Wimakeit (OVH Roubaix / Gravelines, Cblue Gembloux) gardent toutes les données en UE.
À propos de Wimakeit 1
Wimakeit est une agence Magento certifiée Adobe basée à Presles, en Wallonie (entre Charleroi et Namur), Belgique, qui construit des boutiques Magento et Mage-OS depuis 2020, pour des clients BE / FR / NL. Chaque module de cette marketplace tourne en production chez au moins un client Wimakeit (eat your own dog food). Ligne directe avec les développeurs qui ont écrit le code, support multilingue (FR / EN / NL), horaires CET, pas d'offshore. Consultez nos références pour voir le type de projets Magento que nous livrons.
Quelque chose n'est pas couvert par la FAQ ?
Signalez un bug ou posez une question — le formulaire est pré-rempli avec ce 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.
Vous avez trouvé un bug ? Faites-nous-en part.
Un court formulaire s'ouvre dans un nouvel onglet — le nom du module et votre langue sont déjà pré-remplis. Décrivez ce que vous avez tenté, ce qui n'a pas fonctionné, et nous vous répondrons sous un jour ouvré.
Signaler un bug pour Phone Flags
SKU module : wimakeit-module-phone-flags · Langue : fr_FR
Besoin d'aide ?
Notre équipe est disponible pour vous accompagner dans l'intégration.