Shortcodes-Referenz

Dieses Dokument ist eine vollständige Referenz für alle WordPress Shortcodes, die vom ADP Car Market Hub WordPress Plugin bereitgestellt werden.

Wann Sie dieses Dokument verwenden sollten

Verwenden Sie dieses Dokument, wenn Sie Plugin-Ausgaben auf einer WordPress Seite einbetten möchten und die genaue Shortcode-Syntax, die unterstützten Attribute sowie das erwartete Verhalten für jeden Shortcode wissen möchten.

Übersicht

Das Plugin registriert die folgenden Shortcodes:

---

[as24ci_archive]

Rendert das vollständige Fahrzeugarchiv einschließlich des Suchfilter-Formulars, des Ergebnis-Rasters oder der Ergebnis-Liste, der Zustand-Tabs, der Sortiersteuerungen, der Steuerung für Ergebnisse pro Seite und der Seitennummerierung. Erzeugt dieselbe Ausgabe wie die native Custom Post Type Archiv-URL.

Attribute

Alle Attribute sind optional. Wenn ein GET-Parameter mit demselben Namen in der URL vorhanden ist, überschreibt dieser das Shortcode-Attribut.

Beispiele

Alle Fahrzeuge rendern:

[as24ci_archive]

Nur Diesel-SUVs sortiert nach Preis aufsteigend rendern:

[as24ci_archive fuel="diesel" body="suv" order_by="price" order="asc"]

Fahrzeuge in einer Preisspanne mit 12 Ergebnissen pro Seite rendern:

[as24ci_archive price_min="10000" price_max="50000" per_page="12"]

Hinweise

• Besucher können nach dem Laden der Seite mit dem Filterformular interagieren. Jede Filterauswahl durch den Besucher überschreibt die Vorfilter-Attribute des Shortcodes über GET-Parameter.
• Die Seitennummerierung verwendet den GET-Parameter paged oder page.
• Der Shortcode verwendet die eigene URL der Seite als Aktion für das Filterformular. Stellen Sie sicher, dass die Seite eine saubere, zugängliche URL hat.

---

[as24ci_search_filter]

Rendert nur das Suchfilter-Formular, ohne Fahrzeugergebnisse. Verwenden Sie dies auf einer Startseite oder Landingpage, damit Besucher ihre Kriterien festlegen können, bevor sie zur Ergebnisseite weitergeleitet werden.

Attribute

Beispiele

Filterformular, das zum Standard-CPT-Archiv weiterleitet:

[as24ci_search_filter]

Filterformular, das zu einer benutzerdefinierten Ergebnisseite weiterleitet:

[as24ci_search_filter results_url="/car-inventory/"]

Hinweise

• Das Filterformular wird mit denselben Feldern und der gleichen Layout-Manager-Konfiguration wie der Archivseiten-Filter gerendert.
• Alle GET-Parameter, die bereits auf der aktuellen Seite vorhanden sind, spiegeln sich in den vorausgewählten Werten des Filterformulars wider.
• Wenn einfache (nicht-schöne) Permalinks verwendet werden, ist die CPT-Archiv-URL möglicherweise nicht erreichbar. Setzen Sie in diesem Fall results_url explizit auf eine Seite mit dem Shortcode [as24ci_archive].

---

[as24ci_compare]

Rendert die Fahrzeug-Vergleichstabelle. Lädt die Fahrzeug-IDs aus dem GET-Parameter ids (eine kommagetrennte Liste von Post-IDs) und zeigt jedes Fahrzeug als Spalte in einer nebeneinander liegenden Tabelle an.

Attribute

Dieser Shortcode hat keine konfigurierbaren Attribute. Fahrzeug-IDs werden über die URL übergeben.

URL-Format

/compare-page/?ids=123,456,789

Das Vergleichs-JavaScript erstellt diese URL automatisch, wenn der Besucher auf die Schaltfläche "Vergleichen" klickt.

Beispiel

[as24ci_compare]

Platzieren Sie diesen Shortcode auf einer speziellen Seite "Fahrzeuge vergleichen". In den Plugin-Einstellungen sollte die ID dieser Seite als Vergleichsseite hinterlegt sein.

Hinweise

• Die Vergleichstabelle rendert nur veröffentlichte Fahrzeuge des Custom Post Type des Plugins.
• Es werden maximal 4 Fahrzeuge gerendert, unabhängig davon, wie viele IDs übergeben werden. IDs über die ersten 4 hinaus werden stillschweigend ignoriert.
• Wenn kein Parameter ids vorhanden ist oder alle angegebenen IDs ungültig sind, zeigt die Seite "Keine Fahrzeuge zum Vergleich ausgewählt." an.
• Die in jeder Spalte angezeigten Felder werden im Layout-Manager → Zone "Vergleichen" konfiguriert.

---

[as24ci_favorites]

Rendert die Liste der gespeicherten Favoriten des Besuchers. Die Liste wird dynamisch per JavaScript mit Fahrzeug-IDs befüllt, die im localStorage des Browsers gespeichert sind. Das Plugin ruft einen internen REST-Endpunkt auf, um die aktuellen Fahrzeugdaten für jede gespeicherte ID abzurufen.

Attribute

Dieser Shortcode hat keine konfigurierbaren Attribute.

Beispiel

[as24ci_favorites]

Platzieren Sie diesen Shortcode auf einer speziellen Seite "Meine Favoriten".

Hinweise

• Die Seite benötigt JavaScript, um zu funktionieren. Ohne JavaScript kann die Liste nicht befüllt werden.
• Wenn im Browser des Besuchers keine Fahrzeuge gespeichert sind, zeigt die Seite "Sie haben noch keine gespeicherten Favoriten." an.
• Die REST-API muss öffentlich zugänglich sein. Sicherheits-Plugins, die öffentliche REST-Endpunkte blockieren, verhindern das Laden der Favoritenliste.
• Die auf jeder Favoritenkarte angezeigten Felder werden im Layout-Manager → Zone "Favoriten" konfiguriert.
• Pro Anfrage werden bis zu 50 gespeicherte Fahrzeug-IDs abgerufen.

---

[as24ci_location_box]

Rendert die Adressbox des Autohaus-Standorts für ein Fahrzeug. Die Box zeigt den Namen des Autohauses, die Telefonnummer, die Adresse und optional eine Schaltfläche "Standort besuchen", wenn eine Website-URL konfiguriert ist.

Der Standort wird ermittelt, indem die Seller ID des Fahrzeugs (AutoScout24) mit den konfigurierten Standorten des Plugins abgeglichen wird.

Attribute

Beispiele

Standortbox für ein bestimmtes Fahrzeug:

[as24ci_location_box post_id="456"]

Standortbox für den aktuellen Beitrag (bei Verwendung innerhalb eines Fahrzeug-Seitentemplates):

[as24ci_location_box]

Hinweise

• Gibt eine leere Ausgabe zurück, wenn das Fahrzeug keine Seller ID hat oder wenn kein konfigurierter Standort mit der Seller ID übereinstimmt.
• Auf Fahrzeug-Detailseiten werden diese Informationen auch automatisch unter dem Kontaktformular gerendert, sodass eine manuelle Verwendung des Shortcodes auf derselben Seite zu einer doppelten Ausgabe führen würde.

---

[as24ci_hours_box]

Rendert die Öffnungszeiten-Box des Autohauses für ein Fahrzeug. Die Box zeigt eine Spalte pro konfigurierter Öffnungszeiten-Kategorie, die jeweils Zeilen für den Wochentagsbereich und den Uhrzeitbereich enthält.

Der Standort wird ermittelt, indem die Seller ID des Fahrzeugs (AutoScout24) mit den konfigurierten Standorten des Plugins abgeglichen wird.

Attribute

Beispiele

Öffnungszeiten-Box für ein bestimmtes Fahrzeug:

[as24ci_hours_box post_id="456"]

Öffnungszeiten-Box für den aktuellen Beitrag:

[as24ci_hours_box]

Hinweise

• Gibt eine leere Ausgabe zurück, wenn das Fahrzeug keine Seller ID hat, kein passender Standort gefunden wird oder für den passenden Standort keine Öffnungszeiten konfiguriert sind.
• Auf Fahrzeug-Detailseiten werden diese Informationen ebenfalls automatisch unter dem Kontaktformular gerendert.

---

Zugehörige Dokumente

• Fahrzeugarchiv
• Fahrzeug-Detailseiten
• Vergleichen
• Favoriten
• Standort und Öffnungszeiten