Mit diesem Plugin können Sie den eingegebenen Wert asynchron per Ajax Request testen und validieren. Ist der angegebene Wert ungültig, wird er nicht gespeichert.
| Attribut | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| file | string | Nein | Der Pfad zur PHP Datei, mit Ihren Funktionen. Wenn Sie keinen Pfad angeben, wird eine System eigene Datei verwendet, die allerdings nicht kundenspezifisch anpassbar ist. Deshalb wird die Verwendung dieses Parameters empfohlen. |
| func | string | Ja | Die aufzurufende PHP Funktion. Diese muss true oder false zurückliefern. |
| value | string | Nein | Der Standardwert. Ist der eingegebene Wert ungültig, wird dieser gesetzt. Dieser Standardwert wird ersetzt, sobald eine gültige Eingabe erfolgt. |
| pattern | Array | Nein | Ein regulärer Ausdruck, mit dem der eingegebene Wert bereits vor dem Ajax Request validiert werden kann. Dieser Parameter besteht aus einem Array mit den Elementen pattern (regulärer Ausdruck) und invalid (der Fehlertext). |
| invalid | string | Nein | Der anzuzeigende Fehlertext. Wird hier kein Text angegeben, ist nur optisch im Eingabefeld ein Fehler zu erkennen. |
In folgendem Beispiel ist als Eingabe nur "barfoo" erlaubt.
{input type="validate" name="foobar" title="Test" file="pub/theme/DESIGN/site/admin/validate.php" func="test"}
In Ihrer PHP Funktion erhalten Sie als ersten Parameter das Array $params, welches folgende Informationen beinhaltet:
- site: der betroffene Mandant.
- lang: die betroffene Sprache.
- id: die betroffene ID.
- value: der zu prüfende Wert.
function test($params) {
return $params['value'] == 'barfoo';
}
Sie können dieses Input Plugin auch in Kombination mit dem max_length Parameter nutzen.