تخطَّ إلى المحتوى

Listdom Single Map Skin Documentation

View Demo

هذا المحتوى غير متوفر بلغتك بعد.

With the Single Map skin, you can display a simple and clean map featuring directory and listing markers on your website. This skin does not show a list of listings by default (only map markers). It’s ideal for showcasing all listings on one map.

The Single Map skin presents listings as markers on a full-page map. There is no built-in list of results visible (unless using an optional sidebar). Users can click markers to view listing details. This skin is useful for directories where the map itself is the primary focus.

The Single Map skin does not have multiple style variations to choose from. It uses a default map layout. All styling is focused on map controls and markers (configured in Map settings). There is no separate “Style” selection dropdown for this skin.

The Map tab contains settings for the map provider, behavior of markers, clustering, and other map-specific options.

  • Map Provider: Select the map provider (e.g., Google Maps or Leaflet) for displaying the map. Defaults to Listdom’s global default provider. This setting determines which map service is used.
  • Map Style: (Google Maps only) If using Google Maps, choose a predefined map style or theme. You can select a custom map design to match your site’s look. Leave blank for the default style.
  • Map Height: Set the height of the map. Enter a value with units (for example, 500px or 100vh). If left blank, a default height (typically 500px) is used. Adjust this if you need a taller or shorter map on your page.
  • 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.
  • Limit: The maximum number of listings to display as markers on the map. Default is 300. To avoid performance issues, keep this number at or below 300. If you have more listings, use filters to narrow them down for this map.
  • Clustering: Enable or disable marker clustering. When enabled (default On), nearby listings will group into cluster “bubbles” on the map to keep it organized. Turning this Off will display every marker separately.
  • Bubbles: (Visible only if Clustering is On, Google Maps provider) Choose the style of cluster icons (“bubbles”) to use. Listdom provides several bubble icon sets (sizes and colors) to represent clusters. Pick one from the dropdown (default is the first set).
  • Marker/Shape On Click: Choose what happens when a user clicks a listing’s map marker or any drawn shape on the map. Options include Open Infowindow (default), Redirect to Single Listing Page, Open Single Listing in a Lightbox, or None.

    • Open Infowindow: Opens a small info popup on the map with brief listing details.
    • Redirect to Single Listing Page: Navigates directly to the listing’s own page.
    • Open Single Listing in a Lightbox: Displays the listing’s detail page in an overlay/lightbox on the current screen (no page reload).
    • None: No action; clicking the marker will do nothing.

    This setting lets you control how users get more information from the map. For example, infowindows keep users on the map, whereas redirect will take them to the listing page.

  • 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).

These options control how listing marker clustering works on the map.

  • Enable Clustering: Toggle On (default) to group nearby markers into cluster icons when zoomed out. Toggle Off to show all markers individually, even if they overlap.
  • Bubbles: If clustering is enabled and using Google Maps, select the cluster icon style (bubble images). Different “bubble” styles vary in color and size to represent clusters of listings. Choose one that fits your site’s design.

(The clustering settings above are the same as those under Map Structure for convenience.)

  • Map Search: Toggle to enable an interactive map search. When Map Search is On (requires Pro), the listing results can update automatically based on the map’s current viewport. This allows users to filter listings by moving or zooming the map – for example, only showing listings within the area they’re looking at. If Map Search is enabled, you can also connect search forms (see below). By default, Map Search is disabled in Lite (and this toggle will be unavailable without Pro).
  • Connected Shortcodes: (Visible only if Map Search is On and you have Listdom Pro) Select up to 3 other Listdom shortcodes (listing skins that are “searchable” like List, Grid, Masonry, etc.) to synchronize with this map. Using the auto-suggest field, choose the shortcodes whose results should link with this map’s filtering. For example, you might connect a Half Map or List + Grid shortcode here. When Map Search is active, those connected listing views will update in tandem with this Single Map’s position and filters. This is an advanced feature to create combined map/list views across shortcodes.
  • Auto Location (GPS): Automatic geolocation behavior. If enabled, the user’s browser is prompted for location permission on page load. After permission is granted, the map is centered on the user location and nearby listing filtering can be applied. This behavior supports both Google Maps and OpenStreetMap (Leaflet) and requires HTTPS.
  • Drawing Tools: Draw search shapes on the map. This is another advanced feature (available via Advanced Map) that lets users draw shapes (like polygons) on the map to filter listings within that area. The Single Map skin will support drawn shape filtering if the add-on is installed and activated.

(The Auto Location and drawing tools controls can be managed under the Map Controls sub-tab in the Map settings when the relevant add-on is installed.)

(Requires Advanced Map add-on Advanced Map) The Single Map skin can optionally include a sidebar that lists listings alongside the map:

  • Sidebar (Listings List): Enable this switch to display a listing list panel (sidebar) next to the map. By default, the sidebar is hidden (Off). This option appears only if the Advanced Map add-on is installed. When enabled, a scrollable sidebar on the side of the map will show the listings in list format in addition to the markers. The sidebar works with both Google Maps and OpenStreetMap (Leaflet) providers.

  • Default State: Choose the initial state of the sidebar when the page loads. Options:

    • Open (With Toggle): Sidebar starts open, and the user can hide/show it using a toggle button.
    • Open (No Toggle): Sidebar is always open and cannot be collapsed by the user.
    • Closed (With Toggle): Sidebar starts collapsed (hidden) but a toggle is available for the user to open it.

    Default is Open (With Toggle).

  • Mobile & Tablet Limit: Set how many listing cards are shown in the sidebar on small screens (mobile/tablet) before a Load More is required. Default is 12. This controls the sidebar’s initial list length for better performance on smaller devices.

  • Include Sidebar Search: If the sidebar is enabled, this controls whether a search form is shown at the top of the sidebar. By default On, it places a small search bar within the sidebar so users can filter results without leaving the page.

The Single Map skin is a map-only view, so it does not have traditional layout settings like columns or list style. There is no “Listings Per Row” or grid layout to configure (since no grid/list is shown).

However, you can control how many listings load (via Limit in Map settings) and how single listing pages open when clicked (via Marker On Click setting under Map). There is no pagination or “Load More” for Single Map because all markers (up to the limit) are displayed on one map.

Listing Link: (Not applicable in the usual sense for Single Map) – Instead of a list item link, the marker click behavior (infowindow, redirect, etc.) is configured in Map settings as described above. The standard Listing Link setting found in other skins is not used here.

The Sort bar is typically not used with the Single Map skin. Since listings aren’t listed in a visible list format, there is no user-facing sort dropdown in this view. Markers on the map do not have an inherent order that a user would sort by.

Default Sort: You can still set a default sorting method for the query (e.g. by date or title) in case it matters which listings are included first if you have a limit. By default, the Single Map will use List Date (newest first) as the order of retrieving listings. This can be changed in the Sort tab if needed (though it won’t visually affect the map markers).

Sort Options: This setting is not applicable for Single Map in the front-end, because no sort dropdown is shown to users. You can ignore the Sort Options for this skin – they will not be displayed on the map page.

Use the Search tab to embed a search/filter form directly with your Single Map. This is useful if you want users to narrow down the listings they see in the Single Map:

  • Searchable: Toggle to enable or disable search for this shortcode. When enabled, the Single Map 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 Single Map. 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 Single Map:
    • 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.

  • 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.

  • Ajax Search Advanced Portal Search: Choose the search behavior when AJAX is available:

    • 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 Single Map and select it here. That way, users can refine what they see without leaving the page. Make sure the selected search form is intended for the same listing dataset that this map shortcode displays. 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 Single Map, 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 Single Map.
    • Exclude Categories Pro: 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 Locations Pro: 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 Tags Pro: 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 Features Pro: 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 Labels Pro: 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 Addon Rank: Added by the Listdom Rank add-on. Filter listings by rank using minimum and maximum values, or leave them blank to skip ranking filters.
  • Memberships Membership: 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 Single 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.

City Offices Map: Use the Single Map skin to display all your company’s office locations on one interactive map. By setting a specific Label filter (e.g., “Headquarters” or “Branch”) and enabling Clustering, visitors can easily find the nearest office. The Marker On Click is set to Redirect, so clicking a marker takes the user to that office’s detail page for more info.

Vacation Rentals by Area: Create a page with the Single Map skin showing vacation rental listings filtered to a region (using Locations filter). Enable Map Search Pro so that as visitors pan or zoom the map, the rentals update to those visible in the area. This provides an intuitive way to find rentals geographically. Markers use Open Infowindow on click so users can preview details without leaving the map.