Search & Map Settings
Overview
The Search & Map settings control the location search fields, proximity filtering, result ordering, distance display, and map shown with WP Job Manager listings.
Job search features are available in WP Job Manager Geolocation Starter and Pro. Resume search features are available in Pro and require the separately installed WP Job Manager Resume Manager extension.
Accessing the settings
For jobs, go to Job Listings → Settings → Geolocation → Search & Map.
For resumes in Pro, go to Resumes → Settings → Geolocation → Search & Map. Resume settings are stored separately from job settings.
Enabling geolocation search
Outside a selected Preset Page, geolocation is disabled for a plain [jobs] or [resumes] shortcode until you choose how it should be configured.
Settings mode
Use wpjmgeo_mode="settings" to apply the options from this settings page:
[jobs wpjmgeo_mode="settings"]For resumes in Pro:
[resumes wpjmgeo_mode="settings"]Shortcode mode
Use wpjmgeo_mode="shortcode" when one page needs its own configuration. In this mode, the geolocation attributes on the shortcode take precedence instead of this settings page:
[jobs wpjmgeo_mode="shortcode" wpjmgeo_radius="10,25,50" wpjmgeo_units="imperial" wpjmgeo_map="1"]Preset Pages
Select a page under Preset Pages when a theme or template creates the listings page without giving you access to the shortcode. On a selected page, the plugin applies this Search & Map configuration automatically.
Location input
Address Autocomplete
Displays Google-powered suggestions while a visitor types in the location field. This is enabled by default and requires a correctly configured Browser API Key with Places API (New).
Autocomplete Countries
Optionally restrict suggestions to as many as 15 countries. Leave the setting empty to allow suggestions from all countries.
Locator Button
Displays a button inside the location field that allows the visitor to share their current position. It is disabled by default in the saved settings.
Page Load Locator
Attempts to detect the visitor’s position when the page loads and submits the search using that location. It is enabled by default in the saved settings. The visitor’s browser may display a location-permission prompt.
A visitor can also submit the normal WP Job Manager filters without entering a location. Proximity filtering is applied only when the search contains usable coordinates.
Radius, units, and ordering
Radius
Enter one value for a fixed radius, or multiple comma-separated values to display a selector. The default is:
5,10,15,25,50,100Units
Choose Miles, Kilometers, or User Selectable (Miles & Kilometers). The default is user-selectable.
Order By
Enter one value or a comma-separated list in the order the choices should appear. The default is:
distance,title,featured,dateSupported values are distance, title, featured, date, modified, ID, parent, rand, and name.
Results Map
Results Map
Displays a Google Map above the results list. It is enabled by default. Markers update when visitors filter, sort, or paginate the listings.
Map dimensions
The default width is 100% and the default height is 400px. CSS-compatible values such as 600px, 75%, or 50vh are accepted where appropriate.
Map Type
Choose Roadmap, Satellite, Hybrid, or Terrain. The default is Roadmap.
Zoom levels
Zoom Level defaults to 12 and is used when the map contains one marker. A map with multiple markers automatically adjusts to fit them. Maximum Zoom Level is disabled by default.
Gesture Handling
Choose Disabled, Auto, Cooperative, or Greedy. The default is Auto.
Marker Clustering
Groups nearby markers to keep a dense results map readable. It is enabled by default.
Marker icons
Visitor Location Icon controls the marker used for the visitor’s position. Location Map Icon controls job or resume markers. Leave the listing icon empty to use the plugin default.
Show Distance
Displays the calculated distance beside each qualifying result. It is enabled by default.
Examples
Use the saved job settings:
[jobs wpjmgeo_mode="settings"]Configure one job directory directly:
[jobs wpjmgeo_mode="shortcode" wpjmgeo_autocomplete="1" wpjmgeo_locator_button="1" wpjmgeo_auto_locator="0" wpjmgeo_radius="10,25,50" wpjmgeo_units="imperial" wpjmgeo_orderby="distance,featured,date" wpjmgeo_map="1" wpjmgeo_zoom_level="12" wpjmgeo_distance="1"]Place the results map somewhere else on the same page by giving both shortcodes the same explicit ID:
[wpjmgeo_jobs_results_map element_id="jobs-directory"]
[jobs wpjmgeo_mode="settings" wpjmgeo_element_id="jobs-directory"]The results-map shortcode is a placement target for the matching listings instance; it is not a standalone mashup map. If the two IDs do not match, the separate map cannot coordinate with those results.