GeoDirectory V2 Documentation

General

Paolo


General
Default Location
Pages
Titles & Meta
Search
Dummy Data
Developer
Uninstall

General

Select which role should not be allowed to access the wp-admin area of the directory and control the settings that are made available to their role in the WordPress dashboard. For more information about see the document about Account Management.

If this option is checked, whenever a user deletes one of his listings, the entry will be preserved in the trash. If this option is unchecked, listings are deleted permanently.

Allows to select the status for new listings submitted. Options are :

  1. Publish
  2. Pending Review

If you wish to moderate your free listings, select “Pending Review”.

[note: if the Pricing Manager is installed, this setting will not have effect on paid listings that are always immediately published.]

If you decide to use the Google Maps API key, you must enter an API key in this field. Fetching one using the “Generate API Key” button is the easiest method to get one. API Keys from your old projects may not work, because they could have some of the needed API disabled.

General Advance Settings

Following is the explanation of the options available under Advanced Settings

If enabled, visitors will be able to post listings from the front-end without logging in first. If you want users to be able to register when they add a listing, this is an important option to check.

When this setting is checked, an Email and Name field are added to the top of the add-listing form. The fields are required. When the form is filled in, a new user is created silently, in the background.

A password is sent to the user for future usage, like for example to come back and edit his/her listing. In that case they will need to log in.

If you want to make the add listing procedure faster by avoiding the listing preview step, you can disabled this option.

By default it is 2MB. You can increase it or decrease it here.
This setting applies to all individual files uploaded to any GeoDirectory file field including images and logo and other custom file fields you may add to the listing.

Let’s you select which Maps provider to use or to disable maps. By default it is set to Automatic. It will use Google Maps API by default and Open Street Map if Google Maps is returning an error.

The options available are:

  1. Automatic (recommended)
  2. Google Maps API
  3. OpenStreetMap API
  4. Disable Maps

Allows to set the default language of your Maps.

Allows to upload a custom map marker.

Allows faster loading of Map Markers.

Allow GeoDirectory to collect non-sensitive diagnostic data and usage information.

Default Location

You have two options for setting the default location. We recommend that you use the Setup Wizard.

In this section we cover how to set the default location when you do not have the location manager installed. If you do have the location manager installed, check here instead.

Set Default Location in the Setup Wizard

Read more here about using the Setup wizard.

Set Default Location in Settings

Find the default location subtab at

GeoDirectory – Settings – General (tab) – Default Location (subtab) – Show advanced

Drag the map marker to the new default location, and save.
You can also reveal the advanced options to manually enter more information.

If the subtab is not visible that means you have the Location Manager addon installed; check here for instructions for settings the default location with the Location Manager addon.

Warning: If you do not have the Location Manager installed, you will not be able to edit listings that are outside the default location. The core GeoDirectory plugin is for creating a single city directory only. To add or edit listings outside the default location you will need the Location Manager addon.

If you have listings outside the default location, you can export them and then delete them from the site.

Default Location Advance Settings

The default Location. After you fill in a city/town/village name here and click the “Set Address on Map” button, all other fields will be automatically filled with data fetched from the Maps API.

All you need to do is verify that the information are correct.

The region of the default location

The Country of the default location

The City Latitude coordinate. Must be in decimal numbers.
Correct: 39.9523894183957
Wrong: 39°59′53″N

The City Longitude coordinate. Must be in decimal numbers.
Correct: -75.163598245369
Wrong: 75°08′41″W

The timezone is only necessary if the Location Manager is installed, to make sure that the Business Hours of each location can properly show the opening or closing sign.

Pages

Page Settings

The following Page settings are essential to the functioning of GeoDirectory. The pages you set here are used by GD to create the various listing pages that will make up your site.

The following GeoDirectory pages are created automatically when GeoDirectory is installed. However, if the pages have been deleted, simply create a new WordPress page and then return here to select it.

In these settings you assign a page to each of the options available. The name of the page and the slug are not important for the purpose of GeoDirectory, only that each page setting is a unique page. You can use the WordPress Pages backend editor to to update existing pages with different titles or slugs to match better with your GeoDirectory site. After you save the settings here you can use the Edit or View buttons to update or visit the pages.

Note: The WordPress Static Front Page cannot be set to the same page as the GeoDirectory Search, Location, or template pages.

GeoDirectory V2 uses shortcodes or Gutenberg blocks to produce what is shown in the Details, Archive, and Archive Item displays. Visit Page Design to learn more about the shortcodes used on each of these pages.

Select the WordPress page to use for this setting. This must be set to an existing, unique page.

Select the WordPress page to use for this setting. This must be set to an existing, unique page.

Select the WordPress page to use for this setting. This must be set to an existing, unique page.

Template Page Settings

Template pages are used to design the respective pages and should never be linked to directly. As with the pages above, these settings are used to match WordPress Pages to GeoDirectory templates. You can change the title and slug to better fit your site. All pages must be unique and used for only one setting.

Select the WordPress page to use for this setting. This must be set to an existing, unique page.

Select the WordPress page to use for this setting. This must be set to an existing, unique page.

Select the WordPress page to use for this setting. This must be set to an existing, unique page.

Titles & Meta

Here you can set the titles and meta info for your GeoDirectory pages. Click the tags to copy to clipboard then past with ctrl(cmd)-v or use your context menu.

If you are using Yoast, you can choose between GD’s Titles & Meta settings or Yoast’s settings:

Most features on this page have three options. These will be described here in some detail and then the features will be listed out below.

The title of the page, often visible to front end users of the site. Often shown in the browser or browser tab by most major browsers. Visible in the code of the page to browsers bu may be hidden from the visual display of the page in the browser by theme settings or custom CSS.

The meta title is the “machine readable” and “SEO Friendly” title of the page, and may differ from the Title of the page. The meta title is often set to be 50-60 characters and generally contains more information than the Title. The meta title information is stored in the head data of the document. It can only appear once in an entire document and because of this it is a great place to store unique information about the page that elaborates on the title. The meta title is used by search engines to further categories the content of the page and is often used as a ‘snippet’ to describe a page. The meta title is more about the unique contents of a page. Use the meta title to optimize the information about the page for consumption by search engines as part of your SEO strategy.

The meta description, like the Meta Title, is only included once in the document, and should contain even more information about the unique content of the page. Meta Descriptions may vary greatly in length, but are often less than 300 characters.

Post type page

These settings apply to root pages of a GeoDirectory CPT eg: /places/

 

 

 

Archive pages

These settings apply to GeoDirectory category and tags pages.

 

 

 

 

 

 

Single post pages

These settings apply to single post pages, also referred to as the Details pages.

 

 

 

Location page

These settings apply to location pages eg. /location/netherlands/

 

 

 

Using Custom Fields in Titles and Meta Settings

You can use any listing custom field in the Title and Metas settings.

Simple insert the field in the form %%_my_custom_field%% such that it is prefixed with an underscore.

If you want to use all or part of the address, you will need to specify each part as ‘address’ is a compound value stored separately in parts.

Examples:

%%_street%% %%_street2%% %%_neighbourhood%% %%_city%% %%_region%% %%_zip%% %%_country%%
%%_email%%

Search page

These settings apply to the search page.

 

 

 

Add listing page

These settings apply to the add listing page.

 

 

 

Search

This section covers options for GeoDirectory core search.

See this document for information about the Advanced Search Addon.

Settings can be found at:

GeoDirectory – Settings – General – Search

Search bar settings – Basic

Show the search text box `placeholder` value on search form.

Show the near text box ‘placeholder’ value on search form.

Search bar settings – Advanced

Show the search button label on search form. You can use a font awesome class here.

Search results settings – Basic

Limits the search radius to X miles/km (lower numbers help with speed)

Show search distances in miles or km

If distance is less than 0.01 show distance in meters or feet

Search results settings – Advanced

This is useful if your directory is limited to one location such as: New York or Australia (this setting should be blank if using default country, regions etc with multilocation addon as it will automatically add them)

With this option you can limit individual words being searched for, for example searching for `Jo Brown` would return results with words like `Jones`, you can exclude these types of small character words if you wish.

Site settings

Display searched parameters with title? Enable to display searched parameters with title when searching for a custom field.

Dummy Data

Dummy data installer

Use the Dummy Data installer to create dummy (fake) listings to quickly populate your GeoDiretory site. With dummy content in place you can see how the widgets, pages, and shortcodes look.

Dummy content and real content can be mixed, too. Dummy content can easily be removed later with the click of a button y returning back to these settings.

Hint: Install the Advanced Search addon first will add extra search fields to non-default data types.

Settings (coming soon)

Developer

Show advanced settings at all times (not recommended).

Enable 404 rescue This will check 404 pages where a GD CPT is identified and try and redirect to the correct url. This should help tell search engines about term or post permalink changes.

This will allow beta addons to be installed.

Force recaptch fail Force recaptch fail This will force recaptch to throw an error response to be able to test failure conditions (Never use on a production site).

Uninstall

Check this box if you would like GeoDirectory to completely remove all of its data when the plugin is deleted.

Personalize

Use Custom Fields in Titles and Metas

Anywhere that you can use %%xxx%% variables you can use GD Custom Fields.

Use %%_fieldkey%% – that’s an underscore, followed by the key for the field.

You can find the key by opening the custom fields tab, opening the field, show the advanced options, and find the key field.