Darstellung per CSS anpassen
Was die Stylesheets tun
Section titled “Was die Stylesheets tun”Das Plugin bringt zwei Stylesheets mit:
| Handle | Datei | Inhalt | Abschaltbar |
|---|---|---|---|
wpcars24-base | assets/wpcars24-base.css | Grundgerüst: das Raster der Liste, des Filterformulars, der Ausstattung und der Verbrauchsangaben; die Abstände zwischen den Bausteinen; die Galerie mit Blättern, Einrasten und Pfeilen; Seitenverhältnis und Zuschnitt der Bilder; die Schutzregeln | nein |
wpcars24-theme | assets/wpcars24-theme.css | Optik: Rahmen, Flächen, Rundungen, Schatten, Innenabstände, Schriftgrößen, das Verhalten beim Überfahren mit der Maus | ja, siehe Die Optik abschalten |
Schriften und Farben kommen vom Theme. Linien und Flächen leitet die Optik aus der Textfarbe ab; auf einem hellen Theme wird daraus ein zartes Grau, auf einem dunklen ein zartes Aufhellen. Das Grundgerüst enthält keine Farben, Rahmen oder Schriftgrößen.
Die Abstände zwischen den Bausteinen setzt der Behälter, nicht der Baustein: .wpcars24-vehicles stapelt Filterformular, Trefferzahl, Liste und Blätterung mit 1,5rem Abstand, .wpcars24-vehicle die Abschnitte eines Fahrzeugs mit 2rem. Ein einzeln gesetzter Shortcode wie [wpcars24_equipment] bringt deshalb keinen eigenen Abstand mit. Beide Abstände stellt die Variable --wpcars24-stack-gap um.
Geladen wird beides nur dort, wo Fahrzeuge erscheinen: auf den Fahrzeugseiten und auf Seiten, in deren Inhalt einer der Shortcodes steht. Steht ein Shortcode woanders, in einer Vorlage des Block-Themes, in einem Page Builder oder in einer Seitenleiste, lädt er die Stylesheets beim Ausgeben selbst nach, dann aber im Fuß der Seite. Was das für eigene Regeln heißt, steht unter Eigene Regeln.
Websites mit Page Builder laden Stylesheets und Skript besser immer im Kopf. Dafür gibt es den Filter wpcars24_force_assets, in der functions.php des Child-Themes:
add_filter( 'wpcars24_force_assets', '__return_true' );Wer das Gewicht auf den übrigen Seiten sparen will, gibt nur dort true zurück, wo Fahrzeuge stehen, etwa mit is_page( 'bestand' ).
Eigene Regeln
Section titled “Eigene Regeln”Probieren Sie die Wege in dieser Reihenfolge:
- Eine CSS-Variable. Sie wirkt unabhängig davon, in welcher Reihenfolge die Stylesheets geladen werden und wie stark eine Regel ist, und passt zum eigenen CSS eines Page-Builder-Elements.
- Eine Regel mit einer Klasse. Jede gestaltende Regel der Stylesheets kommt mit einer einzigen Klasse aus, ohne Verschachtelung, und jedes Element, das das Plugin gestaltet, trägt dafür eine eigene Klasse. Eine Regel Ihres Themes mit derselben Klasse überschreibt deshalb die Vorgabe des Plugins.
- Der Selektor der Schutzregel, wenn die Angabe in einer Schutzregel steht.
.wpcars24-card__price-amount { font-size: 1.4em;}Wenn die Stylesheets spät geladen werden. Steht der Shortcode außerhalb des Seiteninhalts, ist der Kopf der Seite schon geschrieben, wenn er die Stylesheets nachlädt. WordPress gibt sie dann im Fuß der Seite aus, nach dem CSS des Themes und nach dem Zusätzlichen CSS. Bei gleich starken Regeln gewinnt die spätere, also die des Plugins. Am einfachsten holt der Filter wpcars24_force_assets (siehe oben) die Stylesheets zurück in den Kopf. Ohne ihn wirken zuverlässig die CSS-Variablen und Regeln mit einer Klasse mehr, etwa mit dem Behälter davor: .wpcars24-vehicles um eine Liste, .wpcars24-vehicle um die Abschnitte eines Fahrzeugs, .wpcars24-filter um das Filterformular.
.wpcars24-vehicles .wpcars24-card__price-amount { font-size: 1.4em;}Wo Sie das CSS eintragen:
- Block-Theme: Design › Editor › Stile, dort über Mehr (die drei Punkte) Zusätzliches CSS.
- Klassisches Theme: Design › Anpassen › Zusätzliches CSS.
- Oder in die
style.cssdes Child-Themes.
Schutzregeln
Section titled “Schutzregeln”Viele Themes setzen in ihrem Inhaltsbereich Abstände und Einzug an Absätzen, Listen, Überschriften und Eingabefeldern, mit Regeln aus einer Klasse und einem Element wie .entry-content p, .single-content ul, .elementor-kit-5 h3 oder input[type="number"]. Solche Regeln setzen sich gegen eine einzelne Klasse durch, und gegen Element und Klasse dann, wenn das Theme sein CSS nach dem Plugin lädt. Ohne Schutz rückte Kadence das Raster der Karten ein, Astra gab jedem Feld des Filterformulars Abstand nach unten, und Elementor setzte die Kartentitel in der Größe von Artikelüberschriften.
Deshalb stehen einige Angaben mit dem nächsten Behälter, dem Element und der Klasse im Selektor. Das ist stärker als jede dieser Regeln. Die Schutzregeln setzen nur Abstand, Einzug und Aufzählungszeichen zurück. Ausnahmen sind die Felder und der Knopf des Filterformulars, deren Aussehen sie festlegen, und die Schriftgröße des Kartentitels.
| Selektor | Legt fest |
|---|---|
.wpcars24-vehicles ul.wpcars24-list | Liste der Karten ohne Abstand, Einzug und Aufzählungszeichen |
.wpcars24-list li.wpcars24-list__item | Eintrag der Liste ohne Abstand und Einzug |
.wpcars24-vehicles p.wpcars24-list__count | Trefferzahl ohne Abstand |
.wpcars24-vehicles p.wpcars24-list__empty | Hinweis „keine Fahrzeuge“ ohne Abstand |
.wpcars24-list__pagination ul.wpcars24-list__pages | Blätterung ohne Abstand, Einzug und Aufzählungszeichen |
.wpcars24-card h2.wpcars24-card__title, .wpcars24-card h3.wpcars24-card__title, .wpcars24-card h4.wpcars24-card__title | Kartentitel ohne Abstand; in der Optik seine Größe (1.1em) und Zeilenhöhe, gleich welche Ebene er hat |
.wpcars24-card ul.wpcars24-card__facts | Eckdaten der Karte ohne Abstand, Einzug und Aufzählungszeichen |
.wpcars24-card p.wpcars24-card__price | Preis der Karte am unteren Rand |
.wpcars24-card ul.wpcars24-emissions | Verbrauchsangaben der Karte ohne Abstand, Einzug und Aufzählungszeichen |
search form.wpcars24-filter | Filterformular ohne Abstand |
.wpcars24-filter p.wpcars24-filter__field | Feld des Filterformulars ohne Abstand |
.wpcars24-filter input.wpcars24-filter__control | Zahlenfelder: Breite, Abstand; in der Optik Innenabstand, Rahmen, Rundung, Schrift |
.wpcars24-filter select.wpcars24-filter__control | Auswahllisten, wie die Zahlenfelder |
.wpcars24-filter button.wpcars24-filter__submit | Knopf des Filterformulars, in der Optik |
.wpcars24-vehicle p.wpcars24-vehicle__price | Preis der Detailseite ohne Abstand |
.wpcars24-vehicle dl.wpcars24-vehicle__specs | Fahrzeugdaten ohne Abstand |
.wpcars24-vehicle__spec dd.wpcars24-vehicle__spec-value | Wert der Fahrzeugdaten ohne Einzug |
.wpcars24-vehicle__section h2.wpcars24-vehicle__heading, .wpcars24-vehicle__section h3.wpcars24-vehicle__heading, .wpcars24-vehicle__section h4.wpcars24-vehicle__heading | Überschrift eines Abschnitts, gleich welche Ebene: kein Abstand darüber, .75rem darunter |
.wpcars24-vehicle__description > :is(p, ul, ol):last-child | letzter Absatz oder letzte Liste im Text des Inserats ohne Abstand nach unten |
.wpcars24-vehicle__emissions ul.wpcars24-emissions | Verbrauchsangaben der Detailseite ohne Abstand, Einzug und Aufzählungszeichen |
.wpcars24-vehicle__equipment ul.wpcars24-vehicle__equipment-list | Ausstattung ohne Abstand, mit 1.25rem Einzug für die Aufzählungszeichen |
.wpcars24-vehicle__seller address.wpcars24-vehicle__address | Anschrift ohne Abstand |
.wpcars24-vehicle p.wpcars24-vehicle__source | Verweis auf das Inserat ohne Abstand |
Wer genau diese Angaben ändern will, nimmt denselben Selektor:
.wpcars24-filter input.wpcars24-filter__control,.wpcars24-filter select.wpcars24-filter__control { border-radius: 0;}Schriftart und Farbe stehen in keiner Schutzregel. Die Überschriften der Abschnitte übernehmen deshalb eine globale Typografie des Themes für h2, etwa die aus einem Elementor-Kit. Ihre Größe ändern Sie mit einer Klasse: .wpcars24-vehicle__heading.
CSS-Variablen
Section titled “CSS-Variablen”| Variable | Wofür | Vorgabe |
|---|---|---|
--wpcars24-stack-gap | Abstand zwischen den Bausteinen: Filterformular, Trefferzahl, Liste und Blätterung; Preis, Galerie und Abschnitte der Detailseite | 1.5rem in der Liste, 2rem auf der Detailseite |
--wpcars24-line | Rahmen der Karten und des Filterformulars, Eingabefelder, Trennlinien der Fahrzeugdaten | 22 % der Textfarbe |
--wpcars24-line-strong | Rahmen beim Überfahren mit der Maus: Karte, Blätterung, Vorschaubilder | 45 % der Textfarbe |
--wpcars24-surface | Hintergrund der Karten und des Filterformulars | 5 % der Textfarbe |
--wpcars24-radius | Eckenradius von Karten, Filterformular und Galerie; Eingabefelder und Blätterung die Hälfte | .5rem |
--wpcars24-gap | Abstand der Karten in der Liste | 1.5rem |
--wpcars24-card-min-width | Mindestbreite einer Karte; daraus ergibt sich die Zahl der Spalten. In einer schmaleren Spalte wird die Karte so breit wie die Spalte. | 16rem |
--wpcars24-card-image-ratio | Seitenverhältnis der Bilder auf den Karten | 4 / 3 |
--wpcars24-card-padding | Innenabstand der Karte. Das Bild läuft trotzdem bis an den Rand, denn sein negativer Rand liest dieselbe Variable. Setzen Sie den Innenabstand deshalb hierüber und nicht mit padding. | 1rem |
--wpcars24-shadow | Schatten der Karte beim Überfahren mit der Maus; none schaltet ihn ab | 0 .25rem 1rem in Schwarz, 10 % deckend |
--wpcars24-gallery-height | Höhe der Bühne der Galerie; jedes Bild wird darin ganz gezeigt | min(70vh, 32rem) |
--wpcars24-thumb-width | Breite der Vorschaubilder unter der Galerie; die Höhe folgt im Verhältnis 4:3. Größer gestellt, passen Sie auch die Bildgrößen an. | 6rem |
--wpcars24-arrow-color | Farbe der Pfeile in der Galerie | Weiß |
--wpcars24-arrow-background | Hintergrund der Pfeile in der Galerie | Schwarz, 45 % deckend |
--wpcars24-arrow-background-hover | Hintergrund der Pfeile beim Überfahren mit der Maus | Schwarz, 70 % deckend |
Die Stylesheets lesen die Variablen nur und legen sie nirgends fest. Setzen Sie sie deshalb, wo Sie wollen, am einfachsten an :root:
:root { --wpcars24-radius: 0; --wpcars24-surface: transparent;}Ebenso gut an einem Bereich der Seite, etwa nur für die Liste auf der Startseite. Was Sie nicht setzen, behält seine Vorgabe.
Klassen
Section titled “Klassen”Die Klassen folgen dem Muster block__element--variante. Die wichtigsten:
| Bereich | Klassen |
|---|---|
| Liste | .wpcars24-vehicles (um alles, was [wpcars24_vehicles] ausgibt), .wpcars24-list, .wpcars24-list__item, .wpcars24-list__count, .wpcars24-list__empty |
| Blätterung | .wpcars24-list__pagination, .wpcars24-list__pages, .wpcars24-list__page, .wpcars24-list__page--current, .wpcars24-list__page--dots, .wpcars24-list__page--prev, .wpcars24-list__page--next |
| Filterformular | .wpcars24-filter, .wpcars24-filter__field, .wpcars24-filter__label, .wpcars24-filter__control, .wpcars24-filter__actions, .wpcars24-filter__submit, .wpcars24-filter__reset |
| Karte | .wpcars24-card, .wpcars24-card__media, .wpcars24-card__media-link, .wpcars24-card__image, .wpcars24-card__title, .wpcars24-card__title-link, .wpcars24-card__facts, .wpcars24-card__fact, .wpcars24-card__price, .wpcars24-card__price-amount, .wpcars24-card__price-tax, .wpcars24-card__emissions |
| Detailseite | .wpcars24-vehicle, .wpcars24-vehicle--page, .wpcars24-vehicle--selection, .wpcars24-vehicle--header, .wpcars24-vehicle--details, .wpcars24-vehicle__price, .wpcars24-vehicle__price-amount, .wpcars24-vehicle__price-tax, .wpcars24-vehicle__price-negotiable, .wpcars24-vehicle__source, .wpcars24-vehicle__source-link |
| Datenblatt | .wpcars24-vehicle__specs, .wpcars24-vehicle__spec, .wpcars24-vehicle__spec-label, .wpcars24-vehicle__spec-value, .wpcars24-vehicle__carpass-link und .wpcars24-vehicle__carpass-logo (das Logo des Car-Pass, in der Zeile mit der Variante carpass) |
| Abschnitte | .wpcars24-vehicle__section, .wpcars24-vehicle__heading, .wpcars24-vehicle__description, .wpcars24-vehicle__equipment, .wpcars24-vehicle__equipment-list, .wpcars24-vehicle__equipment-item, .wpcars24-vehicle__emissions |
| Verkäufer | .wpcars24-vehicle__seller, .wpcars24-vehicle__address, .wpcars24-vehicle__seller-name, .wpcars24-vehicle__seller-street, .wpcars24-vehicle__seller-city, .wpcars24-vehicle__seller-phone, .wpcars24-vehicle__seller-email |
| Galerie | .wpcars24-gallery, .wpcars24-gallery__stage, .wpcars24-gallery__slide, .wpcars24-gallery__picture, .wpcars24-gallery__image, .wpcars24-gallery__arrow, .wpcars24-gallery__arrow--prev, .wpcars24-gallery__arrow--next, .wpcars24-gallery__arrow-icon, .wpcars24-gallery__thumbs, .wpcars24-gallery__thumb, .wpcars24-gallery__thumb-image |
| Verbrauch und CO₂ | .wpcars24-emissions, .wpcars24-emissions--compact (Karte), .wpcars24-emissions--table (Detailseite), .wpcars24-emissions__row, .wpcars24-emissions__label, .wpcars24-emissions__value |
| Einzelne Shortcodes | .wpcars24-vehicle__media, .wpcars24-vehicle__image, .wpcars24-vehicle__location, .wpcars24-vehicle__link |
Die Blätterung behält zusätzlich die Klassen von WordPress (page-numbers, current, dots, prev, next). Gestaltet Ihr Theme die Blätterung anderer Listen darüber, sieht die Fahrzeugliste ebenso aus.
Woher ein Rahmen kommt
Section titled “Woher ein Rahmen kommt”.wpcars24-vehicle steht an jedem Rahmen um Abschnitte eines Fahrzeugs: an der ganzen Detailseite, an den beiden Hälften und an jedem einzeln gesetzten Abschnitt. Eine Regel nur mit dieser Klasse trifft deshalb alle. Die zweite Klasse sagt, woher der Rahmen kommt:
| Variante | Rahmen um |
|---|---|
.wpcars24-vehicle--page | die Abschnitte, die das Plugin an den Inhalt einer Fahrzeugseite hängt |
.wpcars24-vehicle--selection | die Ausgabe von [wpcars24_vehicle] |
.wpcars24-vehicle--header, .wpcars24-vehicle--details | die Ausgabe von [wpcars24_vehicle_header] und [wpcars24_vehicle_details] |
.wpcars24-vehicle--specs, .wpcars24-vehicle--envkv, .wpcars24-vehicle--equipment, .wpcars24-vehicle--gallery, .wpcars24-vehicle--description, .wpcars24-vehicle--seller | einen einzeln gesetzten Abschnitt, etwa [wpcars24_equipment] |
Ein Raster nur für die Detailseite trifft so keinen Abschnitt in einem Page Builder:
.wpcars24-vehicle--page { display: grid; grid-template-columns: 2fr 1fr;}Einzelne Felder ansprechen
Section titled “Einzelne Felder ansprechen”Zeilen, die nicht jedes Fahrzeug hat, tragen den Namen ihres Feldes als Variante. Der Name ist derselbe wie in fields= und bei den Shortcodes für Einzelwerte:
| Wo | Muster | Beispiele für den Feldnamen |
|---|---|---|
| Eckdaten der Karte | .wpcars24-card__fact--… | registration, mileage, power, fuel |
| Datenblatt | .wpcars24-vehicle__spec--… | mileage, carpass, power, accident_free, jeder Name aus fields= |
| Verbrauch und CO₂ | .wpcars24-emissions__row--… | consumption, consumption_city, co2, co2_class, range, standard |
| Filterformular | .wpcars24-filter__field--… | make, fuel, price_from, price_to, sort |
Fehlt eine Angabe, fällt ihre Zeile weg, und die übrigen rücken auf. Über die Position (nth-child) lässt sich eine bestimmte Zeile deshalb nicht zuverlässig treffen, über den Namen schon:
.wpcars24-vehicle__spec--mileage { font-weight: 700;}
.wpcars24-card__fact--fuel { display: none;}Die Optik abschalten
Section titled “Die Optik abschalten”Wer die Fahrzeuge vollständig selbst gestaltet, schaltet die Optik des Plugins (wpcars24-theme) über den Filter wpcars24_load_stylesheet ab. In die functions.php des Child-Themes:
add_filter( 'wpcars24_load_stylesheet', '__return_false' );Rahmen, Flächen, Rundungen, Innenabstände und Schriftgrößen des Plugins entfallen dann; Markup und Klassen bleiben. Das Grundgerüst (wpcars24-base) lädt weiter: Die Karten stehen im Raster, die Galerie blättert seitlich und rastet ein, die Bilder behalten ihr Format. Ebenso lädt das kleine Skript der Galerie; es gestaltet nichts, sondern hält Pfeile und Vorschaubilder bedienbar. Passen Sie danach auch die Bildgrößen an Ihr Raster an.
Wer auch das Grundgerüst nicht will, lässt WordPress seinen Verweis nicht ausgeben. Das wirkt im Kopf wie im Fuß der Seite, auch wenn ein Shortcode das Grundgerüst erst beim Ausgeben einreiht:
add_filter( 'style_loader_tag', function ( string $tag, string $handle ) { return 'wpcars24-base' === $handle ? '' : $tag; }, 10, 2);Dann übernimmt Ihr Theme auch das Raster und die Galerie. Ohne Snap und Überlauf stehen die Bilder der Galerie untereinander.