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 importconfiguraties worden hier niet behandeld — deze onderwerpen komen aan bod in Eerste installatie, API-inloggegevens instellen en Verbindingstest.

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 inloggegevens voor het bestandssysteem van 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 is voltooid.

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 opnieuw 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 Technische systeemvereisten voor alle details.
Uitgaande HTTPS-verbinding. De webserver moet de AutoScout24 API-host kunnen bereiken die u later configureert. Zie API-, netwerk- en SSL-vereisten.
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 het 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-installatie 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 beheerdersmenu Plugins → Add New.
Klik bovenaan de pagina op Upload Plugin.
Klik op Choose File en selecteer het ADP Car Market Hub ZIP-archief.
Klik op Install Now en wacht tot WordPress het archief heeft geüpload en uitgepakt.
Klik zodra de upload is voltooid op Activate Plugin.

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 restrictie van een 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 moet een enkele map genaamd adp-car-market-hub/ overhouden die de plugin-bestanden bevat.
Maak verbinding met de WordPress-server via SFTP (of SSH) met een account dat schrijfrechten heeft in 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 → Installed Plugins, zoek ADP Car Market Hub in de lijst en klik op Activate.

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

Activeringscontrole

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

Als de activering wordt geblokkeerd, toont WordPress een bericht 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 geen thema's of andere plugins tijdens de activering.

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.

Beheerdersmenu. 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, Universal Import, Car Importer, Import & Limits, Tools, System & Help, Logs en andere.
Plugin-actielinks. Op Plugins → Installed Plugins moet de rij van ADP Car Market Hub nu een link License activation en een link Settings tonen, naast Deactivate. 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, gevolgd door General Settings (standaardvaluta) en een compacte Data sources & API connections-kaart met een knop Manage data sources. API-inloggegevens worden hier niet langer ingevoerd — deze bevinden zich op Car Market Hub → Universal Import, waar de bron AutoScout24 de velden API Base URL, Seller ID, Client ID en Client Secret toont (leeg 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 weergeven (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 WordPress-foutenlogboek (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 van de First Setup Wizard

Na de eerste activering van de plugin verschijnt er bovenaan elke WordPress-beheerpagina een beheerdersmelding met de titel Welcome to ADP Car Market Hub. De melding bevat 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 sluit de melding. De wizard blijft bereikbaar via het Dashboard en via Car Market Hub → Tools.

De melding is geen gedwongen 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 activeren, 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 beheertabbladen.

Opmerkingen over de configuratie

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 vereisen geen handmatige configuratie.
Aangepaste databasetabellen. De plugin maakt bij activering zijn eigen databasetabellen aan via dbDelta() (bijvoorbeeld voor analytics-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 maakt geen contact 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 (beheerdersupload 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 analytics-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. ADP Car Market Hub is bedoeld om te worden geactiveerd op de individuele site die de voertuigvoorraad moet weergeven, niet netwerkbreed. Stem af met uw hosting- / netwerkbeheerder voordat u installeert in 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 fout 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 fout 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 correct 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 schrijfbaar voor 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 `adp-car-market-hub/`-map 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 Support Information Checklist voordat u contact opneemt met de ondersteuning.