Troubleshooting

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

Most of issues with the directory plugin are caused by wrong configuration in directory settings, so the best solution is to look through directory 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 directories or listings pages

Exemplary symptoms: 404 errors on pages. Categories, locations or listings pages just refreshes.

This could be caused by missing [webdirectory] shortcode. It is required shortcode. Create a page with this shortcode in the description. This page must not have child pages, it must be public, not private, not in trash.

If you are using some kind of page builder, then make sure it processes shortcodes in the same way as it processes in the native WordPress page description. Some builders have own special modules/elements to place shortcodes. We recommend to use SiteOrigin page builder and WP Bakery Visual Composer.

Special attention to directory slugs. Slugs must contain only alpha-numeric characters, underscores or dashes. All slugs must be unique and different.

Problems with the radius search, maps, address fields autocomplete

The most frequent reason is Google API keys. Please follow instructions on how to generate them and enable needed APIs in Google console.

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=w2dc_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.

I want a separate page for listings. Remove all other texts and elements from listings pages.

Create new page with [webdirectory-listing-page] shortcode to build separate page for single listings. Especially when you are building custom home page, so there will not be any other directory elements like on the home page.

How to remove 'web-2-0-directory' slug from URL?

By default new page with [webdirectory] shortcode has a URL like http://www.yoursite.com/web-2-0-directory/. In order to remove 'web-2-0-directory' part from address - select this page as homepage in WordPress Settings -> Reading settings.

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 W2DC.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 (Directory Admin -> Content fields, Directory Admin -> Locations levels, Directory Admin -> Listings levels)

Problems with Facebook sharing

For sharing in Facebook any page must contain some special meta tags in its HTML source code. For correct sharing directory plugin inserts own meta tags on single listings pages. But another plugins (or themes in some cases) can add own meta tags as well. This may cause sharing issues.

Try to find this conflicting plugin and/or a setting to switch off adding meta tags for Facebook. This is the only solution.

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 directory 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".