Brand-Brothers Forms
Handleiding: Bier Selectie Formulier
Deze handleiding beschrijft de verschillende parameters die je kunt gebruiken bij het configureren van een bier selectie formulier.
Het form wordt aangeroepen door middel van een URL en alle parameters worden in de URL meegegeven.
Voorbeeld:
https://....../.../brand-brothers/forms/?eigenaar=naam&merk=Texels&set=Texels-vuurtorenbar&minbeers=3&beerfilter=amstel&options=1,2,3,4,25,26&t=1&maxbeers=3
Spaties in URL
In de gehele URL moeten spaties worden gecodeerd als %20
.
Parameters
De parameters zoals in het voorbeeld getoond, worden hieronder beschreven. Elke parameter is rood gemarkeerd.
minbeers
- Beschrijving: Het minimaal aantal bieren dat geselecteerd moet worden.
- Werking: Als er minder bieren zijn geselecteerd dan het minimum, krijg je een waarschuwing wanneer je probeert het formulier te versturen.
maxbeers
- Beschrijving: Het maximaal aantal bieren dat geselecteerd kan worden.
- Werking: Als je meer bieren selecteert dan het maximum, verschijnt er onmiddellijk een waarschuwing.
Verborgen Velden
- Beschrijving: De volgende velden zijn verborgen en kunnen via de URL worden meegegeven. De verborgen velden worden dor het formulier meegestuurd en verschijnen in de email.
- eigenaar: De eigenaar van het biermerk.
- merk: De naam van het biermerk.
- set: De naam van de set die in de titel van het formulier verschijnt.
t (Testmodus)
- Beschrijving: Hiermee kun je de testmodus van het formulier instellen. aan t kunnen de volgende waarden worden gegeven:
- 0: Normale werking (dezelfde als geen waarde opgegeven).
- 1: Alle verplichte velden zijn niet meer verplicht en het formulier wordt niet per e-mail verzonden.
- 2: Alle verplichte velden zijn niet meer verplicht en het formulier wordt wel per e-mail verzonden.
options
- Beschrijving: Een lijst van opties die als een komma-gescheiden lijst moeten worden opgegeven. Deze opties worden getoond op het formulier.
beerfilter
- Beschrijving: Een filter om bieren op naam te selecteren.
- Werking: Als de waarde 'none' is, wordt de gehele bierselectie niet getoond. Je kunt meerdere filters specificeren, bijvoorbeeld:
beerfilter=amstel,brand
.
Options aanpassen
Om options aan te passen kan deze URL wordneworden gebruikt:
https://....../.../brand-brothers/forms/options
Elke optie heeft een nummer. Aan de hand van dit nummer wordt de optie op het formulieer geplaatst. De nummers hoeven niet uniek te zijn. Wanneer meerdere opties hetzelfde nummer hebben, worden alle opties op het fomrulier getoond wanneer deze optie wordt gekozen.