Radius Behavior

Store Locator Plus  Radius Behavior is set to “always use” in the base plugin or Advance level subscription for SLP SaaS

For additional options you would need Professional level  and /or higher for MySLP/SLP SaaS  or the Experience add-on for the WPSLP plug-in  which allows you to extend the functionality beyond the basic “Always Use” setting.  This setting impacts how the radius selector is employed and how locations are filtered before being displayed to the user.

The map radius is set under the Settings /Search tab and the results (after search) is found under the Settings/Results tab”Initial Search radius”.  The search radius selection options presented to the user in the drop down menu is set under the Settings / Search tab  panel.

Results Pagination

Pagination is a bonus feature when you have the Premier subscription  or or MYSLP Enterprise Customers. The setting is under the Settings/ Results tab when the Premier add-on pack has been installed and activated. When Results Pagination has been enabled a new interface class is activated within the plugin that utilizes JavaScript and modified AJAX listener responses to provide the pagination interface to the Store Locator Plus map interface. A previous/next page and an instructional label appears on the top left of the results listings. When users interact with the page buttons the application queries the database in real-time showing the latest location data available as the user pages through the list of locations available within a given radius.

Hide Google Pegman (Street View)

Hide Street View is available as part of the Premier plugin included with the Premier Subscription for Store Locator Plus.  The Street View icon , also known as “pegman” appears on all Google Maps by default.  The Premier plugin allows you to turn this off.

Premier 4.5 Pegman Active
Premier 4.5 Pegman Active
Premier 4.5 Cluster Map Markers
Premier 4.5 Pegman Inactive

 

Turning Street View On or Off

Go to the Store Locator Plus Experience Map tab and look for Hide Street View in the Appearance group.

Premier 4.5 Experience Map Settings
Premier 4.5 Experience Map Settings

Cluster Map Markers

Cluster Map Markers is available as part of the Premier plugin included with the Premier Subscription for Store Locator Plus or the Enterprise level of MySLP.  Cluster Markers show a single map marker graphic (circle with number inside it) when two or more (you set this number) markers are within close proximity to one another on the current map view.   As a user zooms in on the cluster, the clusters break apart to show the individual markers.  When  zoomed out the individual location markers combine into a single marker graphic with the count of locations represented by the graphic shown in the center. You determine the default radius and minimum number of locations  before cluster map marker is engaged.  Your “center map at” and default radius setting will effect where the map center is located.

Turn On Cluster Markers

Go to the Store Locator Plus : Settings / Map and look under the Appearance section for “Enable Cluster Markers”.

Read the Store Locator Plus news articles about Cluster Map Markers.

Putting Results In A Table Format

Premier Subscribers have access to the Results Header option under the Settings / Results tab in Store Locator Plus. This allows the results listings to be formatted in a tabular output with column headers.

Results Header

Outputs the HTML + shortcodes before displaying results. You may attach the locations to an HTML element other than the default#map_sidebar div by adding id="add_locations_here" to one of your Results header elements (such as a tag). This works well with the Skywalk Rev 01 Plug-in Style for optimizing the table style results under the map.

Read The Feature Release Article.

Tutorial Video

[youtube https://www.youtube.com/watch?v=UKPR7a8lomw&w=560&h=315]

Location Search Enhancements

Premier subscribers  or  MYSLP Enterprise level subscribers will see the following features under the Store Locator Plus Settings / Search Panel.

Premier settings to influence Google search

Show Address Guess

If checked, replace the address the customer typed into the address box with what Google thought they meant. This feature is useful if your site visitor is browsing “incognito: or the location sensor is not activated.

Country Influences Guess

When checked , SLP uses the selected Country Map Domain to influence how Google returns  the location based on what they think the user meant when entering a search address. Google returns the most searched locations based on an algorithm. This feature is coded to redirect the returned location based on your location data points.

Boundaries Influence Guess

Uses a search boundary to influence how Google guesses what the user meant when entering a search address.

  • Locations in your data set will show a rectangle that surrounds all of your locations.
  • Defined Boundary is a rectangle that you define with a map that will appear below.
  • The default is none, using standard Google address lookup rules.

These features are very useful, especially when you have a mix of some non – standard Zip/postal  codes or addresses that otherwise might be hard to find with the basic Google MAP API query.Premier Google influenced guess and Boundary Influemced guessesPremier Search features Show address and show google guesses

Importing Locations With Territories

Importing locations with territories follows the same procedure as importing a standard locations file.  As with all location files the format must be a proper CSV file exported using the UTF-8 character set with no special or non-printable characters.

To load the territory data you must have first enabled the territories feature in the Premier Add On.  You will also need to have installed and activated with the Pro Add On or Power Add On for Store Locator Plus.

Your CSV file should add the following five columns to the file.    Make sure you add the field names to the top of each of these new columns as listed here:

  • territory_distance_unit
  • territory_distance_north
  • territory_distance_south
  • territory_distance_east
  • territory_distance_west

Within each column you will want to have the following values:

  • territory_distance_unit can be ‘miles’, ‘km’, or be blank.  If this is not set to ‘miles’ or ‘km’ it will assume the territory is not enabled for this location.
  • territory_distance_north , south, east, and west should be the distance north, south, east, or west from the location that is part of its territory.

The territory boundaries will automatically be calculated for each location during the import.

Highlighting Locations Served By Territory

Premier 4.5 Territory Results Highlight Example

Version 4.5 of the Premier Add On for Store Locator Plus introduces territories to locations.

Once a location is setup with a territory the map markers that are sent back from the server during a user search will include a ‘in_territory’ property set to ‘1’ if the user’s location is within the territory and ‘0’ if not.   An additional ‘in_territory_class’ property will also be set to either ‘in_territory’ or a blank string.   Both settings are part of the ‘data’ property of the location marker.

Enabling Territory Features

Version 4.5 of the Premier add on for Store Locator Plus introduces territories to locations.

Before you can use the territories features of the Premier add on, you will need to enable the feature under the General / Data tab.   This is off by default to reduce the data storage and processing overhead of Store Locator Plus for sites that do not need territory services.  Go to the General / Data tab and check off “Enable Territory Bounds” and click save.   This will create the necessary data fields and enable territory settings and features within the application.

SLP 4.5 Premier 4.5 General Data Tab
SLP 4.5 Premier 4.5 General Data Tab

 

If you later disable this feature any of the existing location territory data will be retained until you delete the location.    However the location search process will no longer restrict search results to locations within a territory nor output data related to locations being inside or outside of a territory; assuming those features are enabled in the Experience settings.

Location Data

Locations will now show several new fields when managing a location.

Premier 4.5 Editing A Location Territory
Premier 4.5 Editing A Location Territory

Territory Distance Unit – what is the distance unit used with this location to determine the territory coverage.  None disables the territory.

Distance North – how many miles to the north of the location is the northern boundary of the territory.

Distance South – how many miles to the south of the location is the southern boundary of the territory.

Distance East – how many miles to the east of the location is the eastern boundary of the territory.

Distance West – how many miles to the west of the location is the western boundary of the territory.

When the location is saved the Territory Bounds is calculated.   Editing the location will show the location point as well as the territory it covers.

User Experience Settings

Under the experience tab there is a setting the dictates how locations are shown to the user.

Experience Results Functionality settings
Experience Results Functionality settings

By default the standard “find locations within this distance of a user” is used.    Any location that is within the selected radius from the address the user entered is shown on the map.  Site designers and use the Experience Results Layout and Custom CSS settings to highlight locations that service the address the user has entered.

If you check of the Only Show If In Territory checkbox under the Experience / Results tab in the Functionality group the list of locations shown to the user will only include the locations where the user’s address is within the location’s territory.    The radius is still used to limit the results that the server processes.    If the radius is hidden and set to a default value, caution should be taken to set a reasonable radius.   Checking if a point lies within a territory can be time consuming.  First limiting the locations to a reasonable list by first filtering those within a certain distance of the user can sped up processing.

For example, if none of your territories are more than 100  miles from the location you can reasonably set the default radius to be all locations within 100 miles.   This will limit how many locations need to have their boundaries tested to see if the user’s address is within.  This will improve your territory matching performance.

Displaying WooCommerce Buy Buttons In Location Lists

The Premier add-on, available exclusively to Premier Subscription members,   allows the Store Locator Plus locations to be associated with WooCommerce products.    You can find details on how to associate the products with the locations in our Associating WooCommerce Products With Locations article.    This article explains how to display products along with a “buy now” link in your Store Locator Plus location results.

Requirements

You will need the following products installed and active on your WordPress site:

Displaying Buy Buttons In Locations

As long as you have WooCommerce installed and activated and the products SKUs you have associated with your locations, Store Locator Plus will automatically output a Buy Now button that is preceded by the product title and pricing any time you use the special [slp_location woo_buy_links] shortcode in your Results Layout or Info Bubble Layout in Store Locator Plus.

The Experience add-on pack provides a setting on the admin interface of WordPress where you can edit the Results Layout and place the WooCommerce product buy buttons anywhere you would like in the results listing.

If a location has multiple products associated with it, the products are listed on-after-another in the area where you put the [slp_location woo_buy_links] shortcode.

The following is a simplified output for the location details that includes the buy button links.

<div id="slp_results_[slp_location id]" class="results_entry">

<div class="results_row_left_column"   id="slp_left_cell_[slp_location id]"   >
<span class="location_name">[slp_location name]</span>
<span class="location_distance">[slp_location distance_1] [slp_location distance_unit]</span>
</div>

<div class="results_row_center_column location_secondary" id="slp_center_cell_[slp_location id]" >
<span class="slp_result_address slp_result_citystatezip">[slp_location city_state_zip]</span>
<span class="slp_result_address slp_result_country">[slp_location country]</span>
</div>

<div class="results_row_right_column location_tertiary"  id="slp_right_cell_[slp_location id]"  >
[slp_location woo_buy_links]
</div>

</div>

Buy Button Pricing

The pricing for the products will be based on the pricing data provided in the woo_products field for the location.   If only a SKU is present the default pricing for the product will be used.   If a per-location price has been provided for a SKU then the per-location price will override the default price when the item is added to the cart.   See the Associating WooCommerce Products With Locations article for more details.

Styling The Results

In addition to being able to to add your own DOM elements with custom class names and IDs, the Premier add-on also uses a rudimentary span-in-dive layout for the WooCommerce product information.

The default layout is a div of class woo_buy_block followed by three independent spans of class “woo_product_title” , “woo_price”, and “woo_buy_link”.    These divs will be stacked on top of each other within the results layout.

<div class="woo_buy_block">
<span class="woo_product_title"> . $woo_title                        . </span> .
<span class="woo_price">         . $woo_product->get_price_html()    . </span> .
<span class="woo_buy_link">      . $buy_link                         . </span> .
</div>'

You can  use the CSS Editor provided by the Pro Pack , upload your own custom CSS file to your WordPress theme or the Store Locator Plus plugin directory, or use the CSS Editor that is provided by many WordPress Themes to override the general look-and-feel of the WooCommerce product links presentation in the location results.

 

Related