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.
What this does
Section titled “What this does”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.
Before you start
Section titled “Before you start”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.
Install in this order
Section titled “Install in this order”- Install and activate the Reign theme 8.1.0 or newer.
- Install and activate GeoDirectory.
- Install and activate BuddyPress, BuddyBoss Platform or PeepSo.
- Install and activate Reign GeoDirectory Addon.
- Enter your licence key under Reign Settings > License.
Run the GeoDirectory setup wizard
Section titled “Run the GeoDirectory setup wizard”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
- Choose Open Street Maps or Google Maps.
- For Google Maps, enter your key in the Google Maps API KEY field.
- 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
- Drag the map or the marker to the middle of your main town or city.
- Check the City, Region, Country, City Latitude, City Longitude and Timezone fields.
- 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
- To fill a test site, find Dummy Data. Pick a data type, then click Insert posts. Default makes 30 places.
- 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.
Add a first listing
Section titled “Add a first listing”- Make sure you have at least one member account that is not the administrator.
- Publish one place for that member. Use the Add Listing page, or the dummy data.
- As another member, favourite the place with the heart on the listing.
- 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.
You’ll know it worked when
Section titled “You’ll know it worked when”- The member’s profile has a Places tab. It lists the published places, six per page.
- If the site has more than one listing type, the tab has a sub-menu.
- 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.
- The listing owner sees a favourite notice and a review notice under Notifications.
- 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.
Good to know
Section titled “Good to know”Which pages does GeoDirectory create?
Section titled “Which pages does GeoDirectory create?”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 |
A page is missing. How do I fix it?
Section titled “A page is missing. How do I fix it?”- Open GeoDirectory > Settings > General > Pages.
- Open the dropdown of the missing page and pick an existing page. If you have none, create a page first under Pages > Add New.
- Save the settings.
How do I change the /places/ address?
Section titled “How do I change the /places/ address?”The places archive is at /places/ on a stock site. The Places tab on a profile uses the same word.
- Open Places > Settings in the admin menu.
- Change the Slug field. It takes lower-case letters, numbers, hyphens and underscores, up to 20 characters.
- Save the settings.
- 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.
How do I change the map later?
Section titled “How do I change the map later?”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.
What are the common setup mistakes?
Section titled “What are the common setup mistakes?”| 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.

