Dokumentation · Admin-Referenz

Layout Manager-Referenz

Dieses Dokument ist eine Referenz für den Layout Manager-Bildschirm des ADP Car Market Hub-Plugins (CMH Center → 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 zeigt ein zusätzliches Panel Felder konfigurieren die Sichtbarkeit der Felder pro Block an.

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 Favoriten-/Wunschzettelkarten angezeigt werden.

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

Anforderungen oder Voraussetzungen

Berechtigung zur Verwaltung des Plugins.
Für die Zonen „Vergleichen“ und „Favoriten“ sollten 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 CMH Center → 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 widergespiegelt.

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 „Einzelfahrzeug“, „Vergleichen“ und „Favoriten“).
Klicken Sie auf die Schaltfläche −, um ein Element zurück zu den Verfügbaren Elementen zu verschieben.
Bei 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 in diesem Block 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 ganze Zahl.
Archiv-Layout	`Grid`, `List` oder `Both (Grid & List)`, damit Besucher wechseln können.
Auszugslänge in Liste	Anzahl der Zeichen, die aus dem Beitragssauszug 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, Video.

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, 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.

Betriebliche Hinweise

Jede Zone wird in ihrer 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 diese 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 Aktivierungszustand 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. Stellen Sie sicher, dass der Hauptschalter unter Design & Styles → Layout Manager aktiviert ist, und leeren Sie alle Frontend- oder CDN-Caches.
Einstellungen für das Archiv-Layout fehlen. Diese Einstellungen werden nur in der Zone Car Archive Cards angezeigt.
Das Feld "Auszugslänge der Liste" ist ausgeblendet. Es ist nur sichtbar, wenn das Archive layout auf List oder Both (Grid & List) eingestellt ist.
Finanzierungsrechner erscheint gesperrt. Er ist bereits in einer anderen Single Vehicle-Zone aktiv. Entfernen Sie ihn dort, um ihn hier hinzuzufügen.
Warnung vor doppeltem Finanzierungsrechner. Der Rechner ist in mehr als einer Single Vehicle-Zone aktiviert. Deaktivieren Sie ihn in allen bis auf eine Zone, um die Warnung zu entfernen und eine konsistente Darstellung 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-Neuanordnung wurde nicht gespeichert. Vergewissern Sie sich, dass Sie nach dem Verschieben gespeichert haben. Einige Browser erfordern zudem bei der ersten Verwendung die Freigabe der Seite für Zwischenablage-/Drag-Operationen.