=== Smart Autocomplete Address === Contributors: aisimpleplugin Tags: woocommerce, address, autocomplete, checkout, here maps Requires at least: 6.0 Tested up to: 7.0 WC tested up to: 10.7 Requires PHP: 7.2 Stable tag: 1.0.9 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.9 = * Fix: WooCommerce — autocomplete is now disabled after a suggestion is selected (manual mode). * Fix: Editing the address after selection (e.g. adding an apartment number) no longer clears the postcode, city and state fields. * Fix: Completely clearing the address field re-enables autocomplete normally. * Improve: Selection flag is now tracked separately for billing and shipping addresses. = 1.0.8 = * Update: Tested up to WordPress 7.0 = 1.0.7 = * Improve: 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. * Improve: Address fields are now restored automatically if the user leaves the autocomplete field without selecting a suggestion. * Remove: Legacy save/restore logic tied to WooCommerce’s `updated_checkout` event. = 1.0.6 = * Fix: API key validation now works correctly. = 1.0.5 = * Improve: Enhanced frontend field detection for better compatibility with form builders and wrapped input fields. * Improve: Better support for Gutenberg blocks, shortcode-based forms, and dynamically rendered forms. * Improve: More flexible CSS selector handling for autocomplete field targeting. * Improve: Refined script loading conditions to avoid unnecessary frontend asset loading. * Fix: Improved compatibility with form builders that apply custom CSS classes to wrapper elements instead of direct input fields. * Fix: Improved autocomplete initialization reliability across multiple third-party form plugins. * Fix: Various frontend autocomplete stability and usability issues. = 1.0.4 = * Fix: Corrected HERE API key validation in the admin settings. * Improve: Simplified the API key testing process for better reliability and accuracy. * Remove: Server-side AJAX validation method for HERE API keys, which was incompatible with referrer-based authentication. = 1.0.3 = * Add: Full compatibility with dynamic WooCommerce themes. * Improve: Refactored input handling using delegated listeners for AJAX-safe operation. * Improve: Enhanced debounce handling to reduce duplicate API calls and improve performance. * Improve: Enhanced autofill reliability for country and state selectors. * Improve: Better HERE API error handling and user feedback. = 1.0.2 = * Add: "Check Key" button to validate the HERE API key directly from the settings page. * Improve: Admin settings page layout and tab styling for better visual consistency. = 1.0.1 = * Fix: Dropdown suggestions appearing under the next field on mobile devices when using WPForms integration. * Improve: Removed duplicated CSS rules related to `.aisp_autocomplete-suggestions`. = 1.0.0 = * Initial release. * Add: WooCommerce checkout, account/edit address, and user page address autocomplete support. * Add: Auto-fill support for city, postcode, country, and state fields. * Add: GDPR-friendly address autocomplete with no Google dependency. * Add: Free-tier HERE API support. * Add: Integrations for Fluent Forms, SureForms, Contact Form 7, WPForms, and Custom Fields. * Improve: Modular plugin architecture for better maintainability. * Improve: Enhanced ISO 3166-1 country code mapping for international support. * Improve: Better error handling and user feedback. * Improve: 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.