Installationsanleitung

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

Sie deckt keine API-Zugangsdaten oder Importkonfigurationen ab – diese Themen werden in der Ersteinrichtung, der Einrichtung der API-Zugangsdaten und dem Verbindungstest behandelt.

Wann dieses Dokument zu verwenden ist

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 möchten, 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, die während der Installation auftreten, 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 packen 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 jeder Admin-Tab außer Settings bleibt hinter einem „Lizenz erforderlich“-Bildschirm gesperrt, bis die Lizenz aktiviert ist. Die Lizenzaktivierung wird in der Ersteinrichtung 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-Konnektivität. 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, einschließlich 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 dann 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 den Upload von Plugins verbietet, wenn die Hosting-Umgebung schreibgeschützte Dateisysteme für den Admin-Benutzer erzwingt oder wenn die Installation im Rahmen einer Deployment-Pipeline erfolgt).

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

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

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

Wenn der Upload mit einem Größen- oder Speicherfehler fehlschlägt, liegt dies normalerweise an einem serverseitigen Limit (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 per SFTP

1. 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.
2. Verbinden Sie sich per SFTP (oder SSH) mit dem WordPress-Server unter Verwendung eines Kontos, das in wp-content/plugins/ schreiben darf.
3. 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.
4. Ü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.
5. Melden Sie sich als Administrator bei WordPress an.
6. Ö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 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 vorherige, unvollständige Installation des Plugins ist noch auf dem Datenträger vorhanden.
• Dateiberechtigungen auf wp-content/plugins/ verhindern, dass WordPress die Aktivierung abschließt.

Beheben Sie das zugrunde liegende Problem und versuchen Sie die Aktivierung erneut. Das Plugin verändert während 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.

1. Admin-Menü. Bestätigen Sie, dass ein neuer Hauptmenüeintrag Car Market Hub in der Sidebar des WordPress-Admins 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, einschließlich Dashboard, Settings, Car Importer, Import & Limits, Tools, System & Help, Logs und andere.
2. Plugin-Aktionslinks. Unter Plugins → Installierte Plugins sollte die Zeile für ADP Car Market Hub nun neben Deaktivieren auch einen Link zur Lizenzaktivierung und einen Link zu den Einstellungen enthalten. Lizenzaktivierung öffnet die Einstellungsseite direkt beim Bereich für die Lizenzaktivierung; Einstellungen öffnet die allgemeine Einstellungsseite des Plugins.
3. Einstellungsseite wird gerendert. Öffnen Sie Car Market Hub → Settings. Die Seite sollte ohne PHP-Hinweise, fatale Fehler oder Warnungen zu fehlenden 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 bis zur Aktivierung einer Lizenz einen „Lizenz erforderlich“-Bildschirm.
4. System & Help. Öffnen Sie Car Market Hub → System & Help. Die Seite sollte die Umgebungsprüfungen (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.
5. Keine fatalen Fehler in den Protokollen. Vergewissern Sie sich, dass das WordPress-Debug-Protokoll (falls aktiviert) und das Fehlerprotokoll Ihres Hostings keine fatalen Fehler im Zusammenhang mit dem Plugin aufweisen. Das Plugin führt eine eigene Protokolldatei unter wp-content/uploads/as24ci-logs/, die bei der ersten Verwendung automatisch erstellt wird.

Wenn eine dieser Prüfungen fehlschlägt, fahren Sie nicht mit den Konfigurationsschritten fort. Beheben Sie zuerst das Problem oder kehren Sie zum letzten Backup zurück.

Hinweis zum Ersteinrichtungs-Assistenten

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 Ersteinrichtungs-Assistenten, einen siebenstufigen Ablauf (Lizenz, Modus, Autohaus-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 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.

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 Artefakte und erfordern keine manuelle Einrichtung.
• Eigene 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.
• 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 Access Control and Capabilities.
• Kein Datenimport bei Aktivierung. Die Aktivierung importiert keine Fahrzeuge und kontaktiert nicht AutoScout24. 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 eingespielt werden, der auch 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 Uninstall and Data Cleanup.
• Multisite. ADP Car Market Hub ist für die Aktivierung auf der einzelnen Website vorgesehen, die den Fahrzeugbestand anzeigen soll, nicht netzwerkweit. Stimmen Sie sich mit Ihrem Hosting- / Netzwerk-Administrator ab, bevor Sie das Plugin in einer Multisite-Umgebung installieren.
• Disziplin in der Produktionsumgebung. Produktionsinstallationen sollten einem dokumentierten Release-Verfahren folgen: Backup → Installation auf Staging → Validierung → Installation auf Produktion → erneute Überprüfung. Siehe Staging to Live Migration.

---

Fehlerbehebung

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

Zugehörige Dokumente

• Checkliste vor der Installation
• Technische Systemanforderungen
• API-, Netzwerk- und SSL-Anforderungen
• Ersteinrichtung
• Einrichtung der API-Zugangsdaten
• Verbindungstest
• Go-Live-Checkliste
• Migration von Staging zu Live