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 der weiteren Konfiguration überprüfen, ob die Installation erfolgreich war.

Sie behandelt keine API-Zugangsdaten oder Importkonfigurationen – diese Themen werden unter 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 (beispielsweise 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 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 verpacken Sie es nicht neu.
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 unter 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 Upload-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 Migration von Staging zu Live.
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 Installationswege:

Option A – ZIP-Upload über den WordPress-Adminbereich (empfohlen für die meisten Umgebungen).
Option B – Manueller Upload via SFTP (empfohlen, wenn der WordPress-Adminbereich 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 Weg; führen Sie nicht beide gleichzeitig aus.

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

Melden Sie sich als Administrator bei WordPress an.
Öffnen Sie im linken Admin-Menü Plugins → Installieren.
Klicken Sie oben auf der Seite auf Plugin hochladen.
Klicken Sie auf Datei auswählen und wählen Sie das ADP Car Market Hub-ZIP-Archiv aus.
Klicken Sie auf Jetzt installieren und warten Sie, bis WordPress das Archiv hochgeladen und entpackt hat.
Wenn der Upload abgeschlossen ist, klicken Sie auf Plugin aktivieren.

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

Option B – Manuelle Installation via 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 via SFTP (oder SSH) mit dem WordPress-Server unter Verwendung eines Kontos, das Schreibrechte für wp-content/plugins/ besitzt.
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 → Installierte Plugins, suchen Sie ADP Car Market Hub in der Liste und klicken Sie auf Aktivieren.

Ä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üfung

Nach dem Klicken auf Aktivieren sollte WordPress einen Erfolgshinweis anzeigen und ADP Car Market Hub sollte in der Liste der aktiven Plugins erscheinen.

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

Die Website erfüllt nicht die Mindestanforderungen 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 verändert bei der Aktivierung keine Themes oder andere Plugins.

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ü. Bestätigen Sie, 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, Car Importer, Import & Limits, Tools, System & Help, Logs und andere.
Plugin-Aktionslinks. Unter Plugins → Installierte Plugins sollte die Zeile für ADP Car Market Hub nun neben Deaktivieren auch die Links License activation und Settings anzeigen. License activation öffnet die Einstellungsseite direkt beim Bereich für die Lizenzaktivierung; Settings öffnet die allgemeine Einstellungsseite des Plugins.
Einstellungsseite wird geladen. Öffnen Sie Car Market Hub → Settings. Die Seite sollte ohne PHP-Hinweise, Fatal Errors oder Warnungen wegen fehlender Assets geladen werden. Der Bereich License Activation sollte oben auf der Seite erscheinen, und die Felder API Base URL, Seller ID, Client ID, Client Secret und Default currency sollten sichtbar und (bei einer Neuinstallation) leer sein. Bei einer Neuinstallation zeigen die anderen Plugin-Tabs einen "Lizenz erforderlich"-Bildschirm an, bis eine Lizenz aktiviert wird.
System & Help. Öffnen Sie Car Market Hub → System & Help. Die Seite sollte Umgebungstests (PHP, JSON, OpenSSL, cURL, GD/Imagick, Uploads) mit Status-Badges im Ampel-Stil anzeigen. Eine Neuinstallation, die 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 Fatal Errors in den Logs. Vergewissern Sie sich, dass das WordPress-Debug-Log (falls aktiviert) und das Error-Log Ihres Hostings keine Fatal Errors 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 Einrichtungsassistenten bei Erstaktivierung

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

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

Der Hinweis ist keine erzwungene Weiterleitung. Er erscheint nur, wenn der Zeitstempel der Erstaktivierung gerade aufgezeichnet wurde und der Assistent noch nicht abgeschlossen oder übersprungen wurde. Plugin-Updates, 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.

Hinweise zur Konfiguration

Dieses Dokument behandelt nur die Installation. Die folgenden Punkte gelten speziell für die Phase der Installation/Aktivierung:

Plugin-Slug und -Ordner. Der erwartete Ordnername lautet adp-car-market-hub. Eine Umbenennung 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 Strukturen, die keine manuelle Einrichtung erfordern.
Eigene Datenbanktabellen. Das Plugin erstellt bei der Aktivierung über dbDelta() eigene Datenbanktabellen (beispielsweise für Analytics-Ereignisse und gespeicherte Suchabos). Es ist kein manuelles SQL erforderlich.
Eigene Berechtigung und Rolle. Das Plugin stellt eine eigene Berechtigung und eine delegierte Rolle bereit, die für die tägliche Verwaltung verwendet werden. 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 auch nicht AutoScout24. Importe starten erst, nachdem die Zugangsdaten konfiguriert wurden und ein Import ausgelöst wird.

Hinweise zum Betrieb

Updates. Zukünftige Updates des Plugins sollten über denselben Kanal eingespielt 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 Live-Umgebung 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 Bereinigungsoption aktiviert ist. Siehe Deinstallation und Datenbereinigung.
Multisite. ADP Car Market Hub ist dafür vorgesehen, auf der einzelnen Website aktiviert zu werden, die den Fahrzeugbestand anzeigen soll, und nicht netzwerkweit. Stimmen Sie sich mit Ihrem Hosting- / Netzwerkadministrator ab, bevor Sie das Plugin in einer Multisite-Umgebung installieren.
Disziplin im Live-Betrieb. Live-Installationen sollten einem dokumentierten Release-Verfahren folgen: Backup → Installation auf Staging → Validierung → Installation auf Live-Umgebung → 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.	Die Upload-Limits des Servers (`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-Provider 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-Provider, 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 Administrator mit vollen Rechten an. Deaktivieren Sie vorübergehend andere Plugins zur Anpassung des Admin-Bereichs, um den Konflikt zu isolieren.
Der Link "Einstellungen" fehlt in der Plugin-Zeile.	Die Aktivierung wurde nicht sauber abgeschlossen, oder ein anderes Plugin überschreibt den Filter für die Aktions-Links.	Deaktivieren Sie das Plugin und aktivieren Sie es erneut. Überprüfen Sie das WordPress-Fehlerprotokoll und das plugin-eigene Protokoll 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-Provider; andernfalls kann das Plugin das Verzeichnis nicht erstellen.
Fataler Fehler mit Verweis auf `AS24CI\`-Klassen.	Die 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.