FAQ

If you have questions that are not answered here please use the contact form.

What are the plugin's system requirements?

PHP 5.3+, MySQL 5+ and WordPress 4.1+. Using the latest version of WordPress is highly recommended. Support requests from customers on older versions of the requirements listed above will be very limited and/or not supported.

Why isn't anything displaying after adding a location and the shortcode to a page?

If nothing is displaying after adding the shortcode to a page or post and you’ve added at least one location, try deactivating and reactivating the plugin to clear the location data transient.

Can I use the plugin without showing a map?

No, according to Google’s TOS: “The Geocoding API may only be used in conjunction with a Google map; geocoding results without displaying them on a map is prohibited.” The Geocoding API is used in this plugin to get the latitude and logitude of the address or zip code entered in the input field by a user.

Are locations added using a custom post type automatically geocoded?

Yes, if you’re adding or updating a location using the built-in locations custom post type or another custom post type specified in the plugin settings, Cardinal Store Locator will attempt to automatically geocode the location if you’re connected to the internet. You can check the post’s custom fields for “bh_storelocator_location_lat” and “bh_storelocator_location_lng” to see if the geocoding request was successful.

Are imported locations automatically geocoded?

No, if you have existing location data with locations that haven’t been geocoded and are importing to a custom post type or are using KML, XML or JSON the locations need to be geocoded prior to being used with the plugin. A background geocoding task will potentially be added in a future version.

Does the plugin have a built-in location import functionality?

Not at this time but it is in development. Because Cardinal Store Locator can pull data from WordPress custom post types you can use an existing WordPress import tool such as WP All Import or create your own import script or XML file without too much trouble. Meta fields for address information and coordinates can be mapped within the plugin settings when using a custom post type. If you have a data set you need imported please send an email for further information. Assistance will be provided to license holders and a WordPress import file can potentially be generated for you depending on the current format of the location data until import functionality is completed in the plugin.

Can the location list items and map info windows be overridden?

Yes, the plugin checks for the existence of a cardinal-locator directory within the site’s active theme and checks for infowindow-description.html and location-list-description.html to override the defaults. If you’re using KML location data you should use kml-infowindow-description.html and kml-location-list-description.html instead. If you’re using a custom post types a list of available data attributes available can be found in the plugin documentation. If you’re using XML or JSON the Handlebars expression just has to match the attribute in your data.

Why aren't my imported locations showing up in the locator?

By default all the location data is saved as a WordPress transient. If your imported locations aren’t showing up in the locator you may need to delete this transient. This can be done by deactivating and reactivating the plugin or by using the Transients Manager plugin. The transient is named bh_sl_locations.

How does the plugin handle lots of locations?

By default, the plugin stores all locations in a WordPress transient. If you have more than 1,000 locations there is a setting under the Primary Settings tab that enables a different technique for searching. It works by setting up a custom, indexed database table of all the location coordinates along with the related location post ID. The data is inserted when a new location post is added or updated and there’s also a method that hooks into the WordPress Importer plugin if you’re setting up a custom XML import and have the latitude and longitude meta keys set up.

Can location coordinates be overridden?

Yes, if the coordinates that Google returns aren’t accurate enough for one or more of your locations the latitude and longitude can be overridden with custom fields. Use ‘latitude’ as the meta key name for the latitude and ‘longitude’ for the meta key name for the longitude.

What is the name of the default custom post type?

By default, the plugin registers a custom post type named ‘bh_sl_locations’ so if you’re wanting to create a custom single template for locations, for example, you’d want to name the single template file single-bh_sl_locations.php

Automatic update isn't working, how can I get the latest version?

If the automatic update is failing first try deactivating and reactivating the license key and running the update again. This is especially true if your domain has changed. If it’s still not working you can download the plugin by logging into your account. Email support@cardinalwp.com if you don’t have an account or need your credentials reset.

Are there any known compatibility issues?

There are a couple of things to be aware of when using Cardinal Store Locator with other plugins and pre-built themes.

  • Themify themes handle 404s in a method that’s different form WordPress core. If you’re seeing 404s on every page when using Cardinal Store Locator and a Themify theme, please add at least one location and the issue should go away.
  • The Toolset Views/Google Maps plugins enqueue Google Maps with the same handle as Cardinal Store Locator. If you’re using both plugins make sure you include the Google Maps API key in the Toolset settings.
  • CForm Builder seems to override all Google Maps includes so be sure to add your Google Maps API Key under CForm Builder > Global Options.
Are discount available for nonprofits, charities, etc.?

Yes, on a case by case basis direct purchases from these types of organizations are eligible for a discounted license price. Please email support@cardinalwp.com for more information.

Are refunds available?

Yes, if you’re not satisfied for any reason or run into an issue that’s not solvable via a support request within a reasonable amount of time, a refund is available within the first 30 days from the original purchase date. Refunds are only available for the original purchase license and not renewals. Please refer to the Terms and Conditions for more details.