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 (CMH Center → 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 Dashboard-Widgets, die mit dem Plugin geliefert werden.

Wann Sie dieses Dokument verwenden sollten

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

Einbetten von Fahrzeuglisten, Suchformularen, Vergleichstabellen, Favoriten, Standortboxen oder Öffnungszeitenboxen auf einer Seite.
Vorfiltern des Bestands zum Zeitpunkt des Einfügens mithilfe von Shortcode-Attributen.
Senden von vorgefiltertem Traffic an die Inventarseite 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 Seitennummerierung.
`[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]`	Kontaktkarte für die mit einem Fahrzeug verknüpfte Garage.
`[as24ci_hours_box]`	Öffnungszeitenkarte für die mit einem Fahrzeug verknüpfte Garage.

Jeder Shortcode ist auch auf dem Bildschirm 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 dem Bildschirm 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.

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.

Der Bildschirm zeigt ausserdem eine Tabelle Übersicht über die Shortcode-Nutzung an, in der veröffentlichte Seiten und Beiträge aufgelistet sind, die einen beliebigen Plugin-Shortcode enthalten (bis zu den letzten 100 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 der entsprechende Funktions-Toggle in CMH Center → Settings aktiviert sein. Wenn eine Funktion deaktiviert ist, kennzeichnet der Bildschirm den Shortcode mit einem Deaktiviert-Badge.
Für [as24ci_location_box] und [as24ci_hours_box] muss mindestens ein Standort in 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 editor-eigene Steuerelement 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

`[as24ci_archive]` Attribute

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"`

`[as24ci_search_filter]` Attribute

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

`[as24ci_compare]`

Keine Attribute. Auf einer dedizierten Vergleichsseite platzieren. Die Einstellungsseite kann diese Seite automatisch erstellen.

`[as24ci_favorites]`

Keine Attribute. Auf einer dedizierten Favoriten- oder Wunschzettelseite platzieren. Favoriten werden im Browser des Besuchers über localStorage gespeichert – es ist kein Konto erforderlich und es werden keine Daten an den Server gesendet.

`[as24ci_location_box]` und `[as24ci_hours_box]` Attribute

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 dem Bildschirm meldet vier unterstützte Integrationsfamilien.

Dashboard-Widgets

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

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

Tabelle zur Shortcode-Nutzungsübersicht

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

Spalte	Zeigt
Inhaltstitel	Titel der Seite oder des Beitrags.
Inhaltstyp	Ob der Eintrag eine Seite oder ein Beitrag ist.
Verwendete Shortcodes	Welche(n) Plugin-Shortcode(s) der Inhalt enthält.
Anzahl	Wie oft der Plugin-Shortcode in diesem Inhalt vorkommt.
Zuletzt aktualisiert	Wann die Seite oder der Beitrag zuletzt geändert wurde.
Aktionen	Ein Bearbeiten-Link, der die Seite oder den Beitrag im Editor öffnet.

Template-Overrides

Die Shortcode-Ausgabe verwendet dieselben Templates wie die native Fahrzeug-CPT. Um ein Template zu überschreiben, kopieren Sie die Datei in das Root-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 Shortcode-Nutzungsübersicht scannt bis zu 100 der zuletzt 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 schalten.

Fehlerbehebung

Ein Shortcode wird als Klartext gerendert. 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. Der Bildschirm zeigt in diesem Fall auch ein Deaktiviert-Label 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.
Ein Theme-Override wird nicht erkannt. Die Datei muss sich im Root-Verzeichnis des aktiven (oder Child-)Themes befinden und genau den oben aufgeführten Dateinamen verwenden.