The ability to change results layout is included in the Experience add on.
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.
The Results Layout is a combination of HTML and special shortcodes that are only active when rendering locations. These strings can be reordered or deleted if you have the Experience add on. Display a specific location field, such as a store name, or a location data element, such as distance, where you want it to appear in the results layout. Location fields are data taken directly from the location data table.
You can output a single field (using the correct data field name as shown under Location import) with the [slp_location <location_data>] shortcode in the results layout.
[slp_location <field name>]
Display data for a single location. Field name is a location field name.
It can be a primary field name such as ‘name’.
It can be a Secondary Field Name, as indicated with the “dot notation” which allows access to the “Object” Primary Fields such as “data”. This is typically where add on and extended fields live as well as full access to the raw data for the base plugin. For example the field “data.sl_id” will output the location ID.
Display the city.
The city followed by the state followed by the zip with USA-style formatting. If the city and state are not blank a comma is inserted between the two. The zip is at the end with a space before it if either city or state are not blank.
The zip followed by the state followed by the city with European-style formatting. A space is inserted between each element.
Display the country
Display the email. This is not clickable just the raw email. You will likely want to use email_link from the Experience add-on instead.
The raw hours text, not HTML sanitized.
Display the url. This is not clickable just the raw url. You will likely want to use web_link or url_link instead.
Display the url in a clickable link. Displays the full URL instead of the website label. Use web_link if you prefer the website label. The website label can be changed with the Experience add-on.
This will be the location URL from the location database OR a link to the Pages web page if “pages replace website” is enabled in Pages. The text will be the website label text.
Display the location ID field.
Display whether or not the location is private.
Display the value of a setting, typically from the base Store Locator Plus setting to output a label or other text element set in the global settings.
Display an HTML string.
Allows for a <br> tag or closing anchor tag </a> to be output based on conditions.
A placeholder marker for indicating to add ons where special processing is to take place. Has not output.
These modifiers apply to ALL of the results layout settings other than [slp_addon …].
, [slp_option <option_name>], and [html br|closing_anchor] can all use these as the third parameter. The “text” will be the field value, setting value, or HTML <br/> or </a> tag.
Inverse of ifset as noted above.
If the specified location data field is NOT empty…
The example shows the location’s phone number as long as the phone field is set. Only if the phone field is NOT set will it show the fax.
The [slp_location phone] field can be modified with other settings like add dial extension. The use of data.sl_phone, instead of simply phone, allows us to query the original location data.
[slp_location phone ifset="data.sl_phone"] [slp_location fax ifnotset="data.sl_phone"]
Output the noted suffix after the text string.
Output the HTML break <br/>
Output a comma ,
Output a comma followed by a space ,
Output a space
Wrap the text with some special HTML code.
An HTML anchor tag linked to the Google Maps directions format with source address being what the user typed in the search box and destination being the location’s full address. Make the text for the given field the ‘clickable part’.
Use the text as the image source in an HTML <img src… /> tag.
Use the text as the email address in an HTML <a href=”mailto…” tag. Does NOT output the closing part of the tag. Use [html closinganchor] to set this.
Use the text as the website URL in an HTML <a href=”…” tag. Does NOT output the closing part of the tag. Use [html closinganchor] to set this.
Add a <span class=”results_line location_<field|option name>”>…</span> HTML string around the text.
Apply a special format to the text. Must be ‘decimal1‘ , ‘decimal2‘ , ‘sanitize‘, or ‘text‘.
Parse the text as a float and show one digit after the decimal.
Parse the text as a float and show two digits after the decimal.
Strip out anything that is not a “word character” (letters, numbers, underscores, hyphens).
Force the data to be passed trough the HTML parser and convert special HTML characters to their ampersand encoding.