Multiple Locations

The Multiple Locations extension makes it possible to add multiple locations to the GEO my WP's objects. Objects are post types ( when using the Posts Locator core extension ), BuddyPress members ( when using the Members Locator core extension ), BuddyPress Groups ( when using the BP Groups Locator premium extension ), and WordPress ( Users when using the WordPress Users Locator premium extension ).

The Multiple Locations extension replaces the default Location form provided by GEO my WP with a Locations dashboard that makes it easy to manage an object's locations. The dashboard displays all the locations of a specific object, and users can use it to add, edit, and delete their locations.

When searching for locations using GEO my WP's search forms, GEO my WP will search and display all the different locations of each object.

Requirements

Compatibility

The Multiple Locations extension is compatible with the core extensions and with the premium extensions listed below ( the premium extensions listed below are not included when purchasing the Multiple Locations extension and can to be purchased separately ):

Multiple Locations Key Features

Manage Multiple Locations

Add multiple locations to GEO my WP's object which can then be searched and found using GEO my WP's search forms and maps.

Locations Dashboard

Using the Locations dashboard you can easily add, edit, and delete the locations of a specific object. The dashboard can be placed on any page of your site using a shortcode.

Locations Dashboard Button

Use a shortcode to display a button that will redirect the user to a specific Locations Dashboard. You can use this shortcode in the content area of any page, and you can place it in a single template file so the logged-in user will see it when visiting his posts in the front-end of your site.

Single Object Locations shortcode

Display the locations of a specific object anywhere on your site using a shortcode.

Single Object Location Shortcode

IP Address Locator

Please note that the IP Address Locator extension uses 3rd-party IP Address Lookup providers that might require you to register on their site, pay for their services, and might require a token/API key. Please verify the official website of the supported providers mentioned below for more information regarding their services and requirements before purchasing this extension.
Please note that the accuracy and availability of the current location returned by this extension depend solely on the services provided by the IP Address provider that you choose to use, and GEO my WP has no control over it. Please check the official website of the supported providers mentioned below for more information regarding the accuracy of their services.

Using the IP Address Locator extension, GEO my WP can use its auto-locator feature to retrieve the user's current location based on his/her IP address rather than using the browser's geolocation feature.

GEO my WP's auto-locator feature takes place in 2 scenarios:

  1. When a user first visits the site and GEO my WP tries to retrieve his/her current location automatically.
  2. When the user clicks the locator button of the different elements of GEO my WP, such as the search forms.

You can set the IP Address Locator extension to use the IP address instead of the browser's geolocation in both scenarios mentioned above or only in one of them.

IP Address Providers

The IP Address Locator extension relies on a 3rd-party IP address lookup provider when retrieving the user's location.

There are different IP address providers out there, and at the moment, the IP Address Locator extension supports four different IP address providers that you could choose from.

Listed below are the IP Address Lookup providers that are currently supported by the IP Address Locator extension:

Additional providers might be added in the future.

Please note that each provider offers different plans ( free and/or paid ), might require you to register on their site and/or generate a token/API key, and the accuracy of the location might differ between the different providers.

Please visit the site of each provider for more information before purchasing the extension.

Should I use the IP Address Locator Extension?

One advantage you might find in using the IP address Locator is that it does not require the user's permission when retrieving his current location. Unlike the browser's geolocation feature that asks for the user's permission before it can retrieve his/her location.

On the other hand, the location retrieved by the IP Address Locator might be less accurate than the location retrieved by the browser's geolocation. The accuracy depends solely on the IP Address providers, and the plugin has no control over it.
Moreover, depends on the provider that you choose to use, you might need to sign-up and/or pay for its services.

Radius Per Location

Using the Radius Per Location extension, you can set a specific maximum radius value for each location on your site, preventing those locations from showing in the search results when outside that range.

For example, a visitor on your site searches for locations within 20 miles from "Manhattan, New York". By default, GEO my WP will search and display all the locations that it could find within that range.

If a specific location is 18 miles away from Manhattan, New York, that location will show in the search results by default. However, if that location has a maximum radius value set to 15 miles, it will no longer show in the search results, even though it is within the 20 miles radius value of the search form.

The Radius Per Location extension can be extremely useful when one needs to limit the radius of service providers, such as delivery services, shipping services, professional services, and others. GEO my WP's search result will then be more accurate and will prevent the visitors of your site from seeing results that might not be relevant to them.

Requirements

Compatibility

The Radius Per Location extension is compatible with the core extensions and with the premium extensions listed below ( which are not included when purchasing the Radius Per Location extension and can be purchased separately ):

Radius Per Location Key Features

After installing and activating the Radius Per Location extension, a new "Service Radius" tab will be added to the location form of GEO my WP. Using this tab, you can set the maximum radius when creating or updating a location.

Service Radius Location form tab

Service Radius tab

AJAX Forms

Using the AJAX Forms extension, you can use GEO my WP's forms builder to create AJAX-powered search forms. The AJAX forms are processed and displayed instantly and without reloading the page, providing a smoother user experience for your site.

Checkout the live demo to see how it works.

Requierments

Compatibility

AJAX Form is also compatible with the premium extensions listed below:

AJAX Forms Key Features

Creating AJAX Forms is as simple as creating any other forms using GEO my WP forms builder. Create a new AJAX form, set up the different options, and enter the AJAX form shortcode anywhere on the page where you wish to display it.

Most of the AJAX form settings are the same as the settings provided in the "Normal" forms ( Posts Locator, Members Locator... ). In the screenshots below, you can see the different tabs and settings of the AJAX forms.

Additional Key Features

Described below are the settings that are unique to the AJAX form and are not included in the "Normal" forms.

Order-by Filter

Set a default order-by value, or display an order-by drop-down menu in the search results to allow users to order the list of results.

You can set a default order-by value when the page first loads ( Page Load Results tab ), a default value when the form is first submitted ( Form Submission tag ), and generate an order-by drop-down menu to order the results after form submission.

The order-by options are:

Load More Button / Pagination

Choose between the standard numeric pagination or a load more button to load more results.

Marker Clusters

Use marker marker clusters to group markers that are on the same exact location or very close by on the map.

AJAX powered Info-window

The details of each location on the map is displayed using the information window ( info-window ). The info-window opens with a click on a map marker, and the data of the info-window generated via AJAX.

Nearby Locations

The Nearby Locations extension provides an easy solution to display nearby locations anywhere on a page or sidebars using its shortcode and widget. Locations, which are also referred to as "objects", can be posts ( requires the Posts Locator core extension ), BuddyPress members ( requires the Members Locator core extension ), and others, when provided by additional extensions.

Nearby Locations results can get 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 was 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 available, and at the moment, the only item type available is "posts". I released this add-on before the item "members" was ready due to user requests who have been waiting for the release of the add-on. I will be working on the item type "Members" and, hopefully, 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 select 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:

  1. 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.
  2. 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.
  3. 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.
  4. 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?

Nearby Locations Key Features

Display Nearby Locations

Display location nearby by the visitor's location, a specific item ID, an item being viewd and specific coordinates.

Nearby Locations

Nearby Locations

Nearby Locations on Google Map

Show nearby location on Google Map. You can set the map height, map width, and map type.

Results Template File

Choose between different results template files. Currently, there are 3 template files 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.

Nearby Posts Settings

List of settings you can use when showing posts locations; when the item type is set to "posts".

Global Maps

Use GEO my WP forms builder to create advanced mashup maps with or without an AJAX-powered search form. You may set up your maps to display locations on page load then filter the locations using the search form. See the live demo.

Requierments

Global Maps Key Features

Most of the features below work with Posts Locator core extension, Buddypress Members Locator core extension, Buddypress Groups Locator premium extension, and WordPress Users Locator premium extension. If a feature can be applied to only a specific extension, it will be mentioned in the feature description.

Create Mashup Map

Creating a mashup map is as simple as creating any other form using GEO my WP forms builder. Create Global Map form, set up the different options, and enter the global map shortcode [gmw_global_map form="form ID"] on the page where you wish to display the map.

AJAX Powered Search Form

The maps created with the Global Maps extension are mashup maps, that not only show locations when the page first loads, but you can also display a search form that can search and filter the locations on the map. The search form uses AJAX to filter the locations, which makes it a smooth and pleasant experience for the user.

The extension provides a few search form template files to choose from. However, you can create your custom template files and use them with the map ( this requires a level of development skill ).

You can choose the search form template file in the form editor, along with the rest of the filters that available for the search form. Filters like address field, radius, units, categories, and more.

Once the map is loaded, the search form "floats" within the boundaries of the map, and can be dragged within the boundaries by the user ( using the mouse ). Some forms can also be collapsed and expanded.

AJAX powered Info-window

The details of each location on the map is displayed using the information window ( info-window ). The info-window opens with a click on a map marker, and the data of the info-window generated via AJAX.

  1. Easily Create unlimited Posts Global Maps and Members Global Maps using the form builder.
  2. Create map displaying any or all of your post types
  3. Create maps displaying Buddypress members
  4. Display unlimited maps on a single page using shortcode or in the sidebar using a widget.
  5. Exclude posts from the map by Taxonomies
  6. Set a radius to display results within when the user's current location is available.
  7. Display distance in Miles or Kilometer.
  8. Set the height, width and map type.
  9. Choose to auto zoom the map to fit all the marker within it or choose the zoom level if you want to to have a closer zoom on the marker that represent the user's current location (when available).
  10. Front-end filter menu allow users to filter markers based on post types using checkboxes ( for Posts Global Map only )
  11. Choose map controls: zoom, pan, scale, map type, street view, overview and scroll-wheel
  12. Marker Clustere to groups near by markers
  13. Choose between in-map info window or a pop-up HTML window that will display the marker's information
  14. Ajax powered marker's info window. Allows you to easily edit the content displayed in the info window by editing the php template file
  15. Display single or multiple post types on a map (post types add-on).
  16. Additional Settings being added when using the Premium Settings add-on

Exclude Posts by Taxonomies

When creating a Posts Global Map you will have the option to exclude certain posts by taxonomies. All you will need to do is entered the taxonomy terms ID that you would like to exclude.

Post types Menu Filter

Using this feature, users will be able to filter the markers on the map based on post types. When setting up the map you can choose which post types you want to include in the filters menu. The filters menu will be available on the bottom left side of the map with checkboxes for each of the post types that you choose. Using the checkboxes users will be able to filter the marker on the map.

Premium Settings

The Premium Settings extension provides additional features and settings to GEO my WP forms builder, enhancing the search forms of your site, by providing more options and filters for your users, when searching for locations.

Compatability

Listed below are the extensions that are compatible with the Premium Settings:

Premium Settings Key Features

The Premium Settings features apply to Posts Locator forms, WordPress Users Locator forms, BuddyPress Members Locator forms, and BuddyPress Groups Locator forms. This also applies to forms generated by the Global Maps and AJAX Forms extensions.

If a specific feature applies only to a specific component, an extension, or a form type only, it will be mentioned in the features description.

The Premium Settings features are listed below. Following the list, you can find a short description and screenshots for each feature.

Premium Settings Features Description

Keywords Search

Add additional keywords input text box to your search forms.

In the form editor, you can enable/disable the keywords input textbox, enter a label, and/or a placeholder.

The keywords usage is different between the different form types:

Radius Slider

Display a radius slider in the front-end search form, instead of a drop-down menu.

In the form editor, you can enable/disable the slider, choose the default value, min value, and max value of the slider.

Order-by Search Results

Set a default order-by value, or display an order-by drop-down menu in the search results to allow users to order the list of results.

You can set a default order-by value when the page first loads ( Page Load Results tab ), a default value when the form is first submitted ( Form Submission tag ), and generate an order-by drop-down menu to order the results after form submission.

The order-by options are:

Custom Results Message

Generate custom search result message using placeholders like from_count, to_count, total_results, and more. The results message has 2 parts: the count message and the radius message, and you can modify both via the form editor.

For example, you can use something like "Showing {from_count} - {to_count} of {total_results} locations" to display the results message "showing 1 - 5 of 15 locations".

Form editor results message setting.

Form editor search result message setting.

Custom No Results Message

Generate custom no results message instead of the default message. You can also generate 2 links in the message, one link that will re-submit the form with a larger radius value that you set in the form editor, and another link that will re-submit the form and show all locations.

Maximum Zoom Level

Set the maximum zoom level of the map to limit how far one can zoom into the map markers. The value can be between 1 to 20.

This feature can be useful for privacy purposes, preventing users from zooming in and seeing the exact location of the marker.

Map Controls

Choose the map controls which you would like to enable.

The map controls available for both Google Maps and LeafLet are Zoom control, Resize Map, and Scrollwheel zoom.

The map controls available for Google Maps only are: map type, rotate control, scale, street view, and Overview.

Map Controls options

Map Styles

Apply custom styles to your maps using your custom styles, or use Snazzy Maps styles ( requires the Snazzy Maps plugin ).

This feature is available with Google Maps provider only.

Search Results Address Fields

By default, GEO my WP displays the full address in each item in the list of results. With the Premium Settings extension, you can choose which address fields to display.

The "Address Fields" option is added to the Search Results tab of the form editor.

Form editor address fields option.

Form editor address fields option.

Markers Grouping

Use marker grouping methods to group markers that are on the same exact location or very close by on the map. You can choose between marker clusters or marker spiderfier.

Custom Map Marker Icons

Use different icons in GEO my WP forms to display the different locations on the map. You can choose different icons for each of your forms.
The Premium Settings extension provides icons that you can use out of the box, and you can upload custom icons ( only PNG files at the moment ) using FTP access.

The similar options for all form types are:

  1. Display a custom map icon for the location that represents the user's location on the map.
  2. Display different map icons for the different locations found in the search results.
  3. Set custom height and width ( in pixels ) for the map icons.

Listed below are the different map icons options for the different forms/components:

Posts Locator Component

WordPress Users Locator Component

BuddyPress Members Locator Component

BuddyPress Groups Locator Component

AJAX powered Info-window

The details of each location on the map are displayed using the information window ( info-window ). The info window opens with a click on a map marker, and you can choose to generate the data of the info window via AJAX.

This document is not completed and some more features should be added to it.