WordPress Users Locator

Empower your WordPress site with geolocation, proximity search, and interactive user maps.

Enhance WordPress User Profiles with Geolocation & Proximity Search

The WordPress Users Locator extension transforms your WordPress site by enabling powerful geolocation features, proximity search, and interactive maps. Users can seamlessly add their location to their profile from both the WordPress dashboard and the front end, while admins can build customizable search forms and mashup maps using GEO my WP’s advanced form builder.

Whether you're building a community site, a directory, or a location-based membership platform, WordPress Users Locator provides the tools needed for searching and displaying users based on location.

Key Features of WordPress Users Locator – Add Location & Enable Proximity Search

1. Easily Add & Update Location in WordPress User Profiles

Users can easily add, update, and manage their location in their WordPress profile. The location form is available in both the WordPress dashboard (backend) and the front-end user profile. This ensures accurate geolocation for user profiles, improving searchability and directory functions.

  • Select an address from Google’s autocomplete suggestions.
  • Use the locator button to retrieve the current location.
  • Manually drag the map marker to adjust the location.
  • Enter the address fields manually.
  • Input latitude and longitude coordinates.

The location form can be added to any page using the shortcode:

[gmw_user_location_form]

Additionally, it is possible to integrate the location form into the native WordPress registration page (not custom pages created by plugins or themes). The registration page location settings include:

  • Usage options:
    • Address field only - A simple address input field.
    • Advanced location form - The full GEO my WP location form.
  • Address autocomplete: Enable or disable Google Maps address autocomplete.
  • Address field label & placeholder: Customize the field label and placeholder text.
  • Required location: Force users to enter a location before completing registration.
  • Exclude fields: Select specific fields to hide from the location form.
  • Location form template: Choose from different layout styles.

2. WordPress User Locator – Enable Proximity Search & Nearby User Lookup

The WordPress Users Locator extension enables powerful, location-based proximity searches through the GEO my WP form builder. Users can search for other users nearby based on location, distance, and custom filters. The intuitive form builder makes it easy to create, customize, and embed search forms anywhere on your site.

Form Builder Configuration

  1. Page Load Results – Define search behavior on first page load.
  2. Search Form – Configure filters such as address, radius, locator button, and more.
  3. Form Submission – Set up actions triggered upon form submission.
  4. Search Results – Customize the results layout (avatar, address, directions link, etc.).
  5. Results Map – Adjust map size, zoom level, and type.

Each form can be customized differently and placed anywhere using a shortcode or widget.

3. Mashup Map – Display & Search WordPress User Locations

The Mashup Map feature allows you to create dynamic, interactive maps displaying all users or filtered user groups based on location. Using GEO my WP’s form builder, you can customize map display settings, filtering options, and styles to provide a seamless search experience.

Key Features of the Mashup Map

  • Display all users or filter based on address and user's current location.
  • Set the number of users to display on the map.
  • Customize map width, height, and type.

Configuration Using the Form Builder

  • Map Filters: Set up address-based filtering and define how many users appear on the map.
  • Map Settings: Adjust map dimensions and type.

4. Display User Location Anywhere with a Shortcode

The User Location Shortcode allows you to display a specific user’s location anywhere on your site, including a map, address, and a directions link.

You can easily display the user location on any page using the shortcode [gmw_user_location]

Customizable Attributes:

  • Display any or all of the following elements: user name, address, map, distance, and directions link, in any order.
  • Set map height and width.
  • Choose map type.

5. Custom User Details/Location Page

The User Location Page feature allows you to create a dedicated page where visitors can view a user’s location when they click on a result from a proximity search form.

Flexible Setup Options

Admins can configure the user location page using one of the following options:

  • URL query string only: Uses the site’s home URL as the base for the query string. This is useful when integrating with other plugins or themes that generate user profile pages.
  • Custom Page: Select any existing page from the site and either dynamically replace its content with user location details or manually place the shortcode [gmw_displayed_user_location] in the page content.
  • Theme’s Author Template Page: Links to the built-in author page provided by the active WordPress theme (if available).

Dynamic URL Parameters

The system generates dynamic URLs, allowing user details to be passed as query string parameters for flexible integration with profile pages:

  • User ID - {id}
  • Username - {username}
  • Email - {email}
  • Nicename - {nicename}

This feature is particularly useful for membership sites or directories that require custom user profile integration.

Available Shortcodes

  • [gmw_user_location_form] – Display the User Location form in the front-end.
  • [gmw_user_location] – Display the location details of a specific user.

Advanced Features with Premium Settings

Supercharge the functionality of search forms, mashup maps, and user location settings with additional premium features. The Premium Settings extension unlocks advanced options for greater control and customization, including:

Additional Filtering Options

  • Filter users by role or other custom criteria.
  • Enable keyword search for more precise results.

Enhanced Map Features

  • AJAX-powered info windows for seamless user interactions.
  • Marker clustering for better visualization of densely populated areas.
  • Map boundaries filter to limit results based on visible map areas.
  • Set maximum zoom levels for optimal viewing.
  • Customize with map styles to match your site's design.

Advanced Sorting and Display Options

  • Order search results by distance, name, or other parameters.
  • Customize result display settings for a more tailored experience.

These premium features provide greater flexibility and control, allowing you to create a fully customized and optimized geolocation experience for your users. Visit the Premium Settings extension page for more details.

Get Started with WordPress Users Locator

  • Enable WordPress users to add and update their location from their profile.
  • Create interactive proximity search forms to find users based on location.
  • Build custom user location pages for displaying user addresses and maps.
  • Display a mashup map of users, showing all or selected users on a single interactive map.

Ready to enhance your WordPress site with user location search? Get started with WordPress Users Locator today!

Frequently Asked Questions

What is WordPress Users Locator, and how does it improve WordPress user search?

The WordPress Users Locator extension is a powerful geolocation tool that enables users to add a location to their profile. It allows for proximity-based searches and interactive maps, helping users find each other based on location.

How do users add their location?

Users can add or update their location from their WordPress profile in the admin dashboard or via the front-end location form. The form supports address autocomplete, manual entry, and map marker adjustments.

Can I filter users by additional criteria?

Yes, with the Premium Settings extension, you can filter users by role, keywords, and other custom criteria to refine search results.

Can I create a user directory map in WordPress?

Yes! The Mashup Map feature lets you create a dynamic WordPress user directory map, displaying all or selected users with customizable filters.

Is it possible to customize the user location display?

Yes, the user location can be displayed in a dedicated user page, using a custom page, WordPress author template, or query string-based URLs.

What advanced map features are available?

With the Premium Settings extension, you can enable marker clustering, map boundary filtering, max zoom levels, custom map styles, and more.

Can I integrate the location form with the WordPress registration page?

Yes, the location form can be added to the native WordPress registration page, allowing users to enter their location when signing up.

Does this extension work with membership plugins?

Yes, you can configure the user location page to link to custom profile pages created by membership plugins, passing user details via query string parameters.

How can I get started with WordPress Users Locator?

Simply install the extension, configure the location settings, and use the form builder to create custom search forms and maps to display user locations dynamically.

Unlimited Features

Unlock all extensions and enjoy unlimited features with our Access Passes. It's the best value for WordPress developers!

View Access Passes

Prefer a Single Extension?

You can purchase this extension only. Perfect if you only need this specific functionality!

**All license options include 1 year of support and updates from the date of purchase. Licenses are billed annually and will renew automatically unless canceled. For additional details, visit our FAQ section or feel free to contact us with any pre-sales question.

Details

  • Version 2.0.2
  • Developed by Eyal Fitoussi
  • Requires WordPress 5.6+
  • Requires GEO my WP 4.0+
  • Live demo
  • View changelog
  • View documentation
  • Ask a pre-sale questions

    • Requirements

    WordPress 5.6 or higher
    GEO my WP 4.0 or higher
    Changelog
    • 2.0.2 - 8/2/24
      • Tweak: replace the file gmw-users-locator-ajax-info-window-loader.php with the new function gmw_users_locator_ajax_info_window_loader(); for compatibility with GEO my WP v4.5.
      • PHPCS/WPCS.
    • 2.0.1 - 7/11/24
      • Fix: missing results function \'gmw_search_results_meta_fields\' in the info-window template file.
      • Fix: user location form causes an issue when trying to update a user in the Edit User page of the admin\'s dashboard.
    • 2.0 - 08/26/23
      • This is a major release that is compatible with GEO my WP v4.0. Please read this post before updating the extension on your site.
    • Version 1.5 - 01/30/21
      • Fix: Verify GEO my WP location form submission before tempting to update user\'s location during registration.
      • Tweak: add a \"display_name\" option to the user Permalink generator using the tag {disaplyname}.
      • Tweak: output the user\'s title in results using the function gmw_get_search_results_title().
      • Tweak: move the filters \'gmw_user_location_form_tabs\' and \'gmw_user_location_tab_fields\' from the GMW_User_Locator_Form class into the parent GMW_Location_form class.
      • Tweak: use include_once instead of include.
      • Tweak: load the class GMW_User_Locator_form() ( in file class-gmw-user-location-form.php ) by default so other extensions would be able to use it.
      • WPCS
    • Version 1.4.6 - 7/20/2020
      • Fix: image distorted in search results.
      • Tweak: try getting avatar using the function get_wp_user_avatar() when WP User Avatar plugin is activated.
      • Tweak: use the filter \'gmw_disable_query_clause_between\' to disable the coordinates BETWEEN filter in the search query.
      • Tweak: move the object_type filter of the search query from the WHERE to the JOIN clause.
      • Tweak: add GROUP BY user ID to the search query.
      • Filter: \'gmw_ul_registration_floating_location_form\' to allow disabling the floating location form in registration form.
      • Filter: ‘gmw_ul_get_user_avatar_args’ to modify the avatar arguments in the search results.
    • Version 1.4.5 - 3/23/2020
      • Tweak: Clear internal cache when user profile changes.
      • Tweak: initiate the location features in the admin\'s profile page via the \'init\' action.
      • Tweak: pass the $locatio object via the GMW_Single_User_Location::title() method.
    • Version 1.4.4 - 11/14/2019
      • Fix: load Marker Clusterer JS function in the footer when the Premium Settings extension does not exists.
      • Tweak: adjust Peepso integration code to work with Location type profile field type as well.
      • Filter: filter to allow modifying the user roles that can manage the location of other users.
    • Version 1.4.3 - 07/10/2019
      • New: \"GMW Location\" column in the \"Users\" page of the admin that shows the address of the user with an \"Edit\" link to allow admins to edit the location of other users.
      • New: “Your Location” section in the user’s profile page of the admin’s dashboard that shows the address of the user with a link to the “Edit Location” page.
      • New: Allow admins to edit the location of other users via the dashboard.
      • New: a function that allows updating the user\'s location via user meta fields.
      • New: a function that allows syncing a profile field of Peepso plugin with GEO my WP location, allowing users to update their location via the Peepso profile page.
      • Additional minor bugs fix and improvements.
    • Version 1.4.2 - 05/29/2019
      • Fix: verify that the class \'GMW_User_Location_Form\' loads only once to prevent PHP error.
      • Fix: force the \'uid\' URL parameter only if dynamically replacing the content of the page with the user\'s location shortcode.
      • Tweak: use include_once instead of include.
      • Filter: \'gmw_ul_get_user_permalink\' to modify the user\'s permalink.
      • Filter: \'gmw_ul_get_user_title_args\' to modify the user’s title.
      • Additional minor bugs fix and improvements.
    • Version 1.4.1 - 01/12/2019
      • Requires GEO my WP version 3.2 or higher.
      • Fix: Incorrect avatar loads in info-window.
      • Fix: Permalink in the info-window is incorrect.
      • Fix: avatar permalink in search results does not link to the correct page.
      • WPCS.
      • Minor bugs fix.
    • Version 1.4 - 10/25/2018
      • This version requires GEO my WP v3.2 or higher.
      • Fix: issue with the max_pages argument of the pagination.
      • Tweak: allow showing users without a location in the search query when searching without an address.
      • Tweak: modify the clauses structure to have more control of it when modification of the clauses are needed.
      • coding standards.
      • Various bugs fix, improvements, and new functions,
    • Version 1.3.2 - 8/4/2018
      • Compatible and required GEO my WP v3.1 using multiple maps providers.
      • Compatible with AJAX Forms premium extension.
      • Compatible with new geocoding system of GEO my WP.
      • Fix: Use include_once instead of include to prevent fatal errors.
      • Tweak: enqueue form scripts after form displayed.
      • Tweak: Trigger map resize when a hidden form is shown to make sure the map is displayed properly.
      • Tweak: Update usage of gmw_lf_geocoded_location_data action.
      • Enhancement: coding standards.
      • Enhancement: update stylesheet.
      • Enhancement: update code to support PHP 5.4+.
    • Version 1.3.1 - 5/1/2018
      • New: add location via WordPress registration form. Set it up via GEO my WP Settings page.
      • Fix: bring back Markers Clustered feature which was missing after the last major update ( 1.3 ).
      • Tweak: allow passing user ID to displayed user location using either user_id or uid URL parameter. Instead of uid only.
      • Filter: gmw_ul_displayed_user_location_url_param to modify the user ID URL parameter.
      • Fix: Typos.
      • Enhancement: coding standards.
    • Version 1.3 - 4/2/2018
      • This is a major update which is compatible with GEO my WP 3.0+. Please read this post ( http://geomywp.com/geo-my-wp-3-0-beta-7/ ) before updating your plugin.
    • Version 1.2 - 12/15/16
      • Fix: location not being saved when updating user\'s location in the front-end.
      • New: add Page Load Results tab to WP Users forms.
      • Remove class as function argument from gmaps and search form template files.
    • Version 1.1 - 11/26/14
      • This is a major update. Many bugs were fixed, functions were improved and new functions added as well as new features. Note that this version of the plugin will only work with GEo my WP version 2.5 and higher.
      • Author page improved.
      • Now compitable with Global Maps 2.0; Create Google maps displaying Wp Users.
    • Version 1.0 - 4/29/14
      • Initial Release