PS PrestaShop PrestaShop Beginner

International Phone Input (dfphoneintl)

Installation, configuration and E.164 normalization rules of the international phone dial code module with flag for PrestaShop 8 and 9.

Updated Module version 1.0.0

Overview

DataFirefly International Phone Input (dfphoneintl) adds a dial code selector with country flag on the PrestaShop Phone and Mobile phone fields, and normalizes numbers to the international E.164 format in the database. The module operates on two levels: browser-side for user experience, and server-side to guarantee that every address insert or update — including via API, back office or import — produces a normalized number.

Storage format: for a French customer entering 0633547864, the value stored in the database is +33633547864 — country dial code, leading 0 (trunk prefix) removed, no spaces or separators.

Requirements

  • PrestaShop 8.0.0 to 9.99.99
  • PHP 7.4 minimum (8.1+ recommended)
  • No external dependency — the module ships no third-party library

Installation

  1. Download the dfphoneintl-1.0.0.zip archive from your DataFirefly customer account.
  2. In the PrestaShop back office, go to Modules → Module Manager → Upload a module.
  3. Drag and drop the ZIP file, then click Install.
  4. The module registers itself on the required hooks automatically. No SQL table is created — dial codes are read from the native ps_country table.

Configuration

Go to Modules → Module Manager → DataFirefly International Phone Input → Configure. Three settings are available:

  • Enable on “Phone” field — toggles the selector and normalization on the phone field.
  • Enable on “Mobile Phone” field — same for the phone_mobile field.
  • Preferred countries — comma-separated ISO2 codes (e.g. fr,be,lu,ch,gb,us,de). These countries are pinned at the top of the dropdown. Default: fr,be,lu,ch,gb,us,de,es,it,nl.

The countries shown in the selector come from the countries enabled in your store (Shipping → Locations → Countries). A disabled country, or one with no dial code set in the call_prefix column, does not appear.

Client-side behavior

Covered pages

The selector appears on every front-office page featuring phone fields: account creation, registration, address management, checkout (5-step and one-page), identity page, contact page and guest order tracking.

Country synchronization

When the customer changes the country in the address form, the selector’s dial code updates automatically. Selecting Belgium switches the code to +32, Germany to +49, and so on. This synchronization also works during AJAX reloads of the native checkout: the module listens for the PrestaShop events updatedAddressForm, updatedAddress, updateCustomerAddressForm and changedCheckoutStep, with a debounced MutationObserver as a safety net for heavily customized themes.

Detection on existing addresses

If the field already contains a number in international format (editing an existing address), the module detects the corresponding country using longest dial-code matching: +1242... is recognized as Bahamas, not United States.

Server-side behavior

Server-side normalization is hooked into actionObjectAddressAddBefore and actionObjectAddressUpdateBefore. Before every INSERT or UPDATE on the ps_address table, the phone and phone_mobile fields go through the DfPhoneFormatter class. This covers every write channel: front-office forms, back office, webservice, CSV imports, and third-party modules manipulating the Address class.

Normalization rules

For an address tied to a country with dial code +33:

  • Number starting with + → kept as-is, only separators are removed: +33 6 33 54 78 64 becomes +33633547864.
  • Number starting with 00 → the 00 is replaced with +: 0033633547864 becomes +33633547864.
  • Number starting with 0 (trunk prefix) → the 0 is removed and the dial code is prepended: 0633547864 becomes +33633547864.
  • Number already starting with the dial code without + → the + is simply added: 33633547864 becomes +33633547864.
  • Any other digits-only number → the dial code is prepended.

Existing addresses are not retroactively modified at installation. Normalization applies on the next save of each address. For a bulk normalization of existing data, contact support — a SQL script following the same logic is available on request.

Theme and checkout compatibility

  • PS 8 Classic theme (Bootstrap 4) and PS 9 theme (Bootstrap 5) supported natively.
  • 5-step checkout and one-page checkout (OPC) supported.
  • Flags are Unicode emojis (Regional Indicator Symbols): no sprite, no CDN, rendered natively by all modern browsers and operating systems.
  • Multistore: global settings, country list filtered per store.
  • Multilingual: country names displayed in the visitor’s language.

Troubleshooting

The selector does not appear

  • Check that the field is enabled in the module configuration.
  • Check that your theme uses the standard field names phone / phone_mobile (or address[phone] / address[phone_mobile]). For a field renamed by a custom theme, contact support.
  • Clear the PrestaShop cache (Advanced Parameters → Performance) after installation.

Flags show as letters (FR, BE…)

Expected behavior on some older Windows systems that don’t render flag emojis. The +33 dial code stays visible and the module remains fully functional.

The dial code doesn’t follow country changes

On a heavily customized theme whose country select doesn’t use the id_country name, automatic synchronization can’t attach. The MutationObserver still re-initializes the widget, and the customer can pick the dial code manually. Contact support with your store URL for an adaptation.

Uninstallation

Uninstalling removes the module’s three configuration keys. Numbers already normalized in the database stay in international format — no customer data is modified or deleted.

Support

Email support included, updates included for 12 months. 14-day money-back guarantee on all DataFirefly modules.

Was this page helpful?

Still stuck? Contact support