The [slp_search_element] Shortcode

The [slp_search_element] shortcode is only processed within the Search Layout setting.   It is used to display user input elements on the search form.

Attributes

Attributes are the keywords that appear after the opening [slp_search_element and before the closing ].

Default attributes include:

button=<slug>

Output a form button.  <slug> should be an input supported by the base plugin or an add on such as:

submit

Output the Find Locations button.

 

dropdown_with_label=<slug>

Output a dropdown selector with a preceding label for the specified input.  <slug> should be an input supported by the base plugin or an add on such as:

radius

Output a dropdown of radius selections based on the Experience / Search / Radii Options setting.

hard_coded_value=<value>

Outputs the specified value.  Used by some add ons to add a specific [slp_search_element] output.

input_with_label=<slug>

Output a input selector with a preceding label for the specified input.  <slug> should be an input supported by the base plugin or an add on such as:

address

Output a the address/zip-code input box.

Tech Geek Stuff

Processed by the SLP_UI class via add_shortcode in create string_SearchForm() which calls crease_SearchElement().

Filter shortcode_slp_searchelement is used to manipulate attributes.  Many add ons use this to render specific output using attribute ‘hard_coded_value’ => ‘xyz’ to output a specific value.

Q. What is the difference between a shortcode and locator layout settings?

A.    A shortcode is a WordPress-specific code that lets you do nifty things with very little effort.  Shortcodes can embed files or create objects that would normally require lots of complicated, ugly code in just one line.   In other words, a Shortcode = shortcut. Continue reading “Q. What is the difference between a shortcode and locator layout settings?”

Directory City/State/Country Filters

The directory feature of the Power add on allows you to quickly build a directory-style listing on your pages to show a list of cities, states, or countries where you have locations.

The [slp_directory] shortcode used to build this listing can be combined with a landing_page attribute to quickly refer your site visitors to an interactive map showing your locations in the selected city, state, or country.
Continue reading “Directory City/State/Country Filters”

Adding Locations with additional features

If you have any of the Store Locator Plus featured Add-ons such as Power, Experience, or Premier add-ons you will see additional sections when Adding (or managing) a Location.

You can opt to fill in all the rows and info that determine the Location and geocoding and hit Add button if you are done entering information. Or you can opt to continue to the next section, whether it be featured, tags, categories, territories, or other functions that are in separate sections on the Location Add Tab.Click the “Add button” at the bottom of the next section instead.

For example, I want to add a location that also is going to have a category assigned to it. I have the latest version of the Power Add-on activated. After adding all the Location information, I do not click on the Add button under the location information but continue on down to the next section called “Power” and add whatever pertinent information I wish to add there. Once I am satisfied and have no additional data to add, I click on the Add Button under the Power section of the Locations Panel to create the location that I have just added.

The category or other additional data you just associated will appear when you review the Locations Page.When to click the add buttonaddlocationa nd acategories

Radius Behavior

Store Locator Plus  Radius Behavior is set to “always use” in the base plugin. The Experience and/or Premier Add On packs 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 search radius is set under the Settings /Search tab and the results after search is established under the Settings/Results tab with “Initial Search radius” and can be set to any number which equates to miles radius.

The radius selection options presented to the user in the drop down menu is set under the Settings / Search tab  panel.

Continue reading “Radius Behavior”

Locator Widgets

Store Locator Plus Widgets are included in the Experience Add On. This add-on pack creates new widgets that can be used to connect to the Store Locator Plus map or location data on your site from any widget-enabled area in your WordPress theme.

Experience 4.5 Widget List
Experience 4.5 Widget List

SLP Search Form

The SLP Search widget places an interactive zip/address search box in any widget location on your site. A search initiated from the widget will direct the user to the Store Locator Plus map page that you have specified.

Experience 4.5 Search Form Widget Settings
Experience 4.5 Search Form Widget Settings

Map Page URL

The URL for the page on your site where you want the user to end up. The page should have the SLPLUS shortcode for rendering the Store Locator Plus map. For example http://localhost/?page_id=8 or https://localhost/locations/ if you have SEO-friendly page URLs enabled in the permalinks settings.

[box type=”note”]For users with pre 4.2.02 version of the widget pack, this is a single combined field including the URL portion before the “?” and after the “?” including the “?” itself. The versions 4.3 and lower are no longer maintained and may not be compatible with 4.4 versions [/box]

Search Label

The label to precede the input box, or if ‘use placeholder’ is set, the text to use as a placeholder.

Button Label

The text for the submit button.

Use Placeholder

When checked the label will be placed inside the input box as a placeholder.

Radius

Show locations within this radius from the zip code/address the user input.

Widget for States

The SLP States widget places a drop down list of the states or provinces where you have active locations. The user selects a state and presses the submit button to be redirected to a page with a Store Locator Plus map in place.

Experience 4.5 State Widget Settings
Experience 4.5 State Widget Settings

Widget for Cities

The cities widget provides a drop down list of cities based on your Store Locator Plus locations.   Users can select a city where you have locations and be directed to your locator map to get directions or other details.

Experience 4.5 Cities Widget Settings
Experience 4.5 Cities Widget Settings

Store Locator Plus Discrete Searches

The Experience provides a “search by city”, “search by state”, and “search by country” feature.   This search form element, when enabled, will build a drop down list based on the locations in your database.   This is meant to provide a hint to the user where your locations are.

The legacy system was a simple “address input” feature.   When a user selected an entry from the drop down list it types the text into the address box.  When the user clicks the search button it looks for locations closest to that location based on your other search form settings.   If your default radius is 100 miles and the user selects the state of Texas, this system will search for all locations within 100 miles of Google’s estimated “center of Texas”.

Continue reading “Store Locator Plus Discrete Searches”