Het doel van Checkout Fields Manager is om u flexibiliteit te geven in welke gegevens u van uw klant wilt verzamelen. Met dat in gedachten biedt CFM 22 verschillende veldtypen, zodat u gegevens op de best mogelijke manier kunt verzamelen.
Veelvoorkomende veldelementen
Hoewel er heel weinig veldopties zijn die op elk veld voorkomen, zijn er enkele die op de meeste velden voorkomen. Hier zijn voorbeelden:
Veld tonen op checkoutveld aan de voorkant
Met deze optie kunt u het veld alleen in de admin of in zowel de admin als de voorkant van de site tonen. Hier is een voorbeeld van een veld in de builder dat alleen aan de achterkant verschijnt.
Hier is hetzelfde veld dat wordt weergegeven op de Betalingsrecordpagina (Downloads → Betalingsgeschiedenis):
Dit veld kan door de beheerder worden gebruikt, terwijl de klant er misschien nooit van weet dat het bestaat.
Tonen in geëxporteerde CSV's
U kunt ervoor kiezen dit veld wel of niet op te nemen in geëxporteerde CSV's
Waar moet deze meta worden opgeslagen
U kunt ervoor kiezen deze meta op te slaan in Payment Meta (verschillende waarden voor alle bestellingen van een bepaalde gebruiker), of User Meta (dezelfde waarde voor alle bestellingen van een bepaalde gebruiker).
Opmerking: Als u "Login vereist" niet hebt ingeschakeld in uw instellingen, verschijnt de optie om de gegevens op te slaan in User Meta niet, omdat uw gebruikers mogelijk geen gebruikersaccounts hebben waarin de gegevens kunnen worden opgeslagen. Deze instelling vindt u door te navigeren naar Downloads → Instellingen → Diversen → Checkout
Meta Sleutel
Dit is de naam van het meta-veld waarin u deze gegevens wilt opslaan. Als u het leeg laat bij het aanmaken van het veld, wordt er een voor u aangemaakt op basis van het Veldlabel.
Opmerking: Verander de meta-sleutel niet nadat u deze hebt aangemaakt. Als u dat wel doet, gaan alle gegevens die met de vorige meta-sleutel zijn aangemaakt verloren.
Opmerking: Meta-sleutels mogen geen spaties bevatten. Conventie is om spaties te vervangen door een underscore, maar een koppelteken werkt ook.
CSS Klasse Naam
Hiermee kunt u een aangepaste CSS-klassenaam instellen, speciaal voor dit veld.
Grootte
Alle velden van het teksttype hebben een optie voor grootte (breedte). De resultaten kunnen variëren, afhankelijk van het gebruikte thema.
Gegevens opslaan in user meta
Zoals hierboven vermeld, heeft u de optie om uw veld op te slaan in Payment Meta of User Meta. Alle gegevens die in User Meta worden opgeslagen, worden gekoppeld aan de ingelogde gebruiker die de aankoop doet en zijn beschikbaar voor die gebruiker voor toekomstig gebruik.
Een voorbeeld zou het telefoonnummer van een klant zijn. Zodra het tijdens een transactie in user meta is opgeslagen, wanneer die klant terugkeert en een andere transactie doet terwijl hij is ingelogd, zou zijn telefoonnummer al voor hem zijn ingevuld.
De klant heeft ook toegang tot aangepaste velden die aan hun gebruiker zijn gekoppeld in hun Profieleditor, aangemaakt door de [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.
Meerkeuze
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.
