Documentation /

Store Locator Documentation

Installing the Plugin

To install the plugin:

  • Download the free plugin zip from our Plugins page.
    • Note: Some browsers (e.g. Safari) may auto-extract ZIP files. Right-clicking on the download link and selecting "Save Linked File As" will allow you to download the ZIP version.
  • Then go to your WP Admin > Plugins > Add New > Upload Plugin
  • Now upload the plugin zip file and click "Install Now".
  • After the plugin is installed, click "Activate Plugin" to activate the plugin.

install-plugin

FYI: If you can't install the plugin using WordPress plugin installer, you may also use a FTP software to install the plugin. To install plugins with an FTP method: extract the plugin zip on your local computer then upload the plugin folder to your FTP server where you installed WordPress > wp-content > plugins folder. After, login to your WP Admin > Plugins to activate the plugin.

Developed by Themify, Store Locator is a simple plugin that allows you to display an unlimited number of locations on a map, list, or grid view.

Using the Store Locator

Once you activate the plugin, you will see, a "Store Location" on the WP-admin sidebar. Follow the steps below to add your store locations on any page/post. (NOTE: you need at least one location in order to display the location/map):

Step 1: Add New Locations

Add a new location

  • To add a location, go to your WP Admin > Store Locations > Click on "Add New"
  • Enter the following options:
    • Post Title - Store location title
    • Content Editor - Will be used as the location description
    • On the Themify Custom Panel (scroll down to view), enter the following:
      1. Store Address - Location address
      2. Contact Info - Custom label and number of store location (ie. for phone, fax, mobile numbers)
      3. Business Hours - Input days of operation with open and closing times

Step 2: To Display Locations

Text editor location icon

  • Add or edit an existing page
  • On the text editor, click on the Store Locator shortcode generator (the location icon in the red box above), and select how you would like to show your locations:
    • "Store Map" - To show a map with all your locations as map with map markers
    • "Store List" - To show your locations in a list form
  • Input the parameters (read shortcodes for mode detail) on the popup lightbox to generate the shortcode. Once you click OK, it will generate a shortcode in the editor (TIPS: You can copy & paste the shortcode to display elsewhere like a sidebar Text widget).

Shortcodes

Map View Shortcode

[tsl_map width="100%" height="500px" map_controls="yes" scrollwheel="no" mobile_draggable="no"]

  • width - Input the width of the map in px or %
  • height - Input the height of the map in px or %
  • map_controls - This allows you to enable or disable the map controls that appear on the left side of the map
  • scrollwheel - Enable or disable the ability for users to zoom in and out of your map by scrolling either up or down
  • mobile_draggable - Enable or disable the ability for users to drag your map on mobile

Store List Shortcode

[tsl_stores posts_per_page="8"  layout="grid4" hours="yes" contact="yes" description="no" unlink_title="no" pagination="yes" orderby="title" order="asc"]

  • post_per_page - Input # of posts that will appear on the list
  • layout - Select list layout: Fullwidth, Grid 4, 3, 2
  • contact - Show or hide contact field
  • hours - Show or hide hours field
  • description - Show or hide description field
  • feature_image - Show or hide featured image of each post
  • unlink_title - Link or unlink the post title to single post
  • pagination - Show or hide pagination
  • order = specifies ascendent or descendent order (ASC, DES, default = DES)
  • orderby = criteria used to order posts (author, comment_count, date, menu_order, rand, title, default = date)

Reinstall Plugin

In the event there are issues/bugs with the plugin or you can't auto update the plugin, try to reinstall it with the latest version. Since WP 5.9, you can reinstall plugins by re-uploading the plugin zip. Reinstalling the plugin shouldn't affect the content/data because they are saved separately in the database. To be safe, you should backup your WordPress site before reinstalling it.

To reinstall a plugin:

  • Download the latest plugin zip
  • Go your site WP Admin > Plugins > Add new
  • Then upload the new plugin zip and WordPress will ask if you want to replace the current version, click "Replace current with uploaded"

Themify 7.5 has released! Please read the update notes.