Skip to content

Set up your directory (GeoDirectory) for Reign

Reign GeoDirectory Addon overviewPremiumGet Reign GeoDirectory Addon →

Also called: set up GeoDirectory, directory setup wizard, add first listing, map setup, Google Maps key, listing pages, places address, dummy data.

The add-on adds no listings of its own. It shows the listings that GeoDirectory already holds. If GeoDirectory has no listing type or no published places, the Places tab is hidden or empty. The add-on then looks broken.

This page covers the GeoDirectory side only. Steps and menu names were checked against GeoDirectory 2.8.203. GeoDirectory’s own help is at wpgeodirectory.com/docs-v2.

You need all of these.

  • Reign 8.1.0 or newer, active. On older Reign, or any other theme, the add-on pauses and keeps its settings.
  • GeoDirectory, active, with at least one listing type. The add-on does not check the GeoDirectory version.
  • One community plugin: BuddyPress, BuddyBoss Platform or PeepSo. Without one, the add-on has nothing to attach to.
  • PHP 8.1 to 8.5 and WordPress 6.5 or newer.

The paid GeoDirectory add-ons are not needed.

The community features use these parts of your community plugin.

Feature BuddyPress and BuddyBoss PeepSo
Places tab Members (profiles) Profile menu
Feed posts Activity Streams Activity stream
Notices Notifications Notifications

On BuddyPress and BuddyBoss the Activity and Notifications cards in Reign Settings appear only when those components are on. Turn them on in the Components settings of BuddyPress or BuddyBoss. On PeepSo they are always available.

  1. Install and activate the Reign theme 8.1.0 or newer.
  2. Install and activate GeoDirectory.
  3. Install and activate BuddyPress, BuddyBoss Platform or PeepSo.
  4. Install and activate Reign GeoDirectory Addon.
  5. Enter your licence key under Reign Settings > License.

On a new install GeoDirectory shows a notice with a Run the Setup Wizard button. If you skipped it, open wp-admin/admin.php?page=gd-setup. The wizard has five steps: Map’s, Default Location, Extra Features, Content and Ready. Most steps have a Skip this step link. Do not skip the first two.

Map’s step

  1. Choose Open Street Maps or Google Maps.
  2. For Google Maps, enter your key in the Google Maps API KEY field.
  3. Click Continue.

We suggest Open Street Maps to start. It is free and needs no key. The add-on works the same with either map. You can switch to Google Maps later.

Default Location step

  1. Drag the map or the marker to the middle of your main town or city.
  2. Check the City, Region, Country, City Latitude, City Longitude and Timezone fields.
  3. Click Continue.

Pick the city where most of your listings will be. GeoDirectory uses it for new listings and for dummy data. Set it before you add real listings. The wizard warns that changing it later “can break current listings”.

If the map shows an error, your Google key is wrong or missing. Press the browser back button and fix it, or switch to Open Street Maps.

Extra Features step

This step lists optional GeoDirectory add-ons. You do not need any of them. Click Continue or Skip this step.

Content step

  1. To fill a test site, find Dummy Data. Pick a data type, then click Insert posts. Default makes 30 places.
  2. Sidebars and Menus set up widgets and menu items. They are not shown on a block theme.

On a live site, skip dummy data and add your own listings.

  1. Make sure you have at least one member account that is not the administrator.
  2. Publish one place for that member. Use the Add Listing page, or the dummy data.
  3. As another member, favourite the place with the heart on the listing.
  4. As another member, leave a review on the place.

Reviews are on by default. They are off if Disable comments is ticked for the listing type. The stars are off if Disable ratings is ticked. Both are under Places > Settings.

Listings made by dummy data, CSV import, Bulk Edit or WP-CLI do not create a feed post or a notice. Publish one place by hand to see a feed post.

  1. The member’s profile has a Places tab. It lists the published places, six per page.
  2. If the site has more than one listing type, the tab has a sub-menu.
  3. The activity stream shows a post for the new place, the favourite and the review. Their switches must be on in Reign Settings > Integrations, then Configure on the GeoDirectory tile.
  4. The listing owner sees a favourite notice and a review notice under Notifications.
  5. On PeepSo, the profile menu has a Places item.

Check the page at phone width too. The List layout is easier to read on a narrow screen.

It creates its pages when it is first activated. You find them under GeoDirectory > Settings > General > Pages.

Setting Created page
Location page Location
Add listing page Add Listing
Search Page Search page
Terms and Conditions page Terms and Conditions
Details Page GD Details
Archive page GD Archive
Archive item page GD Archive Item
  1. Open GeoDirectory > Settings > General > Pages.
  2. Open the dropdown of the missing page and pick an existing page. If you have none, create a page first under Pages > Add New.
  3. Save the settings.

The places archive is at /places/ on a stock site. The Places tab on a profile uses the same word.

  1. Open Places > Settings in the admin menu.
  2. Change the Slug field. It takes lower-case letters, numbers, hyphens and underscores, up to 20 characters.
  3. Save the settings.
  4. Open Settings > Permalinks in WordPress and click Save Changes once. The new address then works.

The tab address on profiles follows the new slug. Sites that kept an older tab address should read Updating from 2.4.0.

Open GeoDirectory > Settings > General. The Maps API field offers Automatic (recommended), Google Maps API, OpenStreetMap API and Disable Maps. Automatic uses Google when a key is set. Otherwise it uses Open Street Maps.

The Maps API field is marked advanced. It may stay hidden until you use the advanced-settings switch on that screen.

Problem Fix
The add-on says it is paused Update Reign to 8.1.0 or activate a Reign child theme.
No Places tab GeoDirectory has no listing type, or the Places tab switch is off. See Troubleshooting.
The Places tab is empty Only published listings show. Publish a place, or approve the held one.
No Activity or Notifications card in Reign Settings Turn those BuddyPress or BuddyBoss components on.
No feed post for a new place The place is not published, has a password, or came from an import.
Places address gives a 404 Save Settings > Permalinks once.
Map is grey or shows an error Check the Maps API setting and the Google key, or use Open Street Maps.

More fixes are in Troubleshooting and Messages.