b13 / phone-number

1.0.2 2026-10-13 18:55 UTC

Requires

• php: ^8.1
• giggsey/libphonenumber-for-php-lite: ^8.0
• typo3/cms-core: ^12.4 || ^13.4 || ^14.0

GPL-2.0-or-later

Published on Packagist.org on 2026-10-13 18:55 UTC

README

Fluid ViewHelper for formatting phone numbers in TYPO3 using libphonenumber.

Formats raw phone numbers or tel: URIs (from TCA type=link with allowedTypes=telephone) into standardized international or national format (e.g. DIN 5008).

Installation

composer req b13/phone-number

Usage

Register the namespace in your Fluid template:

<html
    data-namespace-typo3-fluid="true"
    xmlns:phone="http://typo3.org/ns/B13/PhoneNumber/ViewHelpers"
>

International format (default)

<phone:format value="tel:[phone]" />

Output: [phone]

National format

<phone:format value="tel:[phone]" national="1" />

Output: 0711 3400810

Raw number input

<phone:format value="[phone]" />

Output: [phone]

ViewHelper Arguments

Argument	Type	Default	Description
value	string	—	Phone number or tel: link value (required)
defaultRegion	string	DE	Default region for parsing numbers without country code
national	bool	false	Format as national number (0711 ...) instead of international

Requirements

• PHP ^8.1
• TYPO3 ^12.4, ^13.4 or ^14.0

License

GPL-2.0-or-later

Credits

This extension was created by David Steeb in 2026 for b13 GmbH, Stuttgart.

Phone number parsing is powered by libphonenumber-for-php-lite.

Find more TYPO3 extensions we have developed that help us deliver value in client projects. As part of our work, we focus on testing and best practices to ensure long-term performance, reliability, and results in all our code.