log1x/acf-phone-number

A real ACF phone number field.

Fund package maintenance!
Log1x

Installs: 50 483

Dependents: 0

Suggesters: 0

Security: 0

Stars: 115

Watchers: 11

Forks: 18

Open Issues: 3

Type:wordpress-plugin

v1.3.1 2024-11-05 04:22 UTC

README

Latest Stable Version Total Downloads Build Status

A real ACF phone number field powered by libphonenumber and intl-tel-input

Screenshot

Requirements

Installation

Bedrock

Install via Composer:

$ composer require log1x/acf-phone-number

Manual

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

Usage

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

Calling the field will return an arrayable 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

If you are on Sage 10 and using my ACF Composer package:

$field
  ->addField('my_number_field', 'phone_number')
    ->setConfig('placeholder', '+1 555-555-5555')
    ->setConfig('default_country', 'us');

Bug Reports

If you discover a bug in ACF Phone Number, please open an issue.

Contributing

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

License

ACF Phone Number is provided under the MIT License.