List & Filter

List & Filter turns your map into a proper directory: a scrollable list or grid of locations, with sorting, pagination, and a search filter — instead of (or replacing) the default carousel.

This is an Ultimate module. Enable it under Progress Map Ultimate → Ultimate Modules. Do not install a separate List & Filter plugin.

What it does

  • Replaces the carousel experience with a richer listings UI
  • List view and/or grid view with an options bar
  • Sort by date, title, ID, or custom fields
  • Paginate long result sets
  • Filter by keyword, date, taxonomies, and custom fields
  • Stay synchronized with map markers (click marker → scroll list; click list item → move map)

Live UI inspiration: demos on codespacing.com (List & Filter).

Enable the module

  1. Go to Progress Map Ultimate → Ultimate Modules.
  2. Enable List & Filter.
  3. Save.
  4. Edit the map where you want the list and open the List & Filter settings (map settings / layout area provided by the module).
  5. Activate List & Filter on that map so it replaces the carousel (exact control label: activate / use List & Filter for this map).

If the carousel still shows, the module may be enabled globally but not activated on that specific map.

Layout settings

Option Purpose
Layout type How map and list are arranged (side-by-side, stacked, etc.)
Map height Control the map pane height in this layout
Maximum list height Keep long lists scrollable inside a fixed panel

Test mobile early: directory layouts are sensitive to height and sticky bars in themes.

Options bar

The options bar sits above the list and can include:

  • Toggle list vs grid view
  • Initial view (list or grid)
  • Number of grid columns / items per row
  • Posts count (“24 results”)

Show or hide the bar depending on how minimal you want the UI.

List items

Control what each row/card displays and how it interacts with the map:

  • Scroll the list when the matching marker is clicked
  • Change map zoom when a list item is clicked
  • Custom title / content from custom fields and categories
  • Title and/or image as links; choose same tab / new tab / modal behaviour
  • Show or hide images
  • Show or hide a control that focuses the item’s location on the map

Content tip: use real excerpts and consistent image sizes. If thumbnails look tiny, regenerate WordPress image sizes (same class of issue as carousel featured images).

Sort options

Offer visitors sort modes:

  • ID, date, title
  • Custom field values (price, rating, …)
  • Control which sort options appear and in which order

Default sort should match Query settings expectations so first paint is not surprising.

Pagination

  • Items per page
  • Pagination above and/or below the list
  • Alignment (left / center / right)
  • Previous / Next labels
  • Full page list vs shortened pagination

Pagination is essential once you pass a few dozen listings — loading hundreds of DOM rows at once hurts mobile.

Search filter (list sidebar)

Activate the list’s own filter panel (left or right):

  • Show or hide on page load
  • Place Filter / Reset buttons top and/or bottom
  • Reorder fields
  • Keyword, publish date, taxonomies, custom fields
  • Customize the Filter button label

This filter works with the list population coming from the map query. For a completely separate search landing page, use Advanced Search. For marker-centric filtering on the map chrome, see Markers Filter.

Shortcode attributes

List & Filter can be influenced via map shortcode attributes (layout and list-related parameters). Prefer configuring the map in admin first; use attributes for template-level overrides. The full attribute list will also appear under Shortcodes.

Example pattern (map still required):

[cspm_main_map id="123"]

Attributes vary by version — check the map/module UI and shortcode reference for the exact names supported by your Ultimate build.

Custom icons

You can use custom icons in list UI elements (filter controls, view toggles, etc.) where the module exposes upload/select fields — match your brand like map button icons in Customize.

Common recipes

Goal Approach
Classic real-estate directory List + filter taxonomies (type, city) + sort by price meta
Compact mobile UX List view default, pagination 10, filter hidden until opened
Map-first marketing page Keep map large; list max-height constrained

Troubleshooting

Issue Check
Carousel still visible Module on + activated on this map
Empty list Map query and coordinates
Filter does nothing Field keys / taxonomy names; JS console errors; cache
Tiny images Regenerate thumbnails
Clashes with old plugin Deactivate standalone List & Filter if still installed

Related

Top