Basic installation

Some steps and screenshots in the video are for older versions of GD, please also review the rest of the article.

For these instructions, we will assume you already have WordPress installed and have the theme activated that you wish to use with GeoDirectory.

The short version:

  1. Download GD plugin
  2. Activate GD plugin
  3. Map settings
    1. Setting a Google Maps API KEY
    2. Set the default location
  4. Change WordPress settings
    1. Post settings
    2. Registration settings
    3. Media settings
    4. Comments/reviews settings
  5. Install dummy data (optional but recommended)
  6. Setting your home page

1. Download plugin:

Review these notes about server requirements and Managed WordPress Hosting first.

Automatic installation

Automatic installation is the easiest option. To do an automatic install of GeoDirectory, log in to your WordPress dashboard, navigate to the Plugins menu and click Add New.

In the search field type GeoDirectory and Enter. Once you’ve found our Directory plugin you install it by simply clicking Install Now.

Manual installation

The manual installation method involves downloading our Directory plugin and uploading it to your web server via your favourite FTP application. The WordPress codex will tell you more here.

You can download the plugin from WordPress.org here, and save it on your computer.

Then in your WordPress Dashboard, go to Plugins > Add New,  then select Upload and browse to the GeoDirectory zip file you downloaded from WordPress.org. Click Install Now.

2. Activate the plugin

This might take a few seconds while the plugin installs the required database tables.

3. Map settings:

  1. After activation you will see a message asking you if you want to set a Google Maps API KEY, and another message to set your default location.

3A. Setting a Google Maps API KEY

  1. Clicking on the click here link will take you to GD > Design > Map.
  2. Follow the instructions in the Add Google API KEY article.

3B. Set the default location

  1. Clicking on the click here link will take you to GD > Set Default Location.

You have two ways to set the default location:
See also GD Core Plugin – Default Location

#1 Enter a city, region and country for your default location and then click Set Address On Map, this will set the GPS info as required and move the map marker to the correct location.
Then click Save changes.

There is no need to enter the latitude or longitude.

#2 You can drag the map marker to the location you wish to use as a default location and we will try to fill in the location details, you should check the location details and make any corrections as required.
Then click Save changes to set the default location.

There is no need to enter the latitude or longitude.

4. Change WordPress settings:

For GeoDirectory to work correctly, you need to set WordPress permalinks to use Post name

From the main WordPress Dashboard menu, choose Settings > Permalinks > Tick Post name, and Save changes.

For GeoDirectory to work correctly, you also need to allow Anyone to register.

From the main WordPress Dashboard menu, choose Settings > General > Tick Anyone can register, and Save changes.

For GeoDirectory to work correctly, you also need to Organize my uploads into month- and year-based folders.

From the main WordPress Dashboard menu, choose Settings > Media > Tick Organise my uploads into month- and year-based folders, and Save changes.

If you want visitors to leave reviews, you need to

From the main WordPress Dashboard menu, choose Settings > Discussion > Default article settings > Tick Allow people to post comments on new articles, and Save changes.

5. Install dummy data (optional but recommended): 

This step will add a few categories and listings to your site, so you can get a feel of what is possible with your GeoDirectory site. You will be able to delete them later.

If you do not install the dummy data or you delete the dummy data, you will have to make sure that you create at least one category for your Custom Post Types like Places or Events, or you will not be able to add any listings.

Click on the General tab under the GeoDirectory logo and then select the dummy data tab.  You can select how many listings you would like to install, 10 is the default but you can install up to 30.  After clicking Insert Sample Data there will be a short wait while the dummy images are downloaded and the dummy address info created for your default location. You will see an ajax counter displaying the progress and it will let you know when the installation of the dummy data is finished.
dummy

6. Setting your home page:

Navigate to GD > Permalinks, and under GeoDirectory Pages, you’ll see GD Home Page.

Choose your directory start page here (this is not always the same as the homepage of your website):

  1. If you want to use one of your normal WordPress pages for the homepage of your website, then select the GD Location page here.
  2. Choose GD Home Page if you want your directory home page to be the home page of your website.
  3. Make sure you choose the same page at Settings > Reading > Front page displays > Front Page.