Standort und Öffnungszeiten

Dieses Dokument behandelt die Funktion für Standorte und Öffnungszeiten des ADP Car Market Hub WordPress Plugins: wie Standorte von Autohäusern auf Fahrzeugdetailseiten angezeigt werden, wie Shortcodes Standortdaten an anderer Stelle einbetten können und wie die Funktion konfiguriert wird.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie zum ersten Mal Standorte einrichten, Öffnungszeiten zur Fahrzeugdetailseite hinzufügen oder die Shortcodes für Standorte und Öffnungszeiten auf anderen Seiten verwenden.

Übersicht

Das Plugin enthält eine Standorte-Funktion, die Standortdaten von Autohäusern oder Filialen (Adresse, Telefon, Google Maps-Standort und Öffnungszeiten) zusammen mit einer oder mehreren AutoScout24 Seller IDs speichert. Wenn die Seller ID eines Fahrzeugs mit einem konfigurierten Standort übereinstimmt, zeigt das Plugin automatisch die entsprechende Standort-Adressbox und die Öffnungszeiten-Box nach dem Kontaktformular auf der Fahrzeugdetailseite an.

Dieselbe Information kann auch auf jeder beliebigen WordPress Seite mithilfe spezieller Shortcodes ausgegeben werden.

Voraussetzungen oder Anforderungen

• Mindestens ein Standort muss in der Plugin-Administration konfiguriert sein (Plugin-Einstellungen → Reiter „Standorte“).
• Jeder Standort muss mit mindestens einer Seller ID verknüpft sein, die mit dem in den Fahrzeug-Beiträgen gespeicherten Post-Meta-Wert _as24ci_seller_id übereinstimmt.
• Damit Standort und Öffnungszeiten automatisch auf den Fahrzeugdetailseiten erscheinen, muss das Plugin aktiv und die Seller ID des Fahrzeugs gesetzt sein.

Schritt-für-Schritt-Anleitung

Einen Standort konfigurieren

1. Öffnen Sie in der WordPress Administration die Plugin-Einstellungen und navigieren Sie zum Reiter Standorte.
2. Klicken Sie auf Standort hinzufügen oder bearbeiten Sie einen bestehenden.
3. Füllen Sie die Standortdetails aus: - Name: Der Name des Autohauses oder der Filiale. - Straße: Straßenadresse. - PLZ: Postleitzahl. - Ort: Name der Stadt. - Telefon: Kontakttelefonnummer. - Google Maps Standort: Optionale Google Maps-URL für eine „Route planen“-Schaltfläche. Wird automatisch aus dem Standortnamen und der Adresse generiert, wenn das Feld leer ist. Sie können auch eine benutzerdefinierte Google Maps-URL einfügen. - Seller IDs: Eine oder mehrere AutoScout24 Seller IDs, die mit diesem Standort verknüpft sind. - Öffnungszeiten: Eine oder mehrere Kategorien, jeweils mit Zeilen aus Wochentags- und Uhrzeitbereichen.
4. Speichern Sie den Standort.

Nach dem Speichern erscheinen die Adresse und die Öffnungszeiten des Standorts automatisch auf der Detailseite jedes Fahrzeugs, dessen Seller ID mit einer der konfigurierten Seller IDs für diesen Standort übereinstimmt.

Standortinformationen mit Shortcodes auf beliebigen Seiten einbetten

1. Öffnen Sie die WordPress Seite oder den Beitrag, auf dem Sie Standortinformationen anzeigen möchten.
2. Fügen Sie einen der folgenden Shortcodes im Inhalts-Editor hinzu:

• Standort-Box (Adresse, Telefon, Route-planen-Schaltfläche):

  [as24ci_location_box post_id="123"]

• Öffnungszeiten-Box:

  [as24ci_hours_box post_id="123"]

Ersetzen Sie 123 durch die WordPress Post-ID des Fahrzeugs, dessen zugeordneten Standort Sie anzeigen möchten.

1. Wenn Sie das Attribut post_id weglassen, verwendet der Shortcode die ID des aktuellen Beitrags im Loop. Dies ist nützlich, wenn Sie den Shortcode in einem Template für Fahrzeug-Beiträge platzieren.

Konfigurationsreferenz

Standort-Felder

Jeder Standort wird als Eintrag in der Option „locations“ des Plugins (as24ci_locations) gespeichert. Die folgenden Felder werden unterstützt:

Struktur der Öffnungszeiten

Die Öffnungszeiten sind als eine Liste von Kategorien organisiert. Jede Kategorie hat ein Label und eine oder mehrere Zeilen:

Beispielstruktur für eine einzelne Kategorie:

Category: Sales
  Row 1: Mon–Fri / 08:00–18:00
  Row 2: Sat / 09:00–16:00

Sowohl das Feld days als auch das Feld time sind Freitext-Strings. Das Plugin validiert oder parst deren Inhalt nicht.

Shortcodes

Beide Shortcodes akzeptieren ein Attribut post_id. Wenn es weggelassen wird, wird die aktuelle Post-ID im Loop verwendet. Wenn kein passender Standort für die Seller ID des Fahrzeugs gefunden wird, gibt der Shortcode eine leere Ausgabe zurück.

Betriebshinweise

• Die Standortsuche erfolgt durch Abgleich des Post-Meta-Werts _as24ci_seller_id des Fahrzeugs mit dem Array seller_ids jedes konfigurierten Standorts. Der erste übereinstimmende Standort wird verwendet.
• Die Standort- und Öffnungszeiten-Boxen werden nach dem Kontaktformular-Bereich über den Action-Hook as24ci_after_contact_form gerendert. Beide Boxen sind in ein Container-Div (as24ci-location-hours-wrapper) gehüllt. Wenn keine von beiden Inhalt hat, wird nichts gerendert.
• Die Öffnungszeiten-Box wird nur gerendert, wenn der übereinstimmende Standort mindestens eine nicht-leere Kategorie für Öffnungszeiten hat.
• Standortdaten werden als serialisiertes Array in der Tabelle WordPress options mit deaktiviertem Autoload gespeichert. Sie werden nur auf Fahrzeugdetailseiten und in der Plugin-Administration geladen, nicht bei jedem Seitenaufruf.
• Die Standort-Box enthält eine Schaltfläche „Route planen“, wann immer eine Google Maps-URL verfügbar ist – entweder ist das Feld url gesetzt oder sie kann automatisch aus dem Standortnamen und der Adresse generiert werden. Es werden keine externen API-Aufrufe durchgeführt; die automatisch generierte URL verwendet das einfache Format https://www.google.com/maps/search/?api=1&query=….
• Wenn ein Fahrzeug keinen Meta-Wert _as24ci_seller_id hat, werden weder die Standort-Box noch die Öffnungszeiten-Box gerendert.

Fehlerbehebung

Die Standort-Box erscheint nicht auf einer Fahrzeugdetailseite.

• Überprüfen Sie, ob das Fahrzeug einen Meta-Wert _as24ci_seller_id hat. Dieser wird beim Import gesetzt. Öffnen Sie das Fahrzeug in der WordPress Administration und überprüfen Sie die Fahrzeug-Metafelder.
• Bestätigen Sie, dass in den Plugin-Einstellungen ein Standort mit einer passenden Seller ID konfiguriert ist.
• Überprüfen Sie, ob das Kontaktformular auf der Seite sichtbar ist. Die Standort- und Öffnungszeiten-Boxen werden nach dem Kontaktformular-Bereich über einen Hook auf as24ci_after_contact_form gerendert. Wenn der Kontaktformular-Block im Layout-Manager deaktiviert ist, wird der Hook möglicherweise nicht ausgelöst.

Die Öffnungszeiten-Box erscheint nicht, obwohl ein Standort konfiguriert ist.

• Bestätigen Sie, dass der Standort mindestens eine Kategorie für Öffnungszeiten mit mindestens einer Zeile hat.
• Wenn die Kategorie und die Zeilen vorhanden sind, die Box aber immer noch nicht erscheint, überprüfen Sie, ob die Daten im Admin-Reiter „Standorte“ korrekt gespeichert werden.

Der Shortcode gibt eine leere Ausgabe zurück.

• Überprüfen Sie, ob das Attribut post_id auf ein veröffentlichtes Fahrzeug mit einer gültigen _as24ci_seller_id verweist.
• Bestätigen Sie, dass in den Plugin-Einstellungen ein Standort mit einer passenden Seller ID existiert.
• Der Shortcode gibt eine leere Ausgabe zurück, wenn kein passender Standort gefunden wird oder wenn das Fahrzeug keine Seller ID hat. Dies ist das erwartete Verhalten.

Die Schaltfläche „Route planen“ erscheint nicht.

• Die Schaltfläche wird gerendert, wann immer der Standort eine Google Maps-URL oder genügend Adressdaten (Name, Straße, PLZ, Ort) hat, um eine solche automatisch zu generieren. Wenn keines von beiden verfügbar ist, füllen Sie das Feld „Google Maps Standort“ oder die Adressfelder im Admin-Reiter „Standorte“ aus.

Verwandte Dokumente

• Fahrzeugdetailseiten
• Shortcodes-Referenz