Wat de module doet
De module levert een blok Formuliermet.nl-formulier dat je met de vertrouwde blokindeling in elke regio van je thema plaatst. Je kiest je formulier uit een zoekbare lijst van je eigen formulieren en bepaalt de weergave: in de pagina (past zich automatisch aan de hoogte aan), popup of slide-in.
De module werkt met Drupal 10 en Drupal 11.
Stap 1 — Download de module bij je formulier
Log in op Formuliermet.nl, open je formulier en klik op de deelknop. Kies onder het tabblad Plug-in voor Drupal. Het zip-bestand is vooringevuld met je sleutel en dít formulier, dus je kunt de configuratiestap overslaan.
Elke download krijgt een eigen sleutel, die je los kunt intrekken zonder je andere sites te raken.
Stap 2 — Installeren en inschakelen
Ga naar Beheer → Extensies → Nieuwe module installeren en upload het zip-bestand. Werk je met een eigen codebase, dan pak je de map uit in modules/custom/formuliermet. Schakel daarna de module in via Beheer → Extensies.
Stap 3 — Plaats het blok
Ga naar Structuur → Blokindeling, klik bij de gewenste regio op Blok plaatsen en zoek Formuliermet.nl-formulier. In het blokformulier kies je het formulier, de weergave en — bij popup en slide-in — het opschrift en de kleur van de knop. Met de gewone zichtbaarheidsinstellingen bepaal je op welke pagina's, voor welke rollen of bij welke inhoudstypes het blok verschijnt.
Wil je hetzelfde formulier op meerdere plekken maar met een andere weergave, plaats het blok dan gewoon twee keer met verschillende instellingen.
Stap 4 — Instellingen aanpassen (optioneel)
De algemene instellingen staan onder Beheer → Configuratie → Webdiensten → Formuliermet.nl (/admin/config/services/formuliermet). Daar staan je sleutel, het standaardformulier en de standaardweergave. Heb je de module vooringevuld gedownload, dan is dit al ingevuld.
Waar je op moet letten
Cache. Na het plaatsen of wijzigen van een blok is het gebruikelijke Cache leegmaken soms nodig voordat je de wijziging ziet — dat is Drupal, niet de module. De uitvoer zelf is prima cachebaar.
Content Security Policy. Gebruik je de CSP-module, dan komt het JavaScript van je eigen domein (script-src 'self' volstaat) en voeg je voor het formulier toe: frame-src 'self' https://app.formuliermet.nl; — of jouw eigen formulierdomein.
Rechten. Voor het instellen heb je de rechten administer site configuration (voor de instellingen) en administer blocks (voor de blokindeling) nodig.
De sleutel. Die staat in de configuratie en wordt alleen server-side gebruikt. Een embed-sleutel kan alleen de namen en adressen van je formulieren opvragen — geen inzendingen lezen en niets wijzigen. Intrekken kan altijd in je account.
Waarom niet gewoon Webform?
Webform is een uitstekende Drupal-module en als je alleen gegevens verzamelt is er weinig reden om te wisselen. Het verschil zit in wat eromheen hangt: iDEAL-betalingen via je eigen Mollie-account, reserveringen met beschikbaarheid, automatische incasso en bevestigingsmails met PDF-bon zitten hier ingebouwd — en de persoonsgegevens en betalingen staan niet in je eigen Drupal-database, maar op onze servers in Nederland. Dat scheelt onderhoud én risico.
