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

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. 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.