Wert von/bis für ein Datumsfeld

Die Filterregel „Wert von/bis für ein Datumsfeld“ (Paket filter_fromto) filtert Items anhand eines Datumsbereichs für ein einzelnes Datum-Attribut. Besucher können im Frontend ein „Von“-Datum, ein „Bis“-Datum oder beides eingeben. Die Filterregel vergleicht die als UNIX-Timestamp gespeicherten Datumswerte mit dem angegebenen Bereich.

Typische Einsatzbereiche: Terminfilter (Veranstaltungen von Datum X bis Datum Y), Gültigkeitszeiträume, oder allgemeine Datumsbereichsfilter.

Ein eigenes Template mm_filteritem_datepicker.html5 steht für eine browserbasierte Datumseingabe zur Verfügung. Für das HTML5-date-Inputfeld muss das Datum im Format YYYY-MM-DD übergeben werden – mehr Informationen.

Siehe auch

Für den Vergleich über zwei separate Datumsattribute steht die Filterregel Wert von/bis für zwei Datumsfelder zur Verfügung.
Für numerische Werte steht die Filterregel Wert von/bis für ein Feld zur Verfügung.

Siehe auch

Für einen modernen Datumspicker im Frontend: Einfache Datumsauswahl für den Filterregel from-to durch Integration von Flatpickr

Installation

Die Filterregel wird über den Contao Manager oder Composer installiert:

composer require metamodels/filter_fromto

Einstellungen beim Anlegen der Filterregel

Einstellung	Beschreibung
Typ	Auswahl des Filterregeltyps – hier: „Wert von/bis für ein Datumsfeld“.
Aktiviert	Aktiviert oder deaktiviert diese Filterregel.
Kommentar	Freitextfeld zur Beschreibung des Zwecks dieser Filterregel.
Attribut	Das Datum-Attribut, nach dessen Wert gefiltert werden soll.

Einstellungen für das Frontend-Widget

Einstellung	Beschreibung
URL-Parameter	Der Schlüssel (Key) des URL-Parameters für die Übergabe des Filterwerts. Ohne Angabe wird der Spaltenname des Attributs verwendet. Mit auto_item wird nur der Wert – ohne Schlüssel – in die URL eingebaut.
URL-Typ für den Parameter	Legt fest, ob der Parameter als Slug (sprechende URL), als GET-Parameter übergeben wird (ab MM 2.4) - siehe SEO
Datumsformat	Das Format, in dem das Datum im Frontend-Eingabefeld erwartet wird (z. B. d.m.Y oder Y-m-d). Standard: Contao-Datumsformat aus den Systemeinstellungen.
Zeittyp	Legt fest, ob nur das Datum (date), Datum und Uhrzeit (datim) oder nur die Uhrzeit (time) verglichen wird.
Label	Beschriftung des Filterwidgets.
Label beim Filterwidget ausblenden	Unterdrückt die Ausgabe des Labels.
Template	Template für die Widget-Ausgabe. Standard: mm_filteritem_default; für Datepicker-Eingabe: mm_filteritem_datepicker.
Platzhalter	Platzhaltertext in den Eingabefeldern.
Mehr-als-Gleich (≥)	Ist diese Option aktiv, gilt das „Von“-Datum als inklusiv (>=).
Weniger-als-Gleich (≤)	Ist diese Option aktiv, gilt das „Bis“-Datum als inklusiv (<=).
Von-Feld anzeigen	Aktiviert die Anzeige des „Von“-Datumsfelds im Widget.
Bis-Feld anzeigen	Aktiviert die Anzeige des „Bis“-Datumsfelds im Widget.
CSS-ID/Klasse	Setzt eine CSS-ID oder -Klasse am Widget-Element.

Passende Attribute

Die Filterregel „Wert von/bis für ein Datumsfeld“ eignet sich für Attribut Datum - soll die Filterung nur für Datumsangaben sein, sollte man bei der Option „Handhabung von Datum und Uhrzeit“ die Auswahl auf „Nur Datum ohne Uhrzeit speichern“ stellen.