Map display options

Map Display

The Experience add-on for the WP Store Locator Plus allows you to select when and what you want the Map to display.

With the Experience add-on installed and activated , a pull down menu under the section  “At start-up” allows the below options to be set:

  • Show Map (default)
  • Hide map until search
  • Image until search

Appearance

Additional options for how your Map layout and appearance  looks is also available with the Experience Add-on

Locator Data – The Field Names

Store Locator Plus includes a default set of data fields that is included with every installation as well as extended fields provided by add-on packs.

For  data fields, including those added with the Extended Data Manager, you can output the data in the map info bubble or results layout,  by using the following shortcode:

[slp_location data.<field_slug>]

For example:

[slp_location data.contact]

[slp_location data.facebook_custom_url] (for someone that added a field named Facebook Custom URL).

Both the default data and extended data can be displayed in the search results, (for SEO Pages some fields will be [storepage field=contact] for SEO-friendly details pages. Most of the tools provided by the various add-on packs work best when using the field slug. The slug is a unique name for the field that is similar-to, but not exactly the same as, the field name.

The slugs are used in the add-on packs such as the layout strings from the Experience Add On in as well as the column headers for CSV Import in the Power Add On.

Default Location Fields

ID

Name

Address

Address Line 2

City

State

Zip

Country

Latitude

Longitude

Tags

The Pro Pack tags field. Requires Pro Pack for full functionality.

Description

Email

Website

Hours

Phone

Fax

Image

An fully qualified image URL, http:: with a full domain.

Private

May be used in the future as a 1|0 value to determine if a location is to only appear on the admin interface and not front end searches.

Neat Title

May be used in the future as an alternate store name or subtitle.

Linked Post ID

The ID of the related store_page entry where extra taxonomy data and other location data is stored. Used with Store Pages and Tagalong. Should not be modified.

Pages URL

The relative URL for the Store Pages linked post ID. Provides a processing shortcut for the Store Pages add-on pack.

Pages On

Used with Store Pages to determine which locations have been populated with Store Pages template content.

Option Value

A serialized JSON data object which can store extra location data. Slower and less direct than extended data fields.

Last Updated

A date and time MySQL timestamp indicating the last time the main data for the location was updated.

Initial Distance

The initial distance calculated between your center map latitude/longitude and the location.

Add On Pack Import Fields

These fields appear in the extended data table, slp_extendo. The field metadata, used to manage the slp_extendo table, is store din the slp_extendo_meta table.

Power Add On : Contacts Enabled

Identifier a unique location identifier from an external database that can be used to update existing locations in Store Locator Plus

Contact

First Name

Last Name

Title

Department

Training

Facility Type

Office Phone

Mobile Phone

Contact Fax

Contact Email

Office Hours – long formatted text

Contact Address – long formatted text

Notes – long formatted text

Featured – valid values are “1” for featured and “0” (zero).

Rank – an integer from 1 (highest rank/top of list) to 999999. 0 = no rank.

Power Add On : Categories Data

Power categories utilize the built-in WordPress custom taxonomy system. Standard WordPress category IDs are kept in the term_relationships and term_taxonomy tables. The relationship between locations and categories is managed via the slp_tagalong table that maps the Store Locator Plus id field to the WordPress Taxonomy term_id.

 

Continue reading “Locator Data – The Field Names”

Import remote file retrieval

The Power Add-on Import allows the administrator to  schedule your Import process from a remote file retrieval to provide more control over recurring imports from a full url where you CSV file resides and allows flexibility for scheduling the time for daily imports.
WordPress cron is not exact, it executes the next time a visitor comes to your site. WordPress times are UTC/GMT time NOT local time. Set to none and leave the URL blank to clear the cron job. Example: 14:25. (Default: empty = do not run daily cron)

Power 4.6 import back end

Checking your server, PHP and MySQL to ensure the character set is correct will go a long way toward importing special characters like registration characters.

Additional Import Data field headers

If you have the Power add-on you will have the ability to import data fields via a properly formatted csv file.  All columns MUST have a header row with the  field name. All fields are short text fields, up to 255 characters, unless otherwise noted.  The header text is NOT case sensitive.

If you are using the category (aka tagalong) functionality of Power you may want to import and assign a category slug on the fly.  The header field name is:

category (or plural categories).

If you wish to import and assign more than one category  per location , you will need to use a comma-separated list for the data field  (category).  Example: My location has more than one category associated with it, I want to indicate it is a hotel,restaurant, and has music.  Category  for that location would show under the column with the header row “category”…. hotel,restaurant,music

Alternatively, to define parent/child relationships , i.e.  hierarchical categories , use a double colon as the separator Example the Parent is Facility, the child is showroom.

Facility::Showroom.

Make a Dial Link Phone number (clickable)

A check box under SLP/Experience/Results/Appearance titled “Use Dial Link for Phone” when checked makes the phone number in your locations results clickable to auto dial.  This feature is available  exclusively with the  Experience Add-on (also with Premier)

Experience Add on find this feature under Experience results panel
Experience Add on find this feature under Experience results panel

 

 

 

 

Results Interaction

Results Interaction is a set of features provided by the Premier Add On. This set of features provides a variety of visual cues on the location map to indicate which location a user has clicked on when viewing a list of locations.   This provides a variety of additional options beyond the standard Info Bubble that Store Locator Plus displays when a location is clicked.

Use the Experience add-on to completely disable the Info Bubble and only use these interactive result indicators.
Continue reading “Results Interaction”

Troubleshooting Large scale Exports

Issue: Exports are Incomplete

Multiple large-scale exports (export function is available with Power Add-on ) have been tested on the Store Locator Plus dev site. On a relatively small server, a virtual machine with 2GB RAM running CentOS 6, we  have been able to export 10,000 locations within 15 minutes with no issues. Special characters and extended data have also exported without issue.

If you are experiencing  issues there are several things to check that can cause problems during an export:

Web Server Process Limits

Apache, and nginx as far as I are aware, have per-process limits. This is built into the web server to prevent “runaway” processes that eat up all of the CPU and memory on the server over time. On shared servers this limit is very low and typically allows 30 seconds to 2 minutes of processing time. Large data sets can use up to 5 minutes or more of processing time. Make sure your server has a high enough limit to allow the entire data export to complete execution.
Continue reading “Troubleshooting Large scale Exports”

Q. What is the purpose of ranking under category manager?

A. Category ranking is a feature when you are using the Power Add-on and the category manager. The rank is used to sort the categories which will affect the map marker that is used when a location has been assigned more than one category. Following the page ranking paradigm set by WordPress, the rank field is a simple numeric weighting for the categories. This extended data attribute for categories makes it easy to re-arrange the “weight” of categories for map marker selection without mangling category slugs. The lower the number, the higher the precedence for the map marker.

Categories Panel: taxonomy and settings

If you have the Power add on for WordPress or the Power / Professional / Enterprise level for MySLP you will see a header tab in your Store Locator Plus menu labeled Categories.  This is where you can establish and manage settings and determine the categories you want to add in the form section of the user interface.  The two sub sections under Categories is Settings and Taxonomy.

Continue reading “Categories Panel: taxonomy and settings”