Nearby Locations add-on provides an easy solution to display nearby locations anywhere on a page or sidebars using its shortcode and widget. Locations, which referred to as “object”, can be posts ( requires the Posts Locator core extension ), BuddyPress members ( requires the Members Locator core extension ) and others, if provided by additional extensions.
Nearby Locations results can be displayed as a list of locations showing the title, distance, directions link and more. As well you can choose to display the locations on a Google map.
Please note, it is mentioned in the plugin’s description and the documentation that the item type “members” is available with the add-on out of the box. However, the item type “members” is not yet ready and at the moment the only item type available is “posts”. I released the add-on before the item “members” is ready due to many user requests that have been waiting for the release of the add-on. I will be working on the item type “members” and it will be available in the next release of the plugin.
How does it work?
Nearby Locations add-on provides a shortcode
[gmw_nearby_locations] and a widget that you used on any page and sidebar. The shortcode provides a list of attributes that you can use, and the widget comes with its settings.
There are many features that you can set with the shortcode and the widget; You can set the “item” type ( posts, members and so on ) that you would like to display. You can also set the radius, the number of results to display, units ( Miles or Kilometers ), show/hide map and more.
Nearby Locations will search for locations based on the “nearby” point that you choose. There are 4 “nearby” points that you can choose from:
- user – show locations nearby the visitor’s current position. To do that the plugin will look for the visitor’s location (visitors can find their current position using the “Current Location” shortcode/widget ) and search for locations based on that.
- item ID – show locations nearby a specific item ID. For example, you can enter a specific Post ID to display other posts near the post that you chose.
- item – show locations nearby the displayed item when viewing in a single item page. For example, when viewing a specific post ( in a single post page ) the plugin will display other locations ( posts ) nearby this post.
- coordinates – Enter a set of coordinates ( latitude,longitude ) to display locations nearby a specific point on earth.
If the plugin could not find locations nearby the point you set you can choose to display random locations.
What is required?
- WordPress 4.3 or higher
- Nearby Locations add-on.
- GEO my WP plugin version 2.6 or higher.
- BuddyPress plugin version 2.3 or higher.
Nearby Locations Key Features
Nearby Locations on Google Map
Show nearby location on Google Map. You can set the map height, map width and the map type.
Results Template File
Choose between different results template files. Currently there are 3 template file you can choose from: Default, LightCoral or LightSeaGreen.
Nearby locations widget
Display nearby locations in any of the sidebars of your theme using the Nearby Locations widget.
Nearby Locations Settings
List of global settings provided by the plugin that you can use with all of the “item” types. Remember, an item can be posts, members and so on.
- item type – set the locations item type: “posts” for post types or “members” for BuddyPress members.
- Nearby – choose between user, item, item ID or coordinates.
- Radius – set the radius to search within from the nearby point
- Units – search by Miles or Kilometer
- Results count – Set the number or location that you would like to display
- Oreder-by – Set the order of the results
- Order – Choose the ordering direction of the list of results between ascending or descending.
- Google map – show or hide Google Map
- Map height – Set the map height in pixels or percentage ( ex. 250px or 100% ).
- Map width – Set the map width in pixels or percentage ( ex. 250px or 100% ).
- Map type – choose between ROADMAP, SATELLITE, HYBRID or TERRAIN.
- Show/hide list of locations – you can hide the list of locations. That is useful in case that you want to only show the map.
- Group markers – you can group nearby map markers using Markers Clusters.
- Show distance – show the distance to each location in the list of results.
- Show image – show the location’s image if exists.
- Address Field – the address fields that you’d like to show for each location in the list of results.
- Get directions – show “get directions” link for each location in the list of results.
- Show random locations if no nearby locations were found
- No Results message – choose the “no results” message that you’d like to show when no nearby locations were found ( when random locations set to false )
Nearby Posts Settings
List of settings you can use when showing posts locations; when the item type is set to “posts”.
- Post types – choose a single or multiple post types
- Include/exclude taxonomy terms – filter posts by including or excluding specific taxonomy term ID’s.