De Hexon-koppeling instellen
Welke instellingen in Hexon aan moeten, waar je de gegevens vindt en wat je doet als de eerste push niet binnenkomt.
Voordat je begint
Je hebt nodig:
- een Hexon-account met een koppeling voor Doorlinken Voorraad naar je website;
- VoertuigWP, geïnstalleerd en geactiveerd op een site met WordPress 6.9 of nieuwer en PHP 8.1 of nieuwer;
- toegang tot de instellingen van je hosting, voor het geval je een regel in
.htaccessof een cron moet toevoegen.
De installatiewizard van VoertuigWP loopt dezelfde stappen langs. Dit artikel is er voor als je het liever zelf doet, of als iets niet werkt.
De gegevens uit de plugin
Ga in WordPress naar VoertuigWP › Instellingen › Hexon-koppeling. Daar staan drie gegevens, elk met een kopieerknop:
- URL Endpoint: het adres waar Hexon de voorraad naartoe stuurt, bijvoorbeeld
https://jouwsite.nl/voertuigwp-dv/; - Username en Password: de inlog die de plugin bij het activeren aanmaakte.
De installatie bij de stap Hexon; dezelfde gegevens staan onder Instellingen › Hexon-koppeling. Domein en inlog zijn voorbeelden.
Het endpoint staat bewust buiten /wp-json/. Hexon verwacht een kale 1 als antwoord, en de REST API van WordPress zou daar "1" van maken. Zonder mooie permalinks werkt /?voertuigwp_dv=1 ook.
De instellingen in Hexon
Open de koppeling in Hexon en vul deze waarden in. Ze komen uit een koppeling die live draait.
| Instelling in Hexon | Waarde | Waarom |
|---|---|---|
| Version | 2.25 | De plugin leest het XML-formaat van versie 2.25. |
| Request type | HTTP POST (XML) | Zo levert Doorlinken Voorraad. |
| URL Endpoint, Username, Password | Uit de plugin | Met de kopieerknoppen hierboven. |
| Image dimensions | Original | De plugin maakt zelf de formaten voor je site. |
| URL pattern on dealer website | https://jouwsite.nl/voertuig/[voertuignr_hexon] | Hexon linkt hiermee naar de auto; de plugin stuurt door. Zie hieronder. |
| Delete after days | Advies volgt | We zoeken met Hexon uit wat deze instelling precies doet. |
| Target country | Netherlands | De plugin leest de Nederlandse prijzen. |
| Send expected vehicles | Aan | Dan kan een auto de status "verwacht" krijgen. |
| Send overlays seperate | Aan | Nodig voor de verkocht-herkenning. Zie hieronder. |
| Send VIN | Aan | Dan is het chassisnummer beschikbaar. |
het advies voor "Delete after days" staat nog open.
De URL naar je auto's
In het veld URL pattern on dealer website zet je:
https://jouwsite.nl/voertuig/[voertuignr_hexon]
Vervang alleen jouwsite.nl door je eigen domein. Laat [voertuignr_hexon] precies zo staan, met de blokhaken: Hexon vult daar per auto het nummer in.
Hexon gebruikt dit adres om naar de auto op je site te linken. VoertuigWP stuurt /voertuig/56358762 door naar de echte pagina van de auto, zoals /aanbod/volkswagen-golf-2011-56358762/. Verander je later de slug van je aanbodpagina, dan blijft de link in Hexon gewoon werken.
Send overlays seperate
Hexon schrijft het zelf zo, met de spelfout. Zet het vinkje aan.
- Uit: Hexon brandt de labels, zoals een VERKOCHT-banner en je watermerk, in de foto. De plugin krijgt geen los label en kan een verkochte auto niet herkennen.
- Aan: Hexon stuurt schone foto's, met per foto een apart labelplaatje. De plugin kijkt naar het plaatje van de hoofdfoto en ziet daaraan of de auto verkocht is.
Na de eerste pushes laat de plugin de labelplaatjes zien die binnenkwamen. Je wijst één keer aan welk plaatje verkocht, gereserveerd of alleen watermerk is. Daarna herkent de plugin die plaatjes vanzelf, ook in een ander formaat.
Je watermerk staat met het vinkje aan niet meer in de foto. De plugin kan het labelplaatje van Hexon zelf over de foto leggen.
Zet je het vinkje om terwijl er al auto's op je site staan, dan veranderen de foto-URL's van Hexon. De plugin downloadt dan één keer alle foto's opnieuw. Dat gaat vanzelf, maar het duurt even.
Testpush en installatiecheck
Sla de koppeling op in Hexon. Na het instellen publiceert Hexon je hele voorraad opnieuw. De gegevens van elke auto verwerkt de plugin meteen; de foto's komen daarna via een wachtrij binnen, ook als het om honderden auto's gaat.
In de installatiewizard, bij de stap Hexon, zie je live drie vinkjes verschijnen:
- push ontvangen;
- labels aanwezig (de push bevat
<overlays>); - foto's binnen.
Blijft het tweede vinkje leeg, dan staat Send overlays seperate uit. Blijft het eerste leeg, kijk dan bij de valkuilen hieronder. Wat Hexon precies stuurde, zie je in VoertuigWP › Status › Pushlog.
VoertuigWP › Status › Pushlog. Voorbeelddata.
Valkuilen
Hexon kan niet inloggen
Sommige hosts halen de Authorization-header weg voordat hij bij PHP komt, vooral als PHP als CGI of FastCGI draait. Hexon stuurt de inlog dan wel, maar de plugin ziet hem niet en weigert de push.
De systeemcheck in VoertuigWP › Status laat zien of de header doorkomt. Komt hij niet door, zet dan deze regel in .htaccess, boven de regels van WordPress:
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
Helpt dat niet, of draait je site op nginx, zet dan in Instellingen › Hexon-koppeling de reserveroute aan. Die zet een geheim token in de URL in plaats van in de header. De route staat standaard uit, omdat de URL met het token in de toegangslog van de webserver komt.
Een beveiligingsplugin of Cloudflare blokkeert de push
Beveiligingsplugins zoals Wordfence en diensten zoals Bot Fight Mode van Cloudflare zien een XML-POST van buiten soms als een aanval. Hexon krijgt dan een foutpagina terug in plaats van een 1, en in de pushlog staat niets.
Maak in de firewall een uitzondering voor het pad /voertuigwp-dv/, en stuur daarna een nieuwe testpush.
of Hexon vaste IP-adressen heeft die je kunt toestaan, zoeken we nog uit.
Foto's komen langzaam of niet binnen
De plugin verwerkt de voertuiggegevens meteen, maar de foto's één voor één in een wachtrij. Die wachtrij draait op WP-Cron, en WP-Cron draait alleen als er bezoekers op je site komen. Op een stille of goed gecachete site blijven foto's en mails dan liggen.
Laat je host een echte server-cron instellen die wp-cron.php elke paar minuten aanroept, en zet WP-Cron uit in wp-config.php:
define( 'DISABLE_WP_CRON', true );
De systeemcheck toont bij Cron en Wachtrij of de taken op tijd lopen, en de fotowachtrij in VoertuigWP › Status laat zien welke foto's nog wachten.
Kom je er niet uit? Klik in VoertuigWP › Status › Systeemcheck op Kopieer diagnose en plak de tekst in een mail aan support@voertuigwp.nl. Er staan geen persoonsgegevens of wachtwoorden in.