Een formulier bouwen

Op het tabblad Bouwen van de formuliereditor geef je de vragen vorm. Het heeft drie delen: de lijst Stappen en het palet Veld toevoegen links, de actieve stap in het midden, en de instellingen van de geselecteerde stap of vraag rechts. Wijzigingen zijn een concept tot je Opslaan en Publiceren gebruikt (zie Opslaan, publiceren en activeren).

Stappen#

Een formulier bestaat uit één of meer stappen; een bezoeker ziet één stap tegelijk en gaat verder met Volgende. Een contactformulier heeft meestal één stap, een offerteaanvraag meerdere.

• Stap toevoegen voegt een stap aan het eind toe. Een formulier heeft maximaal 20 stappen.
• Sleep een stap aan zijn greep, of gebruik de pijltjes omhoog en omlaag, om de volgorde te wijzigen.
• Klik op een stap in de lijst om hem in het midden te tonen. Elke stap toont hoeveel velden hij heeft, en een vertakkingsicoon als hij alleen bij bepaalde antwoorden wordt getoond.
• Klik op de titel van de stap boven de vragen om rechts de stapinstellingen te openen: Titel van de stap, Logica (zie Vragen alleen bij bepaalde antwoorden tonen) en, onder Geavanceerd, de Sleutel van de stap ("Herkent de stap in regels en in de API.").
• Stap verwijderen verwijdert de stap en de vragen erin nadat je hebt bevestigd. Een formulier houdt altijd minstens één stap. Op je site verandert niets tot je opslaat en publiceert.

Een vraag toevoegen#

Klik op een veldtype in Veld toevoegen om het aan het eind van de actieve stap toe te voegen. Een formulier heeft maximaal 150 invoervelden (Kop en Alinea tellen niet mee); het palet toont hoeveel je er hebt gebruikt.

Klik in het midden op een vraag om hem te selecteren en rechts te bewerken. Sleep vragen aan hun greep, of gebruik de pijltjes, om ze binnen de stap te verplaatsen. Elke vraag heeft ook Veld dupliceren en Veld verwijderen.

Het midden toont elke vraag ongeveer zoals de bezoeker hem ziet, met een paar hints: Uit URL bij vragen die vanuit het paginaadres kunnen worden ingevuld, "Getoond als ..." bij vragen met een regel, en bijvoorbeeld "Geen EN-tekst" als een tekst ontbreekt in de taal die je bekijkt.

Instellingen van een vraag#

De instellingen rechts zijn in secties gegroepeerd. Met meer dan één contenttaal schrijf je met de taaltabbladen bovenaan elke tekst per taal; de standaardtaal heeft een tekst nodig.

Inhoud#

• Vraag: de tekst van de vraag. Bij een Kop is het de Kop, bij een Alinea de Tekst, bij Toestemming de Toestemmingstekst en bij Verborgen de Naam in de inbox.
• Hulptekst en Placeholder voor de vragen die een bezoeker beantwoordt.

Een Toestemmingstekst mag één link bevatten, geschreven als [privacybeleid](https://example.com/privacy). De link moet met https:// beginnen.

Antwoord#

• Verplicht: de bezoeker moet antwoorden voordat hij verder kan. Bij Toestemming betekent het "Het vakje moet aangevinkt zijn om het formulier te versturen." Een verplichte vraag die door een regel verborgen is, is nooit verplicht.
• Opties voor Keuzelijst en Keuzekaarten (zie hieronder).
• Meerdere antwoorden toestaan voor Keuzekaarten, met Minimaal en Maximaal om te beperken hoeveel de bezoeker mag kiezen.
• Bij Adres: Land, Adres opzoeken en Werkgebied (zie Adresvragen).
• Bij Bestand uploaden: Toegestane bestanden (Afbeeldingen, PDF of allebei), Max. bestanden (1 tot 10) en Max. MB per bestand (1 tot 20).
• Bij Verborgen: Waarde komt uit De pagina-URL (ingevuld vanuit ?key= in het adres van de pagina met het formulier, waarbij key de sleutel van de vraag is) of Je site (je site geeft de waarde mee wanneer het formulier wordt getoond).

Logica#

Wie deze vraag ziet. Zie Vragen alleen bij bepaalde antwoorden tonen.

Geavanceerd#

• Sleutel: "Het antwoord wordt onder deze sleutel opgeslagen en regels verwijzen ernaar." Kleine letters, cijfers en underscores, te beginnen met een letter, maximaal 50 tekens, en uniek binnen het formulier. Als je een sleutel hernoemt, worden de regels die hem gebruiken bijgewerkt.
• Invullen vanuit de pagina-URL: een link met ?key=… vult dit antwoord in, bijvoorbeeld ?email=ada@example.com voor de vraag met sleutel email. De bezoeker kan het nog wijzigen.

Geef de vraag naar de naam van de bezoeker de sleutel name: de inbox, de meldingsmail en de plaatshouder {name} lezen de naam uit die sleutel. Het e-mailadres en telefoonnummer in de inbox komen uit de eerste E-mail- en de eerste Telefoon-vraag.

Opties#

Opties van Keuzekaarten hebben elk een label, een regel Omschrijving (optioneel), een icoon en een Waarde. De waarde wordt opgeslagen en regels vergelijken ermee; het label is wat de bezoeker leest en kan per taal verschillen. Optie toevoegen voegt er een toe (maximaal 30); gebruik de pijltjes om de volgorde te wijzigen en het kruisje om er een te verwijderen. Klik op het icoonvakje om een icoon te kiezen: Iconen zoeken, kies er een, of Geen icoon.

Verwijder je een optie die een regel gebruikt, dan worden de voorwaarden die haar gebruikten ook verwijderd, en een melding vertelt je hoeveel. Hernoem je de waarde van een optie, dan worden de regels die ermee vergelijken bijgewerkt.

Opties van een Keuzelijst zijn gewone teksten, in elke taal hetzelfde. Typ er een in Nieuwe optie om hem toe te voegen (maximaal 50).

Opties uit een collectie#

Keuzekaarten kunnen hun opties uit een collectie halen (een objecttype onder Objecten) in plaats van uit een lijst die je zelf typt. Schakel onder Opties van Handmatig naar Uit een collectie en kies dan:

• Collectie: Kies een collectie (zoek met Zoek een collectie). Zonder collecties staat er "Je hebt nog geen collecties. Maak er een aan onder Objecten."
• Label: het tekstveld dat als optietekst wordt getoond (Kies een veld). Een collectie zonder tekstveld toont "Deze collectie heeft geen tekstveld om als label te gebruiken."
• Omschrijving: een tekstveld voor de tweede regel, of Geen.
• Sorteren op: een getalveld, laagste eerst en items zonder getal als laatste, of Aanmaakdatum.
• Max. opties: hoeveel opties worden aangeboden, 1 tot 100 (standaard 30).

Onder de instellingen zie je hoeveel items de collectie toont, bijvoorbeeld "Toont 12 gepubliceerde items.", of "Sla op om de items van deze collectie te laden." zolang je niet hebt opgeslagen. Alleen gepubliceerde items verschijnen: concepten en ingeplande items blijven buiten beschouwing. De lijst volgt de collectie, dus je hoeft het formulier niet opnieuw te publiceren als een item wordt toegevoegd, hernoemd of gedepubliceerd; wijzigingen in deze instellingen vragen zoals altijd een nieuwe publicatie. In het midden staat onder de vraag "Opties uit de collectie “{type}”".

"Elk antwoord wordt opgeslagen als de slug van het item, zodat regels blijven werken als een titel verandert." Bij een collectie waarvan de items geen adres hebben wordt in plaats daarvan het id van het item opgeslagen. Met Meerdere antwoorden toestaan kunnen Minstens en Hoogstens tot Max. opties gaan. Een regel die nog vergelijkt met een item dat niet meer bestaat, toont "“{value}” is geen optie meer. Kies een ander antwoord."

Adresvragen#

Een vraag Adres vraagt in één blok om Postcode, Huisnummer, Toevoeging, Straat en Plaats, bijvoorbeeld voor een offerteaanvraag of een levering. Postcode, huisnummer, straat en plaats zijn verplicht als de vraag verplicht is. Onder Antwoord stel je in:

• Land: Kies een land (zoek met Zoek een land). Het postcodeformaat volgt het land. Nieuwe adresvragen beginnen met Nederland.
• Adres opzoeken: "Bezoekers vullen postcode en huisnummer in, straat en plaats worden aangevuld." De bezoeker ziet "Adres opzoeken…" en kan het resultaat nog aanpassen. Opzoeken kan alleen voor Nederland ("Adres opzoeken kan alleen voor Nederland."); voor andere landen blijft de schakelaar uit. Als er niets wordt gevonden of de adresdienst niet bereikbaar is, ziet de bezoeker "Geen adres gevonden. Vul straat en plaats zelf in." of "Het adres kon niet worden opgezocht. Vul straat en plaats zelf in." en typt ze zelf.
• Werkgebied: "Controleer de afstand van een startpunt tot het adres." Dit toont meer instellingen:
  • Startpunt: klik op Bedrijfsadres gebruiken om het adres uit Instellingen → Bedrijf te nemen ("Vul eerst een postcode en huisnummer in onder Instellingen > Bedrijf." als het er geen heeft), of zoek een ander adres op onder "Of zoek een ander adres op:" door een Postcode en Huisnummer te typen en op Opzoeken te klikken ("Geen adres gevonden bij deze postcode en dit huisnummer.").
  • Straal (km): hoe ver een adres van het startpunt mag liggen.
  • Buiten het gebied: Een melding tonen ("De bezoeker ziet de melding en kan het formulier toch versturen.") of Verzenden blokkeren ("De bezoeker ziet de melding en kan het formulier met dit adres niet versturen."). Blokkeren werkt alleen met Adres opzoeken aan ("Blokkeren kan alleen met adres opzoeken, dat de locatie controleert."), omdat alleen een opgezocht adres gecontroleerde coördinaten heeft. Een adres dat niet kan worden gevonden of gecontroleerd wordt nooit geblokkeerd.
  • Melding buiten het gebied: de tekst die de bezoeker ziet, per taal. Verplicht.

De afstand is hemelsbreed, niet de rijafstand. In een regel kan een vraag Adres alleen worden getest met is ingevuld of is niet ingevuld. In de Inbox staat het adres op één regel, met de afstand als het buiten het gebied ligt.

Bestanden uploaden#

Met een vraag Bestand uploaden voegt de bezoeker bestanden toe, bijvoorbeeld foto's van een klus of een pdf met een briefing. Kies onder Antwoord:

• Toegestane bestanden: Afbeeldingen (JPEG, PNG, WebP en HEIC, het formaat van iPhone-foto's), PDF, of allebei.
• Max. bestanden: hoeveel bestanden de bezoeker bij deze vraag mag toevoegen, 1 tot 10.
• Max. MB per bestand: 1 tot 20.

In het midden staan deze limieten onder de vraag, bijvoorbeeld "Afbeeldingen · maximaal 3 bestanden, 10 MB per stuk". Zet Verplicht aan om minstens één bestand te vereisen.

Borkol controleert elk bestand op de inhoud, niet op de naam: een bestand dat niet echt een afbeelding of pdf is, wordt geweigerd, en een te groot bestand ook. Een bezoeker kan maximaal 30 bestanden per formulier per uur uploaden. De bestanden komen met de inzending binnen in je Inbox. In Voorbeeld kun je bestanden kiezen, maar er wordt niets geüpload. Je developer vindt de upload-call op het tabblad Gebruiken op je site. Zie Spambescherming en bestanden voor hoe bestanden worden opgeslagen en wanneer ze worden verwijderd.