Checkout Fields Manager – Feldtypen

Der Zweck des Checkout Fields Manager ist es, Ihnen Flexibilität bei der Datenerfassung von Ihren Kunden zu geben. Aus diesem Grund bietet CFM 22 verschiedene Feldtypen, damit Sie Daten auf die bestmögliche Weise sammeln können.

Gängige Feldelemente

Während es nur wenige Feldoptionen gibt, die bei jedem Feld vorkommen, gibt es einige, die bei den meisten Feldern vorhanden sind. Hier sind Beispiele:

Feld im Checkout-Feld des Frontends anzeigen

Diese Option ermöglicht es Ihnen, das Feld entweder nur im Admin-Bereich oder sowohl im Admin-Bereich als auch im vorderen Teil der Website anzuzeigen. Hier ist ein Beispiel für ein Feld im Builder, das so eingestellt ist, dass es nur im Backend erscheint.

Hier ist dasselbe Feld, das auf der Zahlungsseite (Downloads → Zahlungshistorie) gerendert wird:

Dieses Feld kann vom Administrator verwendet werden, während der Kunde nie von seiner Existenz wissen muss.

In exportierten CSVs anzeigen

Sie können wählen, ob dieses Feld in exportierte CSVs aufgenommen werden soll oder nicht.

Wo sollen diese Metadaten gespeichert werden?

Sie können wählen, ob diese Metadaten in Zahlungs-Metadaten (unterschiedliche Werte für alle Bestellungen eines bestimmten Benutzers) oder in Benutzer-Metadaten (gleicher Wert für alle Bestellungen eines bestimmten Benutzers) gespeichert werden sollen.

Hinweis: Wenn Sie in Ihren Einstellungen „Anmeldung erforderlich“ nicht aktiviert haben, wird die Option zum Speichern der Daten in Benutzer-Metadaten nicht angezeigt, da Ihre Benutzer möglicherweise keine Benutzerkonten haben, in denen die Daten gespeichert werden können. Diese Einstellung finden Sie unter Downloads → Einstellungen → Verschiedenes → Checkout 

Meta-Schlüssel

Dies ist der Name des Metafelds, in dem Sie diese Daten speichern möchten. Wenn Sie es beim Erstellen des Felds leer lassen, wird eines für Sie basierend auf dem Feld-Label erstellt.

Hinweis: Ändern Sie den Meta-Schlüssel nicht, nachdem Sie ihn erstellt haben. Wenn Sie dies tun, gehen alle mit dem früheren Meta-Schlüssel erstellten Daten verloren.

Hinweis: Meta-Schlüssel dürfen keine Leerzeichen enthalten. Die Konvention ist, Leerzeichen durch einen Unterstrich zu ersetzen, aber ein Bindestrich funktioniert auch.

CSS-Klassenname

Dies ermöglicht es Ihnen, einen benutzerdefinierten CSS-Klassennamen nur für dieses Feld festzulegen.

Größe

Alle Felder vom Typ Text haben eine Option für die Größe (Breite). Die Ergebnisse können je nach verwendetem Theme variieren.

Speichern von Daten in Benutzer-Metadaten

Wie oben erwähnt, haben Sie die Möglichkeit, Ihr Feld entweder in Zahlungs-Metadaten oder Benutzer-Metadaten zu speichern.  Alle in Benutzer-Metadaten gespeicherten Daten werden dem angemeldeten Benutzer, der den Kauf tätigt, zugeordnet und stehen diesem Benutzer zur zukünftigen Verwendung zur Verfügung.

Ein Beispiel wäre die Telefonnummer eines Kunden. Sobald sie während einer Transaktion in Benutzer-Metadaten gespeichert wurde, wird diese Telefonnummer beim nächsten Einkauf des Kunden, während er angemeldet ist, bereits vorausgefüllt.

Der Kunde hat auch Zugriff auf benutzerdefinierte Felder, die seinem Benutzer im Profil-Editor zugeordnet sind und durch den Shortcode [edd_profile_editor] erstellt wurden.

Hinweis: Die Option zum Speichern von Daten im Benutzer-Meta ist nur verfügbar, wenn die Option „Anmeldung erforderlich“ in Downloads → Einstellungen → Diverses → Kasse aktiviert ist.

Feldtyp-Optionen

Es stehen 22 Feldtypen zur Auswahl:

Action Hook

Dies ist für Entwickler, um dynamische Elemente nach Belieben hinzuzufügen. Es bietet die Möglichkeit, jeden Eingabetyp hinzuzufügen, den Sie in diesem Formular wünschen. Das folgende Bild zeigt dieses Feld mit einem Codebeispiel, das den Hook-Namen „hookname“ verwendet.

Codebeispiel: 

add_action('{hookname}', 'my_function_name}', 10, 4 ); 
// first param: Form Object 
// second param: Save ID of payment if in scope, else -2 
// third param: Save ID of user if in scope, else -2 
// fourth param: Field Object 
function my_function_name( $form, $payment_id, $user_id, $field ) { 	
// Do whatever you want here 
}

Hinweis: Easy Digital Downloads bietet keinen Support für benutzerdefinierten Code/Entwicklung. Bei Bedarf empfehlen wir, einen Entwickler über Codeable zu engagieren, um die gewünschten benutzerdefinierten Änderungen vorzunehmen.

Kontrollkästchen

Erstellt eine standardmäßige, generische Gruppe von Kontrollkästchen.

Land

Dieses Feld ermöglicht es Ihnen, dem Benutzer eine Liste von Ländern anzuzeigen. Die Feldoptionen umfassen alle aktuellen Länder, und Sie haben die Möglichkeit, diese hinzuzufügen oder zu entfernen, um bei Bedarf eine benutzerdefinierte Liste zu erstellen.

Datum

Dieses Feld ermöglicht es dem Endbenutzer, ein Datum und optional eine Uhrzeit einzugeben. Sie können wählen, ob die Uhrzeit eingegeben werden darf und ob die Startansicht Tag, Monat oder Jahr sein soll. 

E-Mail

Dieses Feld erscheint wie ein normales Textfeld, validiert aber die Eingabe und erfordert eine gültige E-Mail-Adresse.

Datei-Upload

Dieses Feld erstellt einen Mechanismus zum Hochladen von Dateien und ermöglicht es Ihnen, eine maximale Dateigröße, eine maximale Anzahl von Dateien festzulegen und Dateitypen auf diese zu beschränken:

• Bilder (jpg, jpeg, gif, png, bmp)
• Audio (mp3, wav, ogg, wma, mka, m4a, ra, mid, midi)
• Videos (avi, divx, flv, mov, ogv, mkv, mp4, m4v, divx, mpg, mpeg, mpe)
• PDF (pdf)
• Office-Dokumente (doc, ppt, pps, xls, mdb, docx, xlsx, pptx, odt, odp, ods, odg, odc, odb, odf, rtf, txt)
• Zip-Archive (zip, gz, gzip, rar, 7z)
• Ausführbare Dateien (exe)
• CSV (csv)

Vorname

Dieses Feld erstellt ein Textfeld mit einer Standardgröße von 40 und enthält keine Optionen für meta_key oder Import-/Exportfunktionen. Sie können auch nicht mehr als ein Vorname-Feld in einem Formular erstellen.

Versteckt

Dieses Feld erstellt ein standardmäßiges verstecktes Formularfeld. Es hat NUR Optionen für meta_key, meta_value und ob es nur im Frontend oder sowohl im Frontend als auch im Backend vorhanden sein soll.

Honeypot

Dieses Feld erstellt ein leeres Feld, das nur Bots sehen können und das sie ausfüllen werden.  Wenn es ausgefüllt ist, wird die Formularübermittlung abgelehnt. Weitere Informationen zu Honeypot-Feldern.

HTML

Dieses Feld ermöglicht es Ihnen, einen Titel und beliebiges HTML bereitzustellen.

Nachname

Dieses Feld ist ein einfaches Textfeld für den Nachnamen.

Hinweis: Formulare enthalten ein Feld für den Nachnamen, das nicht gelöscht werden kann, und Sie können kein zweites hinzufügen. Das bedeutet, dass Sie diese Option wahrscheinlich nie verwenden werden. Gelegentlich werden Nachnamensfelder versehentlich entfernt; diese Option ermöglicht es Ihnen, es wiederherzustellen.

Mehrfachauswahl

Dieses Feld erstellt eine Standard-Mehrfachauswahl-Auswahlliste. Sie können den Standardtext für die Auswahl festlegen und beliebig viele Optionen erstellen.

Radio

Dieses Feld erstellt eine Standardgruppe von Radiobuttons. Sie können beliebig viele erstellen.

reCAPTCHA

Dieses Feld erstellt ein reCAPTCHA v3-Tool. Damit reCAPTCHA funktioniert, müssen Sie Ihren Site-Schlüssel und Secret-Schlüssel im EDD-Einstellungsbereich einfügen. Bitte navigieren Sie zur Seite Downloads > Einstellungen > Erweiterungen > Checkout-Felder-Manager und fügen Sie dort Ihre API-Schlüssel hinzu.

Wenn Sie keine reCAPTCHA-Schlüssel haben, können Sie diese hier erhalten. Stellen Sie sicher, dass Sie bei der Erstellung Ihrer API-Schlüssel reCAPTCHA V3 aus der Liste auswählen.

reCAPTCHA v3 arbeitet im Hintergrund, sodass Sie dieses Feld nicht in Ihrem Checkout-Formular sehen. reCAPTCHA wird für externe Zahlungen wie PayPal automatisch deaktiviert.

Wiederholen

Dieses Feld erstellt ein Textfeld und bietet dem Kunden die Möglichkeit, beliebig viele weitere zu erstellen. Unten sehen Sie ein Beispiel der Frontend-Ansicht.

Abschnittstrenner

Dieses Feld erstellt einen Abschnittstrenner im Formular. Es ermöglicht einen Titel und eine Beschreibung.

Auswählen

Dieses Feld erstellt ein Standard-Dropdown-Auswahlfeld. Es funktioniert genau wie die Mehrfachauswahl oben, außer dass vom Kunden nur eine Option ausgewählt werden kann.

AGB

Dieses Feld ermöglicht es Ihnen, einen HTML-Block mit Allgemeinen Geschäftsbedingungen zu drucken, und bietet außerdem eine Checkbox mit einer Beschriftung, die der Kunde anklicken muss, um zuzustimmen.

Text

Dieses Feld erstellt ein Standard-HTML-Texteingabefeld.

Textbereich

Dieses Feld erstellt einen Standard-HTML-Textbereich. Sie können die Anzahl der Spalten und Zeilen, Platzhaltertext, einen Standardwert festlegen und zwischen einfachem Textbereich, Rich-Textbereich oder Teeny-Rich-Textbereich wählen.

URL

Dieses Feld erstellt ein Standard-Texteingabefeld, validiert aber auf eine URL.

Benutzer-E-Mail

Dieses Feld erstellt ein Standard-Texteingabefeld, validiert aber auf eine E-Mail-Adresse. Es ist dazu gedacht, die E-Mail-Adresse eines WordPress-Benutzers zu erfassen.

Hinweis: Ähnlich wie beim Nachnamen sollte dieses Feld bereits in Ihrem Formular vorhanden sein, und Sie können kein zweites hinzufügen. Diese Option existiert nur, damit Sie Ihr E-Mail-Feld ersetzen können, falls es versehentlich entfernt wurde.

Allgemeine Verwendung

Sobald ein Feldtyp angeklickt wird, wird er in die zentrale Spalte in der Mitte des Bildschirms eingefügt und Sie erhalten mehrere Optionen für das Feld. Die genauen Optionen können je nach Feldtyp variieren, aber alle Felder haben einige gemeinsame Optionen:

• Erforderlich: Wählen Sie „Ja“, wenn Kunden das Feld ausfüllen müssen, oder „Nein“, wenn es optional sein soll
• Feldbezeichnung: Dies ist der Text, der als primäre Bezeichnung für das Feld beim Checkout angezeigt wird
• Hilfetext: Dies ist der Text, der beim Checkout unter dem Feld hinzugefügt wird, um eine hilfreiche Erklärung zu geben, was der Kunde eingeben soll

Nachdem Sie alle benötigten Felder hinzugefügt haben, klicken Sie einfach auf die Schaltfläche „Speichern“, die sich im oberen rechten Bereich des Bildschirms befindet. Nach dem Speichern werden Ihre Felder nun auf der Checkout-Seite angezeigt.

Wichtige Hinweise:

Es gibt einige Checkout-Felder, die von dieser Erweiterung nicht geändert werden können:

1. Rechnungsadressfelder. Diese sind für Kreditkartenzahlungsgateways und das EDD-Steuersystem erforderlich, daher dürfen sie nicht geändert werden.

2. Das Kreditkartenformular, das von Zahlungsgateways verwendet wird, die Kreditkarten verarbeiten. Da es wichtig ist, dass diese Felder genau wie von EDD erwartet angezeigt werden, dürfen diese Felder nicht geändert werden.