The Half Map skin displays listings in a split layout with a listing section and a map section side by side. This provides a combined Grid/List view of your directory listings alongside an interactive map for geolocation context. Users can browse listings and see their locations on the map simultaneously.
To use this skin, select Half Map when choosing a skin in the Listdom shortcode generator. Half Map splits the content area into two panels: one for the listings (with toggleable List or Grid view) and one for a map showing all listings’ locations. This skin is ideal for directories where spatial context is important (e.g. real estate or travel listings).
Under the Style tab, choose a style preset for the Half Map skin. The presets (Style 1, Style 2, Style 3) control the visual design of the listing cards. Select the Style dropdown and pick a style variation. Each style may arrange listing elements slightly differently or apply a distinct layout.
Below the style selection, you can toggle the visibility of each element on the listing cards:
Image: Toggle to display the listing’s featured image on the card. If disabled, no image will appear. Enabling this reveals additional image options:
Image Method: Choose how to display images on the card. Cover shows only the featured image, filling the image area. Slider shows all gallery images as an image slider on the card.
Image Fit: Choose how the image fills its container. Cover (default) makes the image cover the box (cropping if necessary), whereas Contain fits the entire image inside (letterboxing if necessary).
Content (Description): Available in Style 3, this controls the listing description text.
Display Description: Turn this on to show a snippet of the listing’s description or excerpt. If off, no description text is shown on cards.
Content Length: Set the number of words to display from the description/excerpt (default is 10 words).
Content Type: Choose whether to use the Excerpt (default) or the full Description for the content snippet.
Other Elements: The Half Map skin can show various listing details. Toggle each of these on or off:
Contact Info: (Style 1) Show the contact information icon (e.g. phone/email icon) on each listing card.
Location: (Style 2) Show the location name or address snippet on the card.
Price Class: (if pricing categories are enabled) (Style 3) Show the price category or classification (e.g. $, $$, $$$) for the listing.
Address: (if Map component is enabled) (Styles 1 & 3) Show the listing’s address text on the card.
Share Buttons: (if Social Share component is enabled) (Styles 1 & 2) Show social share icons on each card, allowing users to share the listing.
Work Hours: (if “Work Hours” feature is used) (Styles 2 & 3) Display the listing’s availability or work hours status (e.g. “Open Now” or “Closed”) on the card.
Categories: (Styles 2 & 3) Display the listing’s category labels on the card.
Price: (if pricing is enabled) (Styles 1 & 2) Show the listing’s price or price range.
Display Matched Bookables: If the Listdom Booking add-on is active, show matched bookable items on the listing cards so users can see what can be booked without leaving the Half Map view.
Labels: Show any labels (tags/flags) on the listing – for example, “Featured” or custom labels.
Favorite Icon: Show a “favorite” (bookmark/heart) icon that users can click to save the listing to their favorites.
Compare Icon: Show a “compare” icon that allows the listing to be added to a comparison list.
Review Rates: Show the listing’s average rating as star icons (if the Reviews system is in use).
Title: Toggle the display of the listing title. (Usually this should remain enabled.)
Claim Status: If the listing can be claimed, toggle display of a “claimed” badge or status next to the title (e.g. a checkmark indicating a verified or claimed listing).
The Map tab contains settings for the map portion of the Half Map layout:
Map Provider: Select the map service to use for displaying the map. By default, you can choose Google Maps or OpenStreetMap (Leaflet). Google Maps provides detailed maps and customization, while OpenStreetMap is an open-source alternative. (The default provider is set in Listdom’s general settings.) Selecting a provider may reveal provider-specific options (e.g., map style for Google).
Map Style:(Google Maps only) Choose a custom style theme for the Google map. You can select from predefined map color themes or leave it blank for the standard Google Maps style.
Map Position: Choose where the map panel appears relative to the listings. Left or Right are available for Half Map. This determines whether the map is on the left side and listings on the right, or vice versa.
Map Height: Set a custom height for the map panel. Enter a value with units (e.g., 500px for a fixed pixel height, or 100vh for full viewport height). If left blank, the map height will auto-adjust to fit the content. Use this if you need to constrain the map’s height.
Mouse Wheel Zoom: Enable or disable zooming the map via mouse wheel/trackpad scroll. Disabled is the default to prevent accidental zooming while scrolling the page. Toggle to Enabled when you want scroll-to-zoom behavior.
Marker/Shape On Click: Define what happens when a user clicks a listing’s marker on the map (or a shape, in case of custom map layers):
Open Infowindow: (Default) Opens a small info window popup over the marker with a summary of the listing.
Redirect to Single Listing Page: Navigates the user directly to the listing’s single page when a marker is clicked.
Open Single Listing in a Lightbox: Opens the listing’s detail page in an overlay lightbox modal on the same page (without redirecting). This lightbox option is available only in Pro.
None: No action – marker clicks will do nothing (the map will just highlight the marker).
Info Window Trigger: Appears when Marker/Shape On Click is set to Open Infowindow. Choose Show on click (default) or Show on hover to control how the infowindow opens. This applies to markers only (not shapes).
Clustering: Enable or disable marker clustering on the map. When Enable is on (default), nearby markers will group into a single cluster marker (typically shown as a “bubble” with a number) to keep the map less cluttered. If clustering is enabled, you can choose a Cluster Icon Style under Bubbles – a selection of marker cluster image styles (available for Google Maps). (Leaflet maps use their default clustering behavior and do not use the custom bubble images.)
Map Search: Toggle to enable Map-Based Filtering. If Map Search is on, the listing results will dynamically filter to those currently visible in the map’s bounds. As the user pans or zooms the map, the list on the side will update to show only listings in the map’s area. This feature requires Listdom Pro. If Pro is not active, this option will be disabled. When enabled, this provides an interactive “search as I move the map” experience.
Auto GPS:(Requires Advanced Map) Automatically asks for location permission, centers the map on the visitor, and applies nearby filtering on supported setups. Auto GPS supports both Google Maps and OpenStreetMap (Leaflet) and requires HTTPS.
Map Limit: Specify the maximum number of listings to display on the map at once (default is 300). For performance reasons, the map will only plot up to this number of markers. If you have more than this number of listings in the results, only the first 300 (or the number set here) will show on the map.
If you have the KML/GeoJSON add-on installed, additional Map Layers options will appear here (via the KML Layers hook). This would allow overlaying custom shapes/regions on the map. For example, you could display drawn boundaries or service areas using a KML file. (This requires the KML add-on.)
In the Layout tab, configure how listings are paginated and displayed in the listing section of the Half Map skin:
Default View: Choose the default listing view mode for the listings panel. Options are Grid View or List View. Half Map supports both views and includes a toggle switch on the front-end for users to swap between them. The default you set here (Grid or List) is what users see first when the page loads (default is Grid).
Listings Per Row (Grid): Set how many listing cards appear per row when in Grid view. You can choose 2, 3, or 4 columns (default is 2 per row in Half Map). This affects the card layout in grid mode only (list mode shows one per row).
Limit: Specify the number of listings to show per page (or per “load” segment) in the listings panel (default 12). This should typically be a multiple of the “Listings Per Row” value for a balanced grid (for example, if 3 per row, use a limit of 6, 9, 12, etc.).
Pagination Method: Choose how additional listings are loaded beyond the initial limit:
Disabled: No pagination controls; only the first set of listings (up to the limit) will display.
Load More Button: Use a “Load More” button that users can click to load the next set of listings (ajax-based loading).
Infinite Scroll: Automatically load more listings when the user scrolls to the bottom of the listing list.
Numeric Pagination: Use numbered page links for pagination (traditional page navigation).
Select the method that fits your design. “Load More” is the default for Half Map, offering a seamless scrolling experience.
Single Listing Open Method: Control how a listing opens when a user clicks on it from the list:
Normal: Open the listing in the standard way – navigating to its single listing page.
Lightbox: Open the listing’s detail page in a lightbox modal overlay on the current page. (Requires Pro.)
Right Panel / Left Panel / Bottom Panel: Open the listing’s detail in a sliding panel on the page (from the right side, left side, or bottom). These panel options allow users to view details without leaving the map page. (These are premium options available with Pro.)
For Half Map, a Lightbox can be a great user experience so they don’t navigate away from the map. Choose the option that suits your needs – Normal is simplest, while Lightbox/panels provide an in-page detail view.
Under Default Sort, you can set how listings are ordered by default when this Half Map view loads:
Order By: Select the default sorting field. Options include:
Publish Date – order by newest or oldest listing date.
Update Date – order by the last modified date of listings.
Title – order alphabetically by title.
Price – order by price (if pricing is used).
Views – order by number of views (if tracking views).
Random – random order.
ID – order by the listing ID.
Author – order by listing author name.
Comments – order by number of comments.
(Additional criteria from addons may appear here; e.g., “Rating” if using the Reviews add-on Reviews, or “Rank” if using the Rank add-on Rank.)
Order: Choose Descending or Ascending for the default order direction. For example, you might choose to order by Publish Date in Descending order (so newest listings show first), which is a common default.
In Sort Options, you control which sorting choices are available to end-users in the front-end interface and how they are presented:
Display Sort Options: Toggle this ON to show a sort control to users. If turned OFF, users will not see any sort dropdown or buttons (the listings will just remain in the default order you set). By default this is enabled.
Sort Style: Choose how the sort options are displayed to users:
Default Style: Inherit the global or theme default style for the sort control.
Drop Down: Display the sort choices in a dropdown menu.
List: Display the sort choices as a horizontal list of buttons/links.
Available Sort Criteria: You will see a list of all possible sort criteria (as listed under Order By above). For each criterion, you can:
Enable/Disable it (a checkbox or toggle icon).
Rename it by editing its label text.
Set the default order direction (Ascending or Descending) when a user selects it.
Reorder the sort options by dragging them in this list; the order here will be the order they appear in the sort dropdown or list on the front-end.
For example, you might put “Price” and “Rating” at the top of the list if those are most important for your directory, and disable sorting by ID or Author if they aren’t relevant. The user’s sort UI will reflect these settings.
Use the Search tab to embed a search/filter form directly with your Half Map view. This is useful if you want users to narrow down the listings they see in the Half Map view:
Searchable: Toggle to enable or disable search for this shortcode. When enabled, the Half Map view can be filtered by a search form. When disabled, the shortcode shows fixed results that do not change based on search queries.
Search Form: Select which Listdom search form to display with this Half Map view. This dropdown will list any search forms you have created by their titles. Choose a form that has fields relevant to these listings.
Search Form Position: Choose where the search form appears in relation to the Half Map view:
Show on top
Show on bottom
Show on left
Show on right
Show before the listings
Top or bottom placement usually works best. Left or right can be used as a sidebar, and “Show before the listings” places the form ahead of the listing content. In Half Map layouts, top or bottom placement is often the easiest fit because the map and listing panels already split the page width.
Sticky Search Form: When using Show on left or Show on right, enable this option to keep the sidebar form visible while scrolling. If the form is taller than the viewport, Listdom automatically adds a vertical scrollbar.
Sticky Offset (px): Set the top spacing for sticky sidebar forms. This helps prevent overlap with fixed headers. Leave it empty to use default spacing.
Disabled: Submit normally with a full page reload.
On Submit: Apply filters via AJAX when the user submits the form.
On The Fly: Update results as the user changes fields.
The fields users see come from the selected search form itself. The Search settings here only control placement and behavior.
Usually, you will create a custom search form tailored to the listings shown in the Half Map view and select it here. That way, users can refine what they see without leaving the page.
To build and configure those forms, see Create Search & Filter Form and Search Form Fields and Options. For a practical walkthrough, see Listdom Search Forms.
The Filter Options tab lets you predefine criteria to limit which listings are shown in this Half Map view, even before any user search or interaction. These filters work behind the scenes to include or exclude listings based on taxonomy terms or other attributes.
For each filter type below, you can configure an Include list or Exclude list of terms. “Include” means only show listings that have those terms. “Exclude” means hide any listings that have those terms. If you leave a filter category blank, it imposes no restriction on that aspect.
Categories: Filter by listing categories.
Include Categories: Choose one or more categories; only listings in those categories will appear in this Half Map view.
Exclude CategoriesPro: Choose categories to omit; any listing in those categories will be left out.
Locations: Filter by location taxonomy.
Include Locations: Only show listings that are in the selected location(s).
Exclude LocationsPro: Omit listings that are in the selected location(s).
Tags: Filter by listing tags.
Include Tags: Show listings that have at least one of these tags.
Exclude TagsPro: Do not show listings that have any of these tags.
Features: Filter by features (these are like amenities or boolean attributes of a listing).
Include Features: Listings that have any of the selected feature(s) will be included.
Exclude FeaturesPro: Exclude listings that have any of the selected features.
Labels: Filter by label terms.
Include Labels: Show only listings that have one of these label(s) (for example, only “Featured” listings).
Exclude LabelsPro: Hide listings that have any of these labels.
Author (Listing Owner): You can restrict by listing author (the user who posted the listing).
Select one or more authors under Include to show only listings by those user accounts.
Or select authors under Exclude Pro to hide listings by those users.
Custom Fields: If you have custom fields associated with listings, they appear here for filtering based on the field type. Use these to include listings based on custom metadata (exclude options are not available for custom fields).
Checkbox: Enter the checkbox value to match.
Time: Pick a time value.
Date: Select a date.
Tel: Enter a phone value.
Textarea: Enter text to match the textarea content.
Text: Enter text to match the field value.
Number: Set a minimum and/or maximum range (two numeric inputs).
Dropdown: Choose one or more values from the dropdown list (multi-select).
Radio: Enter the radio value to match.
Datetime: Select a date and time value.
URL: Enter a URL value.
Email: Enter an email value.
Image: Image fields are not available as filters in this section.
Rank AddonRank: Added by the Listdom Rank add-on. Filter listings by rank using minimum and maximum values, or leave them blank to skip ranking filters.
MembershipsMembership: Added by the Listdom Membership add-on. Filter listings by membership packages using checkboxes.
You can combine multiple filters. A listing must satisfy all the Include filters and none of the Exclude filters to appear. Within a single filter type, if multiple terms are included, a listing that has any one of those terms will pass (logical OR for included terms within one filter type). Exclusions work similarly: if a listing has any one of the excluded terms, it will be filtered out.
If no Filter Options are set, the shortcode shows all eligible listings by default.
These pre-filters form the base dataset for the shortcode. If you also attach a search form, that search refines this pre-filtered set rather than replacing it.
Using Filter Options, you can create a Half Map shortcode that is targeted to a specific subset of listings. For example, you might include one category and one location, or exclude one tag, label, or author, to keep the output focused on exactly the content you want.
Imagine a city directory showing restaurants on a map. Using the Half Map skin, you position the map on the right and listings on the left. Under Filter Options, you include only the “Restaurant” category. You set Default View to Grid with 3 listings per row, so multiple restaurant cards display at once. The map provider is Google Maps with clustering enabled, so in dense areas multiple restaurant markers group into one. Users can use the search form you placed at the top (with fields like cuisine, neighborhood, etc.) and with Map Search enabled (Pro), the list automatically updates as they move the map. This provides an interactive city guide where users see restaurant listings and their locations in one glance.
Real Estate Listings with Map Search
You create a real estate listings page using Half Map. The map is on the left and listings on the right (by setting Map Position to Left). You allow both list and grid views (Default View: Grid). Each listing card shows a photo, price, and a “Favorite” heart icon for logged-in users (via the Favorite add-on Favorite). You enable Map Search so that as homebuyers pan the map to different neighborhoods, the listings refresh accordingly. The Sort Options are configured to offer sorting by price and newest listings first. This way, users can explore homes visually on the map and easily sort and filter results without leaving the page.
Listdom Official WebsiteVisit the official Listdom website for more guides, add-ons, and support.
