=== Thinqmagic Country State City Dropdown for WPForms ===
Contributors: shivanirajput, thinqmagic
Donate link: https://thinqmagictech.com/
Tags: country dropdown, state dropdown, city dropdown, location field, cascading dropdown
Requires at least: 5.5
Tested up to: 7.1
Requires PHP: 7.2
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Easily add dynamic Country, State, and City cascading dropdown fields to WPForms forms.

== Description ==

**Thinqmagic Country State City Dropdown for WPForms** is a lightweight, responsive addon for WPForms that adds an intelligent cascading Country, State, and City field to your forms.

When a user selects a Country, the State/Province dropdown dynamically loads the corresponding states. When a State is selected, the City dropdown automatically populates with relevant cities.

### 🌟 Key Features (Free Version)
* **Cascading Dropdowns:** Country -> State -> City linked selection.
* **Instant Dynamic Loading:** Fast, asynchronous AJAX loading without page reloads.
* **Show/Hide Controls:** Option to hide State or City fields if only Country is required.
* **Standard Field Sizing:** Supports standard WPForms Small (250px), Medium (60%), and Large (100%) widths.
* **Custom "Other" Input:** Allows users to manually type their custom country, state, or city if not listed.
* **Strict Validation:** Fully integrated with WPForms required field validation.
* **Mobile Responsive:** Adapts fluidly to all screen sizes and mobile devices.

### 🚀 Upgrade to Pro Version
Looking for advanced features? Check out [Country State City Dropdown for WPForms Pro](https://thinqmagictech.com/product/wpforms-country-state-city-dropdown-pro/):
* **Google Places Address Autocomplete:** Instant address search & auto-fill.
* **Complete Address Block:** Full card with Street Address Line 1 & 2 and Zip/Postal Code.
* **Country Whitelisting & Blacklisting:** Restrict or allow only specific countries.
* **GeoIP Location Auto-Detect:** Automatically detect user's country and city on page load.
* **Default Country Pre-selection:** Pre-select default country code (e.g. US, GB, IN).

== Installation ==

1. Upload the plugin folder to the `/wp-content/plugins/` directory, or install the plugin directly through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Open any form in **WPForms** -> **Add New** or **Edit**.
4. Drag and drop the **Country State City** field from the Standard Fields panel into your form.
5. Save your form and embed it anywhere on your site!

== Frequently Asked Questions ==

= Does this plugin require WPForms Pro? =
No! This addon works with both **WPForms Free (Lite)** and **WPForms Pro**.

= Can I hide the State or City dropdown? =
Yes! In the form builder, click on the Country State City field options to toggle "Hide State Field" or "Hide City Field".

= What happens if a user's location is not in the list? =
Users can select "Other (Please specify)" to enter their custom country, state, or city in a dedicated text box.

== External or 3rd Party Services ==

This plugin utilizes the **CountriesNow API** (`https://countriesnow.space/`) to dynamically retrieve city lists for selected states and countries.

* **Service:** CountriesNow API (https://countriesnow.space/)
* **Data Sent:** Only the selected Country Name and State Name are sent in an API request to fetch city options. No personal data, user IP, or identifying user information is transmitted.
* **Terms & Service Information:** https://countriesnow.space/
* **Privacy Policy:** https://countriesnow.space/

== Screenshots ==

1. WPForms builder showing Country State City field options.
2. Frontend form display with cascading Country, State, and City dropdowns.
3. Custom "Other" text input when custom location is specified.

== Changelog ==

= 1.1.0 =
* Added dynamic country, state, and city cascading dropdowns.
* Added standard WPForms field size support (Small, Medium, Large).
* Added show/hide toggles for State and City fields.
* Added custom text inputs for "Other" selections with strict required validation.
* Tested with WordPress 6.7 and WPForms 1.9+.

== Upgrade Notice ==

= 1.1.0 =
Initial release of Country State City Dropdown for WPForms.
