=== 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.8 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.8 = * Updated: Tested up to WordPress 7.0 = 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.