Troubleshooting

Before troubleshooting clear cache of your browser and cache on your site, if any caching system is used.

Most of issues with the maps plugin are caused by wrong configuration in the settings, so the best solution is to look through plugin settings and set up them correctly. Another issues can be easily fixed by following below instructions.

The plugin follows WordPress coding standards and compatible with all themes and plugins, those follow the same standards. But in some cases problems might be caused by a conflict with your theme or another plugin. The very first step to find the reason of this conflict is to test your site with another theme and/or disable all plugins one by one. If you are not able to change your WP theme or disable conflicting plugin, then you can try to find a setting related to current problem, that can fix it.

Problems with the radius search, maps, address fields autocomplete

The most frequent reason is the MapBox Access Token. Check geolocation responce at the debug page of your site

To test server API key you can visit debug page and check geolocation response. Debug page is placed on your site by similar URL http://www.yoursite.com/wp-admin/admin.php?page=w2mb_debug

Problems with emails sending

Exemplary symptoms: users do not receive login details after first submission. Users do not receive notification emails. Admin does not receive notification emails. Emails go to spam folder.

First of all check if needed notifications templates are filled in and not empty on emails notifications settings tab.

If notifications templates are filled in, but you still have problems with emails sending, this means, that your mail server on your site has wrong configuration. Try to install and configure SMTP plugin like this one WP Mail SMTP plugin.

Listings never expire

Exemplary symptoms: you've set up listing level with limited active period. Expiration date has passed, but listings still active. This means scheduled events function does not work on your WordPress for some reason.

First of all try to deactivate and then reactivate the plugin (you'll not lose any information). If this will not help - download and install WP Crontrol plugin, it should show "scheduled_events" in the list of Cron Events.

Can not update the plugin

Exemplary symptoms: WordPress updater says something like "Update Failed: Update package not available".

Check your Envato Personal Access Token and its permissions. Otherwise you can update manually as explained here.

Translation problems

Question: I have made everything as you explained in translation instructions, but it does want to take my translation file.

Answer: Double check everything you've made step by step. Special attention to the name of translation files and paths where you place them.
There is no problem at the plugin's side. The plugin uses translation files in exactly the same way any other WordPress plugin does.

Question: I have translated all strings from the W2MB.po file, but it still shows some untranslated texts at the frontend, like address, phone, website, country, e.t.c.

Answer: These are names of content fields. It is user-generated content, you should translate these strings at the admin dashboard at the directory management pages (Maps Admin -> Content fields, Maps Admin -> Locations levels)

How to register?

Question: There is only login form. I do not see how users can register at the site to submit or claim a listing. Where is registration form?

Answer: This is because you disabled registration in WordPress settings of your site. Check "Anyone can register" option on the WordPress Settings -> General page. Registration link will appear below the login form.

Errors in javascript console of the browser

Javascript errors could break different parts of functionality of the plugin: images gallery, radius slider, content fields, search forms and so on. To see errors open browser console by pressing F12 and refresh the page.
Usually javascript errors could be caused by 3rd party plugins or installed theme. Sometimes another plugin or your theme tries to "format" the output of maps plugin, this also can give odd behaviour due to unnecessary tags in page markup, like paragraphs, divs or spans tags. The only way to fix this - to look through plugins/theme settings and find an option to disable "formatting".