Skip to content

Latest commit

 

History

History
executable file
·
164 lines (123 loc) · 7.04 KB

table_manager_validierungen.md

File metadata and controls

executable file
·
164 lines (123 loc) · 7.04 KB

Table Manager: Validierungen

Inhalt

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, bspw. !=, !=, >, <
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, bspw. yform_validate_custom
Weitere Parameter Eingabe-Wert, gegen den geprüft werden soll, bspw. 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 bspw. im project-Addon in der boot.php hinterlegen:

function yform_validate_custom($label, $value, $param)
{
	if($value > $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
    }
}

email

Überprüft, ob der Eingabe-Typ eine E-Mail-Adresse 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, contact
Fehlermeldung Hinweis, der erscheint, wenn keine gültige E-Mail-Adresse angegeben wurde.

Hinweis: Falls das E-Mail-Feld ein Pflichtfeld ist, muss auch die Validierung empty hinzugefügt werden, da ein leeres Feld eine keine ungültige E-Mail-Adresse darstellt.

Hinweis: Die Validierung ist seit YForm 1.1 RFC-konform.

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.

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.

size

Überprüft, ob der Eingabe-Wert eine bestimmte 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 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.