Alles voor de webbouwer op één pagina.
Vroeg een autobedrijf je hiernaar te kijken, of bouw je sites voor meer dealers? Hier staat wat VoertuigWP nodig heeft en doet, per onderwerp.
WordPress 6.9 of nieuwer, PHP 8.1 of nieuwer, 256 MB geheugen.
Hexon Doorlinken Voorraad 2.25, als push op een eigen adres van de plugin.
Blok, widget of shortcode, en templates die je in je thema overschrijft.
Gratis kern zonder limiet. Pro en de agency-licentie zijn in de maak.
Starten
De plugin staat op wordpress.org. Zoek in Plugins › Nieuwe plugin op VoertuigWP, of upload de zip. De pluginpagina bestaat na de goedkeuring door wordpress.org.
- Bij het activeren maakt de plugin zijn eigen tabellen, de rollen Verkoper en Beheerder, en de inlog en het endpoint voor Hexon.
- De installatie loopt in zes stappen: bedrijf, Hexon, labels, pagina's, testmail, klaar. Elke stap is over te slaan; alles staat ook onder VoertuigWP › Instellingen.
- Mail gaat via
wp_mail(). Op veel hosts komt die slecht aan; de systeemcheck raadt een SMTP-plugin aan als die ontbreekt. - Verwijderen laat de gegevens staan. Alleen met het vinkje "gegevens verwijderen" gaan de tabellen en instellingen weg.
- Pro wordt een tweede plugin naast de gratis plugin, met een licentiesleutel. In de maak.
De koppeling met Hexon
De dealer kent zijn voorraadsysteem (VWE, Autodata, AutotelexPro, Mobilox, WinCar of een ander); dat levert via Hexon Doorlinken Voorraad. In Hexon vul je het adres en de inlog uit de plugin in, en zet je Send overlays seperate aan. De installatie toont alle waarden met een kopieerknop.
VoertuigWP › Installatie, stap Hexon. Het echte scherm; domein en inlog zijn voorbeelden.
Onder de motorkap
- Hexon stuurt per auto een push (add, change, delete) naar
/voertuigwp-dv/, buiten/wp-json. De plugin antwoordt met een kale1; bij een fout ziet Hexon een echte foutmelding. - Elke push bevat de hele auto, dus een push die twee keer binnenkomt kan geen kwaad. Een delete betekent verkocht, nooit wissen.
- Foto's gaan in een wachtrij, één foto per taak; een foto die niet veranderde wordt niet opnieuw gedownload. WP-Cron draait alleen bij bezoek: de plugin raadt een server-cron aan en toont de achterstand.
- Foto's staan in
uploads/voertuigwp/, niet in de mediabibliotheek. Alleen de hoofdfoto wordt een gewone afbeelding, voor de uitgelichte afbeelding en de preview bij delen. - Verkocht wordt herkend aan het labelplaatje bij de hoofdfoto, op het beeld en niet op de bestandsnaam. De dealer wijst één keer aan welk plaatje verkocht, gereserveerd of alleen watermerk is.
- De korte link
/voertuig/[voertuignr_hexon]gaat met een 301 naar de pagina van de auto. Velden die de dealer vergrendelt, overschrijft Hexon niet; er gaat niets terug naar Hexon. - Na een push leegt de plugin de cache van WP Rocket, LiteSpeed Cache of W3 Total Cache en de objectcache.
VoertuigWP › Status › Pushlog: elke push van Hexon met zijn uitkomst. Voorbeelddata.
Alle instellingen in Hexon, de URL naar de auto's en de valkuilen (de Authorization-header, een firewall, WP-Cron) staan in Hexon instellen.
Weergave en templates
Blok, widget en shortcode gaan door dezelfde renderer, met dezelfde attributen en dezelfde templates.
| Onderdeel | Gutenberg-blok | Elementor-widget | Shortcode |
|---|---|---|---|
| Lijst met auto's | voertuigwp/vehicle-list | voertuigwp-vehicle-list | [voertuigwp_list] |
| Eén voertuig | voertuigwp/vehicle | voertuigwp-vehicle | [voertuigwp_vehicle] |
| Formulier met de auto erbij | voertuigwp/form | voertuigwp-form | [voertuigwp_form type="contact"] |
Bijvoorbeeld [voertuigwp_list status="sold" make="BMW" per_page="24"] voor een verkocht-overzicht van BMW's, of [voertuigwp_vehicle nr="56358762" gallery="0"] voor één auto zonder galerij. Onbekende attributen worden genegeerd. In Bricks en Divi maak je met de themabouwer een sjabloon voor het posttype voertuigwp_vehicle met [voertuigwp_vehicle] erin.
Templates overschrijven
Kopieer een deel naar voertuigwp/ in je thema en pas het aan. Volgorde: kindthema, hoofdthema, plugin.
| Bestand in je thema | Wat erin staat |
|---|---|
| voertuigwp/single-vehicle.php | De hele voertuigpagina in een klassiek thema |
| voertuigwp/vehicle/detail.php | De indeling: galerij, samenvatting, beschrijving, specificaties, accessoires |
| voertuigwp/vehicle/summary.php | Titel, status, prijs, btw of marge en de kernfeiten |
| voertuigwp/vehicle/gallery.php | De foto's |
| voertuigwp/vehicle/specs.php | De specificaties per groep |
| voertuigwp/vehicle/sold.php | De melding bij een verkochte auto |
| voertuigwp/list/list.php | Het raster, de lege lijst en de paginering |
| voertuigwp/list/card.php | Eén kaart in de lijst |
- Blokthema: een eigen
templates/single-voertuigwp_vehicle.htmlgaat voor, en ook een versie die je in de site-editor aanpast. - Elementor zonder Pro: ontwerp een gewone pagina met de detailwidgets en kies die als layoutpagina; de plugin vult hem per auto.
- Stijl: de CSS van de plugin gebruikt één klasse per regel; je overschrijft hem zonder
!important. Zonder eigen accentkleur neemt de plugin de hoofdkleur uit jetheme.json. - Velden: een template krijgt alleen openbare velden. Interne velden uit Hexon, zoals een inkoopprijs, komen er niet bij; het kenteken staat standaard uit, het chassisnummer nooit aan.
- SEO: elke auto is een bericht met een eigen adres, in de sitemaps van je SEO-plugin. Met Yoast of Rank Math vult de plugin alleen aan wat leeg is; JSON-LD staat standaard aan. Per plugin: werkt samen met.
- Pro (in de maak) voegt filters en zoeken, een carrousel, een verkocht-overzicht en Elementor Dynamic Tags en Loop Grid toe. Stopt de licentie, dan valt de site terug op de gewone lijst en detailpagina.
Het thema Showroom (in de maak)
- Een blokthema met
theme.jsonen acht style variations; alleen core blocks, dus alles is te wijzigen in de site-editor. - Een stijl is een style variation plus een keuze uit de patronen: vier headers, twee footers, vijf hero's en losse secties.
- Het palet gebruikt de slugs
base,contrast,primary,secondaryenaccent; de blokken van VoertuigWP kleuren mee, ook in een ander blokthema. - Werkt zonder de plugin als gewoon blokthema: geen functies, geen demo-import, geen externe aanroepen, de lettertypes in de zip. De plugin installeert het van wordpress.org via de installer van WordPress, alleen na een klik, en onthoudt het vorige thema.
Formulieren en aanvragen
Elke aanvraag komt als lead in de inbox van de site, in eigen tabellen. Het formulier van de plugin plaats je als blok, widget of shortcode; bestaande formulieren koppel je.
| Formulierplugin | Zo koppel je |
|---|---|
| Elementor Forms | De actie "Stuur naar VoertuigWP" na verzenden. |
| Contact Form 7 | Het tabblad VoertuigWP in de editor van het formulier. |
| Gravity Forms | Een feed op het formulier. |
- Koppelen: je wijst aan welk veld de naam, het e-mailadres en het telefoonnummer is, en welk soort lead het is. Staat het formulier op de pagina van een auto, dan hangt die auto aan de lead. Andere velden komen als extra gegevens mee. Mails en spambeveiliging blijven bij de formulierplugin.
- Spam: het eigen formulier heeft geen nonce (die verloopt op gecachete pagina's), maar een verborgen veld, een ondertekend tijdstempel en een limiet per afzender. Turnstile, reCAPTCHA v2 of hCaptcha zet je aan met eigen sleutels; het script laadt pas als een bezoeker het formulier aanraakt.
- Herkomst: bron en campagne per lead, standaard alleen na toestemming voor statistieken via de WP Consent API (Complianz, CookieYes, Cookiebot en andere).
- Rollen: een Verkoper behandelt leads; een Beheerder mag ook exporteren, verwijderen en de instellingen wijzigen. Verkopers alleen hun eigen leads laten zien, is een instelling.
- Gegevens: leads staan niet in de berichten van WordPress, dus niet in de zoekfunctie, de REST API of de gewone export. De privacytools van WordPress exporteren of wissen op e-mailadres; na 24 maanden (instelbaar) gaan naam, contactgegevens en bericht weg.
- Inruilfoto's (Pro, in de maak) worden opnieuw opgeslagen zonder EXIF en GPS, in een privémap buiten de mediabibliotheek. De systeemcheck kijkt of die map van buiten dicht is.
Cookiebanners, SEO-, cache- en SMTP-plugins en captcha's per plugin: werkt samen met.
Overstappen
Bij een overstap van een andere voorraadplugin wijzigt in Hexon het URL Endpoint en de inlog; de rest van de instellingen loop je na zoals bij een nieuwe koppeling. Hexon stuurt daarna de hele voorraad opnieuw. De auto's van de vorige plugin zijn niet nodig: VoertuigWP heeft een eigen berichttype.
Oude adressen
Een oud adres dat op je site een 404 zou geven, stuurt de plugin door, zonder lijst. Hij kijkt in deze volgorde:
- Eindigt het laatste deel op het voertuignummer van Hexon (
…-56358762), dan 301 naar die auto. - Een link met
?voertuignr_hexon=56358762, op welk pad ook: 301 naar die auto. - Een pagina van de vorige plugin die nog in de database staat: het nummer komt uit die pagina.
- De titel van de auto in het adres (merk, model en type): 301 naar die auto.
Is de auto er niet meer, of nog niet, dan gaat het adres naar de aanbodpagina (301 voor een verborgen auto, 302 voor een onbekend nummer). Alleen GET en HEAD; een gewone 404 blijft een 404.
De adressen van de vorige plugin
- Tussendoor (Autobedrijf en Voertuigen plugin): standaard
/aanbod/en/voertuig/{titel}; met#{/}in de titel wordt het adres opgeknipt. De basis is te wijzigen metpost.register.rewrite.slugenpost.register.has_archive, extra zoekpagina's staan onderarchive.pages, in het tabblad Geavanceerd.1 Het basisthema van Tussendoor draait als child-theme naast het hoofdthema.2 - Softwarewinkel (Hexon WordPress Plugin, onderdeel van POSlogic): op de demosite van de leverancier staat het aanbod op
/voertuigen/en één auto op/voertuigdetails/{naam}/; de basis is instelbaar.3
- Tussendoor docs, Admin: https://doc.tussendoor.nl/books/autobedrijf-voertuigen-plugin/page/admin, geraadpleegd op 12 oktober 2026.
- Tussendoor docs, Ontwikkeling: https://doc.tussendoor.nl/books/autobedrijf-voertuigen-plugin/page/ontwikkeling, geraadpleegd op 12 oktober 2026.
- Softwarewinkel, Hexon WordPress Plugin: https://softwarewinkel.nl/product/hexon-wordpress-plugin/ en de demosite https://preh.nl/voertuigen/, geraadpleegd op 4 november 2026.
Checklist op de dag zelf
| Controle | Waar | Goed als |
|---|---|---|
| Eerste push binnen | Installatiecheck | Er staan auto's in de voorraad, met de tijd van de push |
| Labels komen mee | Installatiecheck | De pushes bevatten labelplaatjes; zo niet, dan staat Send overlays seperate uit |
| Foto's bereikbaar | Status › Fotowachtrij | De wachtrij loopt leeg |
| Verkocht aangewezen | VoertuigWP › Instellingen | Een verkochte auto staat als VERKOCHT op de site |
| Oude adressen | Je browser | Een paar oude adressen gaan naar de nieuwe pagina van die auto |
| Link vanuit Hexon | /voertuig/56358762 | Opent de pagina van die auto |
| Aanvraag en mail | Het formulier op een auto | De lead staat in de inbox en de mail komt aan |
Hooks
Een lead naar het CRM van de dealer, of een melding als een auto verkocht is.
voertuigwp_lead_created- Action. Een nieuwe lead is opgeslagen, uit welk formulier ook.
voertuigwp_lead_status_changed- Action. De status van een lead is gewijzigd.
voertuigwp_vehicle_activated- Action. Een auto staat online.
voertuigwp_vehicle_sold- Action. Een auto is verkocht, herkend aan het VERKOCHT-label.
voertuigwp_client_ip- Filter. Het IP-adres van de bezoeker, voor sites achter een proxy of CDN.
voertuigwp:lead_submitted- JavaScript-event in de browser, plus een push naar de
dataLayer. Of een conversie meetelt, bepaalt de cookiebanner.
de argumenten per hook komen in de docs.
Installatiecheck en support
Komt de voorraad niet binnen, dan ligt het meestal aan de host. De systeemcheck in VoertuigWP › Status zegt welke regel niet klopt en wat er moet gebeuren.
| Controle | Als het niet klopt |
|---|---|
| Eerste push van Hexon | De installatie laat live zien of de testpush binnenkwam. |
| Labels van Hexon | Geen <overlays> in de push: Send overlays seperate staat uit. |
Authorization-header | Hexon kan niet inloggen. De regel voor .htaccess, of de reserveroute met een token. |
| Cron en wachtrij | Foto's en mails wachten. Een server-cron die wp-cron.php aanroept. |
| PHP en geheugen | Onder 256 MB kan de fotoverwerking stoppen. |
| Privémap | Inruilfoto's zijn van buiten te openen; met de regel voor nginx. |
| SMTP-plugin | Geen gevonden: leadmails kunnen in spam landen. |
Kopieer diagnose op dezelfde pagina geeft in één tekst de versies, het thema, de actieve plugins, de uitkomst van elke controle en de laatste fouten, zonder persoonsgegevens, inlog of sleutels. Plak die in je supportvraag aan support@voertuigwp.nl, met bij een Hexon-probleem het tijdstip van de push. Stuurt Hexon op werkdagen 48 uur niets, dan krijgt de dealer een waarschuwing.
De agency-licentie
De gratis kern zet je op elke site. Met agency krijgen je klantsites ook Pro. Pro is in de maak; sta je op de lijst, dan hoor je als eerste wanneer je hem kunt kopen.
- Prijs
- Op aanvraag: neem contact op.
- Aantal sites
- Vanaf 4 sites op één licentie. Een test- of stagingsite op een subdomein telt niet mee.
- Activeren
- Per site de licentiesleutel. Verhuist een klant naar een ander domein, dan verhuis je de licentie mee.
- Stopt de licentie
- Dan stoppen de Pro-functies en blijven de gegevens. De site valt terug op de gratis kern en gaat voor bezoekers niet kapot.
- Code
- GPL, net als WordPress: aanpassen mag. Verkoop je een aangepaste versie door, dan onder een andere naam.
de regel voor testsites staat nog niet vast.