Extra velden

Je kunt betaalformulieren maken met extra velden. Extra velden, of “Custom Fields” zijn relatief gezien best eenvoudig in gebruik. Je voegt voor ieder veld een regeltje shortcode toe aan je bestaande Paytium shortcode. Voor ieder veld dat je wilt toevoegen doe je dat.

Na installatie van Paytium kun je voorbeelden bekijken bij het iDEAL icoon in de WordPress editor. In de dropdown van het iDEAL icoon selecteer je “Field examples (text, textarea, email)” om geïnspireerd te raken. Alle mogelijke velden worden hieronder omschreven. Je kunt zoveel velden toevoegen als je wilt, als ze maar een unieke “label” hebben.

De extra velden moet je plaatsen in een bestaande Paytium shortcode. Een volledige Paytium shortcode wordt omringd door deze shortcodes:

[paytium]
[/paytium]

Zoals je ziet in onderstaand voorbeeld plaats je extra velden tussen die twee shortcodes (begin en eind shortcode). Als je nog niet zo ervaren bent met shortcodes, lees dan ook “Beginners: meer over formulieren en shortcodes“.

Tip: aan alle extra velden kun je een bedrag toevoegen!

Voorbeeld met drie extra velden

Code

[paytium name="Formulier naam" description="Product naam" amount="19,95"]
[paytium_field type="text" label="Tekst veld" required="true" /]
[paytium_field type="textarea" label="Opmerking" required="true" /]
[paytium_field type="email" label="Email" required="true" /]
[paytium_total /]
[/paytium]

Resultaat

Mogelijke extra velden

Text:
[paytium_field type="text" label="Your text" required="true" /]

In een “text” veld kun je bijna alle informatie verzamelen, maar het kan nuttig zijn om een specifiek veld te gebruiken. Die velden hebben namelijk validatie voor hun type. Zo controleert het “email” veld of een ingevoerde waarde wel echt een correct formaat is voor een mail. En het “postcode” veld controleert bijvoorbeeld of de ingevoerde waarde wel het formaat van de Nederlandse postcode’s heeft.

Text area:
[paytium_field type="textarea" label="Your text area" required="true" /]

Email:
[paytium_field type="email" label="Your email" required="true" /]

Label:
Als je alleen een tekst wil tonen, zonder veld.
[paytium_field type="label" label="Toon deze tekst zonder veld"/]

Checkbox:
[paytium_field type="checkbox" label="Meals" options="Breakfast/Lunch/Dinner" required="true" /]

Radio button:
[paytium_field type="radio" label="Want a cookie?" options="Yes/No" required="true" /]

Dropdown:
[paytium_field type="dropdown" label="Country" options="Belgium/The Netherlands/Germany" required="true" /]

Date:
[paytium_field type="date" label="Your date" required="true" /]

Let op: bij WordPress admin > Instellingen > Algemeen > Datumnotatie moet je wel formaat d-m-Y kiezen!

Birthday:
[paytium_field type="birthday" label="Your birthday" required="true" /]

Let op: bij WordPress admin > Instellingen > Algemeen > Datumnotatie moet je wel formaat d-m-Y kiezen!

[paytium_field type="birthday" label="Geboortedatum" required="true" ac_custom_field="GEBOORTEDATUM_…" /]

Let op: Bij veld geboortedatum/jaar naar boven te scrollen.
Gebruik het veldtype “Birthday” met een breder jaarbereik voor dit geval.

Postcode:
[paytium_field type="postcode" label="Your postcode" required="true" /]

Dit veld controleert postcodes op het Nederlandse postcode formaat, dus 1234 AB of 1234AB. Indien je ook graag validatie hebt voor andere postcode’s, stuur ons dan een mail zodat wij jouw verzoek kunnen meenemen in toekomstige updates. Voor buitenlandse postcodes kun je tijdelijk ook een “text” veld gebruiken.

Bestand uploaden (file uploads):
[paytium_field type="file" /]

Hidden:
[paytium_field type="hidden" label="Hidden field" default="Hidden data" /]

Dit veld wordt niet getoond aan website bezoekers, maar de informatie bij default wordt wel opgeslagen bij de andere informatie van het formulier.

Terms & conditions:
[paytium_field type="terms" label="I accept the terms & conditions" link="https://url-to-your-terms-and-conditions.com" required="true" /]

Verzendkosten:
[paytium_field type="radio" label="Opties" options=“ bedrag/ bedrag/bedrag” options_are_amounts=“true” /]

Er zijn geen verzendkosten in Paytium.
Je kan een radio type veld met de verschillende regio’s etc met de bijbehorende bedragen daarvoor gebruiken

Verdere (geavanceerde) mogelijkheden

Om de extra velden nog meer naar jou hand te zetten kun je onderstaande opties gebruiken:

• Stel bij de type parameter het type veld in dat je wilt toevoegen, de opties zijn: text, textarea, email, checkbox, radio, dropdown, terms.
• Om het label (de tekst bij het veld) aan te passen, gebruik je de parameter label met je eigen tekst.
• Als een veld verplicht is, stel dan de required parameter in op true, en anders false.
• Met placeholder="ABC" kun je een voorbeeld tekst in het veld tonen.
• Met minlength="8" kun je aangeven hoeveel tekens mensen minimaal mogen invoeren in velden van type text, textarea, name, firstname, lastname. Pas op met het gebruik van dit minimum bij namen en emails, je weet namelijk niet hoe lang iemand’s naam of email is!
• Met maxlength="35" kun je aangeven hoeveel tekens mensen maximaal mogen invoeren in velden van type text, textarea, name, firstname, lastname. Pas op met het gebruik van dit maximum bij namen en emails, je weet namelijk niet hoe lang iemand’s naam of email is!
• De checkbox, radio button en dropdown velden hebben een extra parameter options waar je de opties voor die velden kunt instellen (waar een gebruiker uit kan kiezen).
• Bij dropdown is de eerste waarde in de dropdown standaard “Selecteer een bedrag”. Dit kun je aanpassen met first_option="text" first_option_text="Eigen eerste selectie tekst". Als je het eerste bedrag wilt tonen als de eerste optie gebruik dan first_option="amount".
• Het “Algemene Voorwaarden” veld moet ingesteld worden als required, zodat gebruikers het formulier alleen kunnen verzenden als ze de voorwaarden geaccepteerd hebben. Gebruik de link parameter om een URL toe te voegen naar je Algemene Voorwaarden.
• Als je je eigen CSS class aan een field group wilt toevoegen, kan dat met class="jouw_css_class". Een field group is een <div> waarin een <label> en bijvoorbeeld een <input type="text" /> of <select> zich bevinden.

Veld met een default te vullen verplicht of niet verplicht ?

Het was zo dat als er geen waarde ingevuld is, er ‘niks’ was om een TAG te vervangen.
Sinds versie 4.3.5 is het mogelijk om een veld met een default in te vullen. (Er is nu een lege ruimte ipv een TAG.) Mogelijk is ook om de waarde ( ook de technische waarde) helemaal niet te tonen bij niet verplichte velden. Je kan bijvoorbeeld ook de dropdown velden met een default (waarde 0 ) vullen en vervolgens toch verplicht maken. Je wilt een veld niet verplicht maken, je wilt ook niet dat de waarde getoond wordt bij een niet verplichte dropdown. Je wilt mogelijk maken om dropdown velden met een default (waarde 0) te vullen en vervolgens de velden toch verplicht maken. Als er geen waarde wordt ingevuld wordt de TAG vervangen. Er is dus nu een lege ruimte in plaats van een TAG.

Checkbox niet aangeklikt:

Sinds versie 4.3.6 is wordt er door Paytium een check gedaan om klantgegevens ook zichtbaar te maken/meesturen bij betalingen ook indien checkbox label (zie onderstaande code) niet wordt aangeklikt door een klant.

[paytium_field type="checkbox" label="Periodieke incasso" options="Hierbij geef ik toestemming om het terugkerende bedrag periodiek van mijn rekening te incasseren." required="false" /] [/paytium]

Validatie van invoer in de browser

Bij text velden kun je een extra controle toevoegen met validation.
Dit is een controle in de browser van de ingevoerde waarde.
Bijvoorbeeld als je wilt dat bezoekers alleen getallen invoeren, gebruik je validation="digits".

Waardes die gebruikt kunnen worden: url, digits, alphanum.