Documentation
Map Directory documentation
How to set up and use Map Directory: install, settings, shortcodes and fixes for common problems.
Overview
Map Directory is a searchable directory of providers, members or businesses, shown on a Google map with category filters.
Where to find it: Directory, in the main WordPress menu.
What you need
- WordPress 6.2 or newer
- PHP 7.4 or newer
- Google keys for the map: a browser key (Maps JavaScript API) and a server key (Geocoding API). The directory works as a searchable grid without them.
Install
- With The Vault (easiest): open The Vault in your WordPress menu, find Map Directory and click Install. It is installed and activated for you.
- By hand: buy a license on the plugin page, then go to Plugins → Add New → Upload Plugin, choose the zip and activate it.
Updates arrive automatically from wpwizards.com, like plugins from WordPress.org.
License
This is a premium plugin. Open The Vault → Licenses, paste the key from your order confirmation and click Activate License. WP Wizards clients have every plugin included while their service is active, with no key needed. Without a license the plugin keeps working but stops receiving updates.
Quick start
- Add your Google keys. Under Directory → Settings, add the browser key and server key, then pick a layout and colors.
- Add categories and listings. Add categories under Directory → Categories and listings under Directory → Add Listing. Pins are placed from each listing’s address.
- Place the directory. Add
[map_directory]to a page.
Settings
Layout & filters
| Layout | Map on top with a grid of listings below, or a list in a sidebar next to the map. |
|---|---|
| Grid columns / Map height | Size of the grid and the map. |
| Category filter | Buttons (people can pick several) or a dropdown. |
| Search box | Show it, and set its placeholder. |
| Virtual filter | A checkbox to show only listings that work virtually. |
| No results text | Shown when nothing matches. |
Cards & listing pages
| Show on cards | Logo or photo, categories, location, short description, phone, email and website link. |
|---|---|
| Button | Its label, and whether it opens in a new tab. |
| Listing pages | Give each listing its own page. When off, the button goes to the listing’s website or button link. |
Names
| One listing / Many listings / One category / Many categories | What the directory calls things in the admin menu and on the page, e.g. Provider, Business, Member. |
|---|
Google Maps
| Browser key | Shows the map. Maps JavaScript API, restricted to this site’s domain. |
|---|---|
| Server key | Turns addresses into pins. Geocoding API. |
| Map ID | Optional. Lets you style the map in Google Cloud. |
| Default center and zoom | Used before any listings have pins. Zoom 4 shows the whole US. |
| Region | A two-letter country code that helps geocoding. |
| Place missing pins | Use this after adding a server key to place every listing that still has no pin. |
Design
| Colors | Primary, accent, text, card background, borders and map pins. |
|---|---|
| Corner radius and Custom CSS | Fine-tune the look. |
Shortcodes
[map_directory]
The directory. Every attribute is optional and overrides the settings for that one spot.
| Attribute | Values | What it does |
|---|---|---|
layout |
grid or sidebar | Which layout to use. |
columns |
1 to 4 | Grid columns. |
map |
yes or no | Show the map. |
list |
yes or no | Show the listings. |
height |
number | Map height in pixels. |
filters |
chips, dropdown or none | The category filter style. |
search |
yes or no | Show the search box. |
category |
slugs | Only show these categories, comma separated. |
select |
slug | Start with this category selected. |
Place a shortcode in a Divi Text or Code module, a Shortcode block, or a widget.
Troubleshooting and questions
Listings show but there is no map.
Add the browser key, and check that Maps JavaScript API is enabled and the key allows your domain.
A listing has no pin.
Add the server key, then click Place missing pins. A city or area such as “Atlanta, GA” works as an address.
Can I hide a street address?
Yes. Listings can keep their street address private and still show a pin for the area.
Can a link open a category?
Yes. Add ?category=slug to the page address.
For developers
wpwmd_listing_data |
Filter what a listing card shows. |
|---|---|
WPWMD_Listings::upsert() |
Lets other plugins create and update listings. |
Get help
Stuck on something this page does not cover? Contact us and tell us which plugin and version you are on. Need it to do something it does not do yet? We build custom plugins too.
