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.

Kleo Geolocation

With Kleo Geolocation extension you can provide your visitors with a mapping and proximity search feature for the Members and Groups Directory page of the Kleo theme developed by Seventh Queen.

Kleo Theme

"You no longer need to be a professional developer or designer to create an awesome website. Easily create a stunning community, company presentation, mobile website or membership website. Create the site of your dreams now.
KLEO is compatible with latest versions of WordPress 4.3 & BuddyPress 2.3"

What Does Kleo Geolocation Do?

The extension enhances the functionality of the Members and Groups Directory page of the Kleo theme with geolocation, mapping, and proximity search features.

When using the Members and Groups Directory page by default, you can only search for members or Groups by name. With Kleo Geolocation extension you can also search for members and groups based on address, distance, and units. The search results can be ordered by distance and you can choose to display a Google map showing the members' or group's location.

How does it work?

After activating and settings up the extension, all the geolocation features will be dynamically applied to the Members and Groups Directory pages dynamically. No additional code is required.

Kleo Geolocation extension uses the address and radius entered in the search form to perform a proximity search query, and return nearby members or groups. When the search form is submitted, the extension geocodes the address, and search for members or groups based on their location ( latitude and longitude ), which is saved in the database. The results are accurate, can be sorted by distance, and can be displayed on Google map.

What's required?

Kleo Geolocation Key Features

All the features described below can be applied to any or both the Members and Groups Directory pages of the Kleo theme.

To enable the features on the Members Directory page you need to have the Members Locator core extension activated ( free extension included in GEO my WP core plugin ).

To enable the geolocation features in the Groups Directory page, the BuddyPress Groups Locator premium extension is required.

Geolocation And Proximity Search

Search for BuddyPress groups or members based on location. Enter an address, radius, and units, and see results nearby. The list of results can be sorted by distance and can be displayed on Google map.

Proximity Search Results

Google Address Autocomplete

Enable Google Places address autocomplete to display live suggested results while typing an address.

Address autocomplete

Locator Button

Enable the Locator button inside the address field to help visitor to find their location automatically.

Select Radius

Set a default radius value, or let the visitors choose by enabling a dropdown select box with multiple radius values.

Filter result by radius

Radius filter

Distance Units

Set a default value as miles or kilometers, or let the visitors choose using a dropdown select box.

Filter result by units

Units select menu

Sort Results by Distance

When searching for groups or members using an address, the visitor can order the list of results by distance. This way they can see which members or groups are nearest to their location.

Sort result by distance

Distance select menu

Show Results On Google Map

Enable Google Maps to show the location of the members or groups found in search results. Click on a map marker that will open an info window showing details of that member or group.

You can set the height and width of the map, select the map type and the zoom level.

You can choose to display the map above the list of results, or anywhere else on the page using the shortcode.

Google Map

Marker Cluster

Group map markers together when too close to each other to easily view them.

Markers Cluster

Show Location Details In Results

Display the address, distance, and "get directions" link for each member or group in the list of results.

Showing distance, address, and directions link

Easy Setup

Easily set up the geolocation features via GEO my WP admin's settings page.

Buddypress Groups Locator

Using the BuddyPress Groups Locator extension, you can geotag BuddyPress' groups and create advanced proximity search forms that will search and find those groups based on location and distance.

You can add a location while creating a new group, and you can update the location from the admin tab of the group. Once the Groups Locator add-on is activated, a new search form type "BP Groups" will be available in the "Search Forms" page of GEO my WP.

Groups Locator key features

  1. Add location while creating a new group
  2. Add or update the location after a groups was created from the admin tab of a group
  3. Add location to a group using single address field or multiple address fields
  4. Google's address autocomplete when using single address field
  5. A new "location" tab will be added to the group menu and will display a map and the address of the group
  6. Option to display a map and the locations of all the group's members in the "Members" tab of the group
  7. Create and advance proximity search forms that will search for groups that have location

Group's admin tab settings

  1. Address field - single with Google autocomplete or multiple address field that you can choose

Group's location tab settings

  1. Map size - width and height in pixels or percentage
  2. Map type - ROADMAP, SATELLITE, HYBRID, TERRAIN

Group's members tab settings

  1. Map size - width and height in pixels or percentage
  2. Map type - ROADMAP, SATELLITE, HYBRID, TERRAIN
  3. Display address of each member in the results

Search forms settings

  1. Address Field title ( can be set to be mandatory field)
  2. Radius values - single, default value or multiple values to be used as a dropdown
  3. Units - Miles, Kilometers or both ( as dropdown)
  4. Choose locator icon
  5. Results page - same page or a different page
  6. Display results as lists of posts, Map or both
  7. Results per page - single, default value or multiple values as dropdown
  8. Show address
  9. Driving distance
  10. "Get direction" link
  11. Map - Width and height in pixels or percentage
  12. Map type - ROADMAP, SATELLITE, HYBRID, TERRAIN

Admin's Dashboard

Front end

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.

Buddypress Members Directory Geolocation

BuddyPress Members Directory Geolocation extension enhances the BuddyPress Members Directory page with geolocation features and proximity search queries. The visitors of your site will be able to search and find other members based on location and distance, directly from the Members Directory page of your site.

The Buddypress Members Directory Geolocation extension might not work with themes that use a custom Members Directory page, like the Sweet-date or Kleo themes. Please contact us before making a purchase if you are not sure about the theme that you are using.

Buddypress Members Directory Geolocation Key Features

  1. Perfome proximity search query to search and find members based on location and disatnce.
  2. Add address field to the search form of the Members Directory page to search for members based on location.
  3. Address autocomplete to display live suggested results while the user is typing an address.
  4. Locator button to auto-detect the user's current location.
  5. Add Radius dropdown select box to the search form so users to choose how far to search for other members.
  6. Distance units - choose between Miles or Kilometers.
  7. Display dropdown select box of either states or countries to find members.
  8. Add distance item to the "order by" dropdown select box of the Members Directory to order the list of memebrs by the distance.
  9. Display Google map above the list of results showing the members location.
  10. Set the map height and width.
  11. Select the map type between Roadmap, Satellite, Hybrid or Terrain.
  12. Show the address of each member in the list of results
  13. Show the Distance to each member in the list of results
  14. Show Get Directions link in each member in the list of results, that will open a new page showing Google map and driving directions.

Proximity Search Query

The visitors of your site can search and find other members based on address and distance.

Google Places Address Autocomplete

Displaying suggested results while typing an address makes it easier and faster for the visitor to find an accurate address.

Locator Button

Make it easier for the visitors to detect their current location by adding the locator button inside the address field.

Quick Filters

The plugin provides the States and Countries filters, and the visitors of your site can easily find other members in a specific state or a country. That is, instead of searching for members nearby by specific address.

Order By Distance

Visitors can sort the list of members by distance to see who is in the nearest.

Google Map

Make it easier to see members' locations with a Google map above the list of members.

Additional information

When setting up the extension, you can set it up to display the address of each member in the search results, the distance to the member, and a "Get directions" ( will open a new page with a Google map showing the driving direction from the member to the address entered in the search form ).

Easy Setup

Settings up the extension and enabling the geolocation features is a simple process. You manage it all from the Settings page of GEO my WP. Once set up, the geolocation features will enable on the Members Directory page of your theme. No extra code is needed.

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

Buddypress Xprofile Geolocation

The Buddypress Xprofile Geolocation extension provides integration between the Buddypress' Extended Profile component and GEO my WP. Using the extension, the members of your site can add and update their location using their BuddyPress Member Profile page That's is instead of, or in addition to the Location tab, that is generated by GEO my WP.

With the Buddypress Xprofile Geolocation extension, new members can add a location during registration as well.

How It Works

Once Buddypress Xprofile Geolocation is set up, and profile fields are linked to GEO my WP, each time a member adds or updates a location, this location will be synced with GEO my WP.

When an address is updated by a member using BuddyPress' xprofile fields, GEO my WP geocodes the address and saves the location data in GEO my WP locations table in the database. This is what makes members' location searchable when using GEO my WP forms and mashup maps.

Please note that locations entered previously the installation of Buddypress Xprofile Geolocation will not be recognized by GEO my WP. The members of your site, or you as the admin, will need to update their location after the installation of the extension to sync it with GEO my WP.

Buddypress Xprofile Geolocation Key Features

  1. Buddypress members can add and update their location from thier Member Edit Profile page.
  2. Buddypress members can add a location during Buddypress registration process.
  3. Link any of the Xprofile fields on your site with GEO my WP.
  4. Limit the address fields members can provide for privacy purposes.
  5. Select between single or multiple address fields.
  6. Enable Google Places address autocomplete on the address field to preset the member with live suggested results while typing an address.
  7. Auto populate the member's current location, when exists, into the location fields.
  8. Disable GEO my WP Location tab to force members to add and update their location using the profile page.
  9. As an admin, you will be able to update other members location from the User Profile page of the admin's dashboard.

Add Location Using Member Profile Page

Allow the members of your site to manage their location from the Member Edit Profile page, for a faster and easier user experience. That is instead of, or in addition to, the Location tab, which some users find more advanced or complex to use.

Google Places address autocomplete can be enabled when using the single address field option as a full address.

Location In Edit Profile Page

Add Location During Registration

With GEO my WP by default, it is impossible for members to add a location during registration. That's because an access to the Location tab only possible after a user has registered. Using Buddypress Xprofile Geolocation extension members can add a location during the registration process the same way as any other profile field.

Please note that this feature only works with BuddyPress' built-in registration form. It does not work with custom registration forms generated by some themes or plugins.
Additional Features

Location fields in registration page

Limiting Address Fields For Privacy Porpuses

When using GEO my WP's Location tab, members can add any form of address, and without limitation; Full address, street, city, house/apt number, and so on. But that is not always the ideal solution, especially when privacy is important.

If you want to keep the location of your members private, you can link specific address fields to GEO my WP, such as city, zip code, and/or state. This way members will not be able to enter a more accurate location, such as the street or house number.

Location Tab Setup

Using the extenision you can modify GEO my WP default Location tab. There are 3 options:

Admin Settings

Setting up the extension is a simple task using GEO my WP Settings page.

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.