Tag Search

Tag Search was introduced in version 1.70 of Store Locator Plus.

Administration

Settings for Store Locator Plus Tag Search are under the Map Settings section of the admin panel for WordPress. Store Locator Plus will show you the additional map options only after you have entered a Google API key. Once the Google API key has been entered you will see a left-side menu section in the admin panel labeled "SLP Locations". Click on "Map Settings".

Turning On Tag Searching

Tag based searches are turned off by default. When viewing the Map Settings you will see a "Search Features" section on the page with a "Search By..." subsection. Check off the tag input checkbox to enable tag based searches for your users.

Custom Label For Tag Searching

You can set a custom label for the tag search input. By default the label is blank. Look for the Search By Tag Label: entry on the Store Locator Plus Map Settings section to enter your custom label. We use "Tagged With:" as our custom label.

Admin panel - tag settings.

If you do not enter a label for the tag search field the entry box will remain unlabelled.

Pulldown or Text Input

You can elect to have either a pulldown or a text box input for users to interact with when filtering results by location tags. The default mode is to allow for free-form text input as described above. To switch to pulldown mode you must enter a series of tags that you want to provide to your users in a comma separated list. Fill in the "Preselected tag searches" box with your list of words or phrases that you want to appear in the pulldown. Mark the default entry by surrounding the text with parenthesis.

Providing An Any Selection On The Tag Pulldown

You can also provide an "any" selection which will search for all locations, in addition to the list of tags you enter on the pulldown list. Check off the "show any on tag pulldown" setting and Store Locator Plus will automatically add the phrase "any" to the top of your search list.

Tag pulldown settings.

User Interaction

If you have enabled the "Search By Tag Input" feature, users will see the "Tagged With:" entry box on the form. When they type in a tag the address search will only show results that contain the word of phrase entered in the "tagged with" entry box.

The tag filter matches the information entered in the tags field under manage locations using a partial match method. If you have something tagged with the word "anything" and someone searches for "any" it will match. It will also match a search for "thing" and "thin".

Searches are not case sensitive, so searching for ANYTHING, anything, and Anything will all match the tag "anything".

Text Based Tag Filters

Users can filter the location results by entering tags in the text box. This will return only those results that contain the tag entered.

User interface - tag text box search.df
User interface - tag text box search.

If the user leaves the input box blank it will show all locations that are in the search area.

User interface - tag text box search, no input.
User interface - tag text box search, no input.

Pulldown Based Tag Filters

If you specify a list of pre-selected tags in the admin panel, the user is restricted to only the items on the pulldown list to filter their results. You can check off the "any" box on the admin panel to add a selection to search all locations with no tag filter.

User interface - tag pulldown, show any location.
A search in NY 10009 zip code with any location shown (no tag filter).

user interface - tag pulldown, filtered to red locations.
The same search in NY 10009 zip code showing only locations tagged with "red".

Related Documentation

Using tag qualifiers on the shortcode
Replace tag text with icons

Screen Shots

tag_pulldown_settings.png - Tag pulldown settings. (31.6 kB) Lance Cleveland, 03/03/2011 09:55 pm

tag_settings2.png - Admin panel - tag settings. (17.1 kB) Lance Cleveland, 03/03/2011 10:09 pm

user_tag_search.png - User interface - tag text box search.df (75.8 kB) Lance Cleveland, 03/03/2011 10:57 pm

user_tag_search_blank.png - User interface - tag text box search, no input. (78.4 kB) Lance Cleveland, 03/03/2011 10:57 pm

user_tag_pulldown_selection_anywithzip.png - User interface - tag pulldown, show any location. (79.8 kB) Lance Cleveland, 03/03/2011 10:57 pm

user_tag_pulldown_selection_redwithzip.png - user interface - tag pulldown, filtered to red locations. (86.8 kB) Lance Cleveland, 03/03/2011 10:57 pm