Title: Forms: 3rdparty Phone Numbers Author: zaus Published: December 30, 2015 Last modified: September 29, 2016 --- Search plugins This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://s.w.org/plugins/geopattern-icon/forms-3rdparty-phone-numbers.svg) # Forms: 3rdparty Phone Numbers By [zaus](https://profiles.wordpress.org/zaus/) [Download](https://downloads.wordpress.org/plugin/forms-3rdparty-phone-numbers.zip) * [Details](https://wordpress.org/plugins/forms-3rdparty-phone-numbers/#description) * [Reviews](https://wordpress.org/plugins/forms-3rdparty-phone-numbers/#reviews) * [Installation](https://wordpress.org/plugins/forms-3rdparty-phone-numbers/#installation) * [Development](https://wordpress.org/plugins/forms-3rdparty-phone-numbers/#developers) [Support](https://wordpress.org/support/plugin/forms-3rdparty-phone-numbers/) ## Description An add-on to [‘Forms: 3rdparty Integration’](https://wordpress.org/plugins/forms-3rdparty-integration/), it parses phone number fields from Contact Form submissions and exposes them to additional mapping. Uses the [PHP Port of Google’s libphonenumber](https://github.com/giggsey/libphonenumber-for-php), which may be included via Composer instead — see [GitHub version](https://github.com/zaus/f3i-phonenumber) instead. ## Installation 1. Unzip/upload plugin folder to your plugins directory (`/wp-content/plugins/`) 2. Make sure [Forms 3rdparty Integration](https://wordpress.org/plugins/forms-3rdparty-integration/) is installed and settings have been saved at least once. 3. Activate this plugin 4. Set the ‘Phone number fields’ option (fieldset may be collapsed by default) using URL-querystring format. You can provide one or more phone numbers separated by `&` symbols. You may specify the input format (per country) with `=country-code`. You may specify both the input format and output format with `=input-format,output-format`. You may use another submission field to define the format by prefixing that field name with `##`, e. g. `field_name=##another_field` Will parse and split up input phone number(s) and create additional ‘submission’ fields (which you can map against): * `FIELDNAME-CountryCode` = country code * ` FIELDNAME-NationalNumber` = regional number (without country code) * `FIELDNAME- AreaCode` = regional code * `FIELDNAME-Subscriber` = local number (without area code) * `FIELDNAME-Extension` = telephone extension, if present * `FIELDNAME-NumberOfLeadingZeros` = how many zeros it would start with if it had them * `FIELDNAME-Out` = reformated phone number Example: to convert input phone-number “9195551234” in various fields: ``` field_name&field2=US,2&field3=2,3&field4=##field5 ``` * `field_name` from assumed format into standard international `+1 919-555-1234` * `field2` assuming US country code into standard regional `(919) 555-1234` * `field3` from international format (requires country code `+X`) into url style` tel:+1-919-555-1234` * `field4` from international format (requires country code `+X`) into a format defined by `field5` ## FAQ It doesn’t work right… Drop an issue at https://github.com/zaus/f3i-phonenumber Using field labels Forms 3rdparty Integration makes some form plugin fields available by label as well as by id. There is a [quirk in parsing url-querystrings](http://php.net/manual/en/function.parse-str.php#76978) whereby spaces in keys are turned into underscores. As of v0.4.2 this plugin will check if the key should have had spaces, so that ‘your label=fieldvalue’ will turn into: * `your label-NationalNumber` * `your label-_etc_` Formats From [here](https://github.com/giggsey/libphonenumber-for-php/blob/master/src/libphonenumber/PhoneNumberFormat.php), among other places * _US_ = United States * _CH_ = Switzerland * _other iso country codes_ * _1_ = (default) international format * _2_ = national format * _3_ = RFC3966 (url-format) ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Forms: 3rdparty Phone Numbers” is open source software. The following people have contributed to this plugin. Contributors * [ zaus ](https://profiles.wordpress.org/zaus/) [Translate “Forms: 3rdparty Phone Numbers” into your language.](https://translate.wordpress.org/projects/wp-plugins/forms-3rdparty-phone-numbers) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/forms-3rdparty-phone-numbers/), check out the [SVN repository](https://plugins.svn.wordpress.org/forms-3rdparty-phone-numbers/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/forms-3rdparty-phone-numbers/) by [RSS](https://plugins.trac.wordpress.org/log/forms-3rdparty-phone-numbers/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 0.4.3 * bump giggsey/libphonenumber to v7.6.1 to fix missing autoloader file #### 0.4.2 * addressing [spaces in url key quirk](http://php.net/manual/en/function.parse-str.php#76978) #### 0.4 * updated libphonenumber from v7.2.2 to v7.4.5 * including area code + subscriber number components #### 0.3 * use another submission field as the format #### 0.2 * support for input/output format #### 0.1 * started ## Meta * Version **0.4.3** * Last updated **10 years ago** * Active installations **10+** * WordPress version ** 3.0 or higher ** * Tested up to **4.5.33** * Tags * [api](https://wordpress.org/plugins/tags/api/)[contact form](https://wordpress.org/plugins/tags/contact-form/) [parsing](https://wordpress.org/plugins/tags/parsing/)[phone number](https://wordpress.org/plugins/tags/phone-number/) * [Advanced View](https://wordpress.org/plugins/forms-3rdparty-phone-numbers/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/forms-3rdparty-phone-numbers/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/forms-3rdparty-phone-numbers/reviews/) ## Contributors * [ zaus ](https://profiles.wordpress.org/zaus/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/forms-3rdparty-phone-numbers/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](http://drzaus.com/donate)