Dokumentation · Erste Schritte

Installationsanleitung

Diese Anleitung beschreibt, wie Sie das Plugin ADP Car Market Hub WordPress auf einer WordPress-Website installieren und aktivieren und wie Sie vor jeder weiteren Konfiguration überprüfen, ob die Installation erfolgreich war.

Sie behandelt keine API-Zugangsdaten oder Importkonfigurationen – diese Themen werden in Erste Einrichtung, Einrichtung der API-Zugangsdaten und Verbindungstest behandelt.

Wann Sie dieses Dokument verwenden sollten

Verwenden Sie dieses Dokument, wenn Sie:

ADP Car Market Hub zum ersten Mal auf einer neuen WordPress-Website installieren.
Das Plugin auf einer bestehenden Website neu installieren (z. B. nach einer Servermigration oder einem sauberen Neuaufbau).
Überprüfen, ob eine von Dritten (Agentur, Hosting-Anbieter, interne IT) durchgeführte Installation korrekt abgeschlossen wurde.
Ein dokumentiertes Installationsverfahren für eine Kundenübergabe vorbereiten.

Die Zielgruppe ist ein WordPress-Administrator mit vollem Back-Office-Zugriff und, falls eine SFTP-Installation verwendet wird, mit Dateisystem-Zugangsdaten für den Zielserver.

Bevor Sie beginnen

Bestätigen Sie Folgendes, bevor Sie mit der Installation beginnen. Die meisten Probleme bei der Installation sind darauf zurückzuführen, dass eine dieser Voraussetzungen nicht vollständig erfüllt ist.

Plugin-Paket. Ein signiertes Plugin-ZIP-Archiv von ADP Car Market Hub, das von AD Promotion oder Ihrem Vertriebskanal bereitgestellt wurde. Benennen Sie das Archiv nicht um und entpacken und packen Sie es nicht erneut.
Lizenzschlüssel. Ihr ADP Car Market Hub-Lizenzschlüssel, bereitgestellt von AD Promotion. Das Plugin lässt sich auch ohne diesen installieren und aktivieren, aber alle Admin-Tabs ausser Settings bleiben hinter einem "Lizenz erforderlich"-Bildschirm gesperrt, bis die Lizenz aktiviert ist. Die Lizenzaktivierung wird in Erste Einrichtung behandelt.
WordPress-Umgebung. Eine funktionierende WordPress-Installation, die die Mindestanforderungen des Plugins erfüllt:
WordPress 6.2 oder höher (Requires at least: 6.2 im Plugin-Header).
PHP 8.1 oder höher (Requires PHP: 8.1 im Plugin-Header und composer.json).
Eine von WordPress unterstützte Datenbank (MySQL oder MariaDB).
PHP-Erweiterungen openssl, curl, mbstring, json und entweder gd oder imagick.
Ein beschreibbares Uploads-Verzeichnis (wp-content/uploads/). Siehe Technische Systemanforderungen für alle Details.
Ausgehende HTTPS-Verbindung. Der Webserver muss in der Lage sein, den AutoScout24-API-Host zu erreichen, den Sie später konfigurieren werden. Siehe API-, Netzwerk- und SSL-Anforderungen.
Administrator-Konto. Ein WordPress-Benutzer mit der Berechtigung manage_options (normalerweise die Rolle administrator) ist erforderlich, um das Plugin zu installieren, zu aktivieren und zu konfigurieren.
Backup. Ein aktuelles, wiederherstellbares Backup der WordPress-Website, einschliesslich Datenbank und wp-content/. Produktionsinstallationen sollten vor der Installation oder Aktivierung eines Plugins immer über ein aktuelles Backup verfügen.
Staging-Umgebung (empfohlen). Für Live-Websites wird dringend empfohlen, das Plugin zuerst auf einer Staging-Kopie zu installieren und zu validieren und die Konfiguration anschliessend auf die Live-Umgebung zu übertragen. Siehe Staging to Live Migration.
Checkliste vor der Installation. Gehen Sie die Checkliste vor der Installation durch, um die Bereitschaft von Hosting, PHP, Datenbank und Netzwerk zu bestätigen.

Schritt-für-Schritt-Anleitung

Es gibt zwei unterstützte Installationspfade:

Option A – ZIP-Upload über den WordPress-Admin (empfohlen für die meisten Umgebungen).
Option B – Manueller Upload per SFTP (empfohlen, wenn der WordPress-Admin keine Plugin-Uploads zulässt, wenn die Hosting-Umgebung schreibgeschützte Dateisysteme für den Admin-Benutzer erzwingt oder bei der Installation im Rahmen einer Deployment-Pipeline).

Verwenden Sie den einen oder den anderen Pfad; führen Sie nicht beide gleichzeitig aus.

Option A – Installation über den WordPress-Admin (ZIP-Upload)

Melden Sie sich als Administrator bei WordPress an.
Öffnen Sie im linken Admin-Menü Plugins → Add New.
Klicken Sie oben auf der Seite auf Upload Plugin.
Klicken Sie auf Choose File und wählen Sie das ADP Car Market Hub-ZIP-Archiv aus.
Klicken Sie auf Install Now und warten Sie, bis WordPress das Archiv hochgeladen und entpackt hat.
Wenn der Upload abgeschlossen ist, klicken Sie auf Activate Plugin.

Wenn der Upload mit einem Grössen- oder Speicherfehler fehlschlägt, liegt dies normalerweise an einer serverseitigen Einschränkung (upload_max_filesize, post_max_size, memory_limit oder einer Web-Application-Firewall-Einschränkung). Beheben Sie das Limit mit Ihrem Hosting-Anbieter oder nutzen Sie Option B.

Option B – Manuelle Installation per SFTP

Entpacken Sie das ADP Car Market Hub-ZIP-Archiv auf Ihrem lokalen Computer. Sie sollten einen einzelnen Ordner namens adp-car-market-hub/ erhalten, der die Plugin-Dateien enthält.
Verbinden Sie sich per SFTP (oder SSH) mit dem WordPress-Server unter Verwendung eines Kontos, das in wp-content/plugins/ schreiben kann.
Laden Sie den gesamten Ordner adp-car-market-hub/ nach wp-content/plugins/ hoch, sodass der endgültige Pfad wp-content/plugins/adp-car-market-hub/ lautet.
Überprüfen Sie, ob wp-content/plugins/adp-car-market-hub/adp-car-market-hub.php auf dem Server existiert. WordPress identifiziert das Plugin anhand dieser Hauptdatei.
Melden Sie sich als Administrator bei WordPress an.
Öffnen Sie Plugins → Installed Plugins, suchen Sie ADP Car Market Hub in der Liste und klicken Sie auf Activate.

Ändern Sie die Berechtigungen von Plugin-Dateien nicht manuell, es sei denn, Ihr Hosting-Anbieter verlangt dies ausdrücklich. Das Plugin benötigt keinen Schreibzugriff auf sein eigenes Verzeichnis.

Aktivierungsprüfungen

Nach dem Klicken auf Activate sollte WordPress eine Erfolgsmeldung anzeigen und ADP Car Market Hub sollte in der Liste der aktiven Plugins erscheinen.

Wenn die Aktivierung blockiert ist, zeigt WordPress eine Meldung mit dem Grund an. Die häufigsten Ursachen sind:

Die Website erfüllt nicht die Mindestversionen des Plugins für WordPress oder PHP.
Eine erforderliche PHP-Erweiterung fehlt.
Eine frühere, unvollständige Installation des Plugins ist noch auf dem Datenträger vorhanden.
Dateiberechtigungen auf wp-content/plugins/ verhindern, dass WordPress die Aktivierung abschliesst.

Beheben Sie das zugrunde liegende Problem und versuchen Sie die Aktivierung erneut. Das Plugin nimmt während der Aktivierung keine Änderungen an Themes oder anderen Plugins vor.

Prüfungen nach der Aktivierung

Führen Sie diese Prüfungen unmittelbar nach einer erfolgreichen Aktivierung durch. Sie bestätigen, dass das Plugin korrekt geladen wurde und für die Konfiguration bereit ist.

Admin-Menü. Vergewissern Sie sich, dass ein neuer Hauptmenüeintrag Car Market Hub in der WordPress Admin-Seitenleiste sichtbar ist (der Anzeigename des Plugins im Menü ist verkürzt – die Plugin-Datei selbst ist als ADP Car Market Hub registriert). Bewegen Sie den Mauszeiger über den Eintrag, um die verfügbaren Untermenüpunkte zu sehen, einschliesslich Dashboard, Settings, Connections, Car Importer, Import & Limits, Tools, System & Help, Logs und andere.
Plugin-Aktionslinks. Unter Plugins → Installierte Plugins sollte die Zeile ADP Car Market Hub nun zusätzlich zu Deaktivieren einen Link Lizenzaktivierung und einen Link Einstellungen anzeigen. Lizenzaktivierung öffnet die Einstellungsseite direkt bei der Karte für die Lizenzaktivierung; Einstellungen öffnet die allgemeine Einstellungsseite des Plugins.
Einstellungsseite wird gerendert. Öffnen Sie CMH Center → Settings. Die Seite sollte ohne PHP-Hinweise, fatale Fehler oder Warnungen zu fehlenden Assets geladen werden. Die Karte License Activation sollte oben auf der Seite erscheinen, gefolgt von den General Settings (Standardwährung) und einer schmalen Karte Data sources & API connections mit einer Schaltfläche Manage data sources. API-Zugangsdaten werden hier nicht mehr eingegeben – sie befinden sich unter CMH Center → Connections, wo die Quelle AutoScout24 die Felder API Base URL, Seller ID, Client ID und Client Secret bereitstellt (bei einer Neuinstallation leer). Bei einer Neuinstallation zeigen die anderen Plugin-Tabs einen "Lizenz erforderlich"-Bildschirm an, bis eine Lizenz aktiviert wurde.
System & Help. Öffnen Sie CMH Center → System & Help. Die Seite sollte Umgebungstests (PHP, JSON, OpenSSL, cURL, GD/Imagick, Uploads) mit Status-Badges im Ampel-Stil anzeigen. Eine Neuinstallation, welche die Anforderungen erfüllt, sollte keine roten Badges aufweisen; eine fehlende Erweiterung oder ein nicht beschreibbares Verzeichnis wird hier markiert. Beheben Sie alle Probleme, bevor Sie fortfahren.
Keine fatalen Fehler in den Logs. Vergewissern Sie sich, dass das WordPress Debug-Log (falls aktiviert) und das Error-Log Ihres Hostings keine fatalen Fehler im Zusammenhang mit dem Plugin aufweisen. Das Plugin führt eine eigene Logdatei unter wp-content/uploads/as24ci-logs/, die bei der ersten Verwendung automatisch erstellt wird.

Falls einer dieser Tests fehlschlägt, fahren Sie nicht mit den Konfigurationsschritten fort. Beheben Sie zuerst das Problem oder kehren Sie zum letzten Backup zurück.

Hinweis zum Assistenten für die erste Einrichtung

Nach der ersten Aktivierung des Plugins erscheint oben auf jeder WordPress Admin-Seite ein Admin-Hinweis mit dem Titel Welcome to ADP Car Market Hub. Der Hinweis bietet zwei Schaltflächen:

Start Setup Wizard öffnet den Assistenten für die erste Einrichtung, einen siebenstufigen Ablauf (Lizenz, Modus, Garagen-Profil, AutoScout24, Seiten, Funktionen, Fertigstellen). Die Lizenzaktivierung ist der erste, obligatorische Schritt; die verbleibenden Schritte sind optional.
Skip for now blendet den Hinweis aus. Der Assistent bleibt über das Dashboard und über CMH Center → Tools erreichbar.

Der Hinweis ist keine erzwungene Weiterleitung. Er erscheint nur, wenn der Zeitstempel der Erstaktivierung gerade erst aufgezeichnet wurde und der Assistent noch nicht abgeschlossen oder übersprungen wurde. Plugin-Upgrades, die keine Neuaktivierung auslösen, zeigen den Hinweis auf bestehenden Installationen nicht an. Der Assistent ist optional, wird aber empfohlen; alles, was er bietet, kann auch manuell über die regulären Admin-Tabs konfiguriert werden.

Konfigurationshinweise

Dieses Dokument behandelt nur die Installation. Die folgenden Punkte gelten speziell für die Installations-/Aktivierungsphase:

Plugin-Slug und -Ordner. Der erwartete Ordnername ist adp-car-market-hub. Das Umbenennen des Ordners wird nicht unterstützt und beeinträchtigt die Fähigkeit von WordPress, Updates zu verwalten.
Custom Post Type und Taxonomien. Bei der Aktivierung registriert das Plugin den Custom Post Type as24ci_car und eine Reihe von Fahrzeug-Taxonomien. Dies sind technische Artefakte und erfordern keine manuelle Einrichtung.
Benutzerdefinierte Datenbanktabellen. Das Plugin erstellt bei der Aktivierung über dbDelta() eigene Datenbanktabellen (beispielsweise für Analytics-Ereignisse und gespeicherte Suchaufträge). Es ist kein manuelles SQL erforderlich.
Benutzerdefinierte Berechtigung und Rolle. Das Plugin stellt eine eigene Berechtigung und eine delegierte Rolle bereit, die für die tägliche Verwaltung verwendet wird. Die Erstinstallation und -konfiguration sollte dennoch von einem vollwertigen WordPress Administrator durchgeführt werden. Siehe Zugriffskontrolle und Berechtigungen.
Kein Datenimport bei Aktivierung. Die Aktivierung importiert keine Fahrzeuge und kontaktiert AutoScout24 nicht. Importe starten erst, nachdem die Zugangsdaten konfiguriert wurden und ein Import ausgelöst wird.

Betriebliche Hinweise

Updates. Zukünftige Updates des Plugins sollten über denselben Kanal durchgeführt werden, der für die Installation verwendet wurde (Admin-Upload einer neuen ZIP-Datei oder SFTP-Austausch des Plugin-Ordners). Lassen Sie den Plugin-Slug und den Ordnernamen unverändert, damit Einstellungen, Fahrzeuge und Leads erhalten bleiben. Erstellen Sie vor einem Update in der Produktionsumgebung immer ein aktuelles Backup.
Deaktivierung. Das Deaktivieren des Plugins deaktiviert dessen Funktionen, behält jedoch importierte Fahrzeuge, Optionen, Leads und Analytics-Daten in der Datenbank. Das Plugin entfernt seine Daten nur bei der Deinstallation und nur dann, wenn die entsprechende Bereinigungseinstellung aktiviert ist. Siehe Deinstallation und Datenbereinigung.
Multisite. ADP Car Market Hub ist für die Aktivierung auf der einzelnen Website vorgesehen, welche den Fahrzeugbestand anzeigen soll, nicht netzwerkweit. Stimmen Sie sich mit Ihrem Hosting- / Netzwerkadministrator ab, bevor Sie das Plugin in einer Multisite-Umgebung installieren.
Produktionsdisziplin. Installationen in der Produktionsumgebung sollten einem dokumentierten Release-Verfahren folgen: Backup → Installation auf Staging → Validierung → Installation auf Produktion → erneute Überprüfung. Siehe Migration von Staging zu Live.

Fehlerbehebung

Symptom	Wahrscheinliche Ursache	Was zu prüfen ist
Upload schlägt fehl mit "Der Link, dem Sie gefolgt sind, ist abgelaufen" oder einem Grössenfehler.	Server-Upload-Limits (`upload_max_filesize`, `post_max_size`, `memory_limit`) oder eine WAF-Regel sind für die ZIP-Datei zu restriktiv.	Erhöhen Sie die Limits bei Ihrem Hosting-Anbieter oder installieren Sie via SFTP (Option B).
WordPress zeigt "Das Plugin hat keinen gültigen Header."	Es wurde die falsche Datei hochgeladen (zum Beispiel wurde die ZIP-Datei entpackt und nur die inneren Dateien wurden erneut gezippt).	Laden Sie das originale, signierte ZIP-Archiv ohne Änderungen erneut hoch.
Aktivierung verweigert mit einem PHP- / WordPress-Versionsfehler.	Die Website erfüllt die Mindestanforderungen nicht (`Requires at least: 6.2`, `Requires PHP: 8.1`).	Aktualisieren Sie WordPress und/oder PHP oder wechseln Sie zu einer Hosting-Umgebung, die diese unterstützt.
Aktivierung verweigert wegen einer fehlenden Erweiterung.	Eine der erforderlichen PHP-Erweiterungen ist nicht installiert (`openssl`, `curl`, `mbstring`, `json`, `gd`/`imagick`).	Bitten Sie Ihren Hosting-Anbieter, die fehlende Erweiterung zu aktivieren.
Das Plugin scheint aktiv zu sein, aber das Menü Car Market Hub fehlt.	Der aktuelle Benutzer verfügt nicht über die erforderliche Berechtigung oder ein anderes Plugin/Theme blockiert das Admin-Menü.	Melden Sie sich als Hauptadministrator an. Deaktivieren Sie vorübergehend andere Plugins zur Admin-Anpassung, um den Konflikt einzugrenzen.
Der Link "Einstellungen" fehlt in der Plugin-Zeile.	Die Aktivierung wurde nicht sauber abgeschlossen oder ein anderes Plugin überschreibt den Filter für die Aktionslinks.	Deaktivieren Sie das Plugin und aktivieren Sie es erneut. Überprüfen Sie das WordPress-Fehlerprotokoll und das eigene Protokoll des Plugins unter `wp-content/uploads/as24ci-logs/`.
`wp-content/uploads/as24ci-logs/` ist nach der ersten Verwendung leer oder fehlt.	Das Uploads-Verzeichnis ist für den Webserver-Benutzer nicht beschreibbar.	Korrigieren Sie die Verzeichnisbesitzrechte/-berechtigungen mit Ihrem Hosting-Anbieter; andernfalls kann das Plugin das Verzeichnis nicht erstellen.
Fataler Fehler mit Verweis auf `AS24CI\`-Klassen.	Plugin-Dateien wurden unvollständig hochgeladen (unterbrochene SFTP-Übertragung) oder der Ordner wurde umbenannt.	Laden Sie den vollständigen Ordner `adp-car-market-hub/` erneut hoch und stellen Sie sicher, dass der Slug `adp-car-market-hub` lautet.

Wenn das Problem nach diesen Prüfungen weiterhin besteht, sammeln Sie die in der Checkliste für Support-Informationen beschriebenen Diagnosedaten, bevor Sie den Support kontaktieren.