Docs/Voor webbouwers/De techniek

De techniek voor webbouwers

Wat Autocorso nodig heeft en doet: installeren, de koppeling met Hexon, weergave en templates, formulieren, overstappen, hooks en de installatiecheck.

Starten

De plugin is aangemeld bij wordpress.org en wordt daar nog beoordeeld. Tot hij daar staat, download je de zip op Gratis installeren en upload je hem via Plugins › Nieuwe plugin › Plugin uploaden; pak hem niet uit. Staat hij op wordpress.org, dan zoek je in WordPress op Voertuig Voorraad: zo heet de plugin daar.

  • 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 Autocorso › 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.

De installatie van Autocorso bij de stap Hexon: het adres, de gebruikersnaam en het wachtwoord met een kopieerknop, en de andere instellingen voor Hexon

Autocorso › Installatie, stap Hexon. Het echte scherm; domein en inlog zijn voorbeelden.

Onder de motorkap

  • Hexon stuurt per auto een push (add, change, delete) naar /autocorso-dv/, buiten /wp-json. De plugin antwoordt met een kale 1; 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/autocorso/, 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.
De pushlog van Autocorso: per push van Hexon de tijd, de actie, het voertuignummer, de uitkomst en het bericht

Autocorso › 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.

OnderdeelGutenberg-blokElementor-widgetShortcode
Lijst met auto'sautocorso/vehicle-listautocorso-vehicle-list[autocorso_list]
Eén voertuigautocorso/vehicleautocorso-vehicle[autocorso_vehicle]
Formulier met de auto erbijautocorso/formautocorso-form[autocorso_form type="contact"]

Bijvoorbeeld [autocorso_list status="sold" make="BMW" per_page="24"] voor een verkocht-overzicht van BMW's, of [autocorso_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 autocorso_vehicle met [autocorso_vehicle] erin.

Templates overschrijven

Kopieer een deel naar autocorso/ in je thema en pas het aan. Volgorde: kindthema, hoofdthema, plugin.

Bestand in je themaWat erin staat
autocorso/single-vehicle.phpDe hele voertuigpagina in een klassiek thema
autocorso/vehicle/detail.phpDe indeling: galerij, samenvatting, beschrijving, specificaties, accessoires
autocorso/vehicle/summary.phpTitel, status, prijs, btw of marge en de kernfeiten
autocorso/vehicle/gallery.phpDe foto's
autocorso/vehicle/specs.phpDe specificaties per groep
autocorso/vehicle/sold.phpDe melding bij een verkochte auto
autocorso/list/list.phpHet raster, de lege lijst en de paginering
autocorso/list/card.phpEén kaart in de lijst
  • Blokthema: een eigen templates/single-autocorso_vehicle.html gaat 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 je theme.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.json en 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, secondary en accent; de blokken van Autocorso 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.

FormulierpluginZo koppel je
Elementor FormsDe actie "Stuur naar Autocorso" na verzenden.
Contact Form 7Het tabblad Autocorso in de editor van het formulier.
Gravity FormsEen 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: Autocorso 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:

  1. Eindigt het laatste deel op het voertuignummer van Hexon (…-56358762), dan 301 naar die auto.
  2. Een link met ?voertuignr_hexon=56358762, op welk pad ook: 301 naar die auto.
  3. Een pagina van de vorige plugin die nog in de database staat: het nummer komt uit die pagina.
  4. 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 met post.register.rewrite.slug en post.register.has_archive, extra zoekpagina's staan onder archive.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
  1. Tussendoor docs, Admin: https://doc.tussendoor.nl/books/autobedrijf-voertuigen-plugin/page/admin, geraadpleegd op 12 oktober 2026.
  2. Tussendoor docs, Ontwikkeling: https://doc.tussendoor.nl/books/autobedrijf-voertuigen-plugin/page/ontwikkeling, geraadpleegd op 12 oktober 2026.
  3. 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

ControleWaarGoed als
Eerste push binnenInstallatiecheckEr staan auto's in de voorraad, met de tijd van de push
Labels komen meeInstallatiecheckDe pushes bevatten labelplaatjes; zo niet, dan staat Send overlays seperate uit
Foto's bereikbaarStatus › FotowachtrijDe wachtrij loopt leeg
Verkocht aangewezenAutocorso › InstellingenEen verkochte auto staat als VERKOCHT op de site
Oude adressenJe browserEen paar oude adressen gaan naar de nieuwe pagina van die auto
Link vanuit Hexon/voertuig/56358762Opent de pagina van die auto
Aanvraag en mailHet formulier op een autoDe 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.

autocorso_lead_created
Action. Een nieuwe lead is opgeslagen, uit welk formulier ook.
autocorso_lead_status_changed
Action. De status van een lead is gewijzigd.
autocorso_vehicle_activated
Action. Een auto staat online.
autocorso_vehicle_sold
Action. Een auto is verkocht, herkend aan het VERKOCHT-label.
autocorso_client_ip
Filter. Het IP-adres van de bezoeker, voor sites achter een proxy of CDN.
autocorso:lead_submitted
JavaScript-event in de browser, plus een push naar de dataLayer. Of een conversie meetelt, bepaalt de cookiebanner.

Installatiecheck en support

Komt de voorraad niet binnen, dan ligt het meestal aan de host. De systeemcheck in Autocorso › Status zegt welke regel niet klopt en wat er moet gebeuren.

ControleAls het niet klopt
Eerste push van HexonDe installatie laat live zien of de testpush binnenkwam.
Labels van HexonGeen <overlays> in de push: Send overlays seperate staat uit.
Authorization-headerHexon kan niet inloggen. De regel voor .htaccess, of de reserveroute met een token.
Cron en wachtrijFoto's en mails wachten. Een server-cron die wp-cron.php aanroept.
PHP en geheugenOnder 256 MB kan de fotoverwerking stoppen.
PrivémapInruilfoto's zijn van buiten te openen; met de regel voor nginx.
SMTP-pluginGeen 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@autocorso.com, met bij een Hexon-probleem het tijdstip van de push. Stuurt Hexon op werkdagen 48 uur niets, dan krijgt de dealer een waarschuwing.

Zet je occasions vandaag nog op je site.

Gratis installeren