Location Limit URL control

Location Limit

The location limit feature is available exclusively to our Store Locator Plus Premier/Enterprise customers.

When the URL Control module is active you can enable location ID passing by turning on “Location Limit” under the General / User Interface tab.

When this is enabled you can pass in a limit for the number of locations to be returned when the map initially loads and when a search is performed by adding ?limit=<id> to the end of the page address where your locator map is deployed with the [slplus] shortcode.

Example: Client has 250  results to return by default but when the site via a URL link loaded they only wanted 5 to come back.

Location Limit functionality supersedes the initial default limit.

Store Locator Plus Additional Functionality

Store Locator Plus .     Store Locator Plus SaaS:  Enterprise level subscribers have a module that adds URL control functionality.

Upgraded  Premium Features

Enterprise / Premier Users

Territory Bounds module was moved from the General | Data tab to the General | Server | Web App Settings section.  Cluster Map Markers is useful for a large dataset in close proximity to each other on the map.

URL Control

A  URL Control module was been added to the application for Enterprise or premier subscribers.   Enabling this module will turn on the interface to allow additional data to be presented in a web page URL to impact how the locator behaves.

URL Control : Allow Location In URL

The first URL Control option is to pass a location ID in via a URL.   Adding ?location=<id> to the end of a web page address that hosts the locator will cause the page to load with the specified location being highlighted as if the map marker was clicked.  The default behavior is to show the info bubble for that location.

Premier URL Control

Enabling URL Controls

Enabling URL Control features will require an active Premier Subscription.

Location Selection

When the URL Control module is active you can enable location ID passing by turning on “Location Selection” under the General / User Interface tab.

When this is enabled you can pass in a location ID by adding ?location=<id> to the end of the page address where your locator map is deployed with the [slplus] shortcode.

When the location ID is present and the settings is enabled the specified location will be activated on the location map as if a user had clicked the marker on the map.  This will show the info bubble by default.

Note: If cluster map markers are enabled they will be turned off for the initial page load.   Subsequent input or searches by the user will re-activate the cluster map markers.

Note: When passing in a location ID via a URL the location latitude/longitude will become the center point for the map display.  The location that is shown will be at the top of the result listing if sort by distance (default) is in place.

 

Location Limit

When the URL Control module is active you can enable location ID passing by turning on “Location Limit” under the General / User Interface tab.

When this is enabled you can pass in a limit for the number of locations to be returned when the map initially loads and when a search is performed by adding ?limit=<id> to the end of the page address where your locator map is deployed with the [slplus] shortcode.

Filter By Tag

When the URL Control module is active you can filter locations to show only this matching the tag(s) by turning on “Filter By Tag” under the General / User Interface tab.

This setting will require the Power Add On to be installed and active.

This setting will also require the following shortcode to be present in the Results Layout.  The shortcode is standard in most Store Locator Plus provided Style Gallery Styles.  It can be removed or changed if you have the Experience Add On active.

[slp_search_element selector_with_label="tag"]

An example of a Results Layout where locations are assigned a single tag.  With multiple tags the entire list will be hyperlinked and will not likely perform as expected.  Note the [slp_location data.sl_tags] takes the place of the [slp_location pro_tags] shortcode that is set by default on most Style Gallery styles.

 

[slp_addon section=primary position=first] [slp_location name] [slp_location uml_buttons] [slp_location gfi_buttons] [slp_location distance_1] [slp_location distance_unit] [slp_addon section=primary position=last]

 

[slp_addon section=secondary position=first] [slp_location address] [slp_location address2] [slp_location city_state_zip] [slp_location country] [slp_location phone] [slp_location fax] [slp_addon section=secondary position=last]

 

[slp_addon section=tertiary position=first] [slp_location web_link] [slp_location email_link] [slp_location directions_text] [slp_location hours] [slp_location data.sl_tags] [slp_location iconarray wrap=”fullspan”] [slp_location eventiconarray wrap=”fullspan”] [slp_location socialiconarray wrap=”fullspan”] [slp_addon section=tertiary position=last]

</div>

If you have URL controls enabled you can now pass in location filters based on a tag by adding ?only_with_tag=red to the end of your locations page URL.

Combining URL Options

You can combine the URL control options by using standard URL notation for parameter passing.

The standard is to define the first parameter by starting with a question mark.

Additional parameters are started with an ampersand.

To pass a location ID and a location limit, in this example to show ONLY the location specified, you would add ?location=32&limit=1 to your map page URL.

 

Videos

User Interface Settings for WPSLP plug-in

Settings that impact how JavaScript works on your site.  Note, if you subscribe to the MySLP SaaS, you will  not see a General tab. With the MySLP we  take care of this for you!  The My Store Locator Plus service is a fully-managed application that works with any website or mobile development platform.

UI jQuery Version –

reflects the jQuery version that is currently used with  the Store Locator Plus version  you are using. The SLP jQuery versions are in compliance with the WordPress minimal version requirements.

Force Load JavaScript

 

This settings forces the Store Locator Plus JavaScript (slp.js) to be loaded when your WordPress Theme header is loaded. This is NOT the way to go.  It is recommended that you turn OFF “Force Load JavaScript” and instead contact your theme author. See Troubleshooting for more information