PHPackages                             androlax2/acf-phone-number - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. androlax2/acf-phone-number

ActiveWordpress-plugin[Utility &amp; Helpers](/categories/utility)

androlax2/acf-phone-number
==========================

A real ACF phone number field.

1.0.0(3y ago)01.1k↓50%MITPHPPHP &gt;=7.2

Since Oct 25Pushed 3y agoCompare

[ Source](https://github.com/Androlax2/acf-phone-number)[ Packagist](https://packagist.org/packages/androlax2/acf-phone-number)[ GitHub Sponsors](https://github.com/Log1x)[ RSS](/packages/androlax2-acf-phone-number/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

ACF Phone Number
================

[](#acf-phone-number)

[![Latest Stable Version](https://camo.githubusercontent.com/918ce85955ceabf0da0728cea453767f77ea40770e6aac372d61eee9cf6b86a4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c6f6731782f6163662d70686f6e652d6e756d6265723f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/918ce85955ceabf0da0728cea453767f77ea40770e6aac372d61eee9cf6b86a4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c6f6731782f6163662d70686f6e652d6e756d6265723f7374796c653d666c61742d737175617265)[![Total Downloads](https://camo.githubusercontent.com/350795edd4845793acce19e031b0e09d4a3198d39d4b12478a43ad0f28906db7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c6f6731782f6163662d70686f6e652d6e756d6265723f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/350795edd4845793acce19e031b0e09d4a3198d39d4b12478a43ad0f28906db7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c6f6731782f6163662d70686f6e652d6e756d6265723f7374796c653d666c61742d737175617265)[![Build Status](https://camo.githubusercontent.com/9bd1f1b03d391149c7a955f359df527971702567a05af2064a5d17962493d9eb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6c6f6731782f6163662d70686f6e652d6e756d6265722f436f6d7061746962696c697479253230436865636b733f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/9bd1f1b03d391149c7a955f359df527971702567a05af2064a5d17962493d9eb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6c6f6731782f6163662d70686f6e652d6e756d6265722f436f6d7061746962696c697479253230436865636b733f7374796c653d666c61742d737175617265)

A real ACF phone number field powered by [libphonenumber](https://github.com/giggsey/libphonenumber-for-php) and [intl-tel-input](https://github.com/jackocnr/intl-tel-input)

[![Screenshot](https://camo.githubusercontent.com/5f16a4873a232829e9cbb1aa9caea99d160860d51a5330d2b76634a2b253a94f/68747470733a2f2f692e696d6775722e636f6d2f494c6d734248722e676966)](https://camo.githubusercontent.com/5f16a4873a232829e9cbb1aa9caea99d160860d51a5330d2b76634a2b253a94f/68747470733a2f2f692e696d6775722e636f6d2f494c6d734248722e676966)

Requirements
------------

[](#requirements)

- [PHP](https://secure.php.net/manual/en/install.php) &gt;= 7.2 (with [`php-intl`](https://www.php.net/manual/en/book.intl.php) installed)
- [Composer](https://getcomposer.org/download/)

Installation
------------

[](#installation)

### Bedrock

[](#bedrock)

Install via Composer:

```
$ composer require log1x/acf-phone-number
```

### Manual

[](#manual)

Download the release `.zip` and install into `wp-content/plugins`.

Usage
-----

[](#usage)

Pretty straight forward usage. You can optionally set a default country.

Calling the field will return an [arrayable](https://github.com/Log1x/acf-phone-number/blob/master/src/PhoneNumber.php#L225-L246) object containing everything you need about your number:

```
{
  +"number": "+1 405-867-5309"
  +"country": "US"
  +"uri": "tel:+14058675309"
  +"e164": "+14058675309"
  +"rfc3966": "tel:+1-405-867-5309"
  +"national": "(405) 867-5309"
  +"international": "+1 405-867-5309"
  +"carrier": ""
  +"location": "Oklahoma"
  +"timezone": array:1 [▼
    0 => "America/Chicago"
  ]
}
```

### ACF Composer

[](#acf-composer)

If you are on Sage 10 and using my [ACF Composer](https://github.com/log1x/acf-composer) package:

```
$field
  ->addField('my_number_field', 'phone_number')
    ->setConfig('default_country', 'us');
```

Bug Reports
-----------

[](#bug-reports)

If you discover a bug in ACF Phone Number, please [open an issue](https://github.com/log1x/acf-phone-number/issues).

Contributing
------------

[](#contributing)

Contributing whether it be through PRs, reporting an issue, or suggesting an idea is encouraged and appreciated.

License
-------

[](#license)

ACF Phone Number is provided under the [MIT License](https://github.com/log1x/acf-phone-number/blob/master/LICENSE.md).

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 70.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1296d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/39646949?v=4)[Théo Benoit](/maintainers/Androlax2)[@Androlax2](https://github.com/Androlax2)

---

Top Contributors

[![Log1x](https://avatars.githubusercontent.com/u/5745907?v=4)](https://github.com/Log1x "Log1x (52 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (10 commits)")[![Androlax2](https://avatars.githubusercontent.com/u/39646949?v=4)](https://github.com/Androlax2 "Androlax2 (5 commits)")[![joshuafredrickson](https://avatars.githubusercontent.com/u/3533660?v=4)](https://github.com/joshuafredrickson "joshuafredrickson (2 commits)")[![huubl](https://avatars.githubusercontent.com/u/50170696?v=4)](https://github.com/huubl "huubl (1 commits)")[![thuijssoon](https://avatars.githubusercontent.com/u/4426512?v=4)](https://github.com/thuijssoon "thuijssoon (1 commits)")[![cryptomothy](https://avatars.githubusercontent.com/u/14184116?v=4)](https://github.com/cryptomothy "cryptomothy (1 commits)")[![davidwebca](https://avatars.githubusercontent.com/u/412352?v=4)](https://github.com/davidwebca "davidwebca (1 commits)")[![emanueljacob](https://avatars.githubusercontent.com/u/28386816?v=4)](https://github.com/emanueljacob "emanueljacob (1 commits)")

---

Tags

wordpressacfphone-numberacf-field

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/androlax2-acf-phone-number/health.svg)

```
[![Health](https://phpackages.com/badges/androlax2-acf-phone-number/health.svg)](https://phpackages.com/packages/androlax2-acf-phone-number)
```

###  Alternatives

[log1x/acf-phone-number

A real ACF phone number field.

12072.5k](/packages/log1x-acf-phone-number)[log1x/acf-editor-palette

A replica Gutenberg color picker field for Advanced Custom Fields.

100284.1k](/packages/log1x-acf-editor-palette)[hellonico/acf-country

A country field for ACF.

12193.2k](/packages/hellonico-acf-country)[vinkla/extended-acf

Register advanced custom fields with object-oriented PHP

503264.8k11](/packages/vinkla-extended-acf)[samrap/acf-fluent

A fluent interface for the Advanced Custom Fields WordPress plugin

28656.0k4](/packages/samrap-acf-fluent)[gillesgoetsch/acf-smart-button

A simple, clean and lean ACF Field for internal and external links.

7625.5k](/packages/gillesgoetsch-acf-smart-button)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
