Filter Grid and Cards

module_filter_grid

The Filter Grid displays pages as cards with keyword search, optional category filters, result counts and Newest/A–Z sorting. It is currently used on News and Events.

#Select the data source

Add module_filter_grid to the page that owns the content:

This module can also be used as a child of a subpage_layout parent, but its page itself remains the data source.

Card field mapping

All cards use the page headline (falling back to its name) and link to that page.

The card image uses the first image attachment when one exists. Otherwise it falls back to the page Meta image. Cards are still valid without images.

Category filters

Add one or more filter:Category name tags to a Blog Post, Event or Basic child. The filter controls are generated automatically from the categories present on the rendered cards and sorted alphabetically.

Examples:

• filter:Media release
• filter:Living Wage rate
• filter:Election event

Filtering with several categories uses OR logic: a card is shown when it matches any selected category.

Search and sorting

Keyword search checks card headlines only and is case-insensitive. Clearing the field restores all matching cards.

• Newest sorts by each page's publication date.
• A–Z sorts by the displayed headline.

The initial Blog order comes from NationBuilder's most-recent posts. Calendar cards initially use upcoming-event order even though choosing Newest later uses the page publication date.

Content-editor notes

• Use a concise headline; it is both the card title and search text.
• Add the excerpt when a short card summary will help users.
• For Events, complete the NationBuilder event time and venue fields rather than typing them into the body.
• Keep category spelling and capitalisation consistent. filter:Media release and filter:Media releases become different filters.