{"id":41053,"date":"2015-12-30T11:19:04","date_gmt":"2015-12-30T11:19:04","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/forms-3rdparty-phone-numbers\/"},"modified":"2016-09-29T17:19:58","modified_gmt":"2016-09-29T17:19:58","slug":"forms-3rdparty-phone-numbers","status":"publish","type":"plugin","link":"https:\/\/so.wordpress.org\/plugins\/forms-3rdparty-phone-numbers\/","author":7795090,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"0.4.3","stable_tag":"trunk","tested":"4.5.33","requires":"3.0","requires_php":"","requires_plugins":"","header_name":"Forms: 3rdparty-Integration Phone Numbers","header_author":"zaus","header_description":"","assets_banners_color":"","last_updated":"2016-09-29 17:19:58","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/drzaus.com\/donate","header_plugin_uri":"https:\/\/github.com\/zaus\/f3i-phonenumber","header_author_uri":"http:\/\/drzaus.com","rating":0,"author_block_rating":0,"active_installs":10,"downloads":1573,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"":"<p>N\/A.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.3","0.4","0.4.2"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[30778,1556,358,23477,5304],"plugin_category":[],"plugin_contributors":[],"plugin_business_model":[],"class_list":["post-41053","plugin","type-plugin","status-publish","hentry","plugin_tags-3rdparty-services","plugin_tags-api","plugin_tags-contact-form","plugin_tags-parsing","plugin_tags-phone-number","plugin_committers-zaus"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/forms-3rdparty-phone-numbers.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>An add-on to <a href=\"https:\/\/wordpress.org\/plugins\/forms-3rdparty-integration\/\">'Forms: 3rdparty Integration'<\/a>, it parses phone number fields from Contact Form submissions and exposes them to additional mapping.<\/p>\n <p>Uses the <a href=\"https:\/\/github.com\/giggsey\/libphonenumber-for-php\">PHP Port of Google's libphonenumber<\/a>, which may be included via Composer instead -- see <a href=\"https:\/\/github.com\/zaus\/f3i-phonenumber\">GitHub version<\/a> instead.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Unzip\/upload plugin folder to your plugins directory (<code>\/wp-content\/plugins\/<\/code>)<\/li>\n<li>Make sure <a href=\"http:\/\/wordpress.org\/plugins\/forms-3rdparty-integration\/\">Forms 3rdparty Integration<\/a> is installed and settings have been saved at least once.<\/li>\n<li>Activate this plugin<\/li>\n<li>Set the 'Phone number fields' option (fieldset may be collapsed by default) using URL-querystring format.<\/li>\n<\/ol>\n <p>You can provide one or more phone numbers separated by <code>&amp;<\/code> symbols. You may specify the input format (per country) with <code>=country-code<\/code>. You may specify both the input format and output format with <code>=input-format,output-format<\/code>. You may use another submission field to define the format by prefixing that field name with <code>##<\/code>, e.g. <code>field_name=##another_field<\/code><\/p>\n <p>Will parse and split up input phone number(s) and create additional 'submission' fields (which you can map against): * <code>FIELDNAME-CountryCode<\/code> = country code * <code>FIELDNAME-NationalNumber<\/code> = regional number (without country code) * <code>FIELDNAME-AreaCode<\/code> = regional code * <code>FIELDNAME-Subscriber<\/code> = local number (without area code) * <code>FIELDNAME-Extension<\/code> = telephone extension, if present * <code>FIELDNAME-NumberOfLeadingZeros<\/code> = how many zeros it would start with if it had them * <code>FIELDNAME-Out<\/code> = reformated phone number<\/p>\n <p>Example: to convert input phone-number \"9195551234\" in various fields:<\/p>\n <pre><code>field_name&amp;field2=US,2&amp;field3=2,3&amp;field4=##field5 <\/code><\/pre>\n <ul>\n<li><code>field_name<\/code> from assumed format into standard international <code>+1 919-555-1234<\/code><\/li>\n<li><code>field2<\/code> assuming US country code into standard regional <code>(919) 555-1234<\/code><\/li>\n<li><code>field3<\/code> from international format (requires country code <code>+X<\/code>) into url style <code>tel:+1-919-555-1234<\/code><\/li>\n<li><code>field4<\/code> from international format (requires country code <code>+X<\/code>) into a format defined by <code>field5<\/code><\/li>\n<\/ul>\n\n<!--section=faq-->\n<dl>\n<dt>It doesn't work right...<\/dt>\n<dd><p>Drop an issue at https:\/\/github.com\/zaus\/f3i-phonenumber<\/p><\/dd>\n<dt>Using field labels<\/dt>\n<dd><p>Forms 3rdparty Integration makes some form plugin fields available by label as well as by id.  There is a <a href=\"http:\/\/php.net\/manual\/en\/function.parse-str.php#76978\">quirk in parsing url-querystrings<\/a> 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:  * <code>your label-NationalNumber<\/code>\n * <code>your label-_etc_<\/code><\/p><\/dd>\n<dt>Formats<\/dt>\n<dd><p>From <a href=\"https:\/\/github.com\/giggsey\/libphonenumber-for-php\/blob\/master\/src\/libphonenumber\/PhoneNumberFormat.php\">here<\/a>, among other places<\/p>\n <ul>\n<li><em>US<\/em> = United States<\/li>\n<li><em>CH<\/em> = Switzerland<\/li>\n<li><em>other iso country codes<\/em><\/li>\n<li><em>1<\/em> = (default) international format<\/li>\n<li><em>2<\/em> = national format<\/li>\n<li><em>3<\/em> = RFC3966 (url-format)<\/li>\n<\/ul><\/dd>\n <\/dl>\n\n<!--section=changelog-->\n<h4>0.4.3<\/h4>\n <ul>\n<li>bump giggsey\/libphonenumber to v7.6.1 to fix missing autoloader file<\/li>\n<\/ul>\n <h4>0.4.2<\/h4>\n <ul>\n<li>addressing <a href=\"http:\/\/php.net\/manual\/en\/function.parse-str.php#76978\">spaces in url key quirk<\/a><\/li>\n<\/ul>\n <h4>0.4<\/h4>\n <ul>\n<li>updated libphonenumber from v7.2.2 to v7.4.5<\/li>\n<li>including area code + subscriber number components<\/li>\n<\/ul>\n <h4>0.3<\/h4>\n <ul>\n<li>use another submission field as the format<\/li>\n<\/ul>\n <h4>0.2<\/h4>\n <ul>\n<li>support for input\/output format<\/li>\n<\/ul>\n <h4>0.1<\/h4>\n <ul>\n<li>started<\/li>\n<\/ul>","raw_excerpt":"An add-on to &#039;Forms: 3rdparty Integration&#039;, it parses phone number fields from Contact Form submissions and exposes them to additional mappi &hellip;","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/41053","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=41053"}],"author":[{"embeddable":true,"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/zaus"}],"wp:attachment":[{"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=41053"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=41053"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=41053"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=41053"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=41053"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/so.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=41053"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}