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.
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.
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).
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.
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 addon, or “Rank” if using the Rank addon.)
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 form above, below, or alongside the listings in the Half Map view. This allows users to filter or search within the listings directly on the page.
Search Shortcode: Select which Listdom search form to display. You may have created one or multiple search forms using Listdom’s search form builder. All available search form shortcodes are listed here by name/ID. Choose the search form that is relevant for this listing view.
Position: Choose where the search form will appear relative to the listing+map layout. Options:
Top – display the search form above the map and listings.
Bottom – display the search form below the listings (and map).
Left – display the search form in a left sidebar area.
Right – display the search form in a right sidebar area.
For Half Map, typically Top or Bottom is used (Left/Right might overlap with the map area in this skin).
Use AJAX: If enabled (AJAX Search), the search form will filter the listings without a full page reload. The listings panel will update dynamically when the user submits the search or changes fields, while keeping the map and page intact. If disabled, using the search form will reload the page with filtered results. AJAX search provides a smoother experience, so it’s recommended to turn this on. (This requires JavaScript enabled in the browser.)
Typically, you would create a tailored search form and then select it here for the Half Map view. Set the position to Top so users can refine results and see both the updated list and map immediately.
The Filter Options tab lets you pre-filter which listings will appear in this Half Map view. These filters act on the dataset of listings before they display, allowing you to include or exclude specific categories, locations, etc., without user input.
For each filter type below, you can choose to Include or Exclude terms. “Include” means only show listings that match those terms. “Exclude” means show everything except listings that match those terms. If you leave a filter blank, it will not restrict that aspect.
Categories: Restrict listings by category taxonomy.
Include Categories: Select one or more categories here to show only listings in those categories.
Exclude Categories: Select categories to omit from results.
Locations: Choose specific locations.
Include Locations: Only listings in the selected location(s) will be shown.
Exclude Locations: Omit listings in the selected location(s).
Tags: Filter by listing tags.
Include Tags: Show listings that have at least one of these selected tags.
Exclude Tags: Do not show listings that have these tags.
Features: Filter by features (custom features/amenities of listings).
Include Features: Only listings that have all of the selected features will be shown.
Exclude Features: Remove listings that contain any of these features.
Labels: Filter by labels.
Include Labels: Only show listings that have one of these labels.
Exclude Labels: Exclude listings that have any of these labels.
Author (Listing Owner): Filter by listing author/user. Select one or multiple authors to include. Only listings posted by those user(s) will show. If left empty, listings by all authors are allowed.
Custom Fields: If you have custom fields defined for listings, you can filter by their values. For example, a numeric field might allow setting minimum and maximum values; a select field might allow choosing specific options.
If multiple filters are set, a listing must satisfy all of the Include filters to appear, and must not match any Exclude filters. Within a single filter category, if you include multiple terms, a listing that has any of those terms will be included (logical OR). Exclusions similarly remove a listing if it has any of the excluded terms.
By setting Filter Options, you can reuse this Half Map shortcode for specific subsets of listings. For instance, you might create one Half Map view that only shows “Restaurants in New York” by including the “Restaurant” category and a “New York” location. Another Half Map shortcode could show “Hotels except those tagged as Boutique” by including “Hotel” and excluding the “Boutique” tag.
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). 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.
