TECHNISCHE INTEGRATION

Integrationsleitfaden für den AutoScout24 API-Import in WordPress

Verbinden Sie ADP Car Market Hub mit WordPress, AutoScout24 API-Zugriff, geplanten Importen, Webhooks, Templates, Page-Buildern, Übersetzungen und Frontend-Darstellungs-Workflows.

Übersicht der Integrationsbereitschaft

Eine zuverlässige Integration beginnt mit dem korrekten API-Zugriff, der richtigen Server-Konfiguration, der Hintergrundverarbeitung und der Frontend-Kompatibilität.

API-Zugriff

Konfigurieren Sie API-Basis-URL, Zugangsdaten, Verkäuferzugriff und Verbindungsprüfungen, die für den Import des Fahrzeugbestands erforderlich sind.

Zugehörige Dokumentation anzeigen

Geplante Verarbeitung

Verwenden Sie eine zuverlässige Cron-Verarbeitung für wiederkehrende Importe, Bildverarbeitung, Bereinigungs-Jobs und Hintergrundaufgaben.

Zugehörige Dokumentation anzeigen

Anpassungs-Workflow

Nutzen Sie Template-Overrides, individuelles CSS und Page-Builder-Integration, ohne die Core-Dateien des Plugins zu ändern.

Zugehörige Dokumentation anzeigen

Staging und Go-Live

Testen Sie die Integration in einer kontrollierten Umgebung, bevor Sie Konfiguration und Templates in die Produktion überführen.

Zugehörige Dokumentation anzeigen

Integrationsarchitektur

ADP Car Market Hub verbindet externe Fahrzeugdaten mit WordPress, geplanter Verarbeitung und Frontend-Darstellungs-Schichten.

Schicht Komponente Rolle in der Integration
Extern Externe Datenquelle Stellt Fahrzeugbestandsdaten über den konfigurierten API-Zugriff bereit.
Verbindung API-Zugangsdaten Autorisiert das Plugin, Fahrzeugdaten für das konfigurierte Konto abzurufen.
Konfiguration Plugin-Einstellungen Speichert Verbindungswerte, Import-Einstellungen, Layout-Auswahl und Betriebspräferenzen.
Verarbeitung Import-Engine Verarbeitet Fahrzeugdaten, aktualisiert den Bestand und koordiniert die wiederkehrende Synchronisation.
Speicher WordPress-Datenbank Speichert Fahrzeugdatensätze, Metadaten, Einstellungen, Protokolle, Leads und Analytics-Daten.
Medien Mediathek Speichert importierte Fahrzeugbilder und zugehörige Medien-Assets.
Frontend Templates Rendert Archivseiten, Detailseiten und weitere Frontend-Module.
Einbettung Shortcodes Ermöglicht kontrollierte Frontend-Einbettung in Seiten, Builder und eigene Layouts.
Darstellung Frontend-Seiten Präsentiert den importierten Bestand den Website-Besuchern mithilfe des aktiven Themes.
Conversion Leads und Benachrichtigungen Erfasst Anfragen und unterstützt Kontakt-Workflows mit Kunden.
Intelligence Analytics und Market Insights Bietet operative Sichtbarkeit und Marktanalyse, sofern konfiguriert.

Ablauf für Einrichtung und Verbindung

Der Integrationsprozess sollte in kontrollierter Reihenfolge abgeschlossen werden, damit Verbindungsprobleme erkannt werden, bevor Produktivimporte starten.

  1. API-Zugriff vorbereiten Erfassen Sie API-Basis-URL, Token-URL, Verkäuferkennungen und erforderliche Zugangsdaten, bevor Sie das Plugin konfigurieren.
  2. Plugin-Einstellungen konfigurieren Geben Sie Verbindungswerte im WordPress-Admin ein und halten Sie Zugangsdaten aus öffentlicher Dokumentation und öffentlichen Repositories heraus.
  3. Verbindungstest ausführen Validieren Sie, dass der Server die konfigurierten API-Endpunkte erreichen und gültige Antworten empfangen kann.
  4. Kontrollierten Import ausführen Beginnen Sie mit einem begrenzten Import, um Fahrzeugdaten, Medienverarbeitung und Aktualisierungsverhalten zu bestätigen.
  5. Frontend-Ausgabe validieren Prüfen Sie Archivseiten, Detailseiten, Shortcodes, Vergleichsansichten, Favoriten und Template-Ausgaben.
  6. Go-Live vorbereiten Bestätigen Sie Cron, Backups, Migration vom Staging in den Live-Betrieb, SEO-relevante Seiten und Support-Prüfungen vor dem Produktiveinsatz.

API-Zugriff und externe Zugangsdaten

Die API-Konfiguration definiert, wie sich das Plugin mit externen Fahrzeugdaten verbindet und Anfragen authentifiziert.

Erforderliche Konfigurationswerte

  • API-Basis-URL
  • Token-URL
  • Client ID
  • Client Secret
  • Seller ID oder Konto-Identifier
  • Verbindungstest-Endpunkt, sofern konfiguriert
  • API-Umgebung (Staging oder Produktion)

Verwaltung der Zugangsdaten

  • Veröffentlichen Sie niemals Zugangsdaten in der Dokumentation
  • Speichern Sie Zugangsdaten ausschliesslich in den Plugin-Einstellungen
  • Beschränken Sie den Zugriff auf autorisierte Administratoren
  • API-URLs vor dem Import validieren
  • Bestätigen Sie die Kontoberechtigungen vor dem Go-Live
  • Zugangsdaten bei Zugriffsänderungen rotieren

Cron, Automatisierung und Webhooks

Wiederkehrende Importe, Bereinigungs-Routinen und Integrationsereignisse erfordern eine zuverlässige Hintergrundverarbeitung.

Cron

Einrichtung des Server-Cron

Serverseitiger Cron wird für zuverlässige Produktivimporte, Bereinigungsprozesse und geplante Hintergrundaufgaben empfohlen.

Einrichtung des Server-Cron
Webhooks

Webhook-Integration

Die Webhook-Dokumentation erläutert, wie externe Integrationsereignisse oder -signale behandelt werden können, sofern unterstützt.

Webhook-Integration
Hintergrund

Zuverlässigkeit der Hintergrundverarbeitung

Import-Jobs sollten überwacht werden, damit fehlgeschlagene API-Aufrufe, Bildwarteschlangen oder verzögerte Prozesse frühzeitig erkannt werden können.

Cron und Hintergrundverarbeitung

Theme-, Template- und Page-Builder-Integration

Das Plugin sollte mit dem aktiven WordPress-Theme integriert werden, ohne dass die Core-Dateien des Plugins bearbeitet werden.

Theme- und Template-Integration Theme-Ausgabe

Nutzen Sie Theme-Integration und Template-Overrides, um zu steuern, wie Archivseiten, Fahrzeugdetailseiten und Frontend-Module gerendert werden.

  • Archiv-Templates
  • Detail-Templates
  • Template-Overrides
  • Theme-Kompatibilitätsprüfungen
  • Individuelles CSS
  • Staging-Validierung
Page-Builder-Integration Builder-Workflows

Nutzen Sie Page-Builder-kompatible Workflows, sofern unterstützt, und halten Sie dabei die vom Plugin gesteuerte Bestandsausgabe intakt.

  • Shortcode-Platzierung
  • Builder-Sektionen
  • Layout-Container
  • Wiederverwendbare Inhaltsblöcke
  • Responsive-Prüfungen
  • Frontend-Validierung

Frontend-Ausgabe und Shortcode-Integration

Die Frontend-Ausgabe sollte vor dem Go-Live mit echten Fahrzeugdaten, konfigurierten Filtern und dem aktiven Theme getestet werden.

Komponente Zweck Dokumentation
Fahrzeugarchiv Zeigt den importierten Bestand mit Filtern, Sortierung und Fahrzeugkarten an. Fahrzeugarchiv
Fahrzeugdetailseiten Zeigt Galerie, Preise, Spezifikationen, Kontakt-Aktionen und zugehörige Fahrzeuginformationen an. Fahrzeugdetailseiten
Vergleich Ermöglicht Besuchern den Vergleich ausgewählter Fahrzeuge. Vergleich
Merkliste Ermöglicht Besuchern, Fahrzeuge für die spätere Betrachtung zu speichern. Merkliste
Suchaufträge Unterstützt gespeicherte Such- oder Alarm-Workflows, sofern konfiguriert. Suchaufträge
Shortcodes Ermöglicht eine kontrollierte Einbettung der Plugin-Ausgabe in WordPress-Seiten und Builder-Layouts. Shortcode-Referenz

Übersetzung und Lokalisierung

Plugin und Dokumentation sind auf mehrsprachige Workflows vorbereitet. Englisch bleibt die Quellsprache, während übersetzte Ordner lokalisierte Ordner- und Dateinamen verwenden.

i18n

Mehrsprachige Dokumentationsstruktur

  • Quellsprache Englisch
  • Vorbereitete Übersetzungsordner Deutsch · Französisch · Italienisch · Spanisch · Niederländisch
  • Ordner-Benennung Lokalisierte Ordner- und Dateinamen je Sprache
  • Übersetzungs-Map translation-map.md verbindet lokalisierte Dateien mit der englischen Quelle
  • Plugin-Strings Poedit-kompatible Übersetzungs-Workflows

Workflow vom Staging in den Live-Betrieb

Ein kontrollierter Workflow vom Staging in den Live-Betrieb reduziert das Risiko bei der Übernahme von API-Konfiguration, Templates und Frontend-Ausgabe in die Produktion.

  • Staging-Umgebung vorbereitet
  • API-Zugangsdaten überprüft
  • Verbindungstest bestanden
  • Begrenzter Import getestet
  • Fahrzeugbilder geprüft
  • Archivseite geprüft
  • Detailseiten geprüft
  • Shortcodes geprüft
  • Template-Overrides getestet
  • Cron-Strategie bestätigt
  • Backup vorhanden
  • Go-Live-Checkliste abgeschlossen

Integrationsdokumentation

Öffnen Sie die relevanten Integrationsdokumente direkt im öffentlichen Dokumentations-Repository.

Dokument Link
Abschnitt Integrationsleitfaden Abschnitt Integrationsleitfaden
AutoScout24 API-Einrichtung AutoScout24 API-Einrichtung
Externe API-Zugangsdaten Externe API-Zugangsdaten
Einrichtung des Server-Cron Einrichtung des Server-Cron
Webhook-Integration Webhook-Integration
Theme-Integration Theme-Integration
Page-Builder-Integration Page-Builder-Integration
Leitfaden für Template-Overrides Leitfaden für Template-Overrides
Leitfaden für individuelles CSS Leitfaden für individuelles CSS
Übersetzungs- und Poedit-Leitfaden Übersetzungs- und Poedit-Leitfaden
Staging-zu-Live-Migration Staging-zu-Live-Migration

Die Dokumentationslinks folgen der aktiven Website-Sprache. Englisch ist die Quellsprache. Weitere Sprachordner verwenden lokalisierte Ordner- und Dateinamen.