Standort und Öffnungszeiten

Dieses Dokument beschreibt die Standort- und Öffnungszeiten-Funktion des ADP Car Market Hub WordPress Plugins: wie Garagen-Standorte auf Fahrzeugdetailseiten angezeigt werden, wie Shortcodes Standortdaten an anderer Stelle einbetten können und wie die Funktion konfiguriert wird.

Wann Sie dieses Dokument lesen sollten

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

Übersicht

Das Plugin enthält eine Standorte-Funktion, die Standortdaten von Garagen 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 nach dem Kontaktformular auf der Fahrzeugdetailseite automatisch die entsprechende Standort-Adressbox und die Öffnungszeiten-Box an.

Die gleichen Informationen können auch auf jeder beliebigen WordPress Seite mithilfe spezieller Shortcodes ausgegeben werden.

Anforderungen oder Voraussetzungen

• Mindestens ein Standort muss im Plugin-Admin konfiguriert sein (Plugin-Einstellungen → Tab „Standorte“).
• Jeder Standort muss mit mindestens einer Seller ID verknüpft sein, die mit dem im Fahrzeug-Post 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 im WordPress Admin die Plugin-Einstellungen und navigieren Sie zum Tab Standorte.
2. Klicken Sie auf Standort hinzufügen oder bearbeiten Sie einen bestehenden.
3. Füllen Sie die Standortdetails aus: - Name: Der Name der Garage oder der Filiale. - Strasse: Strasse und Hausnummer. - PLZ: Postleitzahl. - Ort: Name des Ortes. - Telefon: Telefonnummer für den Kontakt. - Google Maps Standort: Optionale Google Maps-URL für eine Schaltfläche „Route planen“. 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 werden die Adresse und die Öffnungszeiten des Standorts automatisch auf der Detailseite jedes Fahrzeugs angezeigt, dessen Seller ID mit einer der konfigurierten Seller IDs für diesen Standort übereinstimmt.

Standortinformationen mit Shortcodes auf einer beliebigen Seite 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-Button):

  [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 verknüpften 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.

Konfigurations-Referenz

Standort-Felder

Jeder Standort wird als Eintrag in der Option „locations“ des Plugins gespeichert (as24ci_locations). 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. Wird es weggelassen, 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) eingepackt. Wenn keine der beiden Boxen Inhalt hat, wird nichts gerendert.
• Die Öffnungszeiten-Box wird nur gerendert, wenn der gefundene Standort mindestens eine nicht-leere Öffnungszeiten-Kategorie enthält.
• Standortdaten werden als serialisiertes Array in der Optionstabelle WordPress mit deaktiviertem Autoload gespeichert. Sie werden nur auf Fahrzeugdetailseiten und im Plugin-Admin 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 wenn das Feld url gesetzt ist oder wenn sie automatisch aus dem Standortnamen und der Adresse generiert werden kann. Es werden keine externen API-Aufrufe getätigt; 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 im WordPress Admin und überprüfen Sie die Fahrzeug-Metafelder.
• Vergewissern Sie sich, 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 ausgeführt.

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

• Vergewissern Sie sich, dass der Standort mindestens eine Öffnungszeiten-Kategorie 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-Tab „Standorte“ korrekt gespeichert werden.

Der Shortcode liefert eine leere Ausgabe.

• Überprüfen Sie, ob das Attribut post_id auf ein veröffentlichtes Fahrzeug mit einer gültigen _as24ci_seller_id verweist.
• Vergewissern Sie sich, 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, wenn der Standort eine Google Maps-URL oder genügend Adressdaten (Name, Strasse, PLZ, Ort) enthält, um eine solche automatisch zu generieren. Wenn beides nicht vorhanden ist, füllen Sie das Feld „Google Maps Standort“ oder die Adressfelder im Admin-Tab „Standorte“ aus.

Verwandte Dokumente

• Fahrzeugdetailseiten
• Shortcodes-Referenz