Hallo Welt
` Option | Erläuterung ------ | ------ Priorität | Ordnet das Feld zwischen anderen Feldern im Formular ein. Name | Name des Felds in der Datenbank, z. B. `info`, `code`. HTML | HTML-Code, der vor, zwischen oder nach anderen Feldern im Frontend oder Backend eingefügt wird. Notiz | Hinweis unterhalb des Feldes, um dem Nutzer zusätzliche Instruktionen zur Eingabe mitzugeben. In der Liste verstecken | Versteckt das Feld in der Tabellen-Übersicht. Als Suchfeld aufnehmen | Zeigt das Feld in den Suchoptionen an, sofern die Option "Suche aktiv" in den Tabellen-Optionen aktiviert wurde. ### index Ein Feld, das einen Index / Schlüssel über mehrere Felder erzeugt. > **Wert in der Datenbank** > Alle Werte zusammengefasst als String, z. B. `max@mustermann.de4ja` bei Feldern `email,article_id,checkbox_agb`, sofern kein Algorithmus gewählt wurde. Option | Erläuterung ------ | ------ Priorität | Ordnet das Feld zwischen anderen Feldern in der Tabelle ein. Name | Name des Felds in der Datenbank, z. B. `password_hash`, `password`. Felder | Auswahl an Feldern, die für das Erstellen des Index verwendet werden sollen. Nicht in Datenbank speichern | Gibt an, ob das Feld nur angezeigt werden soll oder der Wert auch in der Datenbank gespeichert werden soll. Opt. Codierfunktion | Name des Algorithmus, der beim Generieren verwendet wird, z. B. `md5`, `sha1` Notiz | Hinweis unterhalb des Feldes, um dem Nutzer zusätzliche Instruktionen zur Eingabe mitzugeben. In der Liste verstecken | Versteckt das Feld in der Tabellen-Übersicht. Als Suchfeld aufnehmen | Zeigt das Feld in den Suchoptionen an, sofern die Option "Suche aktiv" in den Tabellen-Optionen aktiviert wurde. > Tipp: > Die Generierung eines Index ist nützlich, um aus mehreren Feldern, die sich nicht für `unique` qualifizieren, einen eindeutigen Key zu erstellen. ### integer Ein einfaches Eingabefeld für ganze Zahlen. > **Wert in der Datenbank** > Zahl, z. B. `5` Option | Erläuterung ------ | ------ Priorität | Ordnet das Feld zwischen anderen Feldern in der Tabelle ein. Name | Name des Felds in der Datenbank, z. B. `price`, `quantity`. Bezeichnung | Name des Felds, wie er im Frontend oder Backend angezeigt wird, z. B. `Preis in EUR`, `Anzahl` Defaultwert | Zahl, mit der das Eingabfeld vorausgefüllt wird, z. B. `1`, `5`, `42` Nicht in Datenbank speichern | Gibt an, ob das Feld nur angezeigt werden soll oder der Wert auch in der Datenbank gespeichert werden soll. Notiz | Hinweis unterhalb des Feldes, um dem Nutzer zusätzliche Instruktionen zur Eingabe mitzugeben. In der Liste verstecken | Versteckt das Feld in der Tabellen-Übersicht. Als Suchfeld aufnehmen | Zeigt das Feld in den Suchoptionen an, sofern die Option "Suche aktiv" in den Tabellen-Optionen aktiviert wurde. ### ip ### number Option | Erläuterung ------ | ------ `precision` | ist die Anzahl der signifikanten Stellen. Der Bereich von `precision` liegt zwischen 1 und 65. `scale` | ist die Anzahl der Stellen nach dem Dezimalzeichen. Der Bereich für `scale` ist von `0` bis `30`. MySQL erfordert, dass `scale` kleiner gleich (`<=`) `precision` ist. ### objparams ### password ### php Führt PHP-Code an der gewünschten Stelle des Eingabe-Formulars aus. Option | Erläuterung ------ | ------ Priorität | Ordnet das Feld zwischen anderen Feldern in der Tabelle ein. Name | Name des Felds in der Datenbank, z. B. `php`, `code`. PHP Code | PHP-Code, der vor, zwischen oder nach anderen Feldern im Frontend oder Backend eingefügt wird. In der Liste verstecken | Versteckt das Feld in der Tabellen-Übersicht. Als Suchfeld aufnehmen | Zeigt das Feld in den Suchoptionen an, sofern die Option "Suche aktiv" in den Tabellen-Optionen aktiviert wurde. > **Hinweis**: Zusammen mit dem Upload-Feld lassen sich komfortabel [E-Mails mit Anhang versenden](demo_email-attachments.md). Codebeispiel, um innerhalb des PHP-Codes auf alle oder bestimmte Werte des aktuellen Datensatzes zuzugreifen: ```php params['main_id'] > 0 && rex::isBackend()) { foreach ($this->params['values'] as $key => &$entry) { if ($entry->name == 'gesuchtes_feld') { $value = $entry->value; ... break; } } } ?> ``` ### prio Ein Auswahlfeld, um Datensätze in eine bestimmte Reihenfolge zu sortieren. > **Wert in der Datenbank** > Zahl, z. B. `5`, `20` Option | Erläuterung ------ | ------ Priorität | Ordnet das Feld zwischen anderen Feldern in der Tabelle ein. Name | Name des Felds in der Datenbank, z. B. `prio`, `ranking`, `order` Bezeichnung | Name des Felds, wie er im Frontend oder Backend angezeigt wird, z. B. `Priorität`, `Rang`, `Reihenfolge` Anzeige | Feld(er), die in der Auswahl-Box angezeigt werden, z. B. `name`, `title`, `isbn` Beschränkung | Feld(er), die die Auswahlmöglichkeiten in der Auswahl-Box beschränken, z. B. `category_id` Am Anfang | Vorauswahl, ob ein neuer Datensatz am Anfang oder am Ende angelegt wird. Notiz | Hinweis unterhalb des Feldes, um dem Nutzer zusätzliche Instruktionen zur Eingabe mitzugeben. In der Liste verstecken | Versteckt das Feld in der Tabellen-Übersicht. Als Suchfeld aufnehmen | Zeigt das Feld in den Suchoptionen an, sofern die Option "Suche aktiv" in den Tabellen-Optionen aktiviert wurde. > **Hinweis:** > Wenn eine Beschränkung ausgewählt wurde, kann es vorkommen, dass ein Datensatz zunächst gespeichert werden muss, damit die Beschränkung greifen kann. Dadurch lässt sich z. B. eine Reihenfolge pro Kategorie festlegen. ### showvalue Zeigt einen Wert in der Ausgabe. ### signature ### submit Ein oder mehrere Submit-Buttons zum Absenden des Formulars. > **Wert in der Datenbank** > Wert des abgesendeten Buttons, z. B. `Anfrage` Option | Erläuterung ------ | ------ Priorität | Ordnet das Feld zwischen anderen Feldern in der Tabelle ein. Name | Name des Felds in der Datenbank, z. B. `submit` Bezeichnungen (kommasepariert) | Liste an Beschriftungen für die jeweiligen Buttons, z. B. `Anfragen,Kaufen` oder `Rückruf,E-Mail` Werte (optional, kommasepariert) | `Anfragen,Kaufen`,`email,phone` Nicht in Datenbank speichern | Gibt an, ob das Feld nur angezeigt werden soll oder der Wert auch in der Datenbank gespeichert werden soll. Defaultwert | Wert, mit der das Eingabefeld vorausgefüllt wird, z. B. `Anfragen`, `phone` CSS Klassen (kommasepariert) | CSS-Klassen für die jeweiligen Submit-Buttons, z. B. `submit--email,submit--phone` Notiz | Hinweis unterhalb des Feldes, um dem Nutzer zusätzliche Instruktionen zur Eingabe mitzugeben. In der Liste verstecken | Versteckt das Feld in der Tabellen-Übersicht. Als Suchfeld aufnehmen | Zeigt das Feld in den Suchoptionen an, sofern die Option "Suche aktiv" in den Tabellen-Optionen aktiviert wurde. > **Tipp:** > Mit mehreren Submits kann man auf unterschiedliche Absichten mit dem gleichen Formular reagieren, z. B. zwei Buttons namens `Bestellen` und `Angebot anfragen`. ### text Input-Feld zur Eingabe eines Textes. > **Wert in der Datenbank** > String, z. B. `Musterfirma`, `Paul`, `Musterprojekt` Option | Erläuterung ------ | ------ Priorität | Ordnet das Feld zwischen anderen Feldern in der Tabelle ein. Name | Name des Felds in der Datenbank, z. B. `name`, `prename`, `title` Bezeichnung | Name des Felds, wie er im Frontend oder Backend angezeigt wird, z. B. `Name`, `Vorname`, `Titel` Defaultwert | Wert, der beim Aufruf des Formulars eingetragen ist, z. B. `Musterfirma`, `Paul`, `Musterprojekt` Nicht in Datenbank speichern | Gibt an, ob das Feld nur angezeigt werden soll oder der Wert auch in der Datenbank gespeichert werden soll. individuelle Attribute | Zusätzliche Feld-Attribute im JSON-Format, z. B. `{"placeholder":"+491234567890","type":"phone"}` Notiz | Hinweis unterhalb des Feldes, um dem Nutzer zusätzliche Instruktionen zur Eingabe mitzugeben. In der Liste verstecken | Versteckt das Feld in der Tabellen-Übersicht. Als Suchfeld aufnehmen | Zeigt das Feld in den Suchoptionen an, sofern die Option "Suche aktiv" in den Tabellen-Optionen aktiviert wurde. > Tipp: > Mit der neuen Möglichkeit, individuelle Attribute zu vergeben, lassen sich alle [Input-Feldtypen aus HTML5](http://www.w3schools.com/html/html_form_input_types.asp) nutzen und clientseitig validieren. ### textarea Ein mehrzeiliges Eingabefeld für Text. > **Wert in der Datenbank** > Inhalt des Textarea-Feldes Option | Erläuterung ------ | ------ Priorität | Ordnet das Feld zwischen anderen Feldern in der Tabelle ein. Name | Name des Felds in der Datenbank, z. B. `text`, `description`, `message` Bezeichnung | Name des Felds, wie er im Frontend oder Backend angezeigt wird, z. B. "Text", "Beschreibung", "Nachricht" Defaultwert | Wert, der beim Aufruf des Formulars eingetragen ist, z. B. `Geben Sie hier Ihre Nachricht ein` Nicht in Datenbank speichern | Gibt an, ob das Feld nur angezeigt werden soll oder der Wert auch in der Datenbank gespeichert werden soll. individuelle Attribute | Zusätzliche Feld-Attribute im JSON-Format, z. B. `{"class":"form-control redactor-editor--full","id":"textarea1"}` Notiz | Hinweis unterhalb des Feldes, um dem Nutzer zusätzliche Instruktionen zur Eingabe mitzugeben. In der Liste verstecken | Versteckt das Feld in der Tabellen-Übersicht. Als Suchfeld aufnehmen | Zeigt das Feld in den Suchoptionen an, sofern die Option "Suche aktiv" in den Tabellen-Optionen aktiviert wurde. > Hinweis: Wenn das `class`-Attribut im Backend überschrieben wird, z. B. für einen Editor, dann muss die Klasse `form-control` ebenfalls wieder hinzugefügt werden. > Tipp: Mit Addons wie Redactor oder CKE kann das `textarea`-Feld zu einem WYSIWYG-Editor umgewandelt werden, mit dem Markdown-Addon zu einem WYSIWYM-Editor. ### time Eine Reihe von Auswahlfeldern, in der die Uhrzeit (Stunden, Minuten, Sekunden) ausgewählt wird. > **Wert in der Datenbank** > - MYSQL-Date-Format, z. B. `10:00:00` Option | Erläuterung ------ | ------ Priorität | Ordnet das Feld zwischen anderen Feldern in der Tabelle ein. Name | Name des Felds in der Datenbank, z. B. `time`, `time_begin` Bezeichnung | Name des Felds, wie er im Frontend oder Backend angezeigt wird, z. B. `Uhrzeit`, `Beginn der Veranstaltung` [Anzeigeformat ###H###h ###I###m] | Reihenfolge der Auswahlfelder für Stunde und Minute beim bearbeiteten eines Datensatzes, z. B. `um ###H###:###I### Uhr` Nicht in Datenbank speichern | Gibt an, ob das Feld nur angezeigt werden soll oder der Wert auch in der Datenbank gespeichert werden soll. Notiz | Hinweis unterhalb des Feldes, um dem Nutzer zusätzliche Instruktionen zur Eingabe mitzugeben. In der Liste verstecken | Versteckt das Feld in der Tabellen-Übersicht. Als Suchfeld aufnehmen | Zeigt das Feld in den Suchoptionen an, sofern die Option "Suche aktiv" in den Tabellen-Optionen aktiviert wurde. ### upload Ein **Upload-Feld**, mit dem eine Datei in **die Datenbank oder ein Verzeichnis** hochgeladen wird. Option | Erläuterung ------ | ------ Priorität | Ordnet das Feld zwischen anderen Feldern in der Tabelle ein. Label | | Bezeichnung | | Maximale Größe in Kb oder Range 100,500 | | Welche Dateien sollen erlaubt sein, kommaseparierte Liste. ".gif,.png" | | Pflichtfeld | | min_err,max_err,type_err,empty_err,delete_file_msg | | Speichermodus | | `database`: Dateiname wird gespeichert in Feldnamen | | Eigener Uploadordner [optional] | | Dateiprefix [optional] | | Defaultfile | | Notiz | Hinweis unterhalb des Feldes, um dem Nutzer zusätzliche Instruktionen zur Eingabe mitzugeben. In der Liste verstecken | Versteckt das Feld in der Tabellen-Übersicht. Als Suchfeld aufnehmen | Zeigt das Feld in den Suchoptionen an, sofern die Option "Suche aktiv" in den Tabellen-Optionen aktiviert wurde. > **Hinweis**: Zusammen mit dem PHP-Feld lassen sich komfortabel [E-Mails mit Anhang versenden](demo_email-attachments.md). ### uuid ## Validierung ### compare Vergleicht zwei Eingabe-Werte miteinander. Option | Erläuterung ------ | ------ Priorität | Reihenfolge des Feldes in der Feldübersicht und beim Abarbeiten der Validierungen. 1. Feldname | Name des Tabellenfeldes, das für die Überprüfung herangezogen wird, z. B. `password`, `email` 2. Feldname | Name des Tabellenfeldes, das für die Überprüfung herangezogen wird, z. B. `password2`, `email_verified` Vergleichsart | Operator, wie `Feld 1` und `Feld 2` verglichen werden sollen, z. B. `!=`, `!=`, `>`, `<` Fehlermeldung | Hinweis, der erscheint, wenn der Vergleich beider Felder `false` ergibt. > Tipp: Diese Validierung kann z. B. bei Online-Tarifrechnern oder Ähnlichem eingesetzt werden, um serverseitig unzulässige Konfigurationen durch den Nutzer auszuschließen. ### compare_value Vergleicht einen Eingabe-Wert mit einem fest definierten Wert. Option | Erläuterung ------ | ------ Priorität | Reihenfolge des Feldes in der Feldübersicht und beim Abarbeiten der Validierungen. \1. Feldname | Name des Tabellenfeldes, das für die Überprüfung herangezogen wird, z. B. `checkbox_agb`, `newsletter_consent` Vergleichswert | Fest definierter Wert, der für den Vergleich herangezogen wird, z. B. `1` (bei Checkboxen) Vergleichsart | Operator, wie `Feld 1` und `Vergleichswert` vergleichen werden sollen, z. B. `==`, `!=`, `>`, `<` Fehlermeldung | Hinweis, der erscheint, wenn die Bedingung des Vergleichs erfüllt ist. > Merkhilfe: Wenn die Bedingung erfüllt ist, dann wird eine Fehlermeldung ausgegeben. ### customfunction Ruft eine eigene PHP-Funktion für einen Vergleich auf. Option | Erläuterung ------ | ------ Priorität | Reihenfolge des Feldes in der Feldübersicht und beim Abarbeiten der Validierungen. Name | Name des Tabellenfeldes, das für die Überprüfung herangezogen wird, z. B. `name`, `email`, `phone`, `zip` Name der Funktion | Funktion, die den Wert überprüfen soll, z. B. `yform_validate_custom` Weitere Parameter | Eingabe-Wert, gegen den geprüft werden soll, z. B. `20` Fehlermeldung | Hinweis, der erscheint, wenn die Bedingung des Vergleichs erfüllt ist. > Merkhilfe: Wenn die Bedingung erfüllt ist (`return true;`), dann wird eine Fehlermeldung ausgegeben. #### Beispiel für `customfunction` Diese Funktion z. B. im `project`-Addon in der boot.php hinterlegen: ```php params['main_id']; if($ObjectValue_s > $param) { // eigene Validierung. Hier: Prüft, ob der Formular-Eingabewert größer ist als der Parameter return false; // Achtung: false = gültig } else { return true; // Achtung: true = Fehlermeldung ausgeben } } ``` ### empty Überprüft, ob ein Eingabe-Wert vorhanden ist. Option | Erläuterung ------ | ------ Priorität | Reihenfolge des Feldes in der Feldübersicht und beim Abarbeiten der Validierungen. Name | Name des Tabellenfeldes, das für die Überprüfung herangezogen wird, z. B. `email`, `name` Fehlermeldung | Hinweis, der erscheint, wenn die Eingabe leer ist. ### in_names ### in_table Überprüft, ob ein Eingabe-Wert in der DB vorhanden ist. Option | Erläuterung ------ | ------ Priorität | Reihenfolge des Feldes in der Feldübersicht und beim Abarbeiten der Validierungen. Name | Name des Tabellenfeldes, das für die Überprüfung herangezogen wird, z. B. `email`, `name` Tabellenname | Name der Tabelle, das für die Überprüfung herangezogen wird, z. B. `rex_ycom_user` Feldname | Name des Feldes in der Tabelle, das für die Überprüfung herangezogen wird, z. B. `email` Fehlermeldung | Hinweis, der erscheint, wenn die Eingabe leer ist. ### intfromto Überprüft, ob der Eingabe-Wert zwischen zwei Zahlen liegt. Option | Erläuterung ------ | ------ Priorität | Reihenfolge des Feldes in der Feldübersicht und beim Abarbeiten der Validierungen. Name | Name des Tabellenfeldes, das für die Überprüfung herangezogen wird, z. B. `email`, `name` Von | Wert, der mindestens eingegeben werden muss, z. B. `0`, `5`, `1000` Bis | Wert, der höchstens eingegeben werden darf, z. B. `5`,`10`,`2030` Fehlermeldung | Hinweis, der erscheint, wenn die Eingabe nicht im erlaubten Bereich liegt. ### password_policy ### preg_match ### size Überprüft, ob der Eingabe-Wert eine exakte Anzahl von Zeichen hat. Option | Erläuterung ------ | ------ Priorität | Reihenfolge des Feldes in der Feldübersicht und beim Abarbeiten der Validierungen. Name | Name des Tabellenfeldes, das für die Überprüfung herangezogen wird, z. B. `customer_id`, `pin` Anzahl der Zeichen | exakte Anzahl der Zeichen, die eingegeben werden sollen, z. B. `5`,`10`,`42` Fehlermeldung | Hinweis, der erscheint, wenn die Eingabe die festgelegte Anzahl von Zeichen unter- oder überschreitet. ### size_range Überprüft, ob die Länge des Eingabe-Werts zwischen zwei Zahlen liegt. Option | Erläuterung ------ | ------ Priorität | Reihenfolge des Feldes in der Feldübersicht und beim Abarbeiten der Validierungen. Name | Name des Tabellenfeldes, das für die Überprüfung herangezogen wird, z. B. `customer_id`, `password` Minimale Anzahl der Zeichen (opt) | Anzahl der Zeichen, die mindestens werden sollen, z. B. `0`, `5`, `7` Maximale Anzahl der Zeichen (opt) | Anzahl der Zeichen, die höchstens werden sollen, z. B. `5`,`10`,`15` Fehlermeldung | Hinweis, der erscheint, wenn die Eingabe den festgelegten Bereich an Zeichen unter- oder überschreitet. ### type Überprüft, ob der Typ des Eingabe-Werts korrekt ist. Option | Erläuterung ------ | ------ Priorität | Reihenfolge des Feldes in der Feldübersicht und beim Abarbeiten der Validierungen. Name | Name des Tabellenfeldes, das für die Überprüfung herangezogen wird, z. B. `zip`, `phone`, `name`, `email`, `website` Prüfung nach | Typ, der überprüft werden soll, z. B. `int`, `float`, `numeric`, `string`, `email`, `url`, `date`, `hex`] Fehlermeldung | Hinweis, der erscheint, wenn die Eingabe nicht dem festgelegten Typ entspricht. Feld muss nicht ausgefüllt werden | Gibt an, ob die Validierung erfolgreich ist, wenn keine Eingabe stattfindet. ### unique Überprüft ob der Eingabe-Wert noch nicht in anderen Datensätzen vorhanden ist. Option | Erläuterung ------ | ------ Priorität | Reihenfolge des Feldes in der Feldübersicht und beim Abarbeiten der Validierungen. Names | Namen der Tabellenfelder, die für die Überprüfung herangezogen werden, z. B. `id`, `customer_id`, `email,email_verified` Fehlermeldung | Hinweis, der erscheint, wenn die Eingabe bereits in einem anderen Datensatz existiert. Tabelle [opt] | Name der Tabelle, in der die Felder durchsucht werden. ## Table Manager Snippets - [Table Manager: Spalte ausblenden](#table-manager-spalte-ausblenden) - [Table Manager: Spalteninhalt vor Anzeige in Übersicht ändern](#table-manager-spalteninhalt-vor-anzeige-in-uebersicht-aendern) - [Table Manager: Bilderspalte in Tabellenansicht (Bild statt Dateiname)](#table-manager-bilderspalte-in-tabellenansicht-bild-statt-dateiname) - [Table Manager: Extensionpoint / Listensortierung beeinflussen)](#table-manager-extensionpoint-listensortierung-beeinflussen) ### Table Manager: Spalte ausblenden Beim Einsatz einer YForm-Tabelle im eigenen AddOn können beliebige Spalten über den Einsatz des folgenden Extension points ausgeblendet werden (hier als Beispiel die Spalte ID): ```php getParam("table")->getTableName()=="gewuenschte_tabelle"){ $list = $ep->getSubject(); $list->removeColumn("id"); }); }); ``` ### Table Manager: Spalteninhalt vor Anzeige in Übersicht ändern Beim Einsatz einer YForm-Tabelle im eigenen AddOn kann für beliebige Spalten vor der Anzeige in der Übersicht der Wert manipuliert und ggf. mit Werten aus derselben Tabellenzeile kombiniert werden. Konkret wird hier in der Anzeige der Spalte "title" der Wert der Spalte "name" angehängt. Die Snippets kommen am besten in die boot.php des project-AddOns. ```php getParam('table')->getTableName()=="gewuenschte_tabelle"){ $list = $ep->getSubject(); $list->setColumnFormat( 'title', // Spalte, für die eine custom function aktiviert wird 'custom', // festes Keyword function($a){ // Generierung des auszugebenden Werts unter Einbeziehung beliebiger anderer Spalten // $a['value'] enthält den tatsächlichen Wert der Spalte // $a['list']->getValue('xyz') gibt den Wert einer anderen Spalte ("xyz) zurück. $neuer_wert=$a['value']." ".$a['list']->getValue('xyz'); return $neuer_wert; } ); } }); } ``` Beispiel 2: Verlinken mit der Seite "Datensatz editieren" von YForm mit Verwendung des benötigten CSRF-Tokens. ```php rex_extension::register('YFORM_DATA_LIST', function ($ep) { if ($ep->getParam('table')->getTableName()=="rex_tabelle") { // Tabellenname anpassen $list = $ep->getSubject(); $list->setColumnFormat( 'name', // Feldname, dessen Wert in der Liste verändert werden soll. 'custom', // nicht verändern function ($a) { $_csrf_key = rex_yform_manager_table::get('rex_tabelle')->getCSRFKey(); $token = rex_csrf_token::factory($_csrf_key)->getUrlParams(); $params = array(); $params['table_name'] = 'rex_tabelle'; // Tabellenname anpassen $params['rex_yform_manager_popup'] = '0'; $params['_csrf_token'] = $token['_csrf_token']; $params['data_id'] = $a['list']->getValue('id'); $params['func'] = 'edit'; return ''. $a['value'].''; } ); } }); ``` ### Table Manager: Bilderspalte in Tabellenansicht (Bild statt Dateiname) Der Code kommt entweder in die boot Datei des Projekt AddOns oder in die Boot Datei des Theme Addons (wer damit arbeitet) oder in eine anderweitige Boot Datei. ```php getSubject(); // die Spalte bild (ggf. eigenen Spaltennamen verwenden) soll mit einer custom Funktion umformatiert werden $list->setColumnFormat('bild', 'custom', function ($params ) { // das passiert hier. Ggf. eigenen Medientyp setzen. return '.')
';
});
});
}
```
### Table Manager: Extensionpoint | Listensortierung beeinflussen
Im Table Manager lässt sich _ein_ DB-Feld für die Sortierung der Backendausgabe festlegen.
Manchmal ist eine komplexere Sortierung sinnvoll: `ORDER BY column1, column2`
>Hinweis: Das geht nur, solange keine andere Spalte zum Sortieren ausgewählt wird. Will man eine andere Spalte zum sortieren auswählen wirft der EP nicht das passende Query aus.
Folgendes Snippet kann im Projekt Addon oder Theme Addon platziert werden und ermöglicht es die Sortierung zu erweitern:
#### Ausführliches Beispiel
```php
isAvailable() && rex_plugin::get('yform', 'manager')->isAvailable() &&
rex_be_controller::getCurrentPage() == 'yform/manager/data_edit' && rex_request('table_name') == '' . $row['text'] . '
'; echo 'Tag: ' . $row['name'] . '
'; } ?> ``` #### Many to Many (m:n) ##### Schritt 1 - Tabellen erstellen Als erstes werden per Table-Manager folgende Tabellen erstellt. > **Wichtig** > Diese Tabellen dienen ausschliesslich der Veranschaulichung des Vorgangs (eine echte News-Tabelle würde voraussichtlich noch weitere Felder bzw. Spalten beinhalten). > Es wird ausschliesslich das Feld mit dem Typ be_manager_relation genauer erklärt. Die Konfiguration anderer Feld-Typen wird hier genauer erläutert: [Table Manager: Feldtypen](table_manager_feldtypen.md) ###### Tabelle News-Tags `news_tag` Feld-Name | Feld-Typ ------ | ------ `name` | `text` ###### Tabelle News-Beiträge `news_beitrag` Feld-Name | Feld-Typ ------ | ------ `titel` | `text` `text` | `textarea` ###### Tabelle News-Tags-zu-Beitrag `news_tag_beitrag` Feld-Name | Feld-Typ ------ | ------ `id_tag` | `be_manager_relation` `id_beitrag` | `be_manager_relation` Das Feld `id_tag` wird wie folgt konfiguriert (nicht erwähnte Optionen bleiben unverändert): Option | Erläuterung ------ | ------ Priorität | Kann beliebig gesetzt werden. Der Default-Wert ist in diesem Fall passend. Name | `id_tag` Bezeichnung | `Tag ID` Ziel Tabelle | `[rex_news_tag]` Ziel Tabellenfeld(er) zur Anzeige oder Zielfeld | `id` Mehrfachauswahl | `select (single)` Als Suchfeld aufnehmen | deaktivieren Das Feld `id_beitrag` wird wie folgt konfiguriert (nicht erwähnte Optionen bleiben unverändert): Option | Erläuterung ------ | ------ Priorität | Kann beliebig gesetzt werden. Der Default-Wert ist in diesem Fall passend. Name | `id_beitrag` Bezeichnung | `Beitrag ID` Ziel Tabelle | `[news_beitrag]` Ziel Tabellenfeld(er) zur Anzeige oder Zielfeld | `id` Mehrfachauswahl | `select (single)` Als Suchfeld aufnehmen | deaktivieren ##### Schritt 2 - Hilfstabelle verknüpfen Um die Verknüpfung abzuschliessen, geht's zurück zur Tabelle News-Beiträge `news_beitrag` wo am Ende der Tabelle ein weiteres be_manager_relation Feld angelegt wird und zwar mit folgenden Einstellungen (nicht erwähnte Optionen bleiben unverändert): Option | Erläuterung ------ | ------ Priorität | Kann beliebig gesetzt werden. Der Default-Wert ist in diesem Fall passend. Name | `tags` Bezeichnung | `Tags` Ziel Tabelle | `[rex_news_tag]` Ziel Tabellenfeld(er) zur Anzeige oder Zielfeld | `name` Mehrfachauswahl | `select (multiple)` oder `popup (multilple)`, für Einzelauswahl auch `select` oder `popup` möglich. Relationstabelle | `news_tag_beitrag` Leeroption | Falls ausgefüllt werden muss, deaktivieren Als Suchfeld aufnehmen | deaktivieren ##### Schritt 3 - Frontend-Ausgabe Wenn man nun einen News-Beitrag erfasst oder editiert, findet man ganz am Ende der Eingabemaske ein Feld mit Namen "Tags", entweder mit einem Multi-SELECT-Feld oder einem Rex-Widget mit Popup. Speichert man den Datensatz ab, wird in der News-Beitrag-Tabelle `news_tag_beitrag` die Zuordnung vom jeweiligen Beitrag zu den entsprechenden Tags gespeichert. Im Frontend kann das ganze dann z. B. so abgefragt werden: ```php setQuery($query); $rows = $sql->getArray($query); foreach($rows as $row) { echo '' . $row['text'] . '
'; echo 'Tags: ' . $row['tags'] . '
'; } ?> ``` > die Query ist hier im Dienste der Lesbarkeit auf mehrere Zeilen aufgeteilt. Dass muss natürlich nicht zwingend so sein [GitHub-Diskussion zum Thema Filter](https://github.com/yakamara/redaxo_yform_docs/issues/3) ## CSRF Schutz der Table-Manager-Links Möchte man von Außen in einen Datensatz im Table-Manager linken (z.B. aus dem Frontend), ist es zwingend erforderlich die Links mit einem CSRF-Parameter aufzurufen. ```php // Key auslesen per getCSRFKey $_csrf_key = $table->getCSRFKey(); // Token erstellen $_csrf_params = rex_csrf_token::factory($_csrf_key)->getUrlParams(); ``` Der Token muss dann an die URL z.B. per `&_csrf_token='.$_csrf_params.'` angehängt werden. Rückwärtskompatible Lösung um den csrf_key auch schon in YForm-Versionen < 4 zu erhalten: `$_csrf_key = 'table_field-'.$table->getTableName();` u.a. hier realisiert: [Quick-Naviagtion](https://github.com/FriendsOfREDAXO/quick_navigation/blob/1168253ce47e0b2528856ba0a315565be51b6a91/lib/QuickNavigation.php#L481-L482) ## YForm Listen beeinflussen und z.B. Textfelder komplett oder eingeschränkt ausgeben Der beste Weg ist es, sich in der boot.php des Projekt-AddOn an die Listenausgabe über einen Extensionpoint (EP) anzudocken. ```php rex_extension::register('YFORM_DATA_LIST', static function ($ep) { /** @var rex_yform_list $list */ $list = $ep->getSubject(); $params = $ep->getParams(); $textFields = ['text', 'textarea', 'textarea', 'hashvalue', 'ip', 'showvalue']; foreach ($params['table']->getFields() as $field) { if ('value' == $field->getType() && in_array($field->getTypeName(), $textFields, true)) { $list->setColumnFormat( $field->getName(), 'custom', static function ($params) { $value = rex_escape($params['value']); // Hier die Veränderungen einbauen return rex_escape($value); } ); } } }); ```