Locations Shortcode

The Locations shortcode [listdom_location] lists your listing Locations taxonomy (such as countries, cities, neighborhoods) in different layouts. This helps users navigate listings based on location hierarchy.

Display Styles

• style: Layout style for displaying locations. Options: image, simple, clean. Default: clean.
  • image: Each location is shown as an image card with its name (uses the location’s assigned image).
  • simple: Locations are shown as a basic text list (columns controlled by grid).
  • clean: Locations appear in a clean grid, with an icon placeholder or circle (if icons were supported) and name.
• grid: (For simple or clean style) Number of columns per row. Allowed values: 1, 2, 3, 4, 6. Default: for clean 2, for simple 3. This defines how many location items are in each row for those styles.
• max_grid: (For image style) Maximum number of location cards per row (1-8). Default: 8. If fewer locations exist, the row will just contain those; if more, they wrap to next line.
• show_count: Whether to show the number of listings in each location. Use 1 to display counts or 0 to hide. Default: Off for clean and image styles (count shown only if enabled); On for simple style (count is shown by default).

Filtering Options

• hierarchical: Display locations hierarchically (i.e., parent regions with child subregions nested). Use 1 for yes or 0 for no. Default: 1 (since Locations taxonomy is inherently hierarchical). When enabled, only parent locations (e.g., countries or top-level regions) are listed initially, with their sub-locations listed underneath in the output. When disabled, all locations will appear as a flat list (you can still filter by a specific parent using parent).
• parent: Show only locations that are children of a specific parent location. Accepts a location ID or name. For example, parent="California" will list only locations under “California”. If not set (and hierarchical=1), the shortcode will list top-level locations by default. If hierarchical=0, using parent simply filters the flat list to those under the given parent.
• hide_empty: Use 1 to hide locations with no listings, or 0 to show all locations regardless of emptiness. Default: 0 (include empty locations in the list).
• ids: Comma-separated list of location IDs to display exclusively. Example: ids="101,102,103" will list only those location terms (useful if you want to show a selected set of cities or regions).
• search: Filter locations by a keyword. Only locations whose names contain the search term will be shown. E.g., search="New" might match “New York” or “New Jersey”.
• orderby: Field to sort locations by. Typically name for alphabetical or count for number of listings. Default: name (A-Z by location name).
• order: Sorting order, ASC or DESC. Default: ASC. For example, orderby="count" order="DESC" would list locations from most listings to fewest.

提示

You can assign images to your locations (for example, a city skyline image for each city) via the Locations taxonomy settings. These images will appear when using the image style, adding visual context to the location list.

Examples

State to Cities List:
To list cities within a specific state or region, you could use [listdom_location style="simple" parent="California" hierarchical="0"]. This will output a flat list of all child locations of California (e.g., cities in California) in a simple list format.

Locations Image Cards:
If you want a visual display, try [listdom_location style="image" limit="6"]. Ensure each location has an image set. This might show, for example, 6 city cards with their images. The limit="6" makes sure only the 6 locations (perhaps top or randomly ordered by default) appear.