Wat de plug-in doet
Na installatie herkent Joomla in elk artikel de tekst {formuliermet} en vervangt die door je formulier. In de plug-in-instellingen kies je je standaardformulier uit een zoekbare lijst van je eigen formulieren, plus de weergave: in de pagina (hoogte past zich automatisch aan), popup of slide-in.
De plug-in is gebouwd voor Joomla 4 en Joomla 5 en wordt geleverd met Nederlandse en Engelse teksten.
Stap 1 — Download de plug-in bij je formulier
Log in op Formuliermet.nl, open je formulier en klik op de deelknop. Kies onder het tabblad Plug-in voor Joomla. Het zip-bestand dat je krijgt is vooringevuld met je sleutel en dít formulier, dus na installeren werkt het meteen.
Elke download krijgt een eigen, nieuwe sleutel. Zo kun je een sleutel per site intrekken zonder dat je andere sites stilvallen.
Stap 2 — Installeren en inschakelen
Ga in het beheer naar Systeem → Installeren → Extensies, sleep het zip-bestand in het uploadvak en wacht op de bevestiging. Ga daarna naar Systeem → Plug-ins, zoek op "Formuliermet" en zet de plug-in op Ingeschakeld. Vergeet dat laatste niet — een geïnstalleerde maar uitgeschakelde plug-in doet niets, en dat is de meest gemaakte fout.
Stap 3 — Zet het formulier in een artikel
Open een artikel en typ op de plek waar het formulier moet komen:
{formuliermet}
Dat toont het formulier dat je in de instellingen hebt gekozen. Wil je in dít artikel een ander formulier of een andere weergave, geef dat dan mee tussen de accolades:
{formuliermet slug="zomercursus"}— een ander formulier;{formuliermet mode="popup" label="Maak een afspraak"}— als knop met eigen opschrift;{formuliermet mode="slidein" color="#4f46e5"}— als zijtab in je eigen kleur;{formuliermet height="900"}— een andere starthoogte voor de inline-weergave.
Let op dat je editor de accolades als gewone tekst bewaart en er geen opmaak van maakt; in de code-weergave van de editor zie je precies wat er staat.
Stap 4 — Instellingen aanpassen (optioneel)
Onder Systeem → Plug-ins → Formuliermet.nl staan je sleutel, het standaardformulier, de standaardweergave en de knopkleur. Heb je de plug-in vooringevuld gedownload, dan staat het er al goed in. In het tabblad Geavanceerd vind je het adres van de dienst — dat pas je alleen aan als je formulieren op je eigen subdomein draaien.
Waar je op moet letten
Andere plug-ins met accolades. Sommige Joomla-extensies gebruiken ook {…}-codes. Dat botst niet: onze plug-in reageert alleen op {formuliermet…} en laat de rest ongemoeid.
Caching. Joomla-caching en onze plug-in gaan prima samen — de uitvoer is statische HTML met een verwijzing naar het formulier.
Content Security Policy. Het JavaScript komt van je eigen domein, dus script-src 'self' volstaat. Voor het formulier voeg je toe: frame-src 'self' https://app.formuliermet.nl;
De sleutel. Die staat in de plug-in-instellingen en wordt alleen server-side gebruikt. Een embed-sleutel kan bovendien alleen de namen en adressen van je formulieren opvragen — geen inzendingen lezen en niets wijzigen. Intrekken kan altijd in je account.
