YForm Field - Zusätzliche Feldtypen | Keywords: Forms, Validation, Custom Fields, Extensions, Input, Widgets, Actions

// Pipe-Schreibweise
value|datetime_local|event_datetime|Veranstaltungsdatum|2024-01-01T00:00|2024-12-31T23:59|1|0||Notice

// TableSet
$field = [
    'type' => 'value',
    'type_id' => 'datetime_local',
    'name' => 'event_datetime',
    'label' => 'Veranstaltungsdatum',
    'min' => '2024-01-01T00:00',
    'max' => '2024-12-31T23:59',
    'current_date' => '1'
];

// Breitengrad
value|number_lat|latitude|Breitengrad|10|8|input:number|°

// Längengrad
value|number_lng|longitude|Längengrad|11|8|input:number|°

// Ausgabe
$dataset = MyTable::get($id);
echo 'Koordinaten: ' . $dataset->getLatitude() . ', ' . $dataset->getLongitude();

// Pipe-Schreibweise
value|datalist|city|Stadt|Berlin,München,Hamburg,Köln,Frankfurt

// Datalist akzeptiert auch freie Eingaben!
$dataset->setCity('Meine Stadt'); // Funktioniert auch ohne Vorschlag

// Pipe-Schreibweise
value|domain|selected_domain|Domain auswählen|1||Notice

// Zeigt System-Domain + alle YRewrite-Domains an
// Multiple-Auswahl möglich

// Ausgabe
$domains = explode(',', $dataset->getSelectedDomain());
foreach ($domains as $domainId) {
    $domain = rex_yrewrite::getDomainById($domainId);
    echo $domain->getName() . '<br>';
}

// Pipe-Schreibweise
value|choice_html|product|Produkt auswählen|
<img src="/media/product1.jpg"> Produkt 1=1,
<img src="/media/product2.jpg"> Produkt 2=2,
<img src="/media/product3.jpg"> Produkt 3=3
|0|0||Notice

// HTML im Label wird gerendert!

// Pipe-Schreibweise
value|custom_link|link|Link setzen|1|1|1|1|1||1

// Parameter: media|mailto|external|intern|phone|types|category|media_category|yurl

// Ausgabe im Template
$link = $dataset->getLink();
// Ausgabe: {"type":"internal","value":"5"} oder {"type":"media","value":"image.jpg"}

$linkData = json_decode($link, true);
if ($linkData['type'] == 'internal') {
    echo rex_getUrl($linkData['value']);
} elseif ($linkData['type'] == 'media') {
    echo rex_url::media($linkData['value']);
}

// Pipe-Schreibweise
value|privacy_policy|accept_privacy|Datenschutz|0|{"class":"form-check-input"}|Notice|1=Akzeptiert|Ich akzeptiere die|Datenschutzerklärung|5

// Parameter: name|label|no_db|attributes|notice|output_values|text|linktext|article_id

// Erzeugt: "Ich akzeptiere die <a href="/datenschutz">Datenschutzerklärung</a>"

// Tab 1: Allgemein (erste Tab-Definition)
value|tabs|tab_general|Allgemein|1|general

value|text|title|Titel
value|textarea|description|Beschreibung

// Tab 2: SEO (mittlerer Tab)
value|tabs|tab_seo|SEO|2|general

value|text|seo_title|SEO-Titel
value|textarea|seo_description|SEO-Beschreibung

// Tab schließen (letzter Tab ohne Label)
value|tabs|tab_end||3|general

// Tabs mit group_by können mehrere Tab-Sets erstellen

// Pipe-Schreibweise
value|be_user_select|assigned_user|Verantwortlicher|0

// Zeigt alle Backend-Benutzer zur Auswahl
// Im Gegensatz zu be_user (setzt automatisch aktuellen User)

// Ausgabe
$userId = $dataset->getAssignedUser();
$user = rex_user::get($userId);
echo 'Verantwortlich: ' . $user->getName();

// Pipe-Schreibweise
value|form_url|submitted_from|0

// Speichert automatisch die URL der Seite, von der das Formular abgeschickt wurde
// Nützlich für Statistiken bei seitenübergreifenden Formularen

// Ausgabe
echo 'Formular abgeschickt von: ' . $dataset->getSubmittedFrom();

// Pipe-Schreibweise
value|openai_prompt|ai_description|KI-Beschreibung|YOUR_API_KEY|title,category|description|1|Erstelle eine SEO-optimierte Produktbeschreibung aus dem Titel und der Kategorie.|Du bist ein Marketing-Experte.|Titel: {title}, Kategorie: {category}

// Parameter: name|label|api_key|fields|target_field|overwrite|prompt_text|system_message|user_message_template

// Felder {title} und {category} werden in Prompt eingefügt
// Ergebnis wird in description gespeichert

// Pipe-Schreibweise
value|openai_spellcheck|text_corrected|Korrektur|YOUR_API_KEY|text

// Parameter: name|label|api_key|field

// Korrigiert Rechtschreibung/Grammatik im Feld "text"
// Ergebnis wird in "text_corrected" gespeichert

// Pipe-Schreibweise
value|thumbnail_hqapi|screenshot|Screenshot|url|screenshot_data|YOUR_API_KEY|dark|1|1920|1080|1000|png|0

// Parameter: source_url_field|target_field|api_key|theme|full_page|browser_width|browser_height|delay|format|mobile

// Erstellt Screenshot von URL im Feld "url"
// Speichert base64-Daten in "screenshot_data"

// Pipe-Schreibweise
value|radio|gender|Geschlecht|Frau=w,Herr=m,Divers=d|m|{"class":"form-check-input"}|Notice|0

// Wie YForm 3, auch in YForm 4 verfügbar

// Pipe-Schreibweise
value|select_sql|category_id|Kategorie|SELECT id, name FROM rex_category ORDER BY name|||0

// SQL-Query holt Optionen dynamisch aus Datenbank

// Pipe-Schreibweise
value|seo_title|url_title|SEO-Titel|title,category_name| - ||1

// Parameter: name|label|fields|separator|salt|add_this_param

// Kombiniert Felder "title" und "category_name" mit " - "
// Perfekt für URL-Addon Slugs

// Pipe-Schreibweise
value|datestamp_offset|expires_at|Ablaufdatum|30|days|1

// Parameter: name|label|offset_value|offset_unit|show_value

// Setzt Datum automatisch 30 Tage in die Zukunft
// Units: minutes, hours, days, weeks, months, years

// Pipe-Schreibweise
action|attach_file|agb.pdf,mein_addon/docs/agb.pdf|0

// Parameter: filename,path|replace

// Hängt statische Datei aus rex_path::addonData() an E-Mail an
// replace=1 ersetzt bisherige Anhänge

// Pipe-Schreibweise
action|conversion_push|google_ads|conversion|AW-XXXXXXXXX/XXXXXXXXXXXXXXXXXXXX|999|EUR

// Parameter: platform|event|send_to|value|currency

// Wichtig: Google Tag Manager muss initialisiert sein
// Erstellt Event 'gtagLoaded' wenn gtag.js geladen

// Pipe-Schreibweise
action|history_push|/danke|Vielen Dank!

// Parameter: url|title

// Fügt URL/Titel in Browser-Verlauf ein
// Nützlich für Single-Page-Formulare

// Pipe-Schreibweise
action|to_session|form_data

// Parameter: session_key

// Speichert alle Formularwerte in $_SESSION['form_data']
// Abruf: $_SESSION['form_data']['fieldname']

// Pipe-Schreibweise
validate|pwned|password|Das Passwort wurde in Datenlecks gefunden!

// Prüft Passwort gegen "Have I Been Pwned"-API
// Warnt bei kompromittierten Passwörtern

// Pipe-Schreibweise (wie be_manager_relation)
value|be_manager_relation_set|categories|Kategorien|rex_category|name|1

// Unterschied: Datenbankfeldtyp SET statt TEXT
// Speichert Mehrfachauswahl als MySQL SET

// Pipe-Schreibweise
value|showvalue_extended|preview|Vorschau|<strong>Standard</strong>|Info-Text

// Parameter: name|label|defaultwert|notice

// Wie showvalue, aber mit mehr DB-Typen (text, varchar, mediumtext, longtext)

// Aus install/yform/uuid.php
value|uuid|unique_id|0|1

// Parameter: name|no_db|show_value

// Generiert automatisch UUIDv4
// Format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx

// custom_link mit YForm-URL-Addon
value|custom_link|link|Link|0|0|0|0|0||0|0|1

// yurl=1 aktiviert YForm-Dataset-Linking

// Ausgabe mit URL-Addon
$linkData = json_decode($dataset->getLink(), true);
if ($linkData['type'] == 'yform') {
    // Format: rex-yf-{table}://{id}
    // Z.B.: rex-yf-rex_news://5
    $url = \Url\Url::get($linkData['value']);
    echo '<a href="' . $url . '">Link</a>';
}

// Tab-System zeigt Fehler visuell
value|tabs|tab1|Allgemein|1|mygroup
value|text|title|Titel
validate|empty|title|Titel ist Pflichtfeld!

value|tabs|tab2|Details|2|mygroup
value|text|description|Beschreibung

value|tabs|tab_end||3|mygroup

// Bei Validierungsfehler wird Tab "Allgemein" rot markiert und aktiviert

// Breitengrad mit Präzision 10, Scale 8
value|number_lat|latitude|Breitengrad|10|8|input:number|°||{"step":"0.00000001"}

// Automatische Validierung: -90 bis +90
// DECIMAL(10,8) in Datenbank

// datalist: Freie Eingabe MÖGLICH
value|datalist|city|Stadt|Berlin,München,Hamburg

// select: Freie Eingabe NICHT möglich
value|select|city|Stadt|Berlin=berlin,München=muenchen,Hamburg=hamburg

// datalist für flexible Eingaben
// select für strenge Vorgaben

// Tab 1: Geodaten
value|tabs|tab_geo|Standort|1|form

value|text|address|Adresse
value|number_lat|lat|Breitengrad|10|8|input:number|°
value|number_lng|lng|Längengrad|11|8|input:number|°

// Tab 2: Kontakt
value|tabs|tab_contact|Kontakt|2|form

value|text|name|Name
validate|empty|name|Name erforderlich!

value|custom_link|website|Website|0|1|1|0|1
value|datalist|city|Stadt|Berlin,München,Hamburg,Köln

// Tab 3: Datenschutz
value|tabs|tab_privacy|Datenschutz|3|form

value|privacy_policy|accept_dsgvo|DSGVO|0||Notice||Ich akzeptiere die|Datenschutzerklärung|5
validate|empty|accept_dsgvo|Bitte akzeptieren!

// Tab Ende
value|tabs|tab_end||4|form

// Actions
value|form_url|source_url|0
action|to_session|form_data
action|attach_file|info.pdf,myaddon/docs/info.pdf
action|conversion_push|google_ads|conversion|AW-XXX/YYY|1|EUR