Deutsche Version

Back to overview

Troubleshooting and FAQ

This documentation always describes the latest published version.

No suggestions while typing

On internal errors the plugin deliberately prints nothing, so that it never disturbs the storefront. Check the following in order:

1. Is Enable Autocomplete switched on in the affected sales channel?
2. Is an API key set that is at least 10 characters long and contains only the allowed characters (see Configuration)? The check happens per sales channel.
3. Is the page one of the pages the plugin works on? Nothing is loaded on the checkout registration page.
4. Does the page source contain a script tag from cdn.smartmaps.cloud with the attribute data-smartmaps-apikey? If not, the configuration is not valid or a cached page is stale. Then clear the cache with bin/console cache:clear.
5. Is cdn.smartmaps.cloud loaded in the browser? Ad blockers, firewalls or a Content Security Policy can block it.
6. Does the browser console report errors prefixed with [SmartMaps]? Examples are Failed to initialize and Error.

Messages about domain protection

If the console shows errors about Access-Control-Allow-Origin or SmartMaps rejects requests, the shop domain is probably not allowed for the key. Add it to the key's domain restrictions in the SmartMaps portal.

Country is not applied

The plugin finds the country option through the data-iso attribute or through an option text equal to the ISO code. If your theme uses neither, the selection stays unchanged. Countries not assigned to the sales channel are not in the select and cannot be set.

State is not set

• Is the state field visible in the form, and are states defined for the country (Settings > Shop > Countries)?
• The state name from SmartMaps must exactly equal the option text (case-insensitive). If the spelling differs, the selection stays unchanged.

Country filter has no effect

The country filter only accepts two-letter country codes. Entries like DEU are ignored, and without a valid entry no filter applies. Check the spelling, for example DE, AT, CH.

FAQ

Can I use a separate API key per sales channel?

Yes, all settings can be overridden per sales channel.

Does the plugin write addresses to a database?

No, it creates no tables of its own and stores nothing.

Is using SmartMaps free of charge?

SmartMaps sets the terms, please check them there.

Is there a connection to YellowMap AG?

The plugin is developed and distributed by Markus Michalski. There is no business affiliation with YellowMap AG as the operator of SmartMaps, and YellowMap AG provides no support for the plugin.