The purpose of Checkout Fields Manager is to give you flexibility in what data you’d like to gather from your customer. With that in mind, CFM offers 22 different field types so that you may gather data in the best possible way.
Common Field Elements
While there are very few field options that occur on every field, there are some that are on most fields. Here are examples:
Show field on frontend checkout field
This option allows you to show the field either only in the admin or in both the admin and the front of the site. Here’s an example of a field in the builder set to only appear on the back end.
Here’s that same field rendering on the Payment record page ( Downloads → Payment History):
This field may be used by the administrator while the customer need never knows it exists.
Show in exported CSVs
You may choose to include this field in exported CSVs or not
Where should this meta be stored
You may choose to store this meta in the Payment Meta (different values for all orders by a particular user), or User Meta (same value for all orders by a particular user).
Note: If you do not have “Require Login” enabled in your settings, the option to store the data in User Meta will not appear because your users may not have user accounts in which to store the data. This setting can be found by navigating to Downloads → Settings → Misc → Checkout
Meta Key
This is the name of the meta field in which you wish to store this data. If you leave it blank when creating the field, one will be created for you based on the Field Label.
Note: Do not change the meta key after creating it. If you do, any data created with the former meta key will be lost.
Note: Meta keys may not have spaces. Convention is to replace spaces with an underscore, but a hyphen will also work.
CSS Class Name
This allows you to set a custom CSS class name just for this field.
Size
All fields that are text types have an option for size (width). Results may vary depending on theme used.
Storing data in user meta
As mentioned above, you have the option to store your field either in Payment Meta or User Meta. Any data stored in User Meta will be attached to the logged in user making the purchase and be available to that user for future use.
An example would be a customer phone number. Once stored in user meta during a transaction, when that customer returns and makes another transaction while logged in their phone number would be already filled in for them.
The customer will also have access to custom fields attached to their user in their Profile Editor, created by the [edd_profile_editor] shortcode.
Opmerking: De optie om gegevens op te slaan in gebruikersmeta is alleen beschikbaar als de optie "Login vereist" is ingeschakeld in Downloads → Instellingen → Diversen → Afrekenen.
Opties voor veldtypen
Er zijn 22 veldtypen om uit te kiezen:
Actie Hook
Dit is voor ontwikkelaars om dynamische elementen toe te voegen zoals ze willen. Het biedt de mogelijkheid om elk invoertype toe te voegen dat u in dit formulier wilt toevoegen. De onderstaande afbeelding toont dit veld met een codevoorbeeld met de haaknaam "hookname".
Codevoorbeeld:
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
}
Opmerking: Easy Digital Downloads biedt geen ondersteuning voor aangepaste codering/ontwikkeling. Indien nodig raden we aan een ontwikkelaar in te huren via Codeable om de benodigde aangepaste wijzigingen aan te brengen.
Selectievakje
Creëert een standaard generieke set van selectievakjes.
Land
Met dit veld kunt u de gebruiker een lijst met landen presenteren. De veldopties bevatten alle huidige landen, en u hebt de mogelijkheid om toe te voegen of te verwijderen om indien nodig een aangepaste lijst te maken.
Datum
Met dit veld kan de eindgebruiker een datum invoeren, en optioneel een tijd. U kunt kiezen of tijd mag worden ingevoerd, en of het startbeeld Dag, Maand of Jaar moet zijn.
E-mailadres
Dit veld lijkt op een normaal tekstveld, maar valideert de invoer en vereist een geldig e-mailadres.
Bestand uploaden
Dit veld creëert een mechanisme voor het uploaden van bestanden, en stelt u in staat een maximale bestandsgrootte, maximaal aantal bestanden in te stellen, en u kunt bestandstypen beperken tot deze:
- Afbeeldingen (jpg, jpeg, gif, png, bmp)
- Audio (mp3, wav, ogg, wma, mka, m4a, ra, mid, midi)
- Video's (avi, divx, flv, mov, ogv, mkv, mp4, m4v, divx, mpg, mpeg, mpe)
- PDF (pdf)
- Kantoordocumenten (doc, ppt, pps, xls, mdb, docx, xlsx, pptx, odt, odp, ods, odg, odc, odb, odf, rtf, txt)
- Zip-archieven (zip, gz, gzip, rar, 7z)
- Uitvoerbare bestanden (exe)
- CSV (csv)
Voornaam
Dit veld creëert een tekstveld met een standaardgrootte van 40, en bevat geen opties voor meta_key of een van de import/exportfuncties. U kunt ook niet meer dan één veld voor de voornaam in een formulier maken.
Verborgen
Dit veld creëert een standaard verborgen formulierveld. Het heeft ALLEEN opties voor meta_key, meta_value, en of het alleen voor de frontend of voor zowel de frontend als de backend is.
Honingpot
Dit veld creëert een leeg veld dat alleen bots kunnen zien, en zij zullen het invullen. Als het wordt ingevuld, wordt het indienen van het formulier geweigerd. Meer informatie over honingpotvelden.
HTML
Met dit veld kunt u een titel en willekeurige HTML opgeven.
Achternaam
Dit veld is een gewoon tekstveld voor de achternaam.
Opmerking: Formulieren worden geleverd met een veld voor de achternaam dat niet kan worden verwijderd, en u kunt er geen tweede toevoegen, wat betekent dat u deze optie waarschijnlijk nooit zult gebruiken. Af en toe worden velden voor de achternaam per ongeluk verwijderd; deze optie stelt u in staat deze te herstellen.
Multiselect
Dit veld creëert een standaard multi-select keuzelijst. U kunt de standaard selectietekst specificeren en zoveel opties maken als u wilt.
Radio
Dit veld creëert een standaard set radioknoppen. U kunt zoveel maken als u wilt.
reCAPTCHA
Dit veld creëert een reCAPTCHA v3 tool. Om reCAPTCHA te laten werken, moet u uw site-sleutel en geheime sleutel invoeren in het EDD-instellingenpaneel. Navigeer naar de pagina Downloads > Instellingen > Extensies > Checkout Fields Manager en voeg daar uw API-sleutels toe.
Als u geen reCAPTCHA-sleutels heeft, kunt u ze hier verkrijgen. Zorg ervoor dat u bij het aanmaken van uw API-sleutels reCAPTCHA V3 selecteert uit de lijst.
reCAPTCHA v3 werkt stilzwijgend, dus u ziet dit veld niet in uw afrekenformulier. reCAPTCHA is automatisch uitgeschakeld voor betalingen buiten de site, zoals PayPal.
Herhalen
Dit veld creëert een tekstveld en biedt de klant de mogelijkheid om zoveel meer aan te maken als hij/zij wil. Hieronder vindt u een voorbeeld van de weergave aan de voorkant.
Sectieonderbreking
Dit veld creëert een sectieonderbreking in het formulier. Het maakt een titel en beschrijving mogelijk.
Selecteer
Dit veld creëert een standaard dropdown selectieveld. Het functioneert precies zoals de Multi-select hierboven, behalve dat slechts één optie door de klant kan worden gekozen.
Voorw. & Voorw.
Dit veld stelt u in staat om een blok HTML met voorwaarden en bepalingen af te drukken, en biedt ook een selectievakje met een label waar de klant op kan klikken om akkoord te gaan.
Tekst
Dit veld creëert een standaard HTML-tekstinvoerveld.
Tekstvak
Dit veld creëert een standaard HTML-tekstarea. U kunt een aantal kolommen en rijen instellen, placeholdertekst, een standaardwaarde, en kiezen tussen een gewone tekstarea, Rich-tekstarea of Teeny Rich-tekstarea.
URL
Dit veld creëert een standaard tekstinvoerveld maar valideert voor een URL.
Gebruikers-e-mail
Dit veld creëert een standaard tekstinvoerveld maar valideert voor een e-mailadres. Het is bedoeld om het e-mailadres van een WordPress-gebruiker op te nemen.
Opmerking: Net als Achternaam, zou dit veld al in uw formulier moeten bestaan, en u kunt er geen tweede toevoegen. Deze optie bestaat alleen zodat u uw e-mailveld kunt vervangen als het per ongeluk wordt verwijderd.
Algemeen gebruik
Zodra op een veldtype wordt geklikt, wordt het toegevoegd aan de middelste kolom in het midden van het scherm en krijgt u verschillende opties voor het veld te zien. De exacte opties kunnen per veldtype verschillen, maar alle velden delen een paar gemeenschappelijke opties:
- Verplicht: Selecteer "Ja" als u wilt dat klanten de velden moeten invullen, of "Nee" als dit optioneel moet zijn
- Veld Label: Dit is de tekst die als primair label voor het veld op de checkout wordt weergegeven
- Hulptekst: Dit is de tekst die onder het veld op de checkout wordt toegevoegd om als nuttige uitleg te dienen van wat de klant moet invoeren
Nadat u alle benodigde velden heeft toegevoegd, klikt u gewoon op de knop "Opslaan" rechtsboven op het scherm. Eenmaal opgeslagen, worden uw velden nu weergegeven op de checkout.
Belangrijke opmerkingen:
Er zijn een paar afrekenvelden die niet door deze extensie kunnen worden gewijzigd:
1. Factuuradresvelden. Deze zijn vereist door creditcard betaalpoorten en door het EDD-belastingsysteem, dus deze mogen niet worden gewijzigd.
2. Het Creditcardformulier dat wordt gebruikt door betalingsgateways die creditcards verwerken. Aangezien het van vitaal belang is dat deze velden precies zo verschijnen als verwacht door EDD, mogen deze velden niet worden gewijzigd.
