Search Form Style

Search Form Style sets the styling for the interactive locator elements on your site.   It uses pre-built jQuery Theme Roller style CSS designs to create a simple way to style interactive elements such as the autocomplete feature (available in WPSLP Experience or with MySLP Professional) on the address box.

The default styling is set to “None” which provides not special styling rules from interactive JavaScript elements in the locator interface.   This allows the site designer to create their own styles for the website in which the locator will be placed.

Search Form Style Default None 2017-05-23_16-20-30.png
Default styling for autocomplete is “none”.  The theme in this example does not specifiy any ui-autocomplete styling. The background inherits the transparent background used by the website as the default for all divs.

The base service also includes the Base jQuery theme.

 

Setting A New Style

For WordPress plugin users go to the Store Locator Plus selection on the sidebar menu.

For MySLP users go to Advanced Options.

Select Settings from the tab list.  Search will be the default sub-tab.

Scroll down to the Appearance section and expand it by clicking the word “Appearance” if necessary.

Select a new style from the Search Form Style drop-down menu.

Selecting Base Search Form Style
Selecting a search form style for interactive elements.
jQuery Base default styling 2017-05-23_16-23-52.png
jQuery Base Default Styling

Available For WPSLP and MySLP

Search Form Style is a feature that is included in the base plugin of Store Locator Plus for WordPress and is available under Advanced Options for all levels of the MySLP service.   Premier members on WPSLP and Enterprise Level users for MySLP will have multiple options for the Search Form Style.

 

 

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.

Basic Search and Results Report

The Power Add On includes basic search and results reports. When Power is installed you will see a new Report tab on the Store Locator Plus admin pages. This tab is where you can view and generate locator search reports. See what visitors are searching for and what results are being returned.
Continue reading “Basic Search and Results Report”

[slplus] Shortcode

[slplus] is the primary shortcode used within WordPress sites to display the Store Locator Plus map and location search interface.

A shortcode is a special label inside of square brackets that is used within WordPress pages and posts to display the output from a plugin. You place a shortcode within the text of your page or post and the plugin will “do it’s magic”.

Note: Shortcode attributes WILL NOT WORK if Force Load JavaScript is turned on under Store Locator Plus General Settings. Try turning it off before using attributes. If Store Locator Plus won’t load when you turn Force Load JavaScript off, get a different WordPress Theme that fully implements WordPress code standards.

Note: WordPress Plugin API update 4.2.3 effects shortcodes with filtered styles which will not be recognized when stored between quotes.

Continue reading “[slplus] Shortcode”

Location Search Enhancements

Premier subscribers will see the following features under the Store Locator Plus Experience / Search Panel.

Premier 4.5 Search Settings
Premier 4.5 Search Settings

Show Address Guess

If checked, replace the address the customer typed into the address box with what Google thought they meant. This feature is very useful when they are browsing incognito or the location sensor is not activated.

Country Influences Guess

When checked , uses the selected Country Map Domain to influence how Google guesses what the user meant when entering a search address.

Boundaries Influence Guess

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

  • Locations is 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 ahve a mix of some non standard Zip codes or addresses that otherwise might be hard to find with the basic google query.Premier Google influenced guess and Boundary Influemced guessesPremier Search features Show address and show google guesses

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”

Search Panel Settings

How SLP Search Works

Store Locator Plus searching can operate in radius or discrete search mode.  The default mode is radius based and is the premise behind much of the operational aspects of the Store Locator Plus plugin.  Additional search features and settings can be obtained through the  Experience Add-on suite and/or  the Premier Subscription (see below).
Continue reading “Search Panel Settings”

Creating A Locator Page

Summary

To create a locator page that has a zip/postal code search box, a map of your locations, and the results list put the [slplus] shortcode on a page or post.

Go to Pages in your WordPress admin.

Create a new page.

Name it “Locations”.

Enter [slplus] in the main content area of the page.

Details

First create a new page for your WordPress site where the Store Locator Plus plug-in will reside. Add the shortcode (a special label inside of square brackets that is used within WordPress pages and posts to display the output from a plugin). You place a shortcode within the text of your page or post and the plugin will “do it’s magic”

Locator Shortcode

To display the Store Locator Plus search form, map, and search results using the defaults you have setup via Map Settings in the admin panel, use the following shortcode:

[slplus]

The base plugin will replace the shortcode with a search form, a Google Map, and a results section below the map.   Depending on how you have the plugin configured the map and results may start by showing some or all of your locations.

  • Hint: Do not copy and paste off this page or all you will see is the text. You must type in the shortcode onto your WP page.
SLP slplus shortcode
SLP slplus shortcode

Additional Shortcodes can be found under the SLP documentation Shortcodes:SLP