コンテンツにスキップ

Mosaic Skin

View Demo

このコンテンツはまだ日本語訳がありません。

The Mosaic Skin presents your listings in a visually striking alternating layout. Each listing card’s image and details are laid out side-by-side in alternating positions (one listing with image on the left and details on the right, the next with image on the right and details on the left), creating a mosaic effect. This skin is ideal for directories that want a creative, magazine-style listing grid.

To use the Mosaic Skin, navigate to Listdom > Shortcodes (or the Listdom block settings) and select Mosaic View from the skin selection grid. Once selected, the following options specific to Mosaic become available:

  • Skin Description: The Mosaic skin alternates listing card layouts to add visual variety. It does not show a map alongside listings by default, focusing on the listing cards themselves.

  • Availability: Because of its alternating design, the Mosaic skin works best with an even number of listings per page to maintain the pattern. (You can still use an odd number, but one side of the last row will be empty.)

Once Mosaic is selected, you can choose a style variation and control which elements appear on each listing card:

Select the Style: Use the dropdown to choose the style variation for Mosaic. By default, Style 1 is used. If the Mosaic skin offers additional styles (for example, Style 2), you can select them here. Style variations slightly change the design of the listing cards:

  • Style 1: Displays listing categories and social share buttons on the card.
  • Style 2: Displays the listing location on the card (in place of categories) and omits share buttons for a cleaner look.

If you have created a completely custom layout for Mosaic (via the Listdom Layout Builder), that custom style will also appear in this dropdown. In most cases, you will use the provided styles.

After choosing a style, you can toggle the visibility of various elements on the listing cards. This allows you to simplify or enrich the information shown at a glance:

  • Image: Enable or disable the listing’s featured image on the card. By default this is enabled to showcase each listing visually. If turned off, the image section is removed. Enabling the image also unlocks additional image settings:
    • Image Method: Choose how to display listing images. Cover shows only the featured image as a static image. Slider shows all gallery images in a slider on the card, allowing users to click or swipe through multiple photos. (Cover is default; slider provides an interactive gallery on each card.)
    • Image Fit: Control the image object fit. Cover (default) will crop/zoom the image to fill the space, while Contain will letterbox the image to show the whole image without cropping. This setting helps ensure images display nicely within their container.
  • Contact Info: Toggle the listing’s contact information (such as phone or email icons, or a contact button) on each card. When enabled, a small contact detail section or icon appears, allowing users to quickly see how to reach the listing’s owner.
  • Location: (Style 2 only) Show the listing’s location taxonomy (e.g. city or region) on the card. If enabled, the location name will appear (usually near the title or meta info). This is useful if your directory uses Locations and you want to highlight where each listing is.
  • Categories: (Style 1 only) Show the listing’s category labels on the card. If enabled, the category (or categories) assigned to the listing will display, helping users identify the type of listing at a glance.
  • Share Buttons: (Style 1 only) Show social share buttons on each card. If enabled, small icons (e.g. Facebook, Twitter) allow users to share the listing on social media directly from the listing card. This option requires the Social Sharing component in Listdom. By default, Listdom Pro supports share buttons for listings.
  • Price: Show or hide the listing’s price. If your listings have pricing (for example, a property price or product price), enabling this will display the price on the card. This option is only meaningful if the Pricing feature is enabled in Listdom (which it is by default in Pro).
  • Title: Show or hide the listing title. Usually you will keep this on (default) so that each listing’s name is visible. If turned off, no title will appear (which is rarely recommended).
  • Claim Status: If the Claim addon is active, you can toggle the Claim Status indicator. Enabling this will show a badge or marker on listings that have been “claimed” by their owners. (Unclaimed listings might show an “unclaimed” notice, for example.) If the Claim addon is not installed, this option will not be available.
  • Labels: Toggle the display of listing labels. Labels are custom markers (like “Featured”, “New”, etc.) that can be assigned to listings. If the Labelize addon is active (which introduces listing labels), enabling this will show any labels on the card (usually as a ribbon or badge on the image).
  • Favorite Icon: If the Favorite addon is installed, you can choose to show a Favorite icon (often a heart) on each card. When enabled, users can click the heart to save the listing to their favorites list. If the Favorite addon is not active, this option will be hidden, and the favorite icon won’t appear.
  • Compare Icon: If the Compare addon is installed, you can show a Compare icon on each card. This lets users add the listing to a comparison list. (Without the addon active, the compare icon option is hidden.)
  • Review Rating: If the Reviews addon is active (enabling user reviews and ratings), you can toggle the display of the listing’s average rating (star rating) on the card. Enabling this will show star icons or a rating value so users can see how the listing is rated.

By customizing these element visibility switches, you can control how much information is presented in the Mosaic view. For example, you might disable Contact Info and Share Buttons for a cleaner look, or enable Labels and Favorite icons to encourage interaction.

Unlike some other skins, Mosaic can optionally include a map, but it doesn’t display a map by default in its layout. Instead, you have the option to show an overview map either above or below the listing grid. The Map settings allow you to configure this:

  • Map Provider: Choose the map service for the map component. The default is Leaflet (OpenStreetMap), which works out-of-the-box. If you have the Advanced Map addon (or if using Pro’s advanced map features), you can also select Google Maps here. Selecting Google Maps will utilize Google’s mapping service (requiring a Google Maps API key, configured in Listdom settings).
  • Map Position: Determine where the map will appear in relation to the listings. Options are Top (map above the listing cards) or Bottom (map below the listing cards). For example, choosing “Top” will place a full-width map at the top of the Mosaic view, showing pins for each listing before the list; “Bottom” will show the map after the list of listings. The default position is Top.
  • Map Height: Specify the height of the map display. You can enter a value with units (e.g., 500px or 70vh). If left blank, a default height (typically 500px) is used. Adjust this if you want a taller or shorter map. For instance, using a percentage or viewport height (100vh) can make the map fill the screen.
  • Clustering: Enable or disable marker clustering. When clustering is enabled (default is on), nearby listings on the map will be grouped into cluster markers (with a number indicating count) instead of overlapping. This makes the map easier to read when many listings are close together. You can turn this off to show all individual markers, but it’s recommended to keep it on if you have a dense map.
  • Cluster Images: If using clustering, you may provide custom cluster marker images or styles. (This is an advanced option; by default, Listdom provides a standard cluster icon.) This field accepts an image URL or preset for cluster icons. It’s primarily useful with the Advanced Map addon for further customization of cluster appearance.
  • Map Style: Apply a custom style theme to the map. This setting is mainly applicable to Google Maps. You can enter a style JSON or select a predefined style (if provided). For example, you might use a dark theme map style here. If left blank, the default map style is used.
  • On-Click Action: Choose what happens when a user clicks a marker on the map. Options include showing an Info Window (a small pop-up with listing info - this is the default) or directly opening the listing’s single page. “Info Window” keeps users on the same page, while a direct open will navigate them to the listing detail page. Pick the one that fits your user experience.
  • Map Search Synchronization: Enable Map Search to allow the map to interact with the listings. When this is enabled, the listing results will update based on the map’s viewport – for example, only listings visible in the current map area will show (and panning/zooming the map can load new listings). This feature is disabled by default and requires Listdom Pro. When enabled, it provides an interactive “search as I move the map” experience.
  • Automatic Geolocation (Auto GPS): If enabled, the map will attempt to automatically center on the user’s location (with their permission) when the page loads. This helps show relevant local listings first. This feature is a Pro capability and by default is off. Use it if you expect many users to want local results immediately.
  • Map Controls: (Advanced Map Addon) If you are using Google Maps via the Advanced Map addon, a sub-section called Google Maps Controls will appear. Here you can toggle various controls on the Google map, such as Zoom buttons, Street View Pegman, Map Type toggle (Map/Satellite), Fullscreen control, etc. These allow you to fine-tune the user interface of the Google map. For example, you might disable Street View and fullscreen buttons for a cleaner look or enable the scale bar. These options only apply to Google Maps; for Leaflet maps, the controls are minimal and not separately configurable in this interface.

Layout options control the overall structure and pagination of the Mosaic view:

  • Listings Per Page (Limit): Set the maximum number of listings to display per page in the Mosaic view. The default is 300. You can lower this to only show a subset of listings. For example, setting Limit to 12 will show 12 listings at a time. Because Mosaic’s pattern works best in pairs, it’s recommended to use an even number here (e.g., 12, 14, 16). If you set an odd number, the last row will have one listing without a counterpart on the other side.

  • Pagination Type: Choose how additional listings are loaded when there are more listings than the per-page limit:

    • Disabled: No pagination controls are shown. Only the first set of listings (up to the limit) will display, and users cannot load more from the front-end.
    • Load More Button: A button labeled “Load More” will appear below the listings. Users can click it to load the next set of listings (appending to the list).
    • Infinite Scroll: Listings will automatically load as the user scrolls down, without the need for a button. This provides a continuous scrolling experience.
    • Numeric Pagination: Traditional page numbers are shown (1, 2, 3, …) allowing users to navigate to specific pages of results.

    By default, the Mosaic skin uses a Load More button for a modern feel. You can switch to Numeric if you prefer pages, or Infinite Scroll for a seamless feed.

  • Columns: Specify the number of listing columns per row. Mosaic is fundamentally a two-column layout (one listing on the left, one on the right for each row). By default, it’s set to 2 columns. You can technically set a different number, but note that the Mosaic design alternates content in pairs, so using an odd number of columns may disrupt the intended pattern. It’s recommended to keep this at 2 columns for the proper mosaic effect.

The Mosaic skin supports full sorting controls, allowing users to reorder the listings according to various criteria. The Sort settings are divided into Default Sort and Sort Bar Options:

Under Default Sort, you can define the initial sorting order of listings in this shortcode:

  • Default Sort By: Choose the field by which listings are sorted when the page first loads. Options include Date (usually by publish date), Title (alphabetical), Price (if pricing is enabled), Rating (if using reviews), Views (if tracking views), or Random. For example, you might set the default sort to “Date (Newest First)” to always show newest listings first.
  • Default Order: Choose Ascending or Descending for the Default Sort field. For instance, if Default Sort By is Date and Default Order is Descending, the newest listings will appear first (this is the typical default). If you chose Title and Ascending, listings would default to A→Z alphabetical order.

Together, these define the initial listing order for the Mosaic view until the user changes it.

Under Sort Options, you can configure how and whether the sort bar is displayed to users:

  • Display Sort Bar: Toggle this option on to show sorting controls on the front-end. If enabled, users will see the sort interface (either a bar with dropdowns or a single dropdown, depending on style). If you turn this off, the listings will remain in the default order and users won’t be able to change sorting.

  • Sort Bar Style: Choose the layout for the sort controls. Default Style shows the sort options in a horizontal bar (e.g., a dropdown for sort field and toggles or indicators for order). Drop Down style condenses the sorting into a single dropdown menu (which might list options like “Newest first, Oldest first, A-Z, Z-A, etc.”). The dropdown style is compact, whereas the default may display separate controls.

  • Available Sort Options: You can select which sorting criteria are available to the user. Typical options are:

    • Date: Sort by publish/creation date.
    • Title: Sort alphabetically by title.
    • Price: Sort by price (requires pricing feature enabled).
    • Rating: Sort by average review rating (requires Reviews addon).
    • Views: Sort by view count/popularity (requires Stats or another view-tracking feature).
    • Random: Include a random sort option (so users can randomize the order).

    You can check or uncheck each to determine which options the user sees. For example, if you don’t want users sorting by title, you can disable that option. Or if your directory doesn’t use pricing, you would disable the Price sort. By default, all relevant sorts are enabled. Each enabled sort will appear as an option in the sort UI on the Mosaic listing page.

Configure these to match your use case. If, for instance, freshness is key, you might only enable Date and maybe Rating; if alphabetical browsing matters, include Title.

The Mosaic skin can integrate with Listdom’s search module, allowing you to place a search bar or form that filters the listings:

  • Search Shortcode: Select which Listdom Search form to use with this listings shortcode. Listdom allows you to create custom search forms (via Listdom Search shortcodes). In this dropdown, you’ll see the list of available search form shortcodes by their titles/IDs. Choose the one that fits this listing view. For example, if you have a “Directory Search” form, select it here to pair it with the Mosaic listings.

  • Search Position: Decide where the search form appears in relation to the listings:

    • Top: The search form will be displayed above the map (if a map is top) and above the list of listings.
    • Bottom: The search form will appear below the listing cards (and below the map if map is at bottom).
    • Before Listings: The search form will appear after any top-positioned map but before the listing cards. (In Mosaic, this effectively can be similar to Top if you have a map; it ensures the search is just above the listings themselves.)
    • Left or Right: Not typically used in Mosaic. (These positions are more relevant for skins that have a sidebar. Mosaic skin doesn’t have a dedicated sidebar area, so left/right would likely behave similar to Top in this context.)

    Common choice is Top so that users can refine results immediately.

  • AJAX Search: Enable this to make the search form filter results without reloading the whole page. With AJAX search on, when a user submits the search or changes a filter, the Mosaic listings will update dynamically beneath the search form. If this is off, using the search will reload the page with the filtered results. AJAX provides a smoother experience and is recommended if your site supports it. (This requires Listdom Pro – in Listdom Lite, search will always reload the page.)

Once set up, the search + mosaic combo allows users to narrow down the displayed listings. For example, if they search a keyword or apply a category filter in the search form, the Mosaic list will update to show only matching entries, all while maintaining the mosaic layout.

Filter Options let you pre-filter which listings appear in this Mosaic view, regardless of user search. These settings act as conditions to include or exclude listings by certain criteria. They are especially useful if you want a shortcode to show only a specific subset of listings (like only one category, or excluding certain entries).

You can combine Include and Exclude rules. Include rules restrict the listings to only those that match the chosen criteria, while Exclude rules remove listings that match certain criteria. Here are the available filter settings:

  • Include Categories: Select one or more categories to display. Only listings belonging to those categories will be shown. (If left empty, listings from all categories are allowed.) For instance, if you choose Restaurants, the Mosaic view will show only listings in the “Restaurants” category.

  • Exclude Categories: Select categories that should be excluded from results. Listings in any of those categories will not appear. For example, if you exclude Closed Businesses, no listing tagged as a Closed Business will show up.

    Note: Include and exclude can be used together. If both are set, Listdom will first include only the selected include categories, then remove any of those that are in the exclude list.

  • Include Locations: Choose specific locations to show. Only listings assigned to those location terms will be shown. For example, include New York to only show listings located in New York.

  • Exclude Locations: Choose location terms to omit. Listings in those locations will be filtered out (e.g., exclude California to hide any listings in California).

  • Include Tags: If you use listing tags, you can include only listings with certain tags. For instance, include the tag Featured to only show listings marked Featured (if you use tags that way).

  • Exclude Tags: Filter out listings with certain tags. For example, exclude the tag Expired to hide any listings marked as expired.

  • Include Features: If you have listing features (amenities) taxonomy, select which features to require. Only listings that have all the selected features will be shown. For example, include Wi-Fi to show only listings that have Wi-Fi amenity.

  • Exclude Features: Select features to exclude any listing that has them. For instance, exclude Outdoors if you want to hide listings that are marked with an “Outdoors” feature.

  • Include Labels: If using Labelize (listing labels like “Featured”, “New”), you can include listings that have certain labels. e.g., include Featured label to only show featured listings.

  • Exclude Labels: Exclude listings that have specific labels. For example, exclude the Featured label to show everything except featured listings.

  • Include Authors: Choose specific listing authors to include. Only listings posted by those user accounts will show. This is useful if you want a shortcode to display listings from specific vendors or agents.

  • Exclude Authors: Choose authors whose listings should be hidden. Any listing created by those users will not display in this Mosaic view.

Each filter field is multi-select, so you can pick one or many terms/users. If multiple Include filters are set (e.g., include Category A and Location X), a listing must match all of them to appear (i.e., be in Category A and Location X). The Exclude filters remove any listing that matches any of the exclude criteria.

Note: Filter Options are purely for the shortcode’s initial query. Users can still further filter via search (if you provided a search form) which will layer on top of these filters. For instance, if your shortcode is filtered to Category = Restaurants, and the user searches within that, they’ll only be searching Restaurant listings.

City Guide Mosaic

An tourism website uses the Mosaic skin to showcase attractions. Each listing’s featured image is on alternating sides, giving a lively magazine-like layout. The site owner enabled share buttons and favorite icons on each card – visitors can quickly save attractions they like or share them to social media. With a map positioned at the top, users get an overview of attraction locations in the city, and they can scroll down to see each spot in the stylish alternating format.

Real Estate Gallery Slider

A real estate directory leverages Mosaic skin with the image Slider option. House listings display a photo slideshow on each card that users can click through without leaving the page. Important info like price and location are shown on each card, while less critical details are hidden to keep it clean. The result is an eye-catching property gallery where buyers can browse listings visually, then click a listing to learn more. Infinite scroll is enabled so new properties load automatically as users scroll.