Skip to Content
BannersContactPersonsArchiveBanner

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.

ID

Filters by contact person id.

  • Key: ID
  • Type: string (repeatable)
  • Note: If at least one ID is present, all other archive filters are ignored. sort, order, and page-based load-more behavior still apply.

Examples:

ID=cp_123 ID=cp_123&ID=cp_456

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

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' };
Last updated on