Ein Formularfeld mit festem Schlüssel
wp-field="key" Ohne wp-field kommt ein Formularfeld unter seiner Beschriftung aus dem Layout im Eintrag an. Wird „Dein Name“ zu „Name“, bekommen eine E-Mail-Vorlage mit {{ Dein Name }} oder die Übergabe ans CRM stillschweigend nichts, obwohl weiter Einträge eingehen. wp-field legt den Schlüssel fest.
Wo es hingehört
Am Feld selbst oder an der Hülle „Beschriftung + Feld“. Der Wert ist ein Schlüssel in lateinischen Buchstaben: name, phone, guests.
Der Build schreibt den Schlüssel in name und data-name des Felds, am Theme ändert sich dabei nichts.
Beispiel: ein Reservierungsformular
<form class="form">
<label wp-field="name">Your name
<input type="text" name="field" data-name="Your name"></label>
<label wp-field="phone">Phone
<input type="tel" name="field" data-name="Phone"></label>
<input type="submit" value="Send">
</form>- name: Anna Kowalski
- phone: +1 (555) 010-0142
Your name
Phone
SendIm Eintrag tragen die Felder Schlüssel als Namen, nicht den Text der Beschriftung.
Worauf es ankommt
- In der E-Mail-Vorlage und in den Einstellungen der Übergabe schreibst du den Schlüssel:
{{ name }}. - Das Attribut ist optional: Ohne es arbeitet das Formular mit den Beschriftungen, wie bisher.
- Bei Kommentaren, Bewertungen und der Kasse legt WordPress die Feldnamen selbst fest, dort setzt du
wp-fieldnicht.
Typische Fehler
Das Build-Protokoll ist der Tab „Logs“ deines Projekts auf themeforge.pro; die kostenlose Markup-Prüfung zeigt dieselben Hinweise.
<label wp-field="action">Your name
<input type="text" name="field" data-name="Your name"></label>Ein reservierter Name wie action oder ein Schlüssel mit Umlauten oder nicht lateinischen Buchstaben: Der Build wendet ihn nicht an, schreibt das ins Protokoll, und das Feld wird unter seiner Beschriftung gesendet.
<label wp-field="name">Your name
<input type="text" name="field" data-name="Your name"></label>Ein eigener Schlüssel in lateinischen Buchstaben.