🐣 Relation Select AddOn

Ermöglicht die Auswahl und Sortierung verknüpfter Datensätze mit erweiterten Filter- und Sortiermöglichkeiten.

Features

• Benutzerfreundliche Oberfläche zum Auswählen und Sortieren von Datensätzen
• Flexible Filtermöglichkeiten mit einer vereinfachten Syntax
• Durchsuchbare Liste verfügbarer Einträge
• Drag & Drop Sortierung der ausgewählten Einträge
• Unterstützung für Meta Infos
• Automatische Datumswerte (now, today)
• Flexible Label-Gestaltung durch Feldverknüpfungen

Installation

1. Im REDAXO Installer das AddOn "relation_select" herunterladen
2. AddOn installieren und aktivieren

Anwendung

Basis-Konfiguration

<input type="text" name="my_field" 
    data-relation-mode="modal" 
    data-relation-config='{
        "table": "rex_article",
        "valueField": "id",
        "labelField": "name"
    }'
>

Label-Syntax

Einfache Feldverknüpfung (mit automatischem Leerzeichen):

"labelField": "firstname|lastname"

Filter-Syntax (dbw)

Der dbw Parameter ermöglicht das Filtern der Datensätze mit einer vereinfachten Syntax.

Operatoren

• =: Exakte Übereinstimmung
• !=: Ungleich
• >: Größer als
• <: Kleiner als
• >=: Größer oder gleich
• <=: Kleiner oder gleich
• ~: Textsuche (LIKE)

Spezielle Werte

• now: Aktuelle Zeit (CURRENT_TIMESTAMP)
• today: Aktuelles Datum (CURRENT_DATE)
• NULL: NULL-Wert
• Text mit Leerzeichen: [[Mein Text]]

Beispiele für Filter

// Einfache Vergleiche
"dbw": "status = 1"
"dbw": "priority >= 5"
"dbw": "parent_id != 0"

// Textsuche
"dbw": "name = Willi Meier"              // Exakte Übereinstimmung
"dbw": "name ~ Meier"                    // Enthält "Meier" irgendwo
"dbw": "name ~ Start*"                   // Beginnt mit "Start"
"dbw": "name ~ *Ende"                    // Endet mit "Ende"
"dbw": "description ~ *wichtig*"         // Enthält "wichtig"

// Datum und Zeit
"dbw": "createdate > now"                // Nur zukünftige Einträge
"dbw": "date_from = today"               // Einträge von heute
"dbw": "valid_until > now"               // Noch gültige Einträge

// NULL-Werte
"dbw": "parent_id = NULL"                // Nur Hauptkategorien
"dbw": "updated != NULL"                 // Nur bearbeitete Einträge

// Mehrere Bedingungen
"dbw": "status = 1, parent_id != 0"      // Online und keine Hauptkategorie
"dbw": "name ~ Start*, status != 0"      // Beginnt mit "Start" und online
"dbw": "priority >= 5, createdate > now" // Wichtige zukünftige Einträge

Sortier-Syntax (dbob)

Der dbob Parameter bestimmt die Sortierung der Einträge.

Format

• Komma-getrennte Liste: Feld,Richtung,Feld,Richtung,...
• Richtung: ASC (aufsteigend) oder DESC (absteigend)
• Wenn keine Richtung angegeben wird, wird ASC verwendet

Beispiele für Sortierung

// Einfache Sortierung
"dbob": "name,ASC"                  // Alphabetisch nach Name
"dbob": "priority,DESC"             // Höchste Priorität zuerst
"dbob": "createdate,DESC"           // Neueste zuerst

// Mehrfache Sortierung
"dbob": "parent_id,ASC,name,ASC"    // Nach Kategorie, dann alphabetisch
"dbob": "priority,DESC,name,ASC"    // Nach Priorität, bei gleicher alphabetisch

Autor

Friends Of REDAXO

• http://www.redaxo.org
• https://github.com/FriendsOfREDAXO

Projektleitung

• Peter Bickel
• Thomas Skerbis

Lizenz

MIT License - siehe LICENSE.md