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