Listdom Gallery Skin Documentation

注意

The Gallery skin is available in Listdom Pro Pro. Ensure the Pro add-on is active to use this skin.

The Gallery Skin presents listings in an image-focused grid. Each listing card highlights the featured image and can optionally display an image slider of all gallery images. It’s similar to the Grid skin but with enhanced image presentation. You can optionally show a map above or below the gallery.

1. Select Gallery Skin: Create a shortcode and choose Gallery as the skin (requires Pro).
2. Choose Style Variation: In the Style tab, select a gallery style and decide if images should show as cover or slider on each card.
3. Toggle Listing Elements: Choose which information (title, categories, share buttons, etc.) appears on the cards.
4. Configure Layout: Set the number of columns, listing limit, and pagination method in the Layout tab.
5. Finalize & Embed: Save the shortcode and embed it. Listings display in a responsive gallery grid with the chosen styling.

For shared shortcode setup steps, see Listdom Shortcodes Overview. For practical shortcode examples, see Display Listings with Listdom Shortcodes.

Skin

After selecting Gallery, you’ll see a notice that this skin displays listings in a mosaic-like format and can include a map. If Pro is not active, the admin will show a warning and the skin will not function.

Style

The Style tab controls both image behavior and which elements appear on each card.

Image

• Display Image: Toggle to show or hide the image on the card. Normally enabled to highlight visuals.
• Image Method: Choose Cover to show the featured image or Slider to display all gallery images within the card.
• Image Fit: Set how the image fills its container, Cover crops to fill, while Contain shows the whole image with possible letterboxing.

Other Elements

• Categories: Show category labels on each card.
• Share Buttons: Enable social share icons if the Socials component is active.
• Title: Display the listing title (recommended).
• Price: Show the price if pricing is relevant.
• Labels: Display listing labels on the cards.
• Favorite Icon: If the Favorite addon is active, show a heart icon for quick favoriting.
• Compare Icon: With the Compare addon, show a compare toggle on each card.
• Claim Status: If the Claim addon is active, display a claimed indicator.
• Review Stars: Show rating stars when the Reviews addon provides review data.
• Excerpt/Description: Some styles let you show a short excerpt. Enable and set a word limit if available.

Map

Map Structure

Gallery skin can include an optional map. In the Map tab, pick a provider, Leaflet or Google Maps (Google Maps requires the Advanced Map addon). Position the map at the top or bottom of the gallery, set its height, and enable clustering if you have many listings. You can also choose what happens when a marker is clicked (info window or open listing).

Layout

Listing Output

• Columns: Choose how many cards appear per row (commonly 2, 3, or 4).
• Limit: Set how many listings load initially. Use an even number like 12 to keep rows balanced.
• Pagination Method: Select Load More, Infinite Scroll, or Numeric Pagination. Disabled shows only the initial set with no way to load more.

Listing Link

• Listing Link Pro users can open listings in a new tab, lightbox, or panel instead of the default behavior.

Sort

Default Sort

Enable Default Sort to control the initial order (e.g., Date Descending, Title Ascending, Random). You can also display a sort bar and choose which sort options (Date, Title, Price, Rating, Views, Random) are available to users.

Search

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

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

Filter Options

The Filter Options tab lets you predefine criteria to limit which listings are shown in this gallery, 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 gallery.
  • 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.

警告

Very narrow include filters combined with exclude rules can leave you with no results. Exclude rules also take precedence for listings that match both your include and exclude selections, so always test the shortcode after saving.

提示

For very advanced filtering logic (for example, if you need complex AND/OR conditions or more dynamic filtering), consider using the Advanced Portal Search (APS) add-on. APS enhances how searches and filters are processed, allowing more granular control over which listings show up. It’s useful when the built-in include/exclude filters are not sufficient for your needs.

Using Filter Options, you can create a gallery 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.

Examples

Real Estate Listings Grid

Use Image Method = Slider so each property card cycles through gallery images. Enable Price and Review Stars, and allow a lightbox view for quick details. Infinite Scroll keeps the gallery loading as users browse.

Curated Gallery of Top Restaurants

Filter by a “Top10” label and set Limit = 10 with 2 columns. Show rating stars and categories so visitors can quickly scan your curated list.