PHPackages log1x/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 & Helpers](/categories/utility) 4. / 5. log1x/acf-phone-number ActiveWordpress-plugin[Utility & Helpers](/categories/utility) log1x/acf-phone-number ====================== A real ACF phone number field. v1.3.1(1y ago)12072.5k↓23.5%17[2 PRs](https://github.com/Log1x/acf-phone-number/pulls)MITPHPPHP >=7.2 Since Aug 4Pushed 1y ago10 watchersCompare [ Source](https://github.com/Log1x/acf-phone-number)[ Packagist](https://packagist.org/packages/log1x/acf-phone-number)[ GitHub Sponsors](https://github.com/Log1x)[ RSS](/packages/log1x-acf-phone-number/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (2)Versions (31)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/10e0b27e477c98f1455ddb997413448f5dc3f1d57e0547e7c9642d9b20b370bf/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6c6f6731782f6163662d70686f6e652d6e756d6265722f636f6d7061746962696c6974792e796d6c3f6272616e63683d6d6173746572267374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/10e0b27e477c98f1455ddb997413448f5dc3f1d57e0547e7c9642d9b20b370bf/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6c6f6731782f6163662d70686f6e652d6e756d6265722f636f6d7061746962696c6974792e796d6c3f6272616e63683d6d6173746572267374796c653d666c61742d737175617265) 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) >= 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#L254-L272) object containing everything you need about your number: ``` ^ array:10 [ "carrier" => "" "country" => "United States" "e164" => "+14058675309" "international" => "+1 405-867-5309" "location" => "Oklahoma" "national" => "(405) 867-5309" "rfc3966" => "tel:+1-405-867-5309" "timezone" => array:1 [ 0 => "America/Chicago" ] "uri" => "tel:+14058675309" ] ``` ### 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('placeholder', '+1 555-555-5555') ->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 45 — FairBetter than 93% of packages Maintenance38 Infrequent updates — may be unmaintained Popularity46 Moderate usage in the ecosystem Community23 Small or concentrated contributor base Maturity60 Established project with proven stability Bus Factor1 Top contributor holds 70.2% 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 Every ~57 days Recently: every ~113 days Total 28 Last Release 560d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/5745907?v=4)[Brandon](/maintainers/Log1x)[@Log1x](https://github.com/Log1x) --- Top Contributors [![Log1x](https://avatars.githubusercontent.com/u/5745907?v=4)](https://github.com/Log1x "Log1x (66 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (14 commits)")[![joshuafredrickson](https://avatars.githubusercontent.com/u/3533660?v=4)](https://github.com/joshuafredrickson "joshuafredrickson (3 commits)")[![Androlax2](https://avatars.githubusercontent.com/u/39646949?v=4)](https://github.com/Androlax2 "Androlax2 (2 commits)")[![huubl](https://avatars.githubusercontent.com/u/50170696?v=4)](https://github.com/huubl "huubl (2 commits)")[![emanueljacob](https://avatars.githubusercontent.com/u/28386816?v=4)](https://github.com/emanueljacob "emanueljacob (1 commits)")[![thuijssoon](https://avatars.githubusercontent.com/u/4426512?v=4)](https://github.com/thuijssoon "thuijssoon (1 commits)")[![joostdekeijzer](https://avatars.githubusercontent.com/u/216672?v=4)](https://github.com/joostdekeijzer "joostdekeijzer (1 commits)")[![Dathix](https://avatars.githubusercontent.com/u/6402325?v=4)](https://github.com/Dathix "Dathix (1 commits)")[![cryptomothy](https://avatars.githubusercontent.com/u/14184116?v=4)](https://github.com/cryptomothy "cryptomothy (1 commits)")[![thedavidthomas](https://avatars.githubusercontent.com/u/2648750?v=4)](https://github.com/thedavidthomas "thedavidthomas (1 commits)")[![davidwebca](https://avatars.githubusercontent.com/u/412352?v=4)](https://github.com/davidwebca "davidwebca (1 commits)") --- Tags acfacf-fieldacf-prowordpresswordpress-pluginwordpressacfphone-numberacf-field ### Code Quality Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/log1x-acf-phone-number/health.svg) ``` [![Health](https://phpackages.com/badges/log1x-acf-phone-number/health.svg)](https://phpackages.com/packages/log1x-acf-phone-number) ``` ### Alternatives [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)[mcguffin/acf-customizer Use ACF Fields in customizer. 7611.3k](/packages/mcguffin-acf-customizer) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)