WooCommerce-Styles im eigenen Theme steuern

WooCommerce bringt Styles für klassische Shopseiten und moderne Blöcke mit. Ein eigenes Theme verteilt die Gestaltung zwischen WooCommerce, theme.json und projektspezifischem CSS.

3 Min. von Matthias Ulrich

WooCommerce stellt Layout- und Komponentenstile für Shopseiten, Formulare und Hinweise bereit. Ein individuell entwickeltes WordPress-Theme verbindet Farben, Typografie, Abstände und Bedienelemente zu einem Gestaltungssystem für Shop und Website.

Die Gestaltung entsteht aus dem Zusammenspiel beider Ebenen. Klassische Stylesheets betreffen PHP-basierte Shopansichten, während moderne WooCommerce-Blöcke eigene blockbezogene Styles verwenden.

Klassische Shopansichten im Theme gestalten

Der Filter woocommerce_enqueue_styles enthält die klassischen Stylesheets woocommerce-general, woocommerce-layout und woocommerce-smallscreen. Einzelne Dateien lassen sich aus diesem Array entfernen:

function ud_filter_woocommerce_styles( $styles ) {
	unset( $styles['woocommerce-layout'] );
	unset( $styles['woocommerce-smallscreen'] );

	return $styles;
}

add_filter( 'woocommerce_enqueue_styles', 'ud_filter_woocommerce_styles' );

In diesem Beispiel bleibt das allgemeine WooCommerce-Stylesheet aktiv. Das Theme übernimmt Layout und responsive Anpassung. So lassen sich die Zuständigkeiten zwischen Shop-Funktionen und Designsystem aufteilen.

Gestaltet das Theme sämtliche klassischen Shopansichten, kann es alle drei Dateien steuern:

add_filter( 'woocommerce_enqueue_styles', '__return_false' );

Diese Variante eignet sich für Themes, die Produktlisten, Formulare, Meldungen, Verfügbarkeiten und responsive Zustände vollständig gestalten. Die WooCommerce-Dateien bleiben im Plugin erhalten und werden mit dessen Updates verwaltet.

WooCommerce-Blöcke über Global Styles gestalten

Shop-Blöcke wie Warenkorb, Kasse oder Produktpreis verwenden eigene blockbezogene Styles. Der Filter woocommerce_enqueue_styles steuert diese Blöcke nicht. WooCommerce lädt ihre Styles dort, wo der jeweilige Block vorkommt.

Für Block-Themes bildet theme.json die erste Ebene der Gestaltung. Das folgende Beispiel verbindet den Produktpreis mit Farben und Typografie des Themes:

{
	"version": 3,
	"styles": {
		"blocks": {
			"woocommerce/product-price": {
				"color": {
					"text": "var:preset|color|text"
				},
				"typography": {
					"fontWeight": "600"
				}
			}
		}
	}
}

Global Styles gelten im Editor und im Frontend. Für Eigenschaften, die ein Block noch nicht über theme.json unterstützt, ergänzt das Theme eigenes CSS.

WooCommerce-Komponenten mit den Farben und Gestaltungsvorgaben eines eigenen WordPress-Themes.
Das eigene Theme verbindet WooCommerce-Elemente mit einem gemeinsamen Designsystem für Shop und Website.

Ergänzendes Shop-CSS laden

Umfangreichere Anpassungen lassen sich in einer eigenen Datei bündeln. Die Versionsnummer aus filemtime() lädt nach einer Änderung die aktuelle Fassung:

function ud_enqueue_woocommerce_styles() {
	$file = get_theme_file_path( 'assets/css/woocommerce.css' );

	if ( ! file_exists( $file ) ) {
		return;
	}

	wp_enqueue_style(
		'ud-woocommerce',
		get_theme_file_uri( 'assets/css/woocommerce.css' ),
		array(),
		filemtime( $file )
	);
}

add_action( 'wp_enqueue_scripts', 'ud_enqueue_woocommerce_styles', 20 );

Die separate Datei bildet eine Schnittstelle zwischen dem allgemeinen Theme und den Shop-Komponenten. In einem SCSS-Workflow kann sie auch Teil des regulären Frontend-Bundles sein.

Gestaltung nach Zuständigkeit organisieren

Klassische WooCommerce-Styles lassen sich über den dokumentierten Filter einzeln oder vollständig steuern. WooCommerce-Blöcke erhalten ihre grundlegenden Komponentenstile weiterhin vom Plugin. theme.json verbindet unterstützte Blöcke mit dem globalen Designsystem, während eigenes CSS projektspezifische Details und besondere Zustände ergänzt.

So bleibt die Gestaltung im Editor und auf der veröffentlichten Website konsistent.

Ergebnis

WooCommerce und Theme zu einem gemeinsamen Shop-Design verbinden

Klassische Shopansichten, WooCommerce-Blöcke und eigenes CSS erhalten klar abgegrenzte Aufgaben. Das Theme verbindet diese Ebenen mit seinem Designsystem.

Klassische Styles steuern

Der Filter bestimmt, welche WooCommerce-Dateien für PHP-basierte Shopansichten geladen werden.

Blöcke im Theme gestalten

theme.json verbindet unterstützte WooCommerce-Blöcke mit Farben und Typografie des Themes.

Shop-CSS ergänzen

Eine eigene Stylesheet-Datei bündelt Details, besondere Zustände und weitere Shop-Komponenten.