=== Smart Autocomplete Address ===
Contributors: aisimpleplugin  
Tags: woocommerce, address, autocomplete, checkout, here maps  
Requires at least: 6.0  
Tested up to: 6.9  
WC tested up to: 10.7
Requires PHP: 7.2  
Stable tag: 1.0.7
License: GPLv2 or later  
License URI: https://www.gnu.org/licenses/gpl-2.0.html  

Add lightning-fast, privacy-friendly address autocomplete to WordPress and WooCommerce — powered by the HERE API, not Google.

== Description ==

**Smart Autocomplete Address** instantly suggests accurate, global addresses in your WordPress and WooCommerce forms — powered by the **HERE Geocoding & Search API**, with no Google account required.  
It’s fast, easy to set up, and fully GDPR-compliant.

### Why Choose Smart Autocomplete Address

- Real-time address suggestions for billing, shipping, and profile fields  
- Uses the **HERE API** — reliable, free tier available  
- Automatically limits results to your **WooCommerce shipping countries**  
- Works with any checkout theme or custom form  
- Simple setup: just add your API key  
- 100% GDPR-friendly and fully translatable 

== Features ==

- Autocomplete for billing and shipping address fields  
- Powered by the **HERE API** (no Google Maps required)  
- Automatically limits results to your **WooCommerce shipping countries**  
- Simple setup — just enter your HERE API key in the settings page  
- Compatible with all WooCommerce checkout themes  
- Fully translatable and ready for localization  
- Includes integrations with popular form plugins 

### GDPR & Privacy

Smart Autocomplete Address does **not** store, collect, or share any personal data.  
All lookups are handled securely via the HERE API, ensuring full compliance with privacy laws.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/here-address-autocomplete/`, or install it directly from the WordPress plugin directory.  
2. Activate the plugin through the **Plugins** screen in WordPress.  
3. Go to **Address Autocomplete → Settings**.    
4. Enter your **HERE API Key** (you can get one for free at the [HERE Developer Portal](https://developer.here.com/)).  
5. Save your settings and test your WooCommerce checkout — the address fields will now show autocomplete suggestions.

== Supported Integrations ==

- **WooCommerce** - Integrates seamlessly with checkout, account address, and user profile pages.
- **Custom Field** - Any text field with a CSS class (perfect for ACF, themes, or custom code)
- **Fluent Forms**
- **SureForms**
- **Contact Form 7**
- **WPForms**

All integrations are **optional and configurable**. Enable only what you need!

== Coming Soon ==  

- **Formidable forms**
- **Forminator**
- **Ninja Forms**

== Frequently Asked Questions ==

= Does this plugin use Google Maps? =  
No. It uses the **HERE API** instead — no dependency on Google Maps.

= Is the HERE API free? =  
Yes. HERE offers a free plan with a generous monthly quota, perfect for most WooCommerce stores.

= Does it work with all WooCommerce themes? =  
Yes. The plugin integrates seamlessly with standard WooCommerce checkout fields and is compatible with most themes.

= Can I limit autocomplete suggestions to specific countries in WooCommerce? =  
Yes. The plugin automatically restricts address suggestions based on your WooCommerce shipping country settings.

= Does this plugin work with form plugins? =  
Yes. It natively supports WPForms, Contact Forms 7, SureForms and Fluent Forms.  
Each integration is optimized to work smoothly with default address fields.

= Does this plugin collect user data? =  
No. The plugin does **not** collect, store, or transmit any personal data. Only the lookup request is sent directly to the HERE API for address suggestions. 

== Screenshots ==  

1. Smart Autocomplete settings HERE api key
2. WooCommerce settings  
3. Autocomplete suggestions on the checkout address field.  
4. Address fields automatically filled after selection. 
5. Address autocomplete working inside a WPForms form.

== Changelog == 

= 1.0.7 =
* Improved: Reworked the WooCommerce checkout refresh logic for a smoother autocomplete experience. The plugin now temporarily clears postcode, city, and state/province fields while the user is typing to prevent unnecessary checkout refreshes during address searches.
* Improved: Address fields are now restored automatically if the user leaves the autocomplete field without selecting a suggestion.
* Removed: Legacy save/restore logic tied to WooCommerce’s `updated_checkout` event.

= 1.0.6 =
* Fixed: API key validation now works correctly.

= 1.0.5 =
* Improved: Enhanced frontend field detection for better compatibility with form builders and wrapped input fields.
* Improved: Better support for Gutenberg blocks, shortcode-based forms, and dynamically rendered forms.
* Improved: More flexible CSS selector handling for autocomplete field targeting.
* Improved: Refined script loading conditions to avoid unnecessary frontend asset loading.
* Fixed: Improved compatibility with form builders that apply custom CSS classes to wrapper elements instead of direct input fields.
* Fixed: Improved autocomplete initialization reliability across multiple third-party form plugins.
* Fixed: Various frontend autocomplete stability and usability issues.

= 1.0.4 =
* Fixed: Corrected HERE API key validation in the admin settings.
* Improved: Simplified the API key testing process for better reliability and accuracy.
* Removed: Server-side AJAX validation method for HERE API keys, which was incompatible with referrer-based authentication.

= 1.0.3 =
* Added: Full compatibility with dynamic WooCommerce themes.
* Improved: Refactored input handling using delegated listeners for AJAX-safe operation.
* Improved: Enhanced debounce handling to reduce duplicate API calls and improve performance.
* Improved: Enhanced autofill reliability for country and state selectors.
* Improved: Better HERE API error handling and user feedback.

= 1.0.2 =
* Added: "Check Key" button to validate the HERE API key directly from the settings page.
* Improved: Admin settings page layout and tab styling for better visual consistency.

= 1.0.1 =
* Fixed: Dropdown suggestions appearing under the next field on mobile devices when using WPForms integration.
* Improved: Removed duplicated CSS rules related to `.aisp_autocomplete-suggestions`.

= 1.0.0 =
* Initial release.
* Added: WooCommerce checkout, account/edit address, and user page address autocomplete support.
* Added: Auto-fill support for city, postcode, country, and state fields.
* Added: GDPR-friendly address autocomplete with no Google dependency.
* Added: Free-tier HERE API support.
* Added: Integrations for Fluent Forms, SureForms, Contact Form 7, WPForms, and Custom Fields.
* Improved: Modular plugin architecture for better maintainability.
* Improved: Enhanced ISO 3166-1 country code mapping for international support.
* Improved: Better error handling and user feedback.
* Improved: Updated JavaScript and CSS consistency.


== Upgrade Notice ==  

= 1.0.6 =
Fixed check key. API key validation now works correctly.

= 1.0.5 =
Improved compatibility and autocomplete reliability.

= 1.0.4 =

This update improves the HERE API key validation tool in the admin interface.
No action required — existing API keys continue to work without any changes.

= 1.0.3 =
Improves compatibility with dynamic checkout themes and enhances the stability of the autocomplete engine across AJAX updates.

= 1.0.2 =
New “Check Key” button and Improved: Admin settings page layout

= 1.0.1 =
Fixes display issues with the address suggestions dropdown in WPForms on mobile devices.

== Additional Info ==

This plugin uses the **HERE Geocoding & Search API**. You must obtain a free API key from the [HERE Developer Portal](https://developer.here.com/).

We are not affiliated with HERE Technologies, WooCommerce, or Automattic Inc. "WooCommerce" is a registered trademark of Automattic Inc.
