yakamara / redaxo_yform_docs Goto Github PK

wurden an verschiedensten Feldern ergänzt .. Ein Review der Felder kann nicht schaden.. Sorry, war echt einiges..

Fehler

Feldname der Tabelle, dessen Werte als Select-Box oder im Popup angezeigt werden, bspw. name, title AS name oder CONCAT('id', ' ', 'name') AS name

Dort ist keine SQL-Syntax möglich, sondern es ist eine eigene. Man trennt die Felder einfach mit einem Komma, ohne CONCAT:
id, name

Konstante Strings setzt man in Anführungszeichen:
id, " ", name

Verwendet man als Anzeigefeld ein anderes Relationsfeld, wird dies aufgelöst, und dessen Anzeigefeld(-Kombi) genommen.

Beispiel: Wir haben eine Newstabelle mit einem Relationsfeld author_id. Dies hat als Anzeigefeld diese Kombi: firstname, " ", lastname
In einer anderen Tabelle gibt es nun ein Relationsfeld news_id wo man einen Newsartikel auswählen kann. In der Selectbox sollen die News im folgenden Format erscheinen: "Newstitel (Autor)".
Dazu notieren wir das Anzeigefeld so:
title, " (", author_id, ")"

YForm erkennt, dass author_id ein Relationsfeld ist, und löst es gemäß dessen Anzeigefeld auf (Vorname und Nachname).
Heraus kommt dann sowas wie "Redaxo 5.2 ist raus (Gregor Harlan)".

Diese Auflösung erfolgt rekursiv, also beliebig tief.

yakamara/yform#95

@tbaddade

Formatierungen, Widgets (select oder inputfeld darstellung) mit attributen (z.b. Datepicker oder inputmask) verknüpfbar

http://www.redaxo.org/de/forum/addons-f30/xform-hidden-feld-liefert-nichts-t21272.html

Wir haben das bei uns schon in der Firma, ich muss mich nur daran erinnern, sie hier hochzuladen und in der Doku zu verlinken.

Das Issue ist nur ein Reminder für mich.
https://github.com/yakamara/redaxo_yform_docs/blob/master/de_de/table_manager_feldtypen.md#be_select_category

Kann es sein, dass der daterangpicker die Daten zusammen in einen String speichert?
Ist das sinnvoll für die weitere Bearbeitung?

"Ignoriere Offline-Kategorien" -> "Offline-Kategorien ausblenden."

Mehrfachbearbeiten von Suchergebnissen nun möglich.

Man kann einzele Felder bearbeiten. Jeder Datensatz wird dann nur um diese Änderung ergänzt und durchläuft bei der Veränderungen den normalen Eingabeprozess. D.h. auch Validierungen werden geprüft und eventuelle Funktionen werden durchgeführt

Slack

Frage: "Wie übertrage ich xform Tabellen (rex4) zu yform Tabellen (rex5)?"

Antwort: "xForm-Datenbank importieren, dann alle Felder löschen (die werden nur im Table Manager gelöscht, nicht in der Datenbank), dann Felder neu zuweisen. Und am besten gleich yForm 2.0 nehmen, denn da hat sich zu yForm 1.0 auch noch mal viel geändert."

Man sollte deutlicher machen, dass man Felder über den Table Manager problemlos löschen und neu zuweisen kann. Die Frage taucht hin und wieder auf (und mir war das früher auch nicht aufgefallen).

Funktion erklären.

• Via SPROG / Frontend: PIPE, PHP-Notation
• Via lang-Datei / Backend: Table Manager

Bräuchte Beispiele, wie man "Filter" richtig anwendet. Ist damit die WHERE-Klausel gemeint?

wie findet die Prüfung statt? RFC-Standardkonform oder einfach nur nach @-Zeichen?

hier müsste Gregor schreiben wie man es ungefähr nutzt. Es gibt aber auch in den Issues bei yform ein paar Beispiele. Wenn man die Daten über dieses ORM verwendet, ziehen auch automatische die Historyfunktionen.

Analog zu https://github.com/pixelfirma/yform_email_template

Reminder für mich.

Wo ist der Unterschied zwischen einem Feldtyp E-Mail und einem Textfeld mit Validierungsoption E-Mail? (Wäre das nicht ein Feld, das man aus yform kicken könnte @dergel?)

Machen die beide nicht mehr oder weniger das gleiche? Könnte man die nicht zusammenfassen? @dergel

Laut doku soll das ja mit folgendem Code in Pipe Notation gehen:

action|db|tblname|[where(id=2)/main_where]

im YForm-Formbuilder
text|vorname|Vorname
text|name|Name
text|plz|PLZ
text|ort|Ort

action|db|rex_warenkorb
action|html|Daten gespeichert

Und die PHP Version dieses Beispiels scheint mir auch nicht komplett zu sein:

$yform = rex_yform::factory();
// aus dem Beispiel
$yform->setValueField('text', array("vorname","Vorname"));
$yform->setValueField('text', array("name","Name"));
$yform->setValueField('text', array("plz","PLZ"));
$yform->setValueField('text', array("ort","Ort"));

$yform->setActionField('db', array("rex_warenkorb"));
$yform->setActionField('html', array("Daten gespeichert"));

echo $yform->getForm();

Was ich eben erreichen möchte ist Formulardaten zu aktualisieren und den Code dafür in Pipe Notation aus einer Datenbank holen und action|db|tblname|[where(id=2)/main_where] hier die id durch einen Wert ersetzen. Letztlich den Formularcode ähnlich wie im Formbuilder mit yform->setFormData($formData) ausgeben.

Wie funktioniert das?

Beim Import wird jeder Datensatz "simuliert" eingegeben. D.h. es durchläuft die Validierungen und Indexierungen und Funktionen, als ob man es manuell eingegeben hätte. Und demnach kann ein Import auch mal Fehlschlagen

use case

• Kontaktformular
• Anfrage Preisliste
• Bestellformular
• Mehrsprachiges Kontaktformular
• Unterschiedliche Mails an Empfänger und Versender
• "Antwort an"-Feld befüllen (damit der Website-Betreiber direkt auf Antworten klicken kann)
• Text-Version aus der HTML-Version (mit strip_tags)
• Anhänge

Vor Versand umformatieren

• Zeitstempel
• dynamisches Textfeld, das via REQUEST befüllt wurde
• Text des Feldes, das via SELECT_SQL befüllt wurde.
• Zugriff auf System-Variablen (z.B. Name der Redaxo-Installation)

Zugriff auf E-Mail-Templates via PHP

Falls man sein eigenes Formular mit YForm in PHP schreiben möchte und nicht via YForm-Modul mit Pipe. Siehe http://www.redaxo.org/de/forum/post117833.html#p117833 (XForm).

@rotzek

Änderung siehe yakamara/yform@cb9fba7

mit in die Doku aufnehmen

yakamara/yform#178 (comment)

Anwendungsbeispiel?

In der Doku gibt es 3 Möglichkeiten, einen Antwort-Text im YForm-Modul bzw. der PHP-Notation zu definieren.

• Scheinbar wird answertext nicht ausgegeben
• html (action) und showtext werden gleichzeitig ausgegeben.

Hat das Gründe?
/cc @dergel

Gibt's bisher noch nicht in der Doku.

• Welche Felder sind durchsuchbar?
• Test, ob auch wirklich alle Felder sinnvoll durchsuchbar sind (war in xform nicht so)
• Hinweis zum Export (gefilterte Tabelle exportiert auch immer nur die gefundenen Datensätze und nicht alle, wenn ich mich recht erinnere)

Reminder für mich:
upload. mediafile, ycom_auth_password

Bei upload/mediafile: Auch auf Unterschiede eingehen und erklären, wann was benötigt wird.

Hier hätte ich gerne ein paar typische Anwendungsszenarien genannt. Ideen?

Siehe yakamara/yform#173

Bräuchte dazu mal ein paar sinnvolle Beispiele, wann das notwendig ist, insb. bei so Sachen wie checkbox, date.

Wie funktionieren sie? Was gibt es da für gebräuchliche Szenarien?

Wenn eine be_table befüllt wird, was enthält dann das Feld im Backend? csv mit Komma+Semikolon? Komma+Newline? JSON?

https://github.com/skerbis/yform-solutions

Wann ergibt das Sinn? Konkretes Beispiel wäre super.

Für folgende Felder (u.a.)
date, datetime, time, timestamp

objparam|form_ytemplate|dein_template,bootstrap

Todo

• Howto: Eigene Templates schreiben, ablegen (Struktur), Anwendungsszenarien)

@tbaddade

Formulare, die im Frontend ausgegeben werden, benötigen in aller Regel einen Spamschutz. Hier könnte man in der Doku Beispiele zur Umsetzung machen.

Lösungsansatz honeypot http://www.redaxo.org/de/forum/php-html-css-mysql-f9/submit-button-disabled-spamschutz-t21308.html (Fragestellung: Geht das Prinzip auch ohne extra Klasse?)

Lösungsansatz zeitspanne: ____

Weitere Lösungsansätze?

https://github.com/yakamara/redaxo_yform_docs/blob/master/de_de/table_manager_validierungen.md#unique

Verstehe ich das Szenario richtig:

1. Jemand gibt eine E-Mail-Adresse, bspw. [email protected], im Formular in das Feld "email" ein.
2. unique durchsucht alle Felder der aktuellen Tabelle, bzw. der in "Tabelle [opt]" angegeben Tabelle nach diesem Wert und gibt false zurück, wenn er gefunden wird.

D.h. umgekehrt, dass ich nicht in nur einem Feld einer Datenbank-Tabelle suchen kann, sondern immer in allen gesucht wird?

Damit auch Screenshots gezeigt werden können oder Muster-Imports verlinkt werden können.

Siehe auch https://github.com/aeberhard/dummy_documentation/issues/3

Die Bezeichnung wird doch ohnehin nicht angezeigt, oder?

Wann benötigt man emptyname überhaupt?

Früher war es ja möglich, in der master.inc.php in R4 eine 2. Datenbankverbindung zu hinterlegen. Das geht ja auch in R5.

Und ich lese zwischen den Zeilen öfters, dass der Table Manager auch auf die 2. Datenbankverbindung zugreifen kann. Wie funktioniert das? Verstehe ich da was falsch?

Howto übernehmen
yakamara/yform#134 (comment)

in rex5.2 habe ich yform 2.0 mit docs 2.0 installiert.

in den firefox devtools sehe ich dass eine http://localhost/redaxo_5.2.0/assets/addons/yform/plugins/docs/docs.css nicht geladen werde kann... 404...

im physikalischen ordner auf der platte existiert auch kein unterordner /docs/doc.css

php5.6.15
win10

Wert in der Datenbank: TueAMCESTEthCESTAMJul+02:00

@dergel