WP Location Finder

WP Location Finder: Get a Google Maps API key

1. Settings

1.1 Get Google Maps API key and API Services

Each time you use the Google Maps APIs, if you domain has been created after June 22 2016, you must include a key, to validate your request.
Get a key and enable API: https://developers.google.com/maps/documentation/javascript/get-api-key

More information: https://developers.google.com/maps/documentation/javascript/usage?hl=en

First, you should navigate to Google Cloud console, select a project, or create a new one. Then click on "+ Create credentials" button, select "API key"option.

Then follow the next step and click Create button to get a new API key. Save it for the next step.

Additionally, certain required API services need to be enabled. In the Google Console, go to APIs & Services and find them as shown below:

Maps JavaScript API
Geocoding API
Geolocation API
Places API
Directions API

1.2 How to create Map ID?

In order to create a map ID, please navigate to Maps management page. Click on Create map ID button.

Then on the Create new map ID page, do the following:

Name: input the map ID name.
Description: describe what the map ID is used for (Optional)
Map type: select JavaScript, and also choose a Raster (the default) or Vector map type.

Remember to click Save button to show your new map ID. Please keep it for the setting.

Note: A map ID is a unique identifier that represents Google Map styling and configuration settings that are stored in Google Cloud. Use the map ID "DEMO_MAP_ID" for testing purposes if you don't have a map ID .

1.3 Setting section

Finally, navigate to Menu Location Finder > Settings, and fill the Google Map API key and Map ID created in the previous steps in the corresponding fields:

Google Maps API Key:The Google Maps API key is mandatory. Please roll back to Step 1.1 if you do not know how to create a new API key
Map ID: A map ID is a unique identifier that represents Google Map styling and configuration settings that are stored in Google Cloud.
This is mandatory to have one, you can keep the default one (DEMO_MAP_ID) if you don't need it.
Map default zoom: Default zoom level on the map on first load (set auto zoom to 0)
Display category filter
Display country filter
Display radius filter
Distance for radius search: Distance in the radius search tool
Display tag filter
Open location detail in new tab

Map display

The locations you’ve created will be displayed on the map in the Settings section.

Single location

Add store fields: Add some specific fields to each location like store names and store opening hours

Color and marker

You can adjust the color and default marker image here.

2. Shortcode Generator

In order to generate a map shortcode, navigate to Menu Location Finder > Shortcode generator. You can set some options below:

Type of view: Location search and Map view.
Load a default address: use a toggle to enable and input the address.
Location categories
Location tags

You'll see the shortcode generated in the bottom left corner, and you can easily insert it anywhere on your page!

3. Location Categories

To manage location categories please navigate to Menu Location Finder > Location Categories. From this section, you can effortlessly manage your location categories - add, edit, or remove them as needed!

4. Location Tags

To manage location tags please navigate to Menu Location Finder > Location Tags. From this section, you can effortlessly manage your location tags - add, edit, or remove them as needed!

WP Location Finder: Installation

1. Install

In order to install our plugin, you should use standard WordPress installer or unzip and put all the folder in /wp-content/plugin.

Then click on activate plugin, to see WP Location Finder menu appear on the WordPress left menu.

WP Location Finder is accessible from a dedicated left menu.

From now on, please make sure to log in to your JoomUnited account before using the plugin.

2. Update the plugin

In order to update the WP Location Finder, you can use the WordPress default updater. You can also remove and install the new version from a .zip file downloaded on www.joomunited.com. In any case, you won’t lose any content because everything is stored in the database.

Be sure to always have the latest version to avoid security and stability problems.

To update the paid version, you need to login to your JoomUnited account. If you have not logged in yet, simply click on the 'Connect your Joomunited account to update' or 'JoomUnited Login' link text.

Enter your JoomUnited account login and password. After a successful login, the 'update now' link text will appear where you can click to update a new version.

Then finally, you can update all the JoomUnited commercial plugins from the WordPress standard updated.

WP Location Finder: Search and Locations setup

Create a location
- Store fields
- Preview location

Create a location

To create a new location, navigate to Location Finder > All Locations. Click on "Add new location" button.

After that, the Add New Location page will appear, with the 2 main panel, left is the details field and the right is the map. Below are fields you can input or select value.

Location name: input address name.
URL: will be generated after publish.
Location description:
Location search: Please type an address in the search field in order to get a value for latitude and longitude.

Alternatively, use the manual input address section below the map - click the arrow to expand all fields.

Sroll down to get more detailed options for the location.

Feature image: choose represent image for the location.
Image gallery: upload images for the location.
Marker image: select in Icon set or upload your own icon.

Location contact URL
Location override URL
Tags: input location tag.
Location SEO title
Location SEO meta description

Then, you can select a/multi category for the location.

Next, in the Publish section, you can set these fields:

Status: choose one in 3 status: Draft, Pending review, Published
Visibility: Public, Password protected, Private
Publication time: Immediately, Scheduled publication
Shortcode: use it to publish anywhere on your site.

Store fields

To use this feature for displaying opening hours for customers, you'll first need to enable the option in the settings. Once that's done, you'll be able to see the Store fields section when creating a new location.

Preview location

To see a preview of your location on the front end, simply go to the Publish section and click the "Preview" button.