Dokumentation · Anhänge

Shortcode-Referenz

Dieser Anhang ist eine Schnellreferenz für die vom ADP Car Market Hub-Plugin registrierten Shortcodes.

Wann Sie dieses Dokument verwenden sollten

Verwenden Sie diese Referenz, wenn Sie einen Shortcode-Namen, seine unterstützten Attribute oder ein Copy-Paste-Beispiel nachschlagen müssen. Die konzeptionelle Erklärung der Shortcodes (wann welcher zu verwenden ist, wie sie mit Templates interagieren) finden Sie unter Shortcodes in der technischen Dokumentation und in der Shortcodes-Referenz im Frontend-Handbuch.

Übersicht

Alle Shortcodes werden durch den Haupt-Bootstrap des Plugins registriert und sind auf jeder WordPress-Seite oder jedem Beitrag verfügbar (abhängig vom aktiven Editor und eventuellen Einschränkungen auf Blockebene). Sie geben Strings zurück, anstatt sie direkt auszugeben, sodass sie in Bildunterschriften, Tabellenzellen oder Block-Patterns eingebettet werden können.

Shortcode	Rendert	Hinweise
`[as24ci_archive]`	Das Fahrzeugarchiv (filterbar, sortierbar, paginiert).	URL-Parameter überschreiben Shortcode-Attribute.
`[as24ci_search_filter]`	Das eigenständige Suchfilter-Formular ohne Ergebnisse.	Sendet an eine von Ihnen gewählte Ergebnis-URL.
`[as24ci_compare]`	Die Fahrzeug-Vergleichsseite.	Fahrzeuge werden über den URL-Parameter `ids` ausgewählt.
`[as24ci_favorites]`	Die Favoritenseite des Besuchers.	Wird über den Favoriten-REST-Helper befüllt; Favoriten werden clientseitig gespeichert.
`[as24ci_location_box]`	Eine Standortkarte für einen einzelnen Standort-Beitrag.	Löst den Standort aus `post_id` oder dem Kontext auf.
`[as24ci_hours_box]`	Eine Öffnungszeiten-Karte für einen einzelnen Standort-Beitrag.	Gleiches Fallback-Verhalten wie `[as24ci_location_box]`.

Attribut-Referenz

`[as24ci_archive]`

Alle Attribute sind optional. Gleichnamige URL-Parameter überschreiben das Shortcode-Attribut, sodass Besucher die Ergebnisse interaktiv verfeinern können.

Attribut	Erlaubte Werte	Wirkung
`make`	Marke-Slug	Vorfiltern nach Marke.
`model`	Modell-Slug	Vorfiltern nach Modell.
`price_min`	Zahl	Untergrenze des Preisfilters (zugeordnet zu `min_price`).
`price_max`	Zahl	Obergrenze des Preisfilters (zugeordnet zu `max_price`).
`fuel`	Kraftstoffart-Slug	Vorfiltern nach Kraftstoffart.
`body`	Karosserieform-Slug	Vorfiltern nach Karosserieform.
`order_by`	`price`, `mileage`, `date`	Sortierfeld. Kombiniert mit `order`, um den Parameter `sort` zu erzeugen.
`order`	`asc`, `desc`	Sortierrichtung. Standard ist `asc`.
`per_page`	`12`, `24`, `48`, `72`, `all`	Einträge pro Seite.

Die Paginierung verwendet ?paged= (bevorzugt) oder ?page= aus der URL.

Beispiel:

[as24ci_archive make="bmw" price_max="40000" order_by="price" order="asc" per_page="24"]

`[as24ci_search_filter]`

Attribut	Erlaubte Werte	Wirkung
`results_url`	Absolute oder relative URL	URL, an die das Formular gesendet wird. Standardmäßig die Archiv-URL des Post-Typs `as24ci_car`, mit Fallback auf `/cars/`, wenn keine Archiv-URL verfügbar ist.

Es werden nur die Filter gerendert, die in der Layout-Zone Suchfilter aktiviert sind. Verwalten Sie diese im Admin-Tab Layout-Manager.

Beispiel:

[as24ci_search_filter results_url="/inventory/"]

`[as24ci_compare]`

Keine dokumentierten Attribute im aktuellen Quellcode. Die Auswahl wird durch den URL-Parameter ids gesteuert, eine kommagetrennte Liste von Fahrzeug-Beitrags-IDs.

Beispiel-URL: /compare/?ids=123,456

`[as24ci_favorites]`

Keine dokumentierten Attribute. Die sichtbaren Felder werden über die Layout-Zone Favoriten im Layout-Manager konfiguriert. Fahrzeugdaten werden von POST /wp-json/as24ci/v1/favorites für die IDs abgerufen, die der Besucher lokal gespeichert hat.

`[as24ci_location_box]`

Attribut	Erlaubte Werte	Wirkung
`post_id`	Ganzzahl	ID des zu rendernden Standort-Beitrags. Wenn weggelassen, löst der Shortcode den Standort aus dem aktuellen Kontext auf.

`[as24ci_hours_box]`

Attribut	Erlaubte Werte	Wirkung
`post_id`	Ganzzahl	ID des zu rendernden Standort-Beitrags. Gleiches Fallback-Verhalten wie `[as24ci_location_box]`.

Betriebshinweise

Das Plugin setzt das globale $as24ci_render_mode auf 'shortcode', während ein Shortcode-Template gerendert wird. Das Laden von Assets und Analytics nutzen dieses Flag, damit sich auf Shortcodes basierende Seiten konsistent mit dem nativen CPT-Archiv verhalten.
[as24ci_archive] und [as24ci_compare] tauschen die globale $wp_query aus, während ihr Template gerendert wird, und rufen danach wp_reset_postdata() auf. Betten Sie diese im Hauptinhaltsbereich ein, um Konflikte mit Theme-Komponenten zu vermeiden, die die globale Query frühzeitig auslesen.
[as24ci_search_filter] generiert seine action-URL aus der konfigurierten (oder standardmäßigen) Ergebnis-URL und behält alle in dieser URL vorhandenen Query-Parameter über versteckte Formularfelder bei, sodass es sowohl mit „Pretty Permalinks“ als auch mit einfachen Permalinks funktioniert.
Die mitgelieferten Archiv- und Suchfilter-Templates verwenden immer die eigenen Dateien des Plugins. Theme-Overrides für archive-as24ci_car.php gelten sowohl für das CPT-Archiv als auch für [as24ci_archive], aber page-as24ci_compare.php und parts/search-filter.php werden nicht über locate_template() geladen und können nicht ohne Bearbeitung des Plugin-Quellcodes vom Theme überschrieben werden. Überprüfen Sie dies vor der Veröffentlichung anhand der aktuellen Plugin-Version.
Seiten, die von einem Full-Page-Cache bedient werden, sollten nach dem Bearbeiten einer Seite, die diese Shortcodes verwendet, geleert werden, damit die neueste Ausgabe bereitgestellt wird.

Fehlerbehebung

Shortcode wird als reiner Text ausgegeben. Überprüfen Sie den Shortcode-Namen; bei Namen wird zwischen Groß- und Kleinschreibung unterschieden. Verwenden Sie die oben dokumentierte Kleinschreibung.
[as24ci_archive] zeigt die falschen Fahrzeuge an. Die URL enthält wahrscheinlich bereits Filterparameter von einer vorherigen Seite; URL-Parameter überschreiben immer Shortcode-Attribute.
[as24ci_search_filter] zeigt keine Felder an. In der Layout-Zone Suchfilter sind keine Filter aktiviert. Öffnen Sie den Layout-Manager und aktivieren Sie die benötigten Filter.
[as24ci_favorites] zeigt eine leere Liste an. Der Besucher hat keine Favoriten im aktuellen Browser gespeichert. Favoriten sind an den Browser/das Gerät gebunden.
Paginierungs-Links führen zu 404. Ihre Permalink-Struktur übergibt paged möglicherweise nicht sauber durch die Host-Seite. Versuchen Sie ?page=N oder aktualisieren Sie die Permalink-Struktur.
Vergleichsseite ist leer. Der Parameter ids fehlt in der URL. Fügen Sie mindestens zwei Fahrzeug-IDs hinzu (?ids=123,456).

Wann Sie dieses Dokument verwenden sollten

Übersicht

Attribut-Referenz

[as24ci_archive]

[as24ci_search_filter]

[as24ci_compare]

[as24ci_favorites]

[as24ci_location_box]

[as24ci_hours_box]