Dokumentation · Admin-Referenz

Referenz für Shortcodes und Widgets

Dieses Dokument ist eine Referenz für die Seite Shortcodes & Widgets des ADP Car Market Hub-Plugins (Car Market Hub → Shortcodes & Widgets). Es dokumentiert jeden Shortcode, den das Plugin registriert, die unterstützten Attribute und URL-Parameter, die Editor- und Page-Builder-Integrationen sowie die mit dem Plugin gelieferten Dashboard-Widgets.

Wann dieses Dokument zu verwenden ist

Lesen Sie dies, wenn Sie Redakteur, Website-Ersteller oder Entwickler sind und Folgendes tun müssen:

Einbetten von Fahrzeuglisten, Suchformularen, Vergleichstabellen, Favoriten, Standort-Boxen oder Öffnungszeiten-Boxen auf einer Seite.
Vorfiltern des Fahrzeugbestands zum Zeitpunkt des Einfügens mithilfe von Shortcode-Attributen.
Senden von vorgefiltertem Traffic an die Fahrzeugbestandsseite mithilfe von URL-Parametern.
Überschreiben eines Plugin-Templates in Ihrem aktiven Theme.
Verstehen, welche Dashboard-Widgets das Plugin bereitstellt.

Übersicht

Das Plugin registriert sechs öffentliche Shortcodes:

Shortcode	Zweck
`[as24ci_archive]`	Vollständiger Fahrzeugbestand mit Filtern, Sortierung und Paginierung.
`[as24ci_search_filter]`	Eigenständiges Suchformular, gedacht für Landingpages oder Startseiten.
`[as24ci_compare]`	Fahrzeug-Vergleichstabelle für vom Besucher ausgewählte Fahrzeuge.
`[as24ci_favorites]`	Favoritenseite des Besuchers (Einträge werden clientseitig in `localStorage` gespeichert).
`[as24ci_location_box]`	Visitenkarte für die mit einem Fahrzeug verknüpfte Autohaus-Filiale.
`[as24ci_hours_box]`	Öffnungszeiten-Karte für die mit einem Fahrzeug verknüpfte Autohaus-Filiale.

Jeder Shortcode ist auf der Seite auch als eigener Eintrag mit einer dedizierten Schaltfläche Kopieren und einem erweiterbaren Bereich Attribute & Beispiele aufgeführt, der die unterstützten Attribute und gebrauchsfertige Beispiele für diesen Shortcode anzeigt.

Oben auf der Seite fassen fünf KPI-Kacheln die Shortcode-Nutzung auf einen Blick zusammen:

KPI-Kachel	Zeigt
Verfügbare Shortcodes	Wie viele öffentliche Shortcodes das Plugin registriert.
Verwendete Shortcodes	Gesamtzahl der Shortcode-Vorkommen auf den gescannten Seiten und Beiträgen.
Builder-Integrationen	Wie viele unterstützte Editor- / Page-Builder-Integrationsfamilien verfügbar sind.
Seiten mit Plugin-Nutzung	Anzahl der veröffentlichten Seiten und Beiträge, die mindestens einen Plugin-Shortcode enthalten.
Template-Überschreibungen	Anzahl der Plugin-Templates, die derzeit von Ihrem aktiven Theme überschrieben werden.

Unter den Kacheln bietet eine Intro-Karte Schnellkopier-Schaltflächen mit einem Klick für die vier am häufigsten verwendeten Shortcodes — [as24ci_archive], [as24ci_search_filter], [as24ci_compare] und [as24ci_favorites] —, sodass Sie diese ohne Tippen in die Zwischenablage kopieren können.

Die Seite zeigt außerdem eine Tabelle Übersicht über die Shortcode-Nutzung an, in der veröffentlichte Seiten und Beiträge aufgelistet sind, die einen Plugin-Shortcode enthalten (bis zu den letzten 100 Ergebnissen), sowie eine Karte Entwicklerhinweise, die Template-Überschreibungen und unterstützte URL-Parameter dokumentiert.

Anforderungen oder Voraussetzungen

Ein Benutzer mit einer Berechtigung, die Seiten oder Beiträge bearbeiten kann.
Für [as24ci_compare] und [as24ci_favorites] muss der entsprechende Funktionsschalter in Car Market Hub → Settings aktiviert sein. Wenn eine Funktion deaktiviert ist, kennzeichnet die Seite den Shortcode mit einem Deaktiviert-Badge.
Für [as24ci_location_box] und [as24ci_hours_box] muss mindestens ein Standort unter Standorte konfiguriert sein und die Seller IDs müssen mit dem Fahrzeug übereinstimmen.

Schritt-für-Schritt-Anleitung

Einen Shortcode in eine Seite einbetten

Öffnen Sie die Seite oder den Beitrag in Ihrem Editor.
Fügen Sie den Shortcode über das native Steuerelement des Editors ein: - Block-Editor (Gutenberg): Fügen Sie einen Shortcode-Block hinzu. - Elementor: Fügen Sie ein Shortcode-Widget hinzu. - Divi, Beaver Builder, WPBakery: Verwenden Sie das Shortcode- oder Textmodul. - Classic Editor: Tippen Sie den Shortcode direkt in den Inhalt ein.
Fügen Sie den gewünschten Shortcode ein (bei Bedarf mit Attributen).
Speichern und Vorschau anzeigen.

Das Plugin lädt seine eigenen Styles und Skripte nur auf Seiten, die einen Plugin-Shortcode enthalten, sodass nicht betroffene Seiten nicht beeinträchtigt werden.

Den Archivbestand beim Einfügen vorfiltern

Verwenden Sie Shortcode-Attribute bei [as24ci_archive], zum Beispiel:

[as24ci_archive make="BMW" price_max="40000" order_by="price" order="asc"]
[as24ci_archive fuel="electric" body="suv" per_page="12"]

Dynamische Filterung über Links oder externe Formulare steuern

Hängen Sie GET-Parameter an die Archiv-URL an (URL-Parameter überschreiben Shortcode-Attribute):

/inventory/?make=BMW&max_price=20000
/inventory/?condition=new&sort=price_asc

Konfigurationsreferenz

Attribute für `[as24ci_archive]`

Alle Attribute sind optional. URL-Parameter überschreiben Shortcode-Attribute.

Attribut	Beschreibung	Beispiel
`make`	Vorfiltern nach Marke.	`make="BMW"`
`model`	Vorfiltern nach Modell (zusammen mit `make` verwenden).	`model="3 Series"`
`price_min`	Mindestpreis (numerisch).	`price_min="10000"`
`price_max`	Maximalpreis (numerisch).	`price_max="40000"`
`fuel`	Kraftstoffart, zum Beispiel `petrol`, `diesel`, `electric`.	`fuel="electric"`
`body`	Karosserieform, zum Beispiel `suv`, `sedan`, `coupe`.	`body="suv"`
`order_by`	Sortierfeld: `price`, `mileage` oder `date` (Standard).	`order_by="price"`
`order`	Sortierrichtung: `asc` (Standard) oder `desc`.	`order="asc"`
`per_page`	Einträge pro Seite: `12`, `24` (Standard), `48`, `72`, `all`.	`per_page="12"`

Attribute für `[as24ci_search_filter]`

Attribut	Beschreibung	Beispiel
`results_url`	URL der Ergebnisseite. Standardmäßig die Fahrzeug-Archiv-URL des Plugins.	`results_url="/inventory/"`

`[as24ci_compare]`

Keine Attribute. Platzieren Sie dies auf einer dedizierten Vergleichsseite. Die Einstellungsseite kann diese Seite automatisch erstellen.

`[as24ci_favorites]`

Keine Attribute. Platzieren Sie dies auf einer dedizierten Favoriten- oder Wunschzettelseite. Favoriten werden im Browser des Besuchers über localStorage gespeichert — es ist kein Konto erforderlich und es werden keine Daten an den Server gesendet.

Attribute für `[as24ci_location_box]` und `[as24ci_hours_box]`

Attribut	Beschreibung	Beispiel
`post_id`	ID des Fahrzeug-Beitrags. Standardmäßig der aktuelle Beitrag im Loop.	`post_id="123"`

Die mit dem Fahrzeug verknüpfte Filiale wird über die Seller ID von AutoScout24 aufgelöst. Wenn keine Übereinstimmung gefunden wird, wird der erste (Standard-)Standort aus Standorte verwendet.

Unterstützte URL-Parameter

Diese Parameter können an die Archiv-URL angehängt werden. URL-Parameter überschreiben Shortcode-Attribute.

Parameter	Beschreibung	Beispiel
`make`	Filtern nach Marke.	`?make=BMW`
`model`	Filtern nach Modell (erfordert `make`).	`?model=3+Series`
`min_price` / `max_price`	Filtern nach Preisspanne.	`?min_price=5000&max_price=20000`
`mileage_max`	Maximale Kilometerleistung.	`?mileage_max=80000`
`condition`	`all`, `new` oder `used`.	`?condition=new`
`sort`	`price_asc`, `price_desc`, `mileage_asc`, `mileage_desc`.	`?sort=price_asc`
`per_page`	Einträge pro Seite (`12`, `24`, `48`, `72`, `all`).	`?per_page=12`
`q`	Stichwortsuche.	`?q=diesel`

Builder- & Editor-Unterstützung

Native Shortcode-Steuerelemente im Block-Editor (Gutenberg), Elementor, Divi / Beaver Builder / WPBakery und dem Classic Editor. Die KPI-Leiste auf der Seite meldet vier unterstützte Integrationsfamilien.

Dashboard-Widgets

Das Plugin fügt dem standardmäßigen WordPress-Dashboard die folgenden Widgets hinzu:

Widget	Inhalt
CMH – Company Overview	Fahrzeugzahlen, Importzeitpunkt, Lead-Gesamtzahlen und Portfoliowert.
CMH – AI and SEO Monitor	KI-Text-Warteschlange, Bild-SEO-Warteschlange und API-Verbindungsstatus.
CMH – Current Leads	Kürzliche eingehende Lead-Aktivitäten für Ihre Fahrzeuge.
CMH – Car Performance	Meistgesehene Fahrzeuge und Interaktionen auf einen Blick.
CMH – Price Information	Snapshot der Preisgestaltung für Ihren Fahrzeugbestand.

Tabelle „Übersicht über die Shortcode-Nutzung“

Die Tabelle zur Nutzungsübersicht listet jede veröffentlichte Seite oder jeden Beitrag auf, die einen Plugin-Shortcode enthalten, mit den folgenden Spalten:

Spalte	Zeigt
Content Title	Titel der Seite oder des Beitrags.
Content Type	Ob der Eintrag eine Seite oder ein Beitrag ist.
Shortcodes Used	Welche(n) Plugin-Shortcode(s) der Inhalt enthält.
Count	Wie viele Plugin-Shortcode-Vorkommen in diesem Inhalt vorhanden sind.
Last Updated	Wann die Seite oder der Beitrag zuletzt geändert wurde.
Actions	Ein Bearbeiten-Link, der die Seite oder den Beitrag im Editor öffnet.

Template-Überschreibungen

Die Shortcode-Ausgabe verwendet dieselben Templates wie der native Fahrzeug-CPT. Um ein Template zu überschreiben, kopieren Sie die Datei in das Verzeichnis Ihres aktiven Themes; WordPress lädt Ihre Version automatisch.

Template	Verwendet für
`archive-as24ci_car.php`	Fahrzeugarchiv und Shortcode-Listen-Ausgabe.
`single-as24ci_car.php`	Einzelne Fahrzeug-Detailseite.
`page-as24ci_compare.php`	Fahrzeug-Vergleichsseite.

Betriebliche Hinweise

Die Übersicht über die Shortcode-Nutzung scannt bis zu 100 der am kürzesten geänderten, veröffentlichten Seiten und Beiträge, die einen Plugin-Shortcode enthalten. Benutzerdefinierte Inhaltstypen (Custom Post Types) sind standardmäßig nicht enthalten.
Die KPI-Kachel Verwendete Shortcodes zählt die Gesamtzahl der Vorkommen im selben Scan.
Die KPI-Kachel Template-Überschreibungen zählt die Plugin-Templates, die derzeit von Ihrem aktiven Theme überschrieben werden.
Das Deaktivieren von Vergleich oder Favoriten in den Einstellungen entfernt den Shortcode nicht aus Ihren Inhalten; es markiert ihn in dieser Referenz lediglich als deaktiviert und kann seine Frontend-Ausgabe unterdrücken. Aktivieren Sie die Funktion wieder, um den Shortcode wieder aktiv zu machen.

Fehlerbehebung

Ein Shortcode wird als Klartext gerrendered. WordPress hat das Shortcode-Parsing für dieses Feld nicht ausgeführt. Platzieren Sie den Shortcode im Hauptinhalt der Seite oder des Beitrags, in einem Shortcode-Block oder in einem Builder-Modul, das Shortcodes unterstützt.
Das Archiv zeigt trotz eines Attributs alles an. Ein URL-Parameter überschreibt Shortcode-Attribute. Entfernen Sie den URL-Parameter oder passen Sie ihn an den gewünschten Filter an.
[as24ci_compare] oder [as24ci_favorites] erscheint leer. Überprüfen Sie, ob die entsprechende Funktion in den Einstellungen aktiviert ist. Die Seite zeigt in diesem Fall auch ein Deaktiviert-Badge an.
Standort und Öffnungszeiten fallen auf die Standardfiliale zurück. Die Seller ID des Fahrzeugs ist keinem Standort zugewiesen; fügen Sie diese unter Standorte hinzu.
Eine Theme-Überschreibung wird nicht übernommen. Die Datei muss sich im Hauptverzeichnis des aktiven (oder Child-)Themes befinden und genau den oben aufgeführten Dateinamen verwenden.