FW Real Estate – Documentation
Map View
The FWRE Map View addon adds interactive map support to FW Real Estate. It places an embedded map on each property detail page and adds a map layout option to the property listing page, where all properties appear as clickable markers on a full-width map.
What Map View Adds
- Single property page: An embedded map with the property's location pinned, giving visitors immediate neighborhood context.
- Listing page map panel: An optional map panel alongside the standard list or grid, showing all visible properties as markers. Clicking a marker opens a mini-card with the property photo, title, and price.
- Map View layout: A full-width map layout option for the Properties Listing menu item, with the list or grid displayed as a side panel.
- Auto-geocoding in the admin: When you type an address on the property edit form, the map converts it to coordinates automatically, eliminating manual latitude/longitude entry.
General Tab — Map View Settings
Go to FW Real Estate → Settings → General and locate the Map View card to configure the following options.
| Setting | Description |
|---|---|
| Hide map | When set to Yes, hides the map on all single property pages globally, overriding any per-property coordinate data. |
| Map provider | Choose Google Maps or MapBox as the rendering engine. |
| Google Maps API key | Used to display maps in the visitor's browser. In Google Cloud Console, enable the Maps JavaScript API and Geocoding API on this key, and set the restriction to HTTP referrers (websites) with your site URL. |
| Google Geocoding API key | Used for server-side geocoding when a property is saved. Must be a separate key restricted by IP address. See the note below on why two keys are required. |
| Google Maps zoom | Default zoom level (10–19) for the map on single property pages. |
| Map display as | Initial map style: Map (road map) or Satellite. |
| MapBox API key | Required when MapBox is selected as the provider. Obtain an access token from mapbox.com. |
| MapBox zoom | Default zoom level (14–19) for MapBox maps. Defaults to 15. |
Why Two Separate Google API Keys Are Required
Google enforces different restriction types depending on where a request originates. The display key uses an HTTP referrer restriction, which allows your site's domain to load maps in the browser. However, HTTP referrer restrictions block requests that originate from a server — meaning this key cannot be used for geocoding when a property record is saved. The geocoding key must use an IP address restriction instead, which permits server-side requests. Using the same key for both purposes will not work.
Listing Page Setting
Go to FW Real Estate → Settings → Properties to find the option injected by this addon:
- Display map on listing page — set to Yes to show a map panel on the property listing page alongside the list or grid view.
Setting Property Coordinates
On the property edit form, the Map section provides three ways to set a property's location:
- Type the address — the map geocodes it automatically using the Geocoding API key.
- Drag the marker to the exact position on the map.
- Enter latitude and longitude values directly.
Properties where both latitude and longitude remain at 0 will not appear on the map view.
Frontend Map Views
Important Notes
- Without a valid Google Maps API key, the map loads briefly and then displays an error overlay. The property location pin will not appear, and errors will be logged in the browser console.
- The Hide map setting takes precedence over all per-property coordinate data.
- MapBox requires an account and a valid access token from mapbox.com.
To install this addon, open the Add-ons panel inside FW Real Estate. See Getting Started → Add-ons for details on free addons, paid addons, and site verification.
