Adding Radius Selection First Entry

If you have the  WPSLP Experience Add On or the MYSLP/Professional plan   an additional setting is available under labels and will show you a new field named Radius first entry under the Settings/Search user interface.   When a Radius First Entry has been set it will appear as the first field  in the radius drop down that the user sees on your search form.   The value will be set to the default miles that you have set in Radii Options. The other radiis you have entered to allow users to search will appear in numerical order in the dropdown but the label for the first entry will appear first regardless of numerical order.

Results Layout Shortcodes and Attributes

The ability to change results layout is included in the Experience add on.

Default Format

The default format for the results string uses the numerical encoding for the various data elements that can be rendered.   This default string format is present in the base Store Locator Plus plugin.  You can reset  to the default at any time by deleting the entry in the Results Layout field under  Settings/Results/Appearance and saving the settings.

Appearance Layouts

Experience Add-On

The Experience Add-on allows you to customize the layouts, the map interface, and the search form to display in a certain manner on the front end of your locator page

Search Layout

Search Layout is found under the Settings tab on the Search panel.

This setting allows the search form layout to be modified via a text setting.   If the Search Layout field is left blank the default search form layout and  your SLP style is used.   If Search Layout is modified the layout will take precedence over most of the Search Form settings  and the basic Store Locator Plus.

Search Layout Shortcodes and Attributes

You must have the Experience Add-on   to change the Search Layout appearance, and along with other add-ons,  also allow you to to use the shortcode on  SLP WP page.

These  shortcodes only apply to the Search Layout admin setting when you have the appropriate  Add-on installed and activated.

slp_search_element

This shortcode provides a simple mechanism to place standard search form elements on a custom search form layout, including the wrapping divs and classes around labels and input fields.

button Attribute

Places a search form button on the search form.

Map Panel Settings

SLP plugin/ Settings /Map  selections will determine the  Map layout , display, and focus of the map. The settings contained in the map panel will change the functionality (map domain, zoom) and appearance of the map and provides an array of  selections to choose from such as, Google Map domains,language and additional functionality.   If you need additional functionality or Map Layout , you may wish to review the Experience for WPSLP or Professional for MySLP or Premier/Enterprise options). Note that your  Plug-in style selection will also impact how the map is displayed on your site.Plugin styles can be selected under Settings/View

The following settings are available to manage functionality for both WPSLP stand alone plug-in and MySLP SaaS managed service..

At Startup

  • Center Map:   This is where you enter an address, or a state, or a location or even a specific latitude and longitude to be displayed as the initial focus for the Map. If nothing is entered in this box , the default will be the center of the country of the Map domain selected. For example if you have selected the United States Google map domain then the center of your map will be somewhere in Kansas.

    Basic Map settings without add-on
  • Center Latitude Fallback: Center Longitude Fallback:  These are the latitude/longitude settings  that will be called if the Google server is “busy” or offline and not able to geocode or “call” to load your locations.  If you reset to blank it will fill in with the Center latitude/longitude of the map domain you have chosen.    You can have a different Lat/long fallback  then your map domain or the center map if you so choose. If you do not add anything it will automatically fill with one of the two options described. An image of your fallback will also be displayed (version 4.9+)

Selecting and Customizing your Style

Store Locator Plus Appearance

Store Locator Plus comes with a variety of styles to provide a basic style framework that will attempt to match your locator page to various WordPress themes  installed on your site. You can see the list of  Plugin Styles under  the Store Locator Plus Settings Tab / View panel.

Locations Panel: Manage Locations

The Locations panel in Store Locator Plus is where you add, manage, edit and/or delete locations.

Actions and Filters

Under the Manage Locations panel there are drop down fields and filters that can be applied to display the pagination interface. If you have a large number of locations, bulk actions can be a very useful tool. If you have more locations than can fit on the display, you can set the display filter to show more locations. You may also use filters to display and manage non – geocoded locations, or show locations with certain properties. The display can be adjusted to suit your needs but configuration constraints and/or server constraints may effect your outcome.

Not all Bulk actions will appear if you have only the base plugin installed.  Bulk action filters for removing Tags, performing Exports, geocoding all uncoded, and bulk categorize certain locations will  be shown if you have  the WPSLP Power add-on or Power level Plan for MySLP

The default number of locations that will be displayed on the admin user Interface is 10. Selecting a large number to display can be useful to view or manage but if your server capacity cannot handle it or changes and you go back to manage locations months or years later and try to access your locations panel, you may see no locations panel. If you see the wheels churning on your computer with no results this could be the reason. If you are not sure of the capabilities of your server, browser and various other factors that effect memory, and inhibit loading and displaying fields, err on the side of caution and set the Filter Display locations back to a manageable size before leaving the panel. If you are migrating servers from a “heavy duty” server to a less robust server, or if your memory becomes an issue you will need to reset the display to a manageable number. If you do not take this precaution , the only way to reset the display field is by using Janitor. See Troubleshooting for more info.

Location Imports

Location Imports are handled via a CSV file for users that signed up for the MySLP Professional service or are using the WPSLP Power Add On. With MYSLP the import feature is under the StoreLocatorPlus sidebar/locations as shown in screenshot. If you are using WPSLP self managed and have the Power add-on it will look similar.

CSV Import Format

Getting the proper CSV format can be a challenge when using spreadsheet apps like Excel or Numbers.  Here are some tips to getting a valid CSV format out of a spreadsheet app:

  1. Make sure you always have a header row.  That tells the import process what data is in each column.   The column headers have meaning, so be precise.
  2. When a cell is a text field that STARTS WITH A LEADING ZERO, make sure you explicitly mark the cell as text.   The easiest way to do this is to type a single apostrophe then the number when adding data to the cell as in ‘01886 for the zip code 01886.
  3. Always export with UTF-8 support enabled.
  4. Export to a CSV format.  Comma delimited not tab delimited and quoted strings if given the option.

Check out the Example CSV Imports post to get some usable import files you can play with.

MAP: Info Bubble with Experience add-on

Bubble Layout

The bubble layout setting allows you to change the content and layout of the popup information bubble that appears when someone clicks a map marker or in the results below the map.

The Store Locator Plus shortcodes only work within the bubble layout. These are not generic WordPress shortcodes.
All of the bubble layout shortcodes follow this syntax: