Banners
ContactPersonsArchiveBanner

ContactPersonsArchiveBanner

Archive/listing of contact persons, optionally with filters.

Includes the common banner props.

Contact person archive preview

Props

id
string
required

CMS id.

hideFilters
boolean
required

If true, filters UI is hidden.

query
string
required

Backend query string used to fetch the listing.

URL filtering behavior

This archive currently does not sync filters to the URL (disableUrlSync: true in frontend).

  • No f= URL filter state is restored on page load.
  • CMS defaults from query are applied during initialization.
  • hideFilters only controls filter UI visibility for this archive type.

Supported query params

The query prop accepts a standard URL query string. Multiple params are combined via &. Repeating the same key applies a list filter.

Brand

Filters by brand name.

  • Key: BRAND
  • Type: string (single)

Examples:

BRAND=BMW
BRAND=MINI

Service

Filters by service id.

  • Key: SERVICE
  • Type: string (single)

Examples:

SERVICE=svc_123
SERVICE=service-sales

Location

Filters by location id.

  • Key: LOCATION
  • Type: string (single)

Examples:

LOCATION=loc_123
LOCATION=location-berlin

Combined examples

BRAND=BMW&SERVICE=svc_123&LOCATION=loc_456
BRAND=MINI&SERVICE=service-sales&LOCATION=location-berlin

Sort options

Use the serialized enum values from @haendlerapp/types/src/enums/SortOption.ts and OrderOption.ts when configuring CMS query params.

Name

  • Vorname (A–Z) sort=FIRST_NAME&order=ASC

  • Vorname (Z–A) sort=FIRST_NAME&order=DESC

  • Nachname (A–Z) sort=LAST_NAME&order=ASC

  • Nachname (Z–A) sort=LAST_NAME&order=DESC

Creation Date

  • Neueste zuerst sort=CREATED_AT&order=DESC

  • Älteste zuerst sort=CREATED_AT&order=ASC

Banner example

const banner: ContactPersonsArchiveBanner = {
  typename: BannerTypename.ContactPersonsArchiveBanner,
  id: 'b_123',
  title: 'Contacts',
  titleTag: 'h2',
  titleAlign: 'left',
  cssId: null,
  cssClasses: null,
  hideFilters: false,
  query: 'BRAND=BMW&SERVICE=svc_123&LOCATION=loc_456'
};