Troubleshooting Guide

Some common issues users need help with are “page not found”, maps not working, or diagnosing plugin conflicts etc.

General checks Detail page goes to “page not found” Maps Redirect to homepage when submitting listing Conflict Test More information

General checks

  1. Check that you have the latest versions of all plugins.
    1. Your problem may already have been fixed in the latest versions.
    2. Only all the most current versions of all plugins and themes are guaranteed to work together and supported.
    3. Navigate to your plugin list in the backend of your website, and compare the versions in your account and downloads page.
    4. You may have to add your licenses first to enable updates.
  2. Check your WP permalinks.
    1. Go to WP Settings > Permalinks and make sure they are set to Post name.
    2. Often re-saving this settings will fix “page not found” errors, by forcing WordPress to update any changes you made in the URL structure at GD > Permalinks or in the Location Manager settings.
  3. Check the correct links to your GD pages.
    1. It is important to understand the GD pages structure, ie the location, listings, detail pages etc.
    2. Adding these shortcodes to any WP page will give you a good overview of what GD pages have been created and their correct URL:
      [gd_advanced_search]
      [gd_login_box]
      [gd_cpt_categories]
      [gd_location_switcher]
    3. Note that the last shortcode will only work if you have the Location Manager installed.

Detail page goes to “page not found”

  1. Make sure the listing is in at least one category.
  2. Review the WP Permalink comments above.

Maps

  1. Check Google Map API.
    1. Make sure that you added a key at GD > Design > Map.
    2. Make sure the key is valid for your domain.
  2. Do NOT hide the maps.
    1. Check that there are no boxes ticked at GD > Design > Map > SHOW / HIDE POST TYPE AND CATEGORY ON MAP

Redirect to homepage when submitting listing

  1. An error regularly reported is that when a listing is submitted from the frontend, instead of going to the checkout page, the site redirects to the homepage instead.
  2. This is because either the session directory on your server is not writable or it does not exists, and you will have to talk to your host to get it fixed.
  3. You can add this as a temporary fix to your wp-config.php file:
    if ( !defined( 'GEODIR_USE_PHP_SESSIONS' ) ) {
       define( 'GEODIR_USE_PHP_SESSIONS', false );
    }
    if ( !defined( 'WPINV_USE_PHP_SESSIONS' ) ) {
       define( 'WPINV_USE_PHP_SESSIONS', false );
    }
    

Conflict Test

You can review a list of known issue here, but if your issue isn’t listed, then proceed with the conflict test here.

The test:

  1. Identify the ‘problem page’ where the issue can be seen, and leave this open in a browser tab.
  2. In another browser tab, open up the plugins page – WordPress – Plugins.
  3. Deactivate all non-GD plugins.
  4. In ‘problem page’ tab, refresh and verify if the issue is still present.

If you have a lot of plugins running on your site, here is a priority ordering:

  1. Cache related plugins. (Good idea to leave cache related plugins disabled while doing any work on the site.)
  2. Page builder plugins (Divi).
  3. Plugins with ‘heavy’ javascript or those that alter the page output.
  4. Plugins that are listed in errors in the chrome inspector.
  5. Plugins that are listed in errors in the chrome inspector.

Last but not least, try switching themes. Switch to a theme like twentyseventeen (default) to see if the issue is still present.

Advanced: It is also possible to disable all plugins via FTP. This can be ‘faster’ but requires care and precision. See this tut for more info.

More information

  1. Do and Don’t list of common errors.
  2. List of conflicts caused by some other plugins, themes etc.
  3. Troubleshooting FAQs.