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.

WordPress Users Locator

WordPress Users Locator extension is a mapping and proximity search solution for WordPress users. With the extension, the users of your site will be able to easily add a location to their profile, and search and find other users based on location using GEO my WP proximity search forms

WordPress Users Locator Key Features

Add Location To WordPress Users

Using the advanced Location form of GEO my WP, the users of your site will be able to easily add a location to their profile. The location form provides a few ways for a user to add a location:

The location form makes it easy and as accurate as it can get when adding or updating a location. The form exists in the admin's user profile page, and you can add it to any page in the front-end using the shortcode [gmw_user_location_form]

 

Users Locator Proximity Search Form

WordPress Users Locator extension enables the Users Locator search form in GEO my WP forms builder. You will be able to create unlimited maps and a proximity search form that searches and find WordPress users based on address, radius, and other parameters.

Creating WordPress Users Locator form is a simple task when using the form builder, the same way as creating Posts Locator or Members Locator search forms.

The form builder comes with 5 tabs out of the box, each contains various options:

You can create unlimited forms, and defined each differently. You can place the forms anywhere and on any page using a shortcode or a widget.

 

User Location Shortcode

With the User Location shortcode [gmw_user_location] you can display the location details of a specific user anywhere on a page. You can display a map, address, and get directions link. Using the shortcode attributes you can set the map height and widget, map type, and zoom level.

Single user location

Custom User / Author Location Page

Setup a custom page that will serve as the user's / author's page. Users will usually navigate to this page when clicking on a user in the list of results when searching for users using the Users Locator form.

This page displays the user's location the same way as the shortcode [gmw_user_location] does. This way users can see the location details of a specific user from the search results.

Using the admin's settings, you have few options to set the User Location page:

Along with any of the options above, you can also pass some URL parameters when navigating to the user location page. You can pass the user ID, username, email, and nicename.

This option can be powerful, especially when using another plugin that uses its user profile page. Some membership plugins, for example, provide such a profile page. In this case, you can set the user location page to link to the profile page of the membership plugin, and pass the user ID as a URL parameter if needed.

This way you can set the Users Locator form to navigate to the profile page of the membership plugin when clicking on a user in the list of results.

 

Available Shortcodes

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.

Exclude Locations

When using the Exclude Locations extension, you can easily exclude and include locations from search results based on different parameters; post authors, user roles, user ID, members types, BuddyPress groups, and more. Limit any of your GEO my WP forms to view specific posts, Buddypress members, BuddyPress groups, and WordPress Users, using pre-defined options.

How It Works

The Exclude Locations extension extends GEO my WP form editor with additional "Exclude Locations" tab, where the new options to include and exclude locations can be managed. This way, you can easily define and exclude locations in each of your forms differently and based on your needs.

Exclude Locations Key Features

Listed here are the main features of the Exclude Locations features. These features apply to some of GEO my WP's core extensions and some premium extensions.

Exclude Posts

Exclude posts from the different Posts Locator forms. The "Exclude Posts" settings tab will be added to GEO my WP form editor with the options listed below.

Exclude Posts Settings

Options
Compatibility

Exclude Buddypress Members

Exclude Buddypress members from the different Members Locator forms. The "Exclude Members" tab will be added to GEO my WP form editor with the options listed below.

Options
Compatibility

Exclude Buddypress Groups

This features is availabe only when the Groups Locator premium extension is installed and activated.

Exclude Buddypress groups from the different Groups Locator forms. The "Exclude Groups" tab will be added to GEO my WP form editor with the options listed below.

Exclude BuddyPress Groups Settings

Options
Compatibility

Exclude WordPress Users

This features is availabe only when the WordPress Users Locator premium extension is installed and activated.

Exclude WordPress users from the different WordPress Users Locator forms. The "Exclude Users" tab will be added to GEO my WP form editor with the options listed below.

Exclude Users Settings

Options
Compatibility

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.