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 Integrationen in Editoren und Page-Builder sowie die mit dem Plugin gelieferten Dashboard-Widgets.

Wann Sie dieses Dokument verwenden sollten

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

Fahrzeuglisten, Suchformulare, Vergleichstabellen, Favoriten, Standort-Boxen oder Öffnungszeiten-Boxen auf einer Seite einbetten.
Den Fahrzeugbestand bereits beim Einfügen mithilfe von Shortcode-Attributen vorfiltern.
Vorgefilterte Besucher über URL-Parameter auf die Bestandsseite leiten.
Ein Plugin-Template in Ihrem aktiven Theme überschreiben.
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 Seitennummerierung.
`[as24ci_search_filter]`	Eigenständiges Suchformular, gedacht für Landingpages oder Startseiten.
`[as24ci_compare]`	Fahrzeugvergleichstabelle für vom Besucher ausgewählte Fahrzeuge.
`[as24ci_favorites]`	Favoritenseite des Besuchers (Einträge werden clientseitig in `localStorage` gespeichert).
`[as24ci_location_box]`	Kontaktkarte für die mit einem Fahrzeug verknüpfte Garagen-Filiale.
`[as24ci_hours_box]`	Öffnungszeiten-Karte für die mit einem Fahrzeug verknüpfte Garagen-Filiale.

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

Am oberen Rand 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	Anzahl der veröffentlichten Seiten und Beiträge, die mindestens einen Plugin-Shortcode enthalten.
Template-Overrides	Anzahl der Plugin-Templates, die derzeit von Ihrem aktiven Theme überschrieben werden.

Unterhalb der 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 ausserdem eine Tabelle Übersicht zur Shortcode-Nutzung an, die veröffentlichte Seiten und Beiträge auflistet, die einen Plugin-Shortcode enthalten (bis zu den 100 neuesten Ergebnissen), sowie eine Karte Entwicklerhinweise, die Template-Overrides 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 die entsprechende Funktion 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`	Treibstoffart, 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ässig die Fahrzeug-Archiv-URL des Plugins.	`results_url="/inventory/"`

`[as24ci_compare]`

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

`[as24ci_favorites]`

Keine Attribute. Platzieren Sie diesen 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ässig der aktuelle Beitrag im Loop.	`post_id="123"`

Die mit dem Fahrzeug verknüpfte Filiale wird über die AutoScout24 Seller ID ermittelt. 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 im Classic Editor. Die KPI-Leiste auf der Seite meldet vier unterstützte Integrationsfamilien.

Dashboard-Widgets

Das Plugin fügt dem Standard-WordPress-Dashboard die folgenden Widgets hinzu:

Widget	Inhalt
CMH – Company Overview	Fahrzeugzahlen, Importzeiten, 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	Am häufigsten angesehene Fahrzeuge und Interaktionen auf einen Blick.
CMH – Price Information	Snapshot der Preisanalysen für Ihren Fahrzeugbestand.

Tabelle «Übersicht zur Shortcode-Nutzung»

Die Tabelle zur Nutzungsübersicht listet jede veröffentlichte Seite oder jeden Beitrag auf, der einen Plugin-Shortcode enthält, 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 enthalten 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-Overrides

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`	Fahrzeugvergleichsseite.

Betriebliche Hinweise

Die Übersicht zur 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ässig nicht enthalten.
Die KPI-Kachel Verwendete Shortcodes zählt die Gesamtzahl der Vorkommen im selben Scan.
Die KPI-Kachel Template-Overrides 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 Standard-Filiale zurück. Die Seller-ID des Fahrzeugs ist keinem Standort zugewiesen; fügen Sie diese unter Standorte hinzu.
Ein Theme-Override wird nicht erkannt. Die Datei muss sich im Hauptverzeichnis des aktiven (oder Child-)Themes befinden und genau den oben aufgeführten Dateinamen verwenden.