Maps
The addon can plot job and resume locations on a Google Map in the archive header. All map controls live under Reign Options > WP Job Manager > Job Manager Map Settings.
Google Maps API key
Section titled “Google Maps API key”Maps use the API key stored in WP Job Manager’s own setting (job_manager_google_maps_api_key), found under Job Listings > Settings in WP Job Manager. The addon does not keep a separate key. If markers or the map fail to load, confirm that key is set and valid.
Map settings
Section titled “Map settings”| Setting | Type | Default | Purpose |
|---|---|---|---|
| Show Google Map On Job Listing Header | Checkbox | Off | Displays the map above the job archive. |
| Show Google Map On Resume Listing Header | Checkbox | Off | Displays the map above the resume archive (WP Job Manager Resumes only). |
| Map Zoom Level | Number | 3 | Initial zoom of the map. |
| Map Type | Select | Roadmap | Roadmap, Satellite, Hybrid, or Terrain. |
| Map Height | Text | 400px | Accepts pixels or percentage, for example 400px or 100%. |
| Map Language | Text | en | Language code for Google Places autocomplete and Maps API. |
| Enable Marker Cluster | Checkbox | Off | Groups nearby markers into clusters. |
| Min. Marker Cluster | Number | 3 | Minimum markers before a cluster forms. |
Marker clustering
Section titled “Marker clustering”Marker clustering uses a bundled MarkerClusterer library. As of version 3.1.0 this library ships inside the addon rather than loading from a third-party CDN, so clustering keeps working without an external request.
Performance notes
Section titled “Performance notes”Version 3.1.0 hardened the map queries:
- Two maps built from different searches no longer share one cached set of markers. The cache key is derived from the plotted posts.
- The resume map query is capped and returns IDs only, so large resume sets do not load every record into memory.
Related filters
Section titled “Related filters”Developers can adjust map behavior with these filters:
reign_wpjm_map_marker_limit- caps how many markers are plotted.reign_geolocation_query_args- adjusts the query used to gather mappable posts.jobmate_should_enqueue_map_scripts- controls whether the map scripts are enqueued on a given view.
See the Developer Guide for the full hook list.