Premium Settings

Enhance GEO my WP forms and other components with premium features.

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.


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:

  • Posts Locator - search the post title and/or post content
  • WordPress Users Locator - the plugin searches the username.
  • BuddyPress Members Locator - searches the member/username.
  • BuddyPress Groups Locator - searches the group's name and description.

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:

  • Posts Locator - distance, post_title, post ID, date created, last modified, and post type.
  • WordPress Users Locator - distance, user ID, display name, username, user nicename, user email, and user registered.
  • BuddyPress Members Locator - distance, active, newest, popular, online, and alphabetical.
  • BuddyPress Groups Locator - distance, active, newest, popular, and alphabetical.

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

  • Global - set a custom icon that will be used with all locations on the map.
  • Per Post - display different map icons for each post on the map. When the feature is enabled, you can select different map icons for each post when adding a location in the Post Edit page. The map icons are listed under the "Map icons" tab in the Location form.
  • Per post type - assign and display different map icons for each post type registered on your site.
  • Per category - assign and display different map icons for each taxonomy term registered on your site.
  • Featured image - use the post's featured image as the map marker icon.

WordPress Users Locator Component

  • Global - set a custom icon that will be used with all locations on the map.
  • Per-user - display different map icons for each user on the map. When the feature is enabled, each user can select a specific map icon. The map icons are listed under the "Map icons" tab of the Location form.
  • Avatar - use the user's avatar as the map marker icon.

BuddyPress Members Locator Component

  • Global - set a custom icon that will be used with all locations on the map.
  • Per member - display different map icons for each member on the map. When the feature is enabled, each BuddyPress member of your site can select his/her own map icon. The map icons are listed under the "Map icons" tab of the Location form ( under the Location tab of the Member's profile page ).
  • Avatar - use the member's avatar as the map marker icon.

BuddyPress Groups Locator Component

  • Global - set a custom icon that will be used with all locations on the map.
  • Per group - display different map icons for each group on the map. When the feature is enabled, each group admin can select a specific map icon. The map icons are listed under the "Map icons" tab of the Location form ( under the Location tab of the group's Manage page ).
  • Avatar - use the group's avatar as the map marker icon.

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.

  • Same as the search form template files, the extension provides different info-window template files. And just the same, you can create a custom info-window template file to use with the map.
  • You can choose the info-window type between info-bubble or a popup window.
  • Some info-window can be dragged within the boundaries of the map, and some can be collapsed and expanded ( popup type info-window only ).
  • You can choose the info-window template file using the form editor, where you can also set the location details that display in the info window. Details like image/avatar, the address of the location, distance, directions link, and more.
This document is not completed and some more features should be added to it.
License Agreement
All license options are valid for 1 year from the date of purchase, which during this time you will be eligible for support and updates. All prices are billed yearly until canceled.
For more information, visit our FAQ section or ask a pre-sales question.
Extension Details
Version 3.1
Developed by Eyal Fitoussi
Requires WordPress 5.6 or higher
Requires GEO my WP 4.0 or higher
WordPress 5.6 or higher
GEO my WP 4.0 or higher
  • 3.1 - 07/15/24
    • Note: the Premium Settings v3.1 requires GEO my WP v4.4. make sure to update GEO my WP core plugin on your site.
    • Fix: saved category map icons are not being pull from the correct database location in the Category page.
    • Fix: use $wpdb->users instead of \'wp_users.\' when getting the users\' database table name.
    • Enhancement: the keywords search box can now also search post custom fields ( in addition to post content and excerpt ).
    • Tweak: disable the map styles feature of Google Maps when the advanced markers library is enabled.
    • Tweak: check that the map marker usage variable is set to prevent PHP notice.
    • Tweak: when displaying member types in search results, try and retrieve the member type singular name in case it is missing.
    • Tweak: add the missing \"Distance\" option to the \"Displayed member location tab\" admin settings.
    • Tweak: move the functions gmw_get_search_form_custom_fields() and gmw_get_search_form_custom_field() to GEO my WP core plugin ( v4.4 ).
    • Tweak: move the content of the method GMW_PS_Form_Settings_Helper::get_custom_field() to GEO my WP core plugin ( v4.4 ) under GMW_Form_Settings_Helper::get_custom_field() and the content of the function GMW_PS_Form_Settings_Helper::get_custom_fields() to GMW_Form_Settings_Helper::get_custom_fields().
  • 3.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.
  • 2.4.4 - 01/30/21
    • Fix: append xprofile fields in AJAX form search results.
    • Fix: verify variable before using it to prevent PHP warning.
    • Fix: verify variable for map icons before using it to prevent PHP warning.
    • Tweak: get location data in the info-window using location ID instead of group ID.
    • Tweak: add \'location_name\' and \'featured_location\' DB columns to the info-windows object.
    • Tweak: use the functions gmw_info_window_permalink() and gmw_info_window_title() to generate the title in the info-windows.
    • Tweak: when filtering custom fields using a BETWEEN comparison, if any of the BETWEEN fields are blank use 0 for the min value and 999999 for the maximum value. Otherwise, the search will return nothing if one of the fields left blank.
    • Tweak: get per category icons when getting posts that are not cached.
    • Tweak: update select2 version tag.
    • Tweak: Load full version of select2.
    • Tweak: visually improve the Custom Fields settings box of the form editor.
    • Tweak: include the map icons tab of the Posts Locator Location form in the front-end as well to make it compatible with other extensions.
    • Tweak: set higher priority for the \"address fields\" setting of the form editor.
    • Various minor bug fixes and improvements.
    • WPCS
  • Version - 9/16/2020
    • Fix: pre-defined taxonomies are not included/excluded in Posts Locator Global Maps when the \"All categories\" options is selected.
    • WPCS.
  • Version - 8/29/2020
    • Fix: PHP error.
  • Version 2.4.3 - 8/28/2020
    • Fix: PHP warnings caused by a wrong variable that is being used when checking the form component when a new form is created in the dashboard.
    • Tweak: use the filter \'gmw_search_form_enable_field_wrapping_element\' to enable DIV wrapper for each custom field filter in the search form.
    • Tweak: pass $gmw as 3rd argument into the gmw_ps_pt_get_meta_query_args() function.
    • Filter: \'gmw_ps_meta_query_field_args\' to modify a custom field arguments during the search query.
    • Filter: \'gmw_ps_get_search_form_custom_field_output\' to modify the output of a custom field filter in the search form.
  • Version 2.4.2 - 7/20/2020
    • Tweak: when updating the form editor, allow a few HTML attributes to be added to the results message. The allowed HTML tags are \"a\", \"p\", \"em\", and \"span\".
    • WPCS
  • Version 2.4.1 - 3/23/2020
    • Tweak: updated deprecated filter.
    • Tweak: set \"single\" as the default value of the \"address field\" setting in the form editor.
    • Filter: \'gmw_ps_db_fields_pre_info_window\' to modify the location fields that pass to the info-window via the $post object.
    • Filter: new 3rd argument $location passes to the \'gmw_ps_post_before_info_window\' filter.
  • Version 2.4 - 11/14/2019
    • Fix: Only one custom field filter output in the search form when multiple custom fields are selected in the form editor.
    • Fix: when form editor first loads, the \"Single Address field\" option is set after selecting the \"multiple address fields\" option.
    • Tweak: Show the map styles feature in the form editor when LeafLet map provider is enabled, but make the feature disabled with a message indicates it is only available with Google Maps.
    • Modify the \"wider search link\" and \"all results link\" features to work with Ajax Forms extension. Add some custom class tags to the links.
    • Tweak: bump date-picker script/style version tag.
  • Version 2.3 - 05/29/2019
    • Fix: conflict when the same taxonomy exists twice in the taxonomies picker of the form editor.
    • Fix: deprecate misapplied filter name. Instead of \'gmw_search_forms_range_slider_args\' use \'gmw_search_form_range_slider_args\'.
    • Fix: change incorrect filter name from gmw_search_forms_units_args to \'gmw_search_form_custom_field_args\'.
    • Fix: declare static functions to prevent PHP notices.
    • Fix: directions link show in info-window even when unchecked.
    • Tweak: move custom fields wrapper element from the function gmw_get_search_form_custom_fields() into gmw_search_form_custom_fields(); to allow more control with the fields wrappers.
    • Additional bugs fix and improvments.
  • Version 2.2.2 - 01/20/2019
    • Fix: Users Locator map icons tab doesn\'t load in the \"Your Location\" page of the admin\'s dashboard.
    • Enhancement: set the map icons of the Users Locator forms during the search query for better performance.
    • Tweak: gmw_ps_gmapsul_set_map_icons_via_query() function renamed to gmw_ps_ul_set_map_icons_via_query() and moved to gmw-ps-users-locator-functions.php.
    • WordPress coding standards.
  • Version 2.2.1 - 01/12/2019
    • Requires GEO my WP version 3.2 or higher.
    • Fix: conflict with the date picker and the Global Maps search forms. Load the \'default\' theme of the date picket instead of the classic theme.
    • Fix: Per post icon doesn\'t work properly. Add map_icon column to the search query clauses.
    • Tweak: visually improve the radius slider field.
    • Tweak: Use the JS libraries\' version when registering libraries\' scripts/styles instead of using GEO my WP version.
    • Filters: New hooks added before and after some search form fields.
    • Filter: \'gmw_ps_pickadate_theme\' to change the date picket theme.
    • WPCS.
    • Various bugs fix.
  • Version 2.2 - 10/24/2018
    • This version requires GEO my WP v3.2.
    • Fix: default global map icon.
    • Various bugs fix and improvements.
  • Version 2.1 - 8/4/2018
    • Compatible and required GEO my WP v3.1 using multiple maps providers.
    • Compatible with the new geocoding system of GEO my WP.
    • Compatible with AJAX Forms premium extension.
    • Fix: Use include_once instead of include to prevent fatal errors.
    • Fix: use $field_args[\'name\'] variable instead of $field_name for custom fields filters.
    • Fix: filter used for excerpt options.
    • Fix: Update filter name used with the address in member activity update.
    • Fix: change the filter used for keywords back to gmw_search_form_start to display it first in the search form.
    • Tweak: when default icon images exist, move them to the beginning of the list of icons.
    • Tweak: Pass default shortcode attributes using a private function instead of a variable.
    • Tweak: update the default map icon URL and size.
    • Enhancement: coding standards.
    • Enhancement: update stylesheet.
    • Enhancement: update code to support PHP 5.4+.
  • Version 2.0 - 4/2/2018
    • This is a major update which is compatible with GEO my WP 3.0+. Please read this post ( ) before updating your plugin.
  • version 1.6.4 - 11/20/2016
    • Tweak: users with “Editor” role can now update the per post map icon.
    • New filter: \'gmw_ps_per_post_icon_capability\' - allow to modify the “per post map icon” user role.
    • Fix: issue with date custom field.
  • version 1.6.3 - 3/10/2016
    • Fix: Custom info window won\'t load properly.
    • Fix: Stripslashes added to the search form keywords field.
    • Fix: Issue with taxonomy terms for dropdown and checkboxes caused by the new caching system.
    • Tweak: add the option to choose the \"Normal\" info-window type generated by GEO my WP instead of Pop-up or infobox.
  • Version 1.6.2 - 8/21/2015
    • Fix: Newly created taxonomies won\'t show in the admin settings page.
  • Version 1.6.1 - 8/19/2015
    • Fix: Remove PHP warning - include category icons file only when Post Types add-on is activated.
    • Fix: Remove PHP warning - verify that per_categoty_taxonomy is an array.
    • Fix: filter for member\'s address in search results.
    • Fix: Remove PHP warning - Set default map_icon_usage if not set.
    • Fix: remove PHP warning - apply member count number to gmaps to have members count in default map icons.
    • Tweak: modify some category and icon category arguments.
    • Tweak: Modify \"Smart box\" appearance in admin settings. It is now a checkbox in the Taxonomy \"usage\" settings.
    • Tweak: Improve taxonomies functions and GMW Category walker.
    • Tweak: Improve the category icons feature performance in admin category pages.
    • New: \"Show count\" checkbox in admin taxonomy settings to show the post count for each term in the taxonomy dropdown/checkbox.
    • New: cache taxonomy terms using the new GEO_my_WP_Cache_Helper cache to improve performance ( using GMW 2.6.2 or higher ).
    • Update: language files.
  • Version 1.6 - 7/4/2015
    • This version is only compatible with GEO my WP plugin version 2.6.1 or higher
    • Fix: add missing \"$gmw[\'info_window\'][\'excerpt\'][\'more\']\"\" argument to gmw_excerpt function in popup info window template files.
    • Tweak:Core improvment to category/taxonomy functions by extending the category_walker class with gmw_pt_categories_walker class.
    • Fix: keywords filter doesn\'t work properly.
    • Tweak: Modify map and map icons features to work with the new map functions introduced in GEO my WP 2.6.1.
    • minor core improvment in info window fucntions.
    • Minor core improvment in template functions file.
    • Modify map and map icons features for Global Maps add-on based on the new map functions introduced in GEO my WP 2.6.1.
    • Tweak: Improve the category icons feature performance in admin category pages.
    • Fix: Category icons not added properly when adding new icons to a taxonomy term. Overall improvment of the category icons feature.
    • Modify the admin category icon setting based on the new pre category icon settings feature.
    • Visually improve the category settings in form editor.
    • Add new smartbox settings to the category/taxonomy feature in the form editor.
    • Modify Langauge/grammar in admin settings pages and form editor.
    • Delete single-map.js file. Single map will now be displayed using the new map function introduced in GEO my WP 2.6.1.
    • Modify constants.
    • Modify admon initiate variables to meet with GEO my WP 2.6.1 requierments.
    • minifiy map.js.
    • Modify map.css to work with GEO my WP 2.6.1 and the new map functions.
    • remove inline CSS from admin.js.
    • Edit style.css stylesheet.
    • Delete slider.css file.
  • Version 1.5 - 11/26/2014
    • This is a major update includes many bugs fixs, imrpoved functions, and new features. Note that this version will only work with GEO my Wp version 2.5 and higher.
    • Improved map\'s info-windows ( infobox and pop-up windows ); New info-window templates.
    • New features for info-windows; Draggable windows ( pop-up only) and more.
    • New get directions system for popup infow-windows. Show detailed directions within the info-window.
    • Improved queries.
  • Version - 6/29/2014
    • Fix: error when including by terms taxonomy ID
  • Version - 6/5/2014
    • Fix: uasort Anonymous function wont work with PHP versions lower than 5.3.
  • Version - 5/27/2014
    • Fix: No results feature not working
    • Fix: Problem with new taxonomy feature causes server out of memory
  • Version - 5/18/2014
    • Fix: add-on version
    • Fix: Console error casused by radius slider
    • Fix: Remove warning caused by Gmaps custom Icons
  • Version 1.4 - 5/13/2014
    • Compatibility with WordPress 3.9.1. BUddyPress 2.0.1, GEO my WP 2.4.4, Global Maps 1.4
    • Fix: Per results map feature was not working.
    • Fix: Map markers issue.
    • Fix: Radius Slider not showing.
    • Fix: Date Picker conflicts.
    • New: Major improvment for Taxonomies. Order taxonomies, Order terms, exclude terms by ID, Include terms by ID.
    • New: Info window - \"You location\" - for the marker represents the user\'s current location.
  • 1.3:
    • This is a major update that will work only with GEO my WP 2.4 and up. Please read about it here. Detailed change log will be added soon.
  • 1.2 :
    • GEO my WP 2.2 compatible
    • WordPress 3.7.1 and BuddyPress 1.8.1 compatible
    • Compatibility with Global Maps add-on
    • fixed issue when multisite activated
    • change gmw_pt_query_meta_args filter to gmw_pt_query_args filter in order to query custom fields (meta_query).
    • Fix white screen issue when deactivating GEO my WP and add-on is still activated
    • Fix issues with date field type custom fields
    • Other minor bug fixes
    • Improve ID and Class tags
  • 1.1 :
    • Update for final release of GEO my WP
    • Changed location of map-icons folder
    • Added category icons
    • Added ability to add map icons to theme of child theme
    • bug fixes
  • 1.0 : Initial release