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.

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