Enabling URL Controls
Enabling URL Control features will require an active Premier Subscription.
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.
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.
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.
<div id="slp_results_[slp_location id]" class="results_entry location_primary [slp_location featured]">
<div class="results_row_left_column" id="slp_left_cell_[slp_location id]" >
[slp_addon section=primary position=first]
<span class="location_name">[slp_location name] [slp_location uml_buttons] [slp_location gfi_buttons]</span>
<span class="location_distance">[slp_location distance_1] [slp_location distance_unit]</span>
[slp_addon section=primary position=last]
<div class="results_row_center_column location_secondary" id="slp_center_cell_[slp_location id]" >
[slp_addon section=secondary position=first]
<span class="slp_result_address slp_result_street">[slp_location address]</span>
<span class="slp_result_address slp_result_street2">[slp_location address2]</span>
<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>
<span class="slp_result_address slp_result_phone">[slp_location phone]</span>
<span class="slp_result_address slp_result_fax">[slp_location fax]</span>
[slp_addon section=secondary position=last]
<div class="results_row_right_column location_tertiary" id="slp_right_cell_[slp_location id]" >
[slp_addon section=tertiary position=first]
<span class="slp_result_contact slp_result_website">[slp_location web_link]</span>
<span class="slp_result_contact slp_result_email">[slp_location email_link]</span>
<span class="slp_result_contact slp_result_directions"><a href="https://[slp_option map_domain]/maps?saddr=[slp_location search_address]&daddr=[slp_location location_address]" target="_blank" class="storelocatorlink">[slp_location directions_text]</a></span>
<span class="slp_result_contact slp_result_hours">[slp_location hours]</span>
<a href="?only_with_tag=[slp_location data.sl_tags]">[slp_location data.sl_tags]</a>
[slp_location iconarray wrap="fullspan"]
[slp_location eventiconarray wrap="fullspan"]
[slp_location socialiconarray wrap="fullspan"]
[slp_addon section=tertiary position=last]
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.