Basker Docs

Collections and cards

How Collection, Card patterns, Featured, Calendar, Masthead, and event blocks fit together, and which one to use.

These blocks show your own content, such as events, posts, people, and venues, on a page. A listing or a header then stays current as you add and edit that content. They divide into two jobs: blocks that list many items, and the header that sits on a single item's page.

The piece they share is a Card pattern: a reusable design for one item's title, image, and supporting details. A Collection decides which items appear and how it arranges the listing. Its Card Pattern decides what each item shows and how it looks. Create and edit patterns in Cards, under Design. Then select one in the listing block.

How they relate

  • Collection lists content automatically. Pick a content type and it shows everything of that type as cards, staying in sync as content changes. It can also list a hand-picked or rule-based set, and add filters readers use to narrow the list.
  • Card patterns are reusable designs for Collection and other content-listing blocks. Each pattern belongs to a content family, such as Events or People, and controls the visible details and layout.
  • Featured spotlights a hand-picked set of items as a full-width carousel, one slide per item, with per-slide overrides. Use it to highlight a curated few items instead of an auto-generated list.
  • Calendar shows your events in date-based formats: a running list of dates, a what-is-on grid, a day-by-day schedule, or an A-Z index. A shared filter panel applies across all of them.
  • Masthead is the large header in a page or content template. It matches the kind of page it sits on, and Basker builds it from that page's own details. Edit it in Templates, not the ordinary page-body block picker.
  • Event Instances and Venue add event detail below a Masthead. They show the performance dates with booking buttons, and where the event takes place.

Which one should I use?

You want to…Use
List content by type and keep it current automaticallyCollection
Change what listed items show or how their cards lookCard patterns in Cards, under Design
Scroll items in a swipeable rowCollection (Scroller layout)
Spotlight a hand-picked few items as a carouselFeatured
Show events on a date-based view with filtersCalendar
Build the header at the top of an event, person, or venue pageMasthead
List an event's performance dates with booking buttonsEvent Instances
Show an event's venue, address, and an info linkVenue

Event Instances and Venue appear in the block list only while you build an event page. See Create events.

Where to go next

On this page