This feature requires StoreConnect version 10.8 or above. Here is how to check your version

Location Finder

This article is intended for advanced users and our partners as it requires advanced web development or Salesforce admin or programming knowledge. While the functionality is part of StoreConnect, we do not provide end user assistance to implement it beyond our help documentation. If you need help or are unsure on how to do this, you can hire one of our StoreConnect partners.

Location Finder is a StoreConnect Website feature that allows customers to search for and find various physical places that sell or service your products.

You can have multiple Location Finders on your site, e.g. one for your Outlets and one for your Service Centres.

In its most basic form, the Location Finder allows the customer to select a Country and/or State and see a list of matching results. There are no smarts with this basic search, it is a straight filtering of locations by address data.

Google Maps

The Location Finder supports using Google Maps to show search results on a map. All that’s needed to enable this is to provide a valid Google Maps API Key in your Store Settings.

For even smarter searches, Google Maps with Geocoding enabled allows customers to find locations closest to them.

How to Setup Location Finder

To set up Location Finders you need to use 3 objects:

  1. Account - Account object is used to define the location and location details.
  2. Location Group - Defines the actual Location Finder, eg Outlets, or Service Centres.
  3. Location Group Account (as a join object found under the Accounts related list) - Associates Location Groups and Accounts so that an Account (Location) can belong to many Location Groups.

Minimum requirements to configure an Account as a Location

To configure an Account as a Location, the minimum requirements you need are:

  1. Is Location checkbox is enabled in the Account
  2. Account is associated to a Location Group.

By default it will use the Billing Address as the Location Address. You can either change this to the Shipping Address using the Location Address Source picklist, or set to empty and supply the address in the Location Address fields.

If you opt to use either the Billing or Shipping address as the source, the Location address fields will be populated with a copy of the source address when the record is created/updated.

1. Account - Location Details

Is_Location - Determines whether an Account is being used as a Location. Does not affect anything else, but will only be considered a Location when this is checked.
Location Address Source - Picklist. Can be empty, or set to “Billing Address” or “Shipping Address”, this will prefill the address fields below.

Location Details

1.1 Location Details - Address Fields

Used when Location Address Source is empty

Location City
Location Country
Location Postal Code
Location State
Location Street
Location - (Geolocation field for Latitude/Longitude)
Location Display Name - The Location name that will show on the website (depending on Theme). If not provided will use the Account’s Name field.
Location Path - This is the url path that the Location will be available at on the website (depending on Theme). It needs to be unique per Store.
Location Email - The Location’s email address to show on the website (depending on Theme).
Location Phone - The Location’s phone number to show on the website (depending on Theme).
Location Website - The Location’s web address to show on the website (depending on Theme).
Location Info Markdown - Content to show on the website (depending on Theme).
Location_Meta_Description - For SEO Search Description
Location_Meta_Keywords - For SEO Keywords
Location_Meta_Title - For SEO Title

When supplying the Location Address fields manually, you will need to also supply values for the Latitude and Longitude in the Location (geolocation) field. Without Lat/Lng values, the Location cannot be shown on the map or be found via a proximity search.

2. Location Group - Fields

Active - Only active Location Groups show on the website.
Display Name - The Name of the Location Finder on the website. If not provided will use the Name field.
Meta Description - Content for the meta tags (used for SEO)
Meta Keywords - Content for the meta tags (used for SEO)
Meta Title - Content for the meta tags (used for SEO)
Path - This is the url path that the Location Finder will be available at on the website. It must be unique per Store. Your location finder will be found at /find/{path}
Store - A Location Group must be associated with a Store. It will only show on the website for the Store that it is associated with.


Location Filters

The simplest implementation of the Location Finder performs a search against a location. There are two ways to allow searches to be further refined (other than location).

1. Category Filters

To use Category filters with your Location Groups, you need to associate one or more Product Categories with the Location Group.

To associate the Product Category to the Location Group you must have both added in the Related section of the Account

Product Category must belong to the same Store as the Location Group for the search to provide filtered results.

Location Product Categories Location Product Categories2

For a Product Category to be relevant to a Location Group, it must share the same Store via Taxonomy as the Location Group, the Product Category can belong to any of the Store’s taxonomies.

2. Product Filters

Product filters are an extension of Category filters. You need to first set up some Category filters, then add Products to the Categories.

Product filters build upon Category filters and can be extended by adding Products to Product Categories. This allows the search to provide location results for the specific Product.

You can add a link or button on the Product page to open that Product on the Location Finder page. E.g. The finder might be “Stores” and the button labelled “Where to Buy”.

The Product Categories don’t need to have any products in them. It’s purely a way to further tag Locations for search purposes.

Google Maps Integration

The Location Finder makes use of the following Store Variable Key:

GOOGLE_MAPS_API_KEY

When this is set to a valid value (a real API key for the Google Maps service) it will enable the Map functionality on the Location Finder (depending on Theme). Permitting your Google Maps account to use the Geocoding service will also enable the proximity based searching (i.e. find locations near to the customer).

 

 
Back to Documentation