Plusmodule: Neue Ergebnisliste (Galerie Karte (GaKa)): Eigene Filterkonfiguration - TYPO3

Plusmodule: Neue Ergebnisliste (Galerie Karte (GaKa)): Eigene Filterkonfiguration - TYPO3

Ergebnisliste (Galerie/Karte (GaKa)) - Anlegen Deiner Filter in der Ergebnisliste (GaKa)

Info
Die GaKa ist unser Modul für die ideale Darstellung von strukturierten Daten aus destination.data oder einer anderen Datenbank, sofern die Daten via Schnittstelle angebunden sind. Dabei funktioniert sie mit allen Datensatztypen - egal, ob POIs, Events, Touren u.s.w. Das Besondere: Hier können die Datentypen auch gemischt werden!
Notes
In diesem Artikel geht es nicht um die allgemeine Pflege der GaKa, sondern um die Pflege der Filterleiste. Die Infos zur allgemeinen GaKa-Pflege findet Ihr hier.

Darstellung im Frontend

Um euch das Modul im Frontend anzusehen, besucht einfach unsere Demo-Seite: Ergebnisliste (GaKa).
Das Modul besteht aus einer Galerie und einer Kartendarstellung – daher die Abkürzung GaKa. Welche Datentypen und Ergebnisse angezeigt werden, lässt sich im Backend individuell konfigurieren.

Beispiel: Mixed-GaKa ohne Vorbelegung auf einen bestimmten Datentypen:

Beispiel: Event-GaKa:


Welche Informationen findest Du hier im Artikel?

1. Pflege der eigenen GaKa-Filter
2. Pflege der eigenen Quicksearch-Filter
3. FAQ

Pflege der GaKa Filter im Backend

Alert
Wichtig:
- Für die Anpassung der Filter musst Du bereits eine GaKa gepflegt haben. Die Infos zur allgemeinen GaKa-Pflege findest Du hier.
- Außerdem können mit dieser Funktion keine Filter völlig frei erstellt werden. Es können die Filter gewählt/bearbeitet werden, die grundsätzlich im Produkt vorhanden sind.
- Die Pflege der individuellen Filter ist unabhängig von den vorbelegten Parametern (also Datentypen) der GaKa. Wenn eine GaKa also auf "Event" vorbelegt ist, sind dennoch alle Filter in der Auswahl zu sehen, auch wenn diese nicht speziell zu den Events gehören. Im Frontend würden sie auch nicht ausgegeben, sofern sie gepflegt wären. 

Voraussetzungen:

1. Bestehende Landingpage, auf der die GaKa innerhalb einer Rahmenbühne platziert werden kann.
2. Einspaltige Rahmenbühne (äußerer Container) hinterlegt, in welcher die GaKa platziert wurde.

1. Anlegen der Filterkonfiguration

1.1 Du startest im Reiter "Plugin-In", Abschnitt "Individuelle Filterkonfiguration" (dorthin gelangst Du über die Bearbeitung der Ergebnisliste -> Plugin).
Dort auf "+ Neu anlegen" klicken.

1.2 Möglichkeit 1: Filter mit Standardwerten befüllen

Sind noch keine Filter vorhanden, besteht über den Button "Filter mit Standardwerten befüllen" die Möglichkeit alle Filter aus der Standard-Filterkonfiguration zu erstellen (das sind alle im Produkt zur Verfügung stehenden Filter und damit sehr viele Filter). Das bedeutet, dass Du Dir damit eine sehr volle Filterleiste anlegst.
Dies wäre der schnellste Weg, wenn Du auf das ganze Filterrepertoire zurückgreifen möchtest und bspw. nur einige, wenige entfernt werden sollen.

Alert
Wichtig, wenn ihr diese Funktion nutzt: Nach dem Klick auf + Neu anlegen bei der Filterkonfiguration, muss einmal gespeichert werden. Andernfalls werden euch die Einstellung immer wieder zurückgesetzt. Habt hier auch ein wenig Geduld. Da es sehr viele Filter sind, dauert es u.U. einen Moment. 
Notes
Beachtet hier außerdem:
Habt ihr in der Vergangenheit Filter über die Kundenbetreuung oder eure PMs entfernen lassen, so gehören diese in eurem Projekt auch nicht mehr zum Standard und kommen somit bei oben stehender Option nicht mit.

1.3 Möglichkeit 2: Filter ohne Standardwerte befüllen
Steht von Anfang an fest, dass ihr für eure GaKa nur ein paar Filter benötigt, kann es sinnvoll sein, diese manuell anzulegen und nicht den Weg über die Standardfilter zu gehen (ansonsten musst Du alle Filter aus dem Standard wieder löschen).
Sobald Du mindestens einen Filter manuell angelegt hast, wird der Button für die Standardfilter ausgeblendet.

2. Anlegen der einzelnen Filter für die GaKa

2.1 Wähle zunächst "+ Neu anlegen"


Wenn bereits Filter in der Ansicht vorhanden sind, könnt ihr auch über das "+" an der Seite weitere neue Filter hinzufügen

Daraus ergibt sich ein neues Dialogfeld für die einzelnen Filter. 

2.2 Art des Filters wählen
Hier muss zunächst die Art des Filters aus einem Auswahlfeld aller verfügbaren Filterarten gewählt werden.

Die weiteren zu pflegenden Felder hängen von der gewählten Filterart ab.  Der Titel und das Layout des Filters können für jede Filterart gepflegt werden.
Notes
Auch hier ist nochmals zu erwähnen: Es ist egal, ob die GaKa bereits auf einen bestimmten Datentypen vorbelegt ist oder nicht. Ihr erhaltet hier immer in der Auswahl alle Filter. Diese werden dann je nach Typ im Frontend dargestellt oder nicht.

2.3 Filterarten
Warning
Bei allen Filtern wird immer der Featuretree aus destination.data zu den jeweiligen Datentypen abgefragt. Gibt es dann das Parent-Feature (also Oberkategorie) nicht im Tree, bzw. hat es keine Untereinträge, wird der Filter nicht angezeigt. Da sich die Trees je Projekt unterscheiden können, ist dies auch nicht global bei allen Projekten immer gleich. Wendet euch also gern an eure zuständigen Ansprechpartner:innen, wenn ihr Fragen dazu habt, warum evtl. ein Filter bei euch fehlt.

Bei folgenden Filterarten kann immer ausschließlich Titel, Layout und Datentyp vergeben werden:

Anreise und Parken
Hinweis: Dieser Filter ist auf das Parent-Feature "Parkplätze" gemappt. Der Filter erscheint also nur bei den Datentypen im Frontend, die das Feature "Parkplätze" nutzen.


Art des Datensatzes (Kategorie)
Hinweis: Dieser Filter ist auf den Kategorie-Baum gemappt und gibt immer die Unterkategorien aus. 

Beste Reisezeit
Hinweis: Dieser Filter greift auf die redaktionelle Pflege der Monatseignung in den Tourdaten (one.data) zurück. Dort wird für jeden Monat hinterlegt, wie gut er sich für die jeweilige Tour eignet – z. B. "(3) geeignet", "(2) witterungsbedingt", "(1) ungeeignet" oder "(0) - nicht definiert -". Nur auf Basis dieser Pflege kann der Filter im Frontend sinnvoll Ergebnisse ausspielen.
Im TYPO3-Backend wird der Filter unter "Art des Filters" als "Beste Reisezeit" angelegt. Wie bei den anderen individuellen Filtern lassen sich dabei Titel/Label und Layout ("Primary"/"Secondary") frei konfigurieren – das Filterlabel im Frontend kann also redaktionell frei benannt werden.
Im Frontend erhalten Nutzer:innen eine Auswahl aller zwölf Monate (Januar bis Dezember) und können einen oder mehrere Monate anhaken, um nur die Touren angezeigt zu bekommen, die für den gewählten Zeitraum als geeignet gepflegt wurden.
URL-Verhalten:
Bei Auswahl eines oder mehrerer Monate wird die Seiten-URL entsprechend ergänzt, z. B. um /season:(6 OR 7 OR 9) bei Auswahl der Monate Juni, Juli und September.
Unterschied zu anderen Filtern:
Im Gegensatz zum Filter "Relativer Suchzeitraum" oder dem bisherigen Filter "Zeitraum", die sich auf den Buchungs-/Aufenthaltszeitraum eines Nutzers beziehen (heute, morgen, Wochenende, konkrete Datumsspanne), bezieht sich "Beste Reisezeit" auf eine redaktionell gepflegte Eigenschaft der Tour selbst – nämlich in welchen Kalendermonaten sie inhaltlich/witterungsbedingt am besten geeignet ist. Es handelt sich also nicht um einen dynamischen oder relativen Datumsfilter, sondern um einen inhaltlichen Eigenschaftsfilter auf Monatsbasis, ähnlich dem Prinzip von "Ausgewählte Merkmale", nur eben speziell für die Monatseignung von Touren.


Oberkategorie
Hinweis: Dieser Filter ist auf den Kategorie-Baum gemappt und gibt immer die Oberkategorien aus. 


Nach übergeordneter Kategorie
Hinweis: Dieser Filter ist auf den Kategorie-Baum gemappt. Diese Filter gibt es für Betriebsarten, Küchenarten und Kategorien - je nach dem, welche Bereiche bei den Datentypen vorhanden sind.
Je nach Datentyp kann ein Filter für die Kategorien auf verschiedenen Ebenen angelegt werden. Im unten stehenden Screenshot wird dies am Beispiel der Gastgeber gezeigt.
Filter für:
  1. Betriebsart, dieser gibt dann die Inhalte des roten Bereichs aus
  2. Tagungskategorien, dieser gibt dann die Inhalte des blauen Bereichs aus
  3. Event-Location, dieser gibt dann die Inhalte des grünen Bereichs aus


Frei wählbare Kategorie
Hinweis: Hinweis: Anders als die bisherigen Filter, die jeweils fest auf bestimmte Parent-Features oder den Kategorie-Baum gemappt sind, ermöglicht dieser Filtertyp die freie, individuelle Zusammenstellung von Kategorien im TYPO3-Backend. Er ist für alle Datentypen verfügbar und kann somit z. B. auch bei Datentypen genutzt werden, für die es bislang keinen passenden vordefinierten Filter gab.
Im Backend könnt Ihr dabei Folgendes festlegen:
  1. Art des Filters: Auswahl "Frei wählbare Kategorien"
  2. Layout: Bestimmt die Darstellungsgröße/-priorität des Filters im Frontend ("Primary" wird prominenter dargestellt als "Secondary")
  3. Titel: Freier Name des Filters, wie er im Frontend angezeigt wird (z. B. "Essensrichtung")
  4. Nur bei diesen Datentypen anzeigen: Hier bestimmt Ihr, bei welchen Datentypen (z. B. Gastro, Blog, Story, Webcam, Tour) der Filter überhaupt ausgespielt wird
  5. Ausgewählte Kategorien: Hier wählt Ihr frei aus allen verfügbaren Kategorien diejenigen aus, die im Filter zur Auswahl stehen sollen (z. B. "Gastro - asiatisch", "Gastro - böhmisch", "Gastro - französisch" usw.)
Beispiel:
Ihr möchtet einen Filter "Essensrichtung", der ausschließlich bei Gastro-Einträgen erscheint und dem Nutzer die Auswahl zwischen verschiedenen Küchenstilen (asiatisch, böhmisch, französisch, griechisch, indisch, …) ermöglicht. Dazu legt Ihr den Filtertyp "Frei wählbare Kategorien" an, vergebt den Titel, schränkt die Anzeige auf den Datentyp "Gastro" ein und wählt anschließend die gewünschten Kategorien aus der Liste der verfügbaren Objekte aus.

Unterschied zu den bisherigen Kategorie-Filtern (z. B. "Nach übergeordneter Kategorie" oder "Ausstattung"):
Während die bisherigen Filter automatisch anhand fest hinterlegter Parent-Features oder des Kategorie-Baums erscheinen und inhaltlich vorgegeben sind, gebt Ihr bei "Frei wählbare Kategorien" selbst vor, welche Kategorien – unabhängig von deren Herkunft im Kategoriebaum – gemeinsam in einem Filter gebündelt werden. Dadurch lassen sich flexiblere, thematisch zugeschnittene Filter erstellen, die nicht an eine vorgegebene Struktur gebunden sind.


Ausstattung
Hinweis: Dieser Filter ist auf mehrere Parent-Features gemappt. Diese sind: "Ausstattung, Service, Freizeit/Sport, Zusätzliche Ausstattungsmerkmale, Ausstattung_Camping, Technische Ausstattung, Sonstige Ausstattung/Einrichtung".  Der Filter erscheint also nur bei den Datentypen im Frontend, die eines oder mehrere dieser Features nutzen.

Ausgewählte Merkmale
Hinweis: Dieser Filter ist auf Merkmale gemappt. Er bietet die Möglichkeit im TYPO3 zu bestimmen, welche Merkmale unterhalb Eures Filters ausgegeben werden sollen.
Beispiel - Gastronomie:
Ihr möchtet einen Filter für Ausstattung, der nur die Merkmale zeigt, die für Kinder relevant sind. So könnt Ihr im TYPO3 Backend das übergeordnete Merkmal wählen und im zweiten Schritt bestimmen, welche Unter-Merkmale im Filter erscheinen sollen:

    
Backend: Pflege des Filters


Frontend: Filterdarstellung


Nach übergeordnetem Merkmal
Hinweis: Dieser Filter ist auf Merkmale gemappt und ermöglicht es im TYPO3-Backend, gezielt festzulegen, welche Merkmale unterhalb eines übergeordneten Merkmals im Filter ausgegeben werden sollen.

Bei der Konfiguration wählt Ihr zunächst aus einer Liste aller im Projekt verfügbaren übergeordneten Merkmale ("Parent-Merkmale") dasjenige aus, auf das sich der Filter beziehen soll. Diese Liste ist nicht auf einen bestimmten Datentyp beschränkt, sondern enthält übergeordnete Merkmale für alle im Projekt vorhandenen Datentypen, z. B.:

Allgemeine Informationen (POI)
Allgemeine Informationen (Event)
Anforderung (Tour)
Art der Bestuhlung (Hotel)
Art der Veranstaltung (Hotel)
Art des Raumes (Hotel)
Ausstattung (Gastro)
Ausstattung (Hotel)
Ausstattung Camping (Hotel)
Barrierefrei (Hotel)
Barrierefrei (Gastro)
Barrierefreiheit (POI)
Barrierefreiheit (Gastro)
u.v.m.

Anschließend werden im Frontend die Merkmale, die unter dem gewählten Merkmal der übergeordneten Ebene liegen, ausgegeben.

Barrierefrei
Hinweis: Dieser Filter ist auf mehrere Parent-Features gemappt. Diese sind: "Barrierefrei, Barrierefreiheit, Mindeststandards für Barrierefreiheit". Der Filter erscheint also nur bei den Datentypen im Frontend, die eines oder mehrere dieser Features nutzen.

Belegung (ohne Kinder)
Hinweis: Dieser Filter steuert die Auswahl der Anzahl von Erwachsenen bei der Unterkunftsbelegung. Hier wird auf das Feld occupation Parameter für die Hyper zurückgegriffen. Das Ganze funktioniert also nur, wenn die Hyper gebucht wurde. 

Belegung (mit Kindern) 
Hinweis: Dieser Filter ermöglicht die Auswahl der Anzahl der Reisenden (Erwachsene und Kinder). Für Kinder muss zusätzlich ein Alter angegeben werden. Hier wird auf das Feld occupation Parameter für die Hyper zurückgegriffen. Das Ganze funktioniert also nur, wenn die Hyper gebucht wurde. 

Besucheraufkommen
Hinweis: Dieser Filter nutzt die Besucherauslastung aus destination.data bzw. der Meta. Voraussetzung ist eine aktuelle Pflege der Daten bzw. eine Anbindung der Daten/Sensoren. Das Feld in der Meta nennt sich "peoplecount" bspw. "peoplecount:medium" bei mittlerer Besucherauslastung. 

Buchbar 
Hinweis: Dieser Filter greift auf den Parameter bookable=true zurück.
 
Eigenschaften
Hinweis: Dieser Filter ist auf mehrere Parent-Features gemappt. Diese sind: "Zielgruppe, Reisezeit, Eigenschaften, Eignung, Gruppen". Der Filter erscheint also nur bei den Datentypen im Frontend, die eines oder mehrere dieser Features nutzen.

Eignung:
Hinweis: Dieser Filter ist auf mehrere Parent-Features gemappt. Diese sind: "Zielgruppe, Reisezeit, Eigenschaften, Eignung, Gruppen". Der Filter erscheint also nur bei den Datentypen im Frontend, die eines oder mehrere dieser Features nutzen.

Highlight (hier keine Einschränkung der Datentypen)
Hinweis: Dieser Filter greift auf die Markierung für "Highlights" aus destination.data zurück (gelbes Sternchen)

Lage/Umkreis (hier keine Einschränkung der Datentypen)
Hinweis: Dieser Filter filtert anhand der ausgewählten Koordinaten und der Angabe zum Umkreis. Hierzu werden die in destination.data gepflegten Parameter (latitude, longitude und distance) verwendet. Außerdem ist hier die Definition einer Entfernung für die Umkreissuche möglich. Im Filter-Editor kann die maximale Entfernung sowie der Standardwert für den Einstieg des Swipers gepflegt werden.


Öffnungszeit
Hinweis: Gilt für Gastro und POI 
Greift auf die Leistung der Öffnungszeiten aus destination.data zu:


Qualitätssiegel
Hinweis: Dieser Filter ist auf mehrere Parent-Features gemappt. Diese sind: "Klassifizierung, Tagungsort Auszeichnung". Der Filter erscheint also nur bei den Datentypen im Frontend, die eines oder mehrere dieser Features nutzen.

Serientermine einzeln anzeigen
Hinweis: Gilt nur für Events

Skigebiet geöffnet
Hinweis: Gilt nur für Skigebiete. Dieser Filter ist auf das Feld "Skiberichts-Status" im "Schneebericht" unter "Informationen" gemappt:


Sprachen
Hinweis: Dieser Filter ist auf mehrere Parent-Features gemappt. Diese sind: "Sprachen des Autors, Fremdsprachen, Sprachkenntnisse". Der Filter erscheint also nur bei den Datentypen im Frontend, die eines oder mehrere dieser Features nutzen.

Zeitraum 
Hinweis: Dieser Filter ermöglicht im Frontend die Auswahl fest definierter Zeiträume. Nutzer können dabei:
  1. über eine Kalendereingabe eine konkrete Datumsspanne wählen,
  2. den aktuellen Tag ("Heute") auswählen,
  3. den Folgetag ("Morgen") auswählen,
  4. das nächste Wochenende auswählen.
In allen vier Fällen wird die Auswahl vom System in konkrete Datumsangaben umgerechnet und die URL entsprechend ergänzt (z. B. mit einem festen Start- und Enddatum). Das bedeutet: Sobald die URL erzeugt wurde, ist der Zeitraum statisch – er bezieht sich immer auf das Datum, das zum Zeitpunkt der Auswahl galt, und aktualisiert sich nicht mehr automatisch.
Der Filter wird für Datentypen mit Daten wie Events oder Packages genutzt.


Der relative Suchzeitraum lässt sich im TYPO3-Backend vorbelegen, sodass er sich automatisch auf den jeweiligen Aufrufzeitpunkt bezieht, statt an ein festes Datum gebunden zu sein. Das ist besonders sinnvoll, wenn Ergebnislisten mit Gastgebern geteilt werden, da der Zeitraum sich bei jedem Aufruf neu relativ aktualisiert.
Zusätzlich besteht die Möglichkeit, einer GAKA/Ergebnisliste per Link folgende Parameter anzuhängen, um den Zeitraum direkt vorzugeben:
mode:today – gibt die Ergebnisse für den heutigen Tag aus
mode:tomorrow – gibt die Ergebnisse für den morgigen Tag aus
mode:this_weekend – gibt die Ergebnisse für das kommende Wochenende aus
Der Filter wird für Datentypen mit Daten wie Events oder Packages genutzt.
Idea
Unterschied zum neuen Filter "Relativer Suchzeitraum":
Während der bisherige Filter "Zeitraum" die Auswahl (z. B. "Morgen") sofort in ein fixes Datum übersetzt und dieses in der URL festschreibt, bleibt beim neuen Filter der Parameter (z. B. mode:tomorrow) relativ in der URL erhalten. Das heißt: Ruft jemand den Link zu einem späteren Zeitpunkt erneut auf, bezieht sich "Morgen" immer auf den aktuellen Aufrufzeitpunkt – nicht auf ein einmal festgelegtes Datum aus der Vergangenheit.

Dadurch eignet sich der neue Filter besonders gut zum Teilen von Ergebnislisten (z. B. mit Gastgebern), da der Link dauerhaft "aktuell" bleibt, während der alte Filter nach einer gewissen Zeit ein veraltetes, festes Datum anzeigen würde.

2.4 Einstellungsmöglichkeiten der Filter "Basic"
2.4.1 Feld "Titel"

Definiert das Label, wie der Filter im Frontend benannt wird.


2.4.2 Feld "Layout"
Bestimmt die Optik, in der der Filter im Frontend erscheinen soll. 
Filter mit gewähltem Layout "Primary" (rot) werden im Frontend prominenter dargestellt als Filter mit gewähltem Layout "Secondary" (blau).


2.4.3 Feld "nur bei diesem Datentypen anzeigen"
Definiert, bei welchem Datentypen der Filter ausgegeben werden soll.
Alert
Das geht natürlich nur, wenn es dazu auch ein gemapptes Feature bei dem Datentypen gibt (siehe Hinweise unter 2.3 und 2.5)
Alert
Es gibt einige Filter, die nur bei bestimmten Datentypen Verwendung finden (bspw. Tagungsräume nur bei mice). Andere Filter gibt es bei allen Datentypen (bspw. Kategoriefilter).

2.5 Einstellungsmöglichkeiten Filter mit mehr Konfigurationsmöglichkeiten

max. Anzahl Hotelzimmer
Hinweis: Gilt nur für Convention
Hier kann neben den Basis-Feldern auch ein Icon für das Frontend und die minimale sowie maximale Personenanzahl gepflegt werden:

Mindestanzahl Hotelzimmer (für Convention)
Diesen Filter gibt es auch mit der Logik nach "Mindestanzahl" Hotelzimmer. Die Pflege funktioniert genauso. 


max. Anzahl Tagungsräume
Hinweis: Gilt nur für Convention
Hier kann neben den Basis-Feldern auch ein Icon für das Frontend und die minimale sowie maximale Personenanzahl gepflegt werden:

Mindestanzahl Tagungsräume (für Convention)
Diesen Filter gibt es auch mit der Logik nach "Mindestanzahl" Tagungsräume. Die Pflege funktioniert genauso. 


max. Personenzahl
Hinweis: Gilt nur für Convention
Hier kann neben den Basis-Feldern auch ein Icon für das Frontend und die minimale sowie maximale Personenanzahl gepflegt werden:

Mindestanzahl Personen (für Convention)
Diesen Filter gibt es auch mit der Logik nach "Mindestanzahl" Personen. Die Pflege funktioniert genauso. 


Art der Bestuhlung
Hinweis: Gilt nur für Convention
Hier kann neben den Basis-Feldern auch ein Icon für das Frontend gepflegt werden.

Datentyp
Hinweis: Hier kann neben den Basis-Feldern auch die Auswahl getroffen werden, welche Datentypen im Frontend im Filter auftauchen sollen und mit welchem Label. So könnt Ihr bspw. die Auswahl für "POI" mit dem Label "Sehenswürdigkeiten" im Frontend ausgeben lassen.
Über "Optionen" fügt Ihr bei "+ Neu anlegen" so Datentyp für Datentyp hinzu. Das Feld "Wert" definiert jeweils, auf welchen Typen zurückgegriffen wird.
Der Datentyp "Area" muss - auch wenn das Modul area+ gebucht wurde - immer hier über die Filterkonfiguration ergänzt werden. Dieser kann nicht im Standard ergänzt werden, da er sonst immer angezeigt würde, auch wenn in einem Projekt area+ nicht zur Verfügung steht.


Dauer  (Befindet sich aktuell in Überarbeitung)
Hinweis: Dieser Filter greift auf den Parameter "duration" in der Meta zurück. Dies wird aktuell für die Dauer von Touren verwendet.

Dauer für Pauschalen
Hinweis: Dieser Filter ist auf den Reiter "Allgemeines" -> Aufenthaltsdauer gemappt

Hier kann im Backend eine Auswahl aus der Liste der Angaben der Aufenthaltsdauer für die Anzeige im Dropdown im Frontend gewählt werden:

Höhenunterschied
Hinweis: Gilt für Touren 
Minimum definiert den tiester Punkt der Tour.
Maximum definiert den höchsten Punkt der Tour.
Schrittweite definiert, welche Sprünge der User macht, wenn der Wechsler betätigt wird (bspw. 50 m)

Höhenmeter ab- bzw aufsteigend
Hinweis: Gilt für Touren 
Minimum definiert die minimale Anzahl von Höhenmeter der Tour.
Maximum definiert die maximale Anzahl von Höhenmeter der Tour.
Schrittweite definiert, welche Sprünge der User macht, wenn der Wechsler betätigt wird (bspw. 25 m)
   

Höchster / tiefster Punkt 
Hinweis: Gilt für Touren 
Minimum definiert den tiefsten Punkt der Tour.
Maximum definiert den höchsten Punkt der Tour.
Schrittweite definiert, welche Sprünge der User macht, wenn der Wechsler betätigt wird (bspw. 20 m)

Keywords
Hinweis: Der Filter gilt für alle Datentypen und greift auf das Feld "Keywords" aus destination.data zurück. Hier könnt Ihr zunächst definieren, wie sich die Keywords untereinander verhalten, also ob sie mit UND oder ODER verknüpft werden.

Anschließend legt Ihr die einzelnen Keywords an. Auch hier geht es wieder über "Optionen" bei denen Ihr im Titel das Label für das Frontend definiert. Wert ist das Keyword aus destination.data, auf welches zurückgegriffen werden soll.

Küchenart
Hinweis: Gilt nur für Gastronomie
Dieser Filter ist auf den Reiter "Küchenarten" gemappt. Hier kann neben den Basis-Feldern auch ein Icon für das Frontend gepflegt werden.

Ort/Ortsteil
Hinweis: Dieser Filter greift auf die Orte aus destination.data zurück - unabhängig vom gewählten Datentypen. Über die Ortsauswahl könnt Ihr frei bestimmen, welche Orte im Filter auftauchen sollen. Zu beachten: Die Orte im Filter im Frontend passen sich nicht intelligent an die Suchergebnisse in der GaKa an. Wenn Ihr also den Ort "Aachen" mit aufnehmen im Filter und die GaKa keinen Datensatz diesen Ortes beinhaltet, gibt sie 0 Ergebnisse aus.


Preisspanne
Hinweis: Gilt für Event, Hotel, Convention, Package, POI. Im Standard wird hier "€" verwendet. Bei Bedarf kann das pro Projekt in "CHF" geändert werden. 
Minimum definiert den Start des Preis-Wechslers.
Maximum definiert das Ende des Preis-Wechslers.
Schrittweite definiert, welche Sprünge der User macht, wenn der Wechsler betätigt wird (bspw. 50€ Schritte)



Schwierigkeit (für Touren)
Hinweis: Dieser Filter ist auf den Reiter "Tour-Info" -> Strecke -> Schwierigkeit gemappt


Hier können im Backend die Labels für das Frontend definiert werden:



Streckenlänge (für Touren)
Hinweis: Dieser Filter ist auf den Reiter "Tour-Info" -> Strecke -> Länge gemappt


Minimum definiert den Start des Strecken-Wechslers.
Maximum definiert das Ende des Strecken-Wechslers.
Schrittweite definiert, welche Sprünge der User macht, wenn der Wechsler betätigt wird (bspw. 5km Schritte)



Tageszeit


Hinweis: Der Tageszeit-Filter kann im Standard nur für die Datentypen Event, Gastro und POI verwendet werden. Auf Nachfrage können wir den Filter auch zusätzlich für Packages und Tours erweitern.

Mit dem Tageszeit-Filter können gezielt Datensätze ausgegeben werden, die am aktuellen Tag oder im nächstmöglichen passenden Zeitbereich stattfinden bzw. geöffnet sind.

Der Filter greift dabei auf die gepflegten "Öffnungszeiten" und "Termine" beim Datensatz zurück. Diese Informationen müssen über die Leistungen "Öffnungszeiten" sowie "Termine/Regeln" gepflegt sein. Hinterlegte Fließtexte werden für den Tageszeit-Filter nicht berücksichtigt.

Beispiel

Es sind folgende Tageszeiten hinterlegt:

  • Vormittags: 8–12 Uhr

  • Nachmittags: 12–17 Uhr

  • Abends: 17–24 Uhr

Ein Webseitenbesucher sucht am 01.01.2026 um 10 Uhr nach einer passenden Veranstaltung am Nachmittag und wählt im Filter „Nachmittags, 12–17 Uhr“ aus.

Die Ergebnisliste zeigt nun alle passenden Veranstaltungen an, die am selben Tag zwischen 12 Uhr und 17 Uhr stattfinden.

Befindet sich der Besucher bereits außerhalb des gewählten Zeitbereichs, zum Beispiel wenn er um 18 Uhr nach einem Event im Zeitraum „Nachmittags, 12–17 Uhr“ sucht, werden nur noch Events aus diesem Zeitbereich am Folgetag ausgegeben.

Datensätze, welche in den jeweils anderen Zeitbereichen stattfinden, zum Beispiel Vormittags oder Abends, werden dabei nicht berücksichtigt. Der Datensatz wird nur in dem Zeitraum angezeigt, wenn die Öffnungszeit mit der ausgewählten Tageszeit übereinstimmt.


Anlegen Öffnungszeiten Gastro/POI

Anlegen Termine Events

The image displays a calendar interface with various dates marked for single appointments, including 14th, 18th, 21st, and 25th of August 2026, and additional actions such as editing events and experience assignments.

KI-generierte Inhalte können fehlerhaft sein.

Anlegen Filter Tageszeit im TYPO3-Backend:

The image displays a user interface with a dropdown menu for creating a filter with selectable options, including a section for specifying start and end times separated by a semicolon.

KI-generierte Inhalte können fehlerhaft sein.

Abend

KI-generierte Inhalte können fehlerhaft sein.


Orte für Stories
Hinweis: Gilt nur für story+
Der Filter greift auf das Feld "Ort" bei den einzelnen Storys zurück:

Story-Themenbereiche
Hinweis: Gilt nur für story+
Der Filter greift auf das Feld "Tags (Schlagworte)" bei den einzelnen Storys zurück:


Info
Neue Filter ordnen sich in der Reihenfolge immer untereinander an.

Außerdem könnt Ihr die Filter über den Schieberegler ein- und ausblenden.


Pflege der Quicksearch Filter im Backend

1. Anlegen der Filterkonfiguration

Im ersten Step definiert man hier, für welchen Datentyp der Filter gelten soll:


Sobald der Datentyp definiert wurde, habt Ihr hier die gleiche Filterauswahl wie bei der GaKa und die Logik der Pflege ist auch genau gleich:


Notes
Der Filter "Suchwort" wird immer automatisch ergänzt.

FAQ

1.)
Q:
 Kann die Reihenfolge der Filter im Nachhinein geändert werden?
A: Ja, diese können mit den Pfeilen nach oben und unten verschoben oder per Drag and Drop an die gewünschte Stelle gesetzt werden.


2.)
Q:
Was bedeutet die Zahl (in dem Beispiel die "4", wenn ich eine individuelle Filterkonfiguration anlege?
A: Das ist die uid der Filter-Konfiguration (die ja ein Datensatz in TYPO3 ist). Diese wird automatisch erstellt und kann nicht verändert werden. 


3.)
Q:
 Wie funktioniert die Relevanz-Sortierung in unserer Suche?
A: Die Suchfunktion bewertet Ergebnisse nach Relevanz, einem Punktwert, der zeigt, wie gut ein Ergebnis zur Suche passt. Die Relevanz wird anhand der folgenden Kriterien ermittelt:

- Häufigkeit des Suchbegriffs:
      Je häufiger ein Suchbegriff im Text eines Angebots vorkommt, desto höher wird dessen Bedeutung eingeschätzt. Zum Beispiel wird ein Hotel, das häufig das Wort "Sauna" in seiner Beschreibung verwendet, als relevanter für die Suche nach "Wellness Wochenende Sauna" eingestuft.
- Spezifität des Begriffs:
      Spezifische Begriffe, die selten in anderen Texten vorkommen, erhöhen die Relevanz deutlich, da sie gezielte Interessen besser abdecken. Zum Beispiel werden Begriffe wie "Infinity-Pool" oder "Weinverkostung" höher gewichtet, weil sie präzise Merkmale eines Angebots darstellen, im Gegensatz zu häufig verwendeten generischen Begriffen wie "Hotel" oder "Strand".
- Highlight-Markierung:
      Angebote, die als Highlights gekennzeichnet sind, erhalten einen zusätzlichen Boost in der Reihenfolge, da sie als besonders empfehlenswert oder herausragend gelten. Dadurch erscheinen sie weiter oben, wenn sie zu deiner Suche passen. 

Was bedeutet das für den Gast auf der Website?
✅ Er findet schneller die passenden Angebote
✅ Wichtige und konkrete Informationen zählen mehr
✅ Highlights, die zu der Suche passen, landen ganz oben
✅ Die Sortierung nach Relevanz ist perfekt für die inspirierende Suche
(z. B. „Sommerurlaub mit Kindern am See“)

Beispiel:
Suche nach „Wellness Wochenende Sauna“:
→ Hotels, die diese Begriffe mehrfach und konkret erwähnen, erscheinen ganz oben.
→ Angebote, bei denen diese Begriffe nur am Rande vorkommen, rutschen nach unten

4.)
Q:
 Können auch mehrere Filterkonfigurationen in einer GaKa angelegt werden?
A: Ja, aber es wird immer nur die erste aktive Filterkonfiguration verwendet.

5.)
Q:
 Können auch globale Filterkonfigurationen getroffen werden, die für alle GaKas greifen?
A: Ja, dafür braucht es in Eurem Projekt einen Ordnder, der JSON config (oder ähnlich heißt). Dort könnt Ihr die Filter genau so dann global anlegen. Wenn Ihr diesen Ordner (noch) nicht in Eurem Projekt habt, geht gern auf Eure:n Ansprechpartner:in zu.

6.)
Q: Was ist der Unterschied zwischen in der GaKa oder Filterkonfiguration sind gar keine Datentypen ausgewählt oder es sind alle Datentypen ausgewählt?
A: keine Datentypen ausgewählt ≠ alle Datentypen ausgewählt.

Keine Datentypen ausgewählt = keine ifTypes gesetzt = eher allgemeine Filter

Datentypen gewählt = ifTypes gesetzt = spezifische Filter kommen zusätzlich mit raus
    • Related Articles

    • Plusmodule: Neue Galerie Karte (GaKa) - TYPO3

      Galerie/Karte (GaKa) - Darstellen und Filtern von strukturierten Daten Die GaKa ist unser Modul für die ideale Darstellung von strukturierten Daten aus destination.data oder einer anderen Datenbank, sofern die Daten via Schnittstelle angebunden sind. ...
    • one.pages: Integration in eigene Webseite

      1. Einführung one.pages Die one.pages sind Ausgabe-Module für Ihre Webseite zur Darstellung strukturierter touristischer Angebote wie Artikel, Gastgeber, Pauschalen, Veranstaltungen, Gastronomie, POI/Ausflugstipps sowie Touren & Wege. 1.1 Wo finde ...
    • Plusmodule: Teaserdarstellung: Slider (Card- und Kachelansicht) und Kachelwand

      Teaser - Darstellen von strukturierten Daten im Teaserformat Die Teaser sind Module für die ideale Darstellung von strukturierten Daten aus destination.data oder einer anderen Datenbank, sofern die Daten via Schnittstelle angebunden sind. Dabei ...
    • Plusmodule: Quicksearch - TYPO3

      Die Suche für Deine strukturierten Daten Bei der Quicksearch handelt es sich um ein Modul, welches eine individuelle und detaillierte Suche für strukturierte Daten auf einer Landingpage ermöglicht; beispielsweise für Veranstaltungen. Das Modul im ...
    • HERE Geocoder für die Karte - TYPO3

      HERE Geocoder Die neue GaKa arbeitet nicht mehr mit HERE. Warum? Die Here Geocoder ID ist eine Credential die benötigt wird, damit unsere Karten korrekt funktionieren. Die ID sorgt dafür, dass auf here.com zugegriffen werden kann um den Standort und ...