Dokumentation · Admin-Referenz

Layout-Manager-Referenz

Dieses Dokument ist eine Referenz für den Bildschirm Layout-Manager des ADP Car Market Hub-Plugins (Car Market Hub → Layout Manager). Es erklärt den zonenbasierten Arbeitsbereich, wie Elemente hinzugefügt, neu angeordnet und konfiguriert werden, sowie die zusätzlichen Einstellungen für Archivkarten.

Wann Sie dieses Dokument verwenden sollten

Verwenden Sie diese Referenz, wenn Sie steuern möchten, welche Felder, Blöcke oder Filter im Frontend sichtbar sind, in welcher Reihenfolge sie erscheinen oder wie das Archiv-Raster aufgebaut ist. Informationen zu Farben, Typografie und Schaltflächen finden Sie in der Referenz für Design & Styles.

Übersicht

Der Layout-Manager organisiert das Frontend in sieben Zonen. Jede Zone hat ihren eigenen Arbeitsbereich mit zwei Spalten: einer Liste für das Aktive Layout (was derzeit im Frontend angezeigt wird) und einer Liste für Verfügbare Elemente (was noch hinzugefügt werden kann). Für einige Blöcke bietet ein zusätzliches Panel Felder konfigurieren die Möglichkeit, die Sichtbarkeit einzelner Felder pro Block zu steuern.

Die sieben Zonen sind:

Zone	Label	Zweck
`search_filters`	Suchfilter	Welche Filtereingaben auf der Archivseite und in welcher Reihenfolge erscheinen.
`archive_cards`	Fahrzeug-Archivkarten	Welche Felder auf jeder Fahrzeugkarte in der Archiv- und Listenansicht angezeigt werden.
`single_main`	Hauptinhalt Einzelfahrzeug	Reihenfolge und Sichtbarkeit der Hauptinhaltsblöcke auf der Fahrzeug-Detailseite.
`single_sidebar`	Einzelfahrzeug – Sidebar	Blöcke, die in der Sidebar der Fahrzeug-Detailseite angezeigt werden.
`single_bottom`	Einzelfahrzeug – Unterer Bereich	Blöcke, die unterhalb des Hauptinhalts auf der Fahrzeug-Detailseite angezeigt werden.
`compare`	Fahrzeuge vergleichen	Felder, die in der direkten Fahrzeug-Vergleichsansicht angezeigt werden.
`favorites`	Favoriten	Zusammenfassungsfelder, die auf den Favoriten-/Wunschzettelkarten angezeigt werden.

Das benutzerdefinierte Layout wird im Frontend nur angewendet, wenn der Hauptschalter Benutzerdefinierte Blockreihenfolge anstelle der integrierten Standardeinstellungen verwenden in Design & Styles → Layout-Manager aktiviert ist.

Anforderungen oder Voraussetzungen

Berechtigung zur Verwaltung des Plugins.
Für die Zonen „Vergleichen“ und „Favoriten“ müssen die entsprechenden Frontend-Funktionen in Einstellungen → Frontend-Funktionen aktiviert sein.
Für den Block „Finanzierungsrechner“ muss der Rechner in Einstellungen → Frontend-Funktionen aktiviert sein.

Schritt-für-Schritt-Anleitung

Eine Zone auswählen

Öffnen Sie Car Market Hub → Layout-Manager.
Verwenden Sie die Zonenauswahl oben, um zwischen den sieben Zonen zu wechseln. Die aktive Zone wird auch in der URL über den Parameter lm_zone angezeigt.

Ein Element zum aktiven Layout hinzufügen

Wählen Sie in der rechten Spalte Verfügbare Elemente ein Element aus dem Dropdown-Menü aus und klicken Sie auf Element hinzufügen, oder verwenden Sie die Schaltfläche + in einer Zeile.
Das Element erscheint in der Liste Aktives Layout auf der linken Seite.

Elemente neu anordnen

Ziehen Sie die Zeile an ihrem Griff (≡-Symbol), um die Reihenfolge zu ändern.
Der Zähler „X / Y aktiviert“ aktualisiert sich, wenn Sie Elemente ein- oder ausschalten.

Ein Element aktivieren, deaktivieren oder entfernen

Verwenden Sie den Schalter in der Zeile, um ein Element zu deaktivieren, ohne es zu entfernen (Zonen für Einzelfahrzeug, Vergleichen und Favoriten).
Klicken Sie auf die Schaltfläche −, um ein Element zurück zu den Verfügbaren Elementen zu verschieben.
In den Zonen Suchfilter und Fahrzeug-Archivkarten verbleiben nur aktivierte Elemente in der aktiven Liste; deaktivierte Elemente werden automatisch zu den Verfügbaren Elementen zurückgeführt.

Felder innerhalb eines Blocks konfigurieren

Bei konfigurierbaren Blöcken bietet die Zeile eine Schaltfläche Felder konfigurieren.
Klicken Sie darauf, um das rechte Konfigurationspanel zu öffnen und einzelne Felder innerhalb dieses Blocks ein- oder auszuschalten.

Die Zone Fahrzeug-Archivkarten konfigurieren

Diese Zone verfügt über ein spezielles Layout mit der Feld-Manager-Karte oben und zwei nebeneinander liegenden Karten darunter:

Archiv-Layout-Einstellungen — steuert die Raster-/Listen-Darstellung.
Badges & Labels — wählt aus, welche Zustands-Badges auf den Karten erscheinen.

Konfigurationsreferenz

Archiv-Layout-Einstellungen (nur Zone Fahrzeug-Archivkarten)

Feld	Hinweise
Spalten im Archiv-Raster	Anzahl der Karten pro Zeile: `1`, `2`, `3` oder `4`.
Standard-Sortierung	`Newest`, `Lowest Price`, `Highest Price` oder `Lowest Mileage`.
Fahrzeuge pro Seite	Positive Ganzzahl.
Archiv-Layout	`Grid`, `List` oder `Both (Grid & List)`, um Besuchern den Wechsel zu ermöglichen.
Länge des Listenauszugs	Anzahl der Zeichen, die aus dem Beitragstext in der Listenansicht angezeigt werden. `0` blendet den Auszug aus. Bereich 0–500. Nur sichtbar, wenn das Layout `List` oder `Both` ist.

Badges & Labels (nur Zone Fahrzeug-Archivkarten)

Feld	Hinweise
Sichtbare Badges	Schalten Sie jeweils ein: Neu, Gebraucht, Angebot, Top-Angebot.

Unterhalb der Sichtbarkeitsschalter bietet die Karte auch eine Darstellungsmatrix. Jede Zeile ist ein Badge (Neu, Gebraucht, Angebot, Top) und die Spalten ermöglichen es Ihnen, dieses Badge individuell zu gestalten:

Spalte	Hinweise
Hintergrundfarbe	Füllfarbe des Badges.
Textfarbe	Farbe des Badge-Label-Textes.
Gewichtung	Schriftgewichtung des Badge-Labels.
Transformation	Auf das Label angewendete Texttransformation (z. B. UPPERCASE).
Größe (px)	Schriftgröße des Badge-Labels in Pixeln.

Platzierung des Finanzierungsrechners

Der Block „Finanzierungsrechner“ kann im Hauptinhalt Einzelfahrzeug, in der Einzelfahrzeug – Sidebar oder im Einzelfahrzeug – Unteren Bereich platziert werden. Das Plugin erzwingt eine einzige aktive Platzierung:

Wenn der Rechner in einer der drei Einzelfahrzeug-Zonen aktiv ist, wird er in der Liste der Verfügbaren Elemente der anderen beiden Zonen als gesperrt angezeigt, mit einem Hinweis darauf, welche Zone ihn derzeit besitzt.
Falls der Rechner aus irgendeinem Grund in mehr als einer Einzelfahrzeug-Zone aktiv ist, zeigen die entsprechenden Panels eine Warnung vor doppelter Aktivierung an, die erklärt, dass nur eine Instanz im Frontend gerendert wird.

Betriebshinweise

Jede Zone wird in einer eigenen Option gespeichert, sodass Änderungen in einer Zone die anderen nicht beeinflussen.
Die Zonen Suchfilter und Fahrzeug-Archivkarten verwenden das „Nur-Aktiv“-Modell: Das Deaktivieren einer Zeile entfernt sie auch aus der aktiven Liste, was der strikten Ein/Aus-Natur dieser Bereiche entspricht.
Die anderen Zonen verwenden eine stabile Reihenfolge, die deaktivierte Elemente an Ort und Stelle behält, sodass Sie sie später schnell wieder aktivieren können.
Einstellungen zur Feldsichtbarkeit, die innerhalb eines Blocks konfiguriert wurden (über Felder konfigurieren), werden pro Ansicht gespeichert (z. B. compare, favorites) und sind unabhängig vom Aktivierungsstatus des Blocks.
Das benutzerdefinierte Layout hat im Frontend keine Auswirkungen, bis der Schalter Benutzerdefinierte Blockreihenfolge verwenden in Design & Styles → Layout-Manager aktiviert ist.
Nach dem Speichern wird die Seite mit derselben ausgewählten Zone neu geladen (über den URL-Parameter lm_zone), sodass Sie direkt im Kontext weiterarbeiten können.

Fehlerbehebung

Änderungen werden im Frontend nicht angezeigt. Vergewissern Sie sich, dass der Hauptschalter in Design & Styles → Layout-Manager aktiviert ist, und leeren Sie alle Frontend- oder CDN-Caches.
Archiv-Layout-Einstellungen fehlen. Diese Einstellungen erscheinen nur in der Zone Fahrzeug-Archivkarten.
Das Feld „Länge des Listenauszugs“ ist ausgeblendet. Es ist nur sichtbar, wenn das Archiv-Layout List oder Both (Grid & List) ist.
Finanzierungsrechner erscheint gesperrt. Er ist bereits in einer anderen Einzelfahrzeug-Zone aktiv. Entfernen Sie ihn dort, um ihn hier hinzufügen zu können.
Warnung vor doppeltem Finanzierungsrechner. Der Rechner ist in mehr als einer Einzelfahrzeug-Zone aktiviert. Deaktivieren Sie ihn in allen bis auf eine Zone, um die Warnung zu entfernen und ein konsistentes Rendering zu gewährleisten.
Die Liste der verfügbaren Elemente ist leer. Alle von dieser Zone unterstützten Elemente befinden sich bereits im aktiven Layout.
Eine Drag-and-Drop-Reihenfolge wurde nicht übernommen. Vergewissern Sie sich, dass Sie nach dem Ziehen gespeichert haben. Einige Browser erfordern bei der ersten Verwendung auch die Freigabe der Seite für Zwischenablage- oder Drag-Operationen.