Setup Configuration
1. Setting up your Google Maps API Key
To use features like fetching Google Reviews and the "Fetch Geo Coordinates" button, you need a Google Maps API Key from the Google Cloud Platform. This key allows the plugin to securely access Google’s services on your behalf.
Important: Google requires you to have a Billing Account enabled on your Google Cloud Project to use these APIs. However, the Places API and Geocoding API offer a generous free tier, so most small businesses will not incur charges for typical usage.
- Go to the Google Cloud Platform Console and sign in with your Google account.
- Create a New Project or select an existing one.
(Usually at the top of the page, there’s a project selector dropdown).
- Ensure Billing is enabled for your project. If not, Google will prompt you to set it up.
- Navigate to "APIs & Services" > "Library" from the main navigation menu (often a hamburger menu ☰ on the left).
- Search for and enable the following two APIs for your project:
- Places API (for fetching reviews, place details)
- Geocoding API (for the "Fetch Geo Coordinates" button)
- Go to "APIs & Services" > "Credentials".
- Click on "+ CREATE CREDENTIALS" and select "API key".
- An API key will be generated. Copy this key immediately.
- Highly Recommended: Restrict your API key!
Unrestricted API keys are a security risk. Click on the newly created key (or the "Edit API key" pencil icon next to it) to configure restrictions:
- Under "Application restrictions": Select "HTTP referrers (web sites)". Add your website URL(s) (e.g.,
yourwebsite.com/*
). - Under "API restrictions": Select "Restrict key". In the dropdown, choose the "Places API" and "Geocoding API".
Save your restrictions.
- Under "Application restrictions": Select "HTTP referrers (web sites)". Add your website URL(s) (e.g.,
- In your WordPress admin, navigate to:
Business Schema > Settings
. - Paste your copied Google Maps API Key into the
Google Maps API Key
field. - Click "Save Changes".
2. Finding and Using Google Place IDs
Each business location listed on Google Maps has a unique Place ID. You’ll need to add this ID to each "Location" post in WordPress to allow the plugin to fetch specific reviews for that location.
- Go to Google’s official Place ID Finder tool (This page includes an interactive map).
- In the search box on the map, enter the name and address of your business location.
- When the correct location appears on the map, click its marker.
- A small pop-up window will appear showing details, including the Place ID. It’s a long string of characters (often starting with "ChIJ…").
- Copy this Place ID string.
- In your WordPress admin, go to
Locations
and either edit an existing location or add a new one. - Paste the copied Place ID into the
Google Place ID
field in the "Location Details" meta box. - Save/Update the Location post.
Repeat this process for each distinct business location you want to manage and fetch reviews for.