Dokumentation · Admin-Referenz

Layout Manager-Referenz

Dieses Dokument ist eine Referenz für den Layout Manager-Bildschirm 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 dieses Dokument zu verwenden ist

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. Für Farben, Typografie und Buttons siehe 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 des Aktiven Layouts (was derzeit im Frontend angezeigt wird) und einer Liste der Verfügbaren Elemente (was noch hinzugefügt werden kann). Für einige Blöcke bietet ein zusätzliches Panel Felder konfigurieren die Möglichkeit, die Sichtbarkeit der 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 Fahrzeugdetailseite.
`single_sidebar`	Einzelfahrzeug – Sidebar	Blöcke, die in der Sidebar der Fahrzeugdetailseite angezeigt werden.
`single_bottom`	Einzelfahrzeug – Unterer Bereich	Blöcke, die unterhalb des Hauptinhalts auf der Fahrzeugdetailseite angezeigt werden.
`compare`	Fahrzeuge vergleichen	Felder, die in der nebeneinander liegenden Fahrzeugvergleichsansicht angezeigt werden.
`favorites`	Favoriten	Zusammenfassungsfelder, die auf den Favoriten-/Wunschzettelkarten angezeigt werden.

Das benutzerdefinierte Layout wird im Frontend nur angewendet, wenn der Hauptschalter Die 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 Finanzierungsrechner-Block 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 werden nur aktivierte Elemente in der aktiven Liste behalten; 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, die innerhalb dieses Blocks angezeigt werden, ein- oder auszuschalten.

Die Zone Fahrzeug-Archivkarten konfigurieren

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

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

Konfigurationsreferenz

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

Feld	Hinweise
Archiv-Rasterspalten	Anzahl der Karten pro Zeile: `1`, `2`, `3` oder `4`.
Standard-Sortierreihenfolge	`Newest`, `Lowest Price`, `Highest Price` oder `Lowest Mileage`.
Fahrzeuge pro Seite	Positive Ganzzahl.
Archiv-Layout	`Grid`, `List` oder `Both (Grid & List)`, damit Besucher wechseln können.
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/aus: Neu, Gebraucht, Aktion, Top-Angebot.

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

Spalte	Hinweise
Hintergrundfarbe	Füllfarbe des Badges.
Textfarbe	Farbe des Badge-Labeltextes.
Gewichtung	Schriftgewichtung des Badge-Labels.
Transformation	Auf das Label angewendete Texttransformation (z. B. GROSSBUCHSTABEN).
Grösse (px)	Schriftgrösse 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 Live-Platzierung:

Wenn der Rechner in einer der drei Einzelfahrzeug-Zonen aktiv ist, wird er in der Liste der Verfügbaren Elemente der anderen beiden als gesperrt angezeigt, mit einem Hinweis darauf, welche Zone ihn derzeit besitzt.
Wenn 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.

Betriebliche Hinweise

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 einschalten können.
Feld-Sichtbarkeitseinstellungen, 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 Die 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 im Kontext weiterarbeiten können.

Fehlerbehebung

Änderungen werden im Frontend nicht angezeigt. Vergewissern Sie sich, dass der Hauptschalter in Design & Styles → Layout Manager eingeschaltet 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 hinzuzufügen.
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 das Zulassen von Zwischenablage-/Drag-Operationen für die Seite.