Gravity Forms Advanced Phone Field

How do I enable this functionality?

	Add a Phone field to your form.
	Open the field’s settings, navigate to the Perks section, and check _Enable Advanced Phone Field_.

---

Feature Details

Gravity Forms Phone Number Validation

Any phone number entered into a Phone field that has GF Advanced Phone Field activated is validated on submission. Not only does it check for proper number formatting on a per-country basis, the number is also validated to ensure that it is a real number. If an invalid phone number is entered, the form will fail validation on submission and the field will display a message asking the user to enter a value phone number.

Selectable Country Codes with Flags

Advanced Phone Field simplifies user entry of phone numbers by inserting a country code drop down with integrated flags at the beginning of the field. Users can click on this drop down to select their country.

If a user types in their country code into the field, for example +506 for Costa Rica, Advanced Phone Field will automatically switch the flag and country in the drop down.

Settings

Advanced Phone Field’s settings are found in Forms > Settings > Adv Phone Field. Changes made here will affect all instances of Advanced Phone Field across all forms.

Default Country

By default, Advanced Phone Field will determine the user’s country by GeoIP location. If you’d prefer to set a default country instead, you can select the default country here.

Preferred Countries

The country code selector’s default behavior is to list all countries in alphabetical order. Use this setting to choose preferred countries and display those countries at the top of the list.

Limit Countries

All countries are included by default, but you can choose to limit the available countries. There are two ways to handle this.

1. Select Only include the following countries… to build a list of included countries. Any countries you select will be the only countries available.
2. Select Exclude the following countries… to allow all countries except for an excluded few. Any countries you select will be excluded from the list.

Phone Meta

Advanced Phone Field captures phone meta when the form is submitted. This is stored along with the entry and can be used in a variety of ways.

How to Display Phone Meta in the Entry List Page

To display phone meta in the Entry List Page, click the gear icon to edit the Entry Columns. Then, select the phone meta fields you want to display.

Any selected phone meta fields will display the captured data. Do note that not all data is available for all numbers.

Using Phone Meta in Conditional Logic

Phone meta can be used in conditional logic for Notifications. After enabling conditional logic for a notification, each of the phone meta fields are available from the drop down.

Phone Meta Merge Tag Modifiers

Advanced Phone Field introduces additional merge tag modifiers so you can include phone meta information in Confirmations, Notifications, or anywhere else merge tags are supported.

To use the modifiers, simply add :phone[meta_key] to your Phone field’s merge tag. For example, if my Phone field’s ID is 1 and I want to output the country code, I would use {Phone:1:phone[countryCode]}.

---

Known Limitations

• Carrier and Type phone meta cannot always be reliably determined, particularly in the United States. Do not rely on these meta values being present.
• There is a discrepancy between the default padding that separates the flag selector and the phone number input. Unfortunately, the padding is hardcoded in the 3rd-party library that powers GPAPF.
  • Solution: This snippet will automatically adjust the padding to match the inputs default padding. This solution may not work if the input’s padding is not set in `px`.
• Advanced Phone Fields uses IPinfo to auto-detect the user’s country based on their IP address. By default, this auto-detection is limited to 50,000 lookups per month. Each user’s IP location is cached in local storage and is only looked up once per 24 hours.
  • Solution: If your site is exceeding the lookup limit, you can use your own IPinfo API Key and set it by using the gpapf_init_args filter.

Translations

You can use the free Loco Translate plugin to create translations for any of our Perks. If you’ve never used Loco translate before, here’s a tutorial written for beginners.

Developer’s Notes

Advanced Phone Field’s frontend is powered by the International Telephone Input JS Plugin.

When a form entry gets submitted, the number validation and meta data capture process is powered by Google’s libphonenumber library.

FAQs

What are “real” phone numbers?

A real phone number is a phone number that will pass validation with libphonenumber (Google’s library in Android since 4.0 for validating phone numbers). While a number may pass validation, it could be disconnected.

Gravity Forms Phone Number Verification

For a full verification that the number exists and belongs to the user filling out the form, we recommend sending a confirmation text or call with Twilio.

Hooks

• gpapf_init_args
  
• gpapf_intltelinput_options (JS)
  
• gpapf_merge_tag_value
  

---

Related Resources

No related resources found.