=== International Telephone Field For Elementor Form ===
Contributors: hulkplugins, freemius
Donate link: https://hulkplugins.com/support/
Tags: elementor, form, elementor-form, country code, telephone
Requires at least: 6.2
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.6.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

This plugin simplifies mobile number entry by guiding users to select their country code, ensuring accurate and properly formatted data submissions.

== Description ==
The Elementor Forms International Phone Input plugin is an essential tool that empowers your forms with a specialized field for international phone numbers.

It allows users to input and validate phone numbers in the correct format for their country or region, improving the user experience and data accuracy in your Elementor forms.

###Video Overview

https://youtu.be/QddzSE_bUyM

[Pro Demo](https://demo.hulkplugins.com/international-telephone-field-for-elementor-form/)

[Documentation](https://hulkplugins.gitbook.io/international-telephone-field-for-elementor-form)

###Features

* Easy to use
* International Number Format
* Smart Auto-Detection
* Preferred Countries List
* Selective Country Control
* Validation and Error Handling
* Enhanced User Experience
* Automatically format the number as the user types
* Default value

== Installation ==
###Automatic Installation from the WordPress Dashboard

1. Login to your admin panel
2. Navigate to Plugins -> Add New
3. Search **International Telephone Field For Elementor Form**
4. Click install and activate respectively.

###Manual Installation from the WordPress Dashboard

If your server is not connected to the Internet, then you can use this method

1. Download the plugin. A ZIP file will be downloaded.
2. Login to your site\'s admin panel and navigate to Plugins -> Add New -> Upload.
3. Click choose file, select the plugin file and click install

###Install Using FTP

If you are unable to use any of the methods due to internet connectivity and file permission issues, then you can use
this method

1. Download the plugin. A ZIP file will be downloaded.
2. Unzip the file.
3. Launch your favorite FTP client. Such as FileZilla, FireFTP, CyberDuck etc. If you are a more advanced user, then you
   can use SSH too.
4. Upload the folder to wp-content/plugins/
5. Log in to your WordPress dashboard.
6. Navigate to Plugins -> Installed
7. Activate the plugin

== External Services ==

This plugin connects to various APIs to obtain geolocation information, it's needed to show the user's country based on their IP address. Below is a detailed list of the external services used, along with the data sent, usage details, and links to their terms of service and privacy policies.

1. ipapi.co
   * Purpose: Used to retrieve geolocation data such as the user's country based on their IP address.
   * Data Sent: User's IP address.
   * When Sent: Every time the geolocation functionality is accessed.
   * Terms of Service: [ipapi.co Terms](https://ipapi.co/terms/)
   * Privacy Policy: [ipapi.co Privacy Policy](https://ipapi.co/privacy/)

2. geojs.io
   * Purpose: Retrieves the user's country information based on their IP address.
   * Data Sent: User's IP address.
   * When Sent: Whenever geolocation data is required.
   * Terms of Service: [GeoJS Terms](https://www.geojs.io/tos/)
   * Privacy Policy: [GeoJS Privacy Policy](https://www.geojs.io/privacy/)

3. ip.guide
   * Purpose: Retrieves the user's country information based on their IP address.
   * Data Sent: User's IP address.
   * When Sent: Whenever geolocation data is required.
   * Terms of Service: [IP Guide Terms](https://ip.guide/)
   * Privacy Policy: [IP Guide Privacy Policy](https://ip.guide/)

4. BigDataCloud.net
   * Purpose: Performs reverse geocoding to convert geographic coordinates into readable location information.
   * Data Sent: User's IP address and/or geographic coordinates (latitude and longitude).
   * When Sent: Whenever reverse geocoding is required.
   * Terms of Service: [BigDataCloud Terms](https://www.bigdatacloud.com/terms-and-conditions)
   * Privacy Policy: [BigDataCloud Privacy Policy](https://www.bigdatacloud.com/privacy-and-cookie-policy)

== Frequently Asked Questions ==
### What is this plugin, and what does it do?

This plugin enhances your Elementor forms by adding a specialized field for international phone number input. It ensures users enter phone numbers in the correct format based on their country or region, improving data accuracy and user experience.

### Do I need Elementor Pro to use this plugin?

Yes, this plugin is designed as an add-on for Elementor Pro. It adds features specifically to the Elementor Pro form widget, so you must have it installed and activated on your website for it to work.

### What features does the plugin offer?

The plugin provides a range of features, including:

* Support for international number formats
* Smart auto-detection of the user's country
* Customizable preferred countries list
* Control over which countries to allow
* Real-time validation and error handling
* Automatic formatting as the user types
* Default value settings

### How does the country auto-detection feature work?

The plugin uses the user's IP address to determine their location and automatically sets the country code for the phone input field.

### Can I restrict users to input phone numbers from specific countries?

Yes, you can define a list of allowed countries, ensuring that users can only select phone numbers from these regions.

### Does the plugin support translations for country names?

Yes, the plugin includes translations for country names, making it user-friendly for international audiences.

### Can I set a default country or number format?

Yes, the plugin allows you to configure a default value, including a predefined country code or phone number, to simplify user input.

### What happens if a user enters an invalid phone number?

The plugin validates the input in real-time. If the number is invalid, it displays an error message, prompting the user to correct it before submitting the form.

### Can this plugin format phone numbers automatically?

Yes, as users type, the plugin automatically formats the phone number according to the selected country's format.

### Will this plugin slow down my Elementor forms?

No, the plugin is designed to integrate smoothly without affecting the performance or speed of your Elementor forms.

### Are there any compatibility issues with other plugins?

This plugin is built to work seamlessly with Elementor Pro and should work well with most plugins. However, if you encounter any conflicts, please ensure both Elementor Pro and this plugin are updated to their latest versions. You may also disable other plugins one by one to troubleshoot compatibility issues.

### How do I get support if I encounter issues?

For support, please reach out through our official support page, available from your WordPress dashboard under Plugins > Support. You can also find answers in our online documentation and user community.

== Screenshots ==

1. Product settings page.

== Changelog ==

= 1.6.0 =
* Packages Updated
* Freemius SDK Updated

= 1.5.0 =
* The issue with the phone field in the pop-up not working has been resolved.

= 1.4.0 =
* The issue with the undefined array key "enableValidation" has been resolved.

= 1.3.0 =
* Packages Updated
* Freemius SDK Updated

= 1.2.0 =
* Packages Updated
* Freemius SDK Updated
* Fixed field issue that is not working on block themes

= 1.1.0 =
* full phone number not working

= 1.0.3 =
* Dependencies update
* Bug fixes

= 1.0.2 =
* Bug fixes

= 1.0.1 =
* Country order control updated

= 1.0.0 =
* Initial release
