Documentatie · Aan de slag

Installatiehandleiding

Deze handleiding beschrijft hoe u de ADP Car Market Hub WordPress-plugin installeert en activeert op een WordPress-site, en hoe u controleert of de installatie succesvol is verlopen voordat u verdere configuraties uitvoert.

API-inloggegevens of de importconfiguratie worden hier niet behandeld — deze onderwerpen komen aan bod in Eerste installatie, API-inloggegevens instellen and Verbindungstest.

Wanneer u dit document gebruikt

Gebruik dit document als u:

ADP Car Market Hub voor de eerste keer installeert op een nieuwe WordPress-site.
De plugin opnieuw installeert op een bestaande site (bijvoorbeeld na een servermigratie of een schone herbouw).
Controleert of een installatie die door een derde partij (bureau, hostingprovider, interne IT) is uitgevoerd, correct is voltooid.
Een gedocumenteerde installatieprocedure voorbereidt voor een oplevering aan een klant.

De doelgroep is een WordPress-beheerder met volledige backoffice-toegang en, wanneer SFTP-installatie wordt gebruikt, met bestandssysteeminloggegevens voor de doelserver.

Voordat u begint

Controleer het volgende voordat u met de installatie begint. De meeste problemen die tijdens de installatie optreden, worden veroorzaakt doordat een van deze vereisten niet volledig is.

Plugin-pakket. Een ondertekend plugin-ZIP-archief van ADP Car Market Hub geleverd door AD Promotion of uw distributiekanaal. Wijzig de naam van het archief niet en pak het niet uit om het vervolgens weer in te pakken.
Licentiesleutel. Uw ADP Car Market Hub-licentiesleutel, geleverd door AD Promotion. De plugin kan zonder deze sleutel worden geïnstalleerd en geactiveerd, maar elk beheerders-tabblad behalve Settings blijft vergrendeld achter een "Licentie vereist"-scherm totdat de licentie is geactiveerd. Licentie-activering wordt behandeld in Eerste installatie.
WordPress-omgeving. Een werkende WordPress-installatie die voldoet aan de minimale vereisten van de plugin:
WordPress 6.2 of hoger (Requires at least: 6.2 in de plugin-header).
PHP 8.1 of hoger (Requires PHP: 8.1 in de plugin-header en composer.json).
Een door WordPress ondersteunde database (MySQL of MariaDB).
PHP-extensies openssl, curl, mbstring, json, en een van gd of imagick.
Een beschrijfbare uploads-map (wp-content/uploads/). Zie Technical System Requirements voor alle details.
Uitgaande HTTPS-verbinding. De webserver moet de AutoScout24 API-host kunnen bereiken die u later configureert. Zie API, Network and SSL Requirements.
Beheerdersaccount. Een WordPress-gebruiker met de manage_options-mogelijkheid (meestal de rol administrator) is vereist om de plugin te installeren, te activeren en te configureren.
Back-up. Een actuele, herstelbare back-up van de WordPress-site, inclusief database en wp-content/. Productie-installaties moeten altijd een recente back-up hebben voordat een plugin wordt geïnstalleerd of geactiveerd.
Staging-omgeving (aanbevolen). Voor productiesites wordt ten zeerste aanbevolen om de plugin eerst op een staging-kopie te installeren en te valideren, en de configuratie vervolgens naar productie over te zetten. Zie Staging to Live Migration.
Pre-installatie checklist. Doorloop de Pre-Installation Checklist om te controleren of hosting, PHP, database en netwerk gereed zijn.

Stapsgewijze instructies

Er zijn twee ondersteunde installatieroutes:

Optie A — ZIP-upload via het WordPress-beheer (aanbevolen voor de meeste omgevingen).
Optie B — Handmatige upload via SFTP (aanbevolen wanneer het WordPress-beheer plugin-uploads niet toestaat, wanneer de hostingomgeving alleen-lezen bestandssystemen afdwingt voor de beheerder, of bij installatie als onderdeel van een deployment-pipeline).

Gebruik de ene of de andere route; voer ze niet beide tegelijkertijd uit.

Optie A — Installeren via het WordPress-beheer (ZIP-upload)

Log in op WordPress als beheerder.
Open in het linker beheermenu Plugins → Nieuwe plugin toevoegen.
Klik bovenaan de pagina op Plugin uploaden.
Klik op Bestand kiezen en selecteer het ADP Car Market Hub-ZIP-archief.
Klik op Nu installeren en wacht tot WordPress het archief heeft geüpload en uitgepakt.
Klik zodra de upload is voltooid op Plugin activeren.

Als de upload mislukt met een grootte- of geheugenfout, is dit meestal een limiet aan de serverzijde (upload_max_filesize, post_max_size, memory_limit, of een beperking van de web-application-firewall). Los de limiet op met uw hostingprovider of gebruik Optie B.

Optie B — Handmatig installeren via SFTP

Pak het ADP Car Market Hub-ZIP-archief uit op uw lokale computer. U krijgt dan een enkele map genaamd adp-car-market-hub/ die de plugin-bestanden bevat.
Maak verbinding met de WordPress-server via SFTP (of SSH) met een account dat schrijfrechten heeft op wp-content/plugins/.
Upload de volledige map adp-car-market-hub/ naar wp-content/plugins/, zodat het uiteindelijke pad wp-content/plugins/adp-car-market-hub/ is.
Controleer of wp-content/plugins/adp-car-market-hub/adp-car-market-hub.php op de server bestaat. WordPress identificeert de plugin aan de hand van dit hoofdbestand.
Log in op WordPress als beheerder.
Open Plugins → Geïnstalleerde plugins, zoek ADP Car Market Hub in de lijst en klik op Activeren.

Wijzig de rechten van plugin-bestanden niet handmatig, tenzij uw hostingprovider dit expliciet vereist. De plugin heeft geen schrijftoegang nodig tot zijn eigen map.

Activeringscontroles

Na het klikken op Activeren zou WordPress een succesmelding moeten tonen en zou ADP Car Market Hub in de lijst met actieve plugins moeten verschijnen.

Als de activering wordt geblokkeerd, toont WordPress een melding met de reden. De meest voorkomende oorzaken zijn:

De site voldoet niet aan de minimale WordPress- of PHP-versies van de plugin.
Er ontbreekt een vereiste PHP-extensie.
Er bestaat nog een eerdere, onvolledige installatie van de plugin op de schijf.
Bestandsrechten op wp-content/plugins/ verhinderen dat WordPress de activering voltooit.

Los het onderliggende probleem op en probeer de activering opnieuw. De plugin wijzigt tijdens de activering geen thema's of andere plugins.

Controles na activering

Voer deze controles onmiddellijk uit na een succesvolle activering. Ze bevestigen dat de plugin correct is geladen en klaar is voor configuratie.

Beheermenu. Controleer of er een nieuw hoofdmenu-item Car Market Hub zichtbaar is in de zijbalk van het WordPress-beheer (de weergavenaam van de plugin in het menu is ingekort — het plugin-bestand zelf is geregistreerd als ADP Car Market Hub). Beweeg de muis over het item om de beschikbare submenu-items te zien, waaronder Dashboard, Settings, Car Importer, Import & Limits, Tools, System & Help, Logs en andere.
Plugin-actielinks. Op Plugins → Geïnstalleerde plugins moet de rij van ADP Car Market Hub nu een link License activation en een link Settings tonen, naast Deactiveren. License activation opent de Settings-pagina direct bij de License Activation-kaart; Settings opent de algemene Settings-pagina van de plugin.
Settings-pagina laadt. Open Car Market Hub → Settings. De pagina moet laden zonder PHP-meldingen, fatale fouten of waarschuwingen over ontbrekende bestanden. De License Activation-kaart moet bovenaan de pagina verschijnen, en de velden API Base URL, Seller ID, Client ID, Client Secret en Default currency moeten zichtbaar en leeg zijn (bij een nieuwe installatie). Bij een nieuwe installatie tonen de andere plugin-tabbladen een "Licentie vereist"-scherm totdat een licentie is geactiveerd.
System & Help. Open Car Market Hub → System & Help. De pagina moet omgevingscontroles tonen (PHP, JSON, OpenSSL, cURL, GD/Imagick, uploads) met statusbadges in verkeerslichtstijl. Een nieuwe installatie die aan de vereisten voldoet, mag geen rode badges tonen; een ontbrekende extensie of een niet-schrijfbare map wordt hier gemarkeerd. Los eventuele problemen op voordat u doorgaat.
Geen fatale fouten in logs. Controleer of het debug-logboek van WordPress (indien ingeschakeld) en het foutenlogboek van uw hosting geen fatale fouten tonen die verband houden met de plugin. De plugin houdt zijn eigen logbestand bij op wp-content/uploads/as24ci-logs/, dat automatisch wordt aangemaakt bij het eerste gebruik.

Als een van deze controles mislukt, ga dan niet door naar de configuratiestappen. Los eerst het probleem op of zet de meest recente back-up terug.

Melding Eerste installatiewizard

Na de eerste activering van de plugin verschijnt er bovenaan elke WordPress-beheerpagina een beheermelding met de titel Welcome to ADP Car Market Hub. De melding biedt twee knoppen:

Start Setup Wizard opent de First Setup Wizard, een stappenplan van zeven stappen (licentie, modus, dealerprofiel, AutoScout24, pagina's, functies, afronding). Licentie-activering is de eerste, verplichte stap; de overige stappen zijn optioneel.
Skip for now verbergt de melding. De wizard blijft bereikbaar via het Dashboard en via Car Market Hub → Tools.

De melding is geen geforceerde omleiding. Deze verschijnt alleen wanneer de tijdstempel van de eerste activering net is geregistreerd en de wizard nog niet is voltooid of overgeslagen. Plugin-updates die geen nieuwe activering triggeren, tonen de melding niet op bestaande installaties. De wizard is optioneel maar aanbevolen; alles wat deze biedt, kan ook handmatig worden geconfigureerd via de reguliere beheer-tabbladen.

Configuratienotities

Dit document behandelt alleen de installatie. De volgende punten zijn specifiek van toepassing op de installatie-/activeringsfase:

Plugin-slug en map. De verwachte mapnaam is adp-car-market-hub. Het wijzigen van de mapnaam wordt niet ondersteund en heeft invloed op het vermogen van WordPress om updates te beheren.
Custom post type en taxonomieën. Bij activering registreert de plugin het custom post type as24ci_car en een reeks voertuigtaxonomieën. Dit zijn technische elementen en deze vereisen geen handmatige configuratie.
Aangepaste databasetabellen. De plugin maakt bij activering zijn eigen databasetabellen aan via dbDelta() (bijvoorbeeld voor analytische gebeurtenissen en opgeslagen zoekopdrachten). Er is geen handmatige SQL vereist.
Aangepaste mogelijkheid en rol. De plugin voorziet in een eigen mogelijkheid (capability) en een gedelegeerde rol die wordt gebruikt voor het dagelijkse beheer. De initiële installatie en configuratie moeten nog steeds worden uitgevoerd door een volledige WordPress-beheerder. Zie Access Control and Capabilities.
Geen gegevensimport bij activering. Activering importeert geen voertuigen en neemt geen contact op met AutoScout24. Imports starten pas nadat de inloggegevens zijn geconfigureerd en een import wordt gestart.

Operationele opmerkingen

Updates. Toekomstige updates van de plugin moeten worden toegepast via hetzelfde kanaal dat voor de installatie is gebruikt (beheerupload van een nieuwe ZIP, of SFTP-vervanging van de plugin-map). Houd de plugin-slug en mapnaam ongewijzigd, zodat instellingen, voertuigen en leads behouden blijven. Maak altijd een nieuwe back-up voordat u in een productieomgeving updatet.
Deactivering. Het deactiveren van de plugin schakelt de functies ervan uit, maar behoudt geïmporteerde voertuigen, opties, leads en analytische gegevens in de database. De plugin verwijdert zijn gegevens pas bij het verwijderen (uninstall), en alleen wanneer de bijbehorende opschooninstelling is ingeschakeld. Zie Uninstall and Data Cleanup.
Multisite. Het is de bedoeling dat ADP Car Market Hub wordt geactiveerd op de individuele site die de voertuigvoorraad moet tonen, niet netwerkbreed. Stem dit af met uw hosting- / netwerkbeheerder voordat u installeert op een multisite-omgeving.
Productiediscipline. Productie-installaties moeten een gedocumenteerde releaseprocedure volgen: back-up → installeren op staging → valideren → installeren op productie → opnieuw controleren. Zie Staging to Live Migration. ---

Probleemoplossing

Symptoom	Waarschijnlijke oorzaak	Wat te controleren
Upload mislukt met "De link die u hebt gevolgd is verlopen" of een foutmelding over de bestandsgrootte.	Serveruploadlimieten (`upload_max_filesize`, `post_max_size`, `memory_limit`) of een WAF-regel zijn te restrictief voor het ZIP-bestand.	Verhoog de limieten bij uw hostingprovider, of installeer via SFTP (Optie B).
WordPress toont "De plugin heeft geen geldige header."	Het verkeerde bestand is geüpload (bijvoorbeeld het ZIP-bestand is uitgepakt en alleen de binnenste bestanden zijn opnieuw ingepakt).	Upload het originele, ondertekende ZIP-archief opnieuw zonder wijzigingen.
Activering geweigerd met een PHP- / WordPress-versiefout.	De site voldoet niet aan de minimale vereisten (`Requires at least: 6.2`, `Requires PHP: 8.1`).	Update WordPress en/of PHP, of verhuis naar een hostingomgeving die deze wel ondersteunt.
Activering geweigerd met een foutmelding over een ontbrekende extensie.	Een van de vereiste PHP-extensies is niet geïnstalleerd (`openssl`, `curl`, `mbstring`, `json`, `gd`/`imagick`).	Vraag uw hostingprovider om de ontbrekende extensie in te schakelen.
Plugin lijkt actief, maar het menu Car Market Hub ontbreekt.	De huidige gebruiker heeft niet de vereiste rechten, of een andere plugin/thema blokkeert het beheerdersmenu.	Log in als een volledige beheerder. Schakel tijdelijk andere plugins uit die het beheerdersmenu aanpassen om het conflict te isoleren.
De link "Instellingen" ontbreekt in de plugin-rij.	De activering is niet volledig voltooid, of een andere plugin overschrijft het action-links filter.	Deactiveer de plugin en activeer deze opnieuw. Controleer het WordPress-foutenlogboek en het eigen logboek van de plugin onder `wp-content/uploads/as24ci-logs/`.
`wp-content/uploads/as24ci-logs/` is leeg of ontbreekt na het eerste gebruik.	De uploads-map is niet beschrijfbaar door de webserver-gebruiker.	Herstel de mapeigendommen/rechten met uw hostingprovider; de plugin kan de map anders niet aanmaken.
Fatale fout die verwijst naar `AS24CI\`-klassen.	Plugin-bestanden zijn onvolledig geüpload (onderbroken SFTP-overdracht) of de map is hernoemd.	Upload de volledige map `adp-car-market-hub/` opnieuw en controleer of de slug `adp-car-market-hub` is.

Als het probleem na deze controles aanhoudt, verzamel dan de diagnostische gegevens zoals beschreven in de Checklist voor ondersteuningsinformatie voordat u contact opneemt met de ondersteuning.