LUMA Theme – Handbuch & Dokumentation

Überblick

LUMA ist ein minimalistisches Premium-Theme für Shopware 6 – entwickelt für hochwertige Wohn-, Möbel- und Lifestyle-Shops. Ein ruhiges, inhaltsorientiertes Layout, selbstgehostete Schriften und ein vollständig konfigurierbares Farbsystem sorgen für einen edlen, markenkonformen Auftritt ohne Programmierung.

Im Funktionsumfang enthalten:

Farbsystem mit 7 Farbfeldern direkt in der Theme-Konfiguration
Selbstgehostete Schriften (Jost & Inter, SIL OFL) – DSGVO-konform, kein externes CDN
Fixierter Header mit Scroll-Schatten (abschaltbar)
Service-Leiste (Topbar) mit bis zu 4 Texten
Zahlungs-Icons im Footer und auf der Artikeldetailseite – je Zahlungsart einzeln schaltbar
Produkt-Badges (Versandkostenfrei / Lieferzeit) und Vertrauenssignale unter dem Kaufen-Button
Zusätzlicher Produkt-Tab mit frei befüllbarem HTML-Inhalt
Eigene CMS-Blöcke: Hero-Banner und Kategorie-Kacheln für die Erlebniswelten
Ein-Klick-Demodaten-Import – Produkte, Kategorien, Medien, gestaltete Startseite und fertige Footer-Navigation

Nach der Installation richtet der mitgelieferte Demodaten-Import auf Wunsch einen komplett gestalteten Beispielshop ein. So lässt sich das Theme sofort in voller Ausstattung kennenlernen – und der Import ist wiederholbar, ohne Duplikate anzulegen.

Overview

LUMA is a minimalist premium theme for Shopware 6 – built for high-quality home, furniture and lifestyle stores. A calm, content-first layout, self-hosted fonts and a fully configurable colour system deliver a refined, on-brand storefront without any coding.

What's included:

Colour system with 7 colour fields right in the theme configuration
Self-hosted fonts (Jost & Inter, SIL OFL) – GDPR compliant, no external CDN
Sticky header with scroll shadow (can be disabled)
Service bar (top bar) with up to 4 texts
Payment icons in the footer and on the product detail page – each method can be toggled individually
Product badges (free shipping / delivery time) and trust signals below the buy button
Additional product tab with freely editable HTML content
Custom CMS blocks: hero banner and category tiles for Shopping Experiences
One-click demo data import – products, categories, media, the designed homepage and a ready-made footer navigation

After installation, the bundled demo data import optionally sets up a fully designed example store. This lets you explore the theme in full right away – and the import is repeatable without creating duplicates.

Systemanforderungen

Komponente	Mindestversion	Empfohlen
Shopware	6.6.0	6.7.x
PHP	8.2	8.3
Composer	2.x	–

Composer-Paketname: yorg/yorg-luma. Das Theme funktioniert auf Shopware 6.6 und 6.7; die Administrations-Erweiterungen (Demodaten-Import, CMS-Blöcke) sind für beide Versionen mitgeliefert.

Requirements

Component	Minimum	Recommended
Shopware	6.6.0	6.7.x
PHP	8.2	8.3
Composer	2.x	–

Composer package name: yorg/yorg-luma. The theme runs on Shopware 6.6 and 6.7; the administration extensions (demo import, CMS blocks) ship for both versions.

Installation

Option A – Shopware Store

Im Shopware-Admin Erweiterungen → Store öffnen und nach LUMA suchen
Kaufen bzw. installieren
Unter Erweiterungen → Meine Erweiterungen das Theme aktivieren
Theme dem Verkaufskanal zuweisen (siehe unten)

Option B – ZIP hochladen

Erweiterungen → Meine Erweiterungen → Erweiterung hochladen wählen
Die LUMA-ZIP-Datei auswählen und hochladen
Installieren und aktivieren, anschließend Theme zuweisen

Die ZIP enthält die Demo-Medien und ist daher mehrere Megabyte groß. Schlägt der Upload mit „Parameter file is missing" fehl, sind die PHP-Limits zu klein. Hebe upload_max_filesize und post_max_size (z. B. auf 64M) sowie ggf. die nginx-Direktive client_max_body_size an.

Option C – Konsole (CLI)

cd /var/www/shopware/custom/plugins
unzip YorgLuma-1.0.0.zip
chown -R www-data:www-data YorgLuma/
php bin/console plugin:refresh
php bin/console plugin:install --activate YorgLuma
php bin/console theme:compile
php bin/console cache:clear

Theme zuweisen

Damit der Storefront das LUMA-Design verwendet, muss das Theme dem Verkaufskanal zugewiesen werden:

Zu Inhalte → Themes navigieren
Das LUMA-Theme auswählen und „Theme zuweisen" klicken
Den gewünschten Verkaufskanal wählen und speichern

Installation

Option A – Shopware Store

In the Shopware Admin open Extensions → Store and search for LUMA
Buy / install it
Under Extensions → My Extensions, activate the theme
Assign the theme to your sales channel (see below)

Option B – Upload ZIP

Choose Extensions → My Extensions → Upload extension
Select and upload the LUMA ZIP file
Install and activate it, then assign the theme

The ZIP bundles the demo media and is therefore several megabytes in size. If the upload fails with "Parameter file is missing", your PHP limits are too low. Raise upload_max_filesize and post_max_size (e.g. to 64M) and, if needed, the nginx directive client_max_body_size.

Option C – Console (CLI)

cd /var/www/shopware/custom/plugins
unzip YorgLuma-1.0.0.zip
chown -R www-data:www-data YorgLuma/
php bin/console plugin:refresh
php bin/console plugin:install --activate YorgLuma
php bin/console theme:compile
php bin/console cache:clear

Assign the theme

For the storefront to use the LUMA design, the theme must be assigned to the sales channel:

Navigate to Content → Themes
Select the LUMA theme and click "Assign theme"
Pick the desired sales channel and save

Demodaten importieren

LUMA bringt einen vollständigen Beispielshop mit. Nach der Aktivierung lässt er sich mit einem Klick importieren:

Im Admin zu Einstellungen → Plugins → LUMA Demodaten navigieren
Auf „Demodaten jetzt importieren" klicken
Der Fortschrittsbalken zeigt den Import in mehreren Schritten an

Importiert werden:

Medien (Produktbilder)
Eigenschaften und Varianten
Kategorien inkl. Navigation
Produkte (inkl. Varianten)
Gestaltete Startseite (Erlebniswelt mit Hero-Banner und Kategorie-Kacheln)
Fertige Footer-Navigation (Spalten „Rechtliches" und „Service" mit Links)

Der Import ist idempotent: Er kann beliebig oft ausgeführt werden, ohne Duplikate anzulegen. Alle Inhalte tragen feste Kennungen und werden bei einem erneuten Lauf aktualisiert.

Alternativ per Konsole:

php bin/console yorg-luma:install-demo-data

Mit der Option --no-assign wird das bestehende Home-Layout des Verkaufskanals nicht überschrieben.

Demo data import

LUMA ships with a complete example store. After activation you can import it with a single click:

In the Admin, navigate to Settings → Plugins → LUMA Demo data
Click "Import demo data now"
A progress bar shows the import running through several steps

The import includes:

Media (product images)
Properties and variants
Categories incl. navigation
Products (incl. variants)
A designed homepage (Shopping Experience with hero banner and category tiles)
A ready-made footer navigation ("Legal" and "Service" columns with links)

The import is idempotent: it can be run any number of times without creating duplicates. All content carries fixed identifiers and is updated on a re-run.

Alternatively via console:

php bin/console yorg-luma:install-demo-data

With the --no-assign option, the sales channel's existing home layout is not overwritten.

Theme-Konfiguration

Alle Optionen befinden sich im Admin unter Inhalte → Themes → LUMA → Bearbeiten. Nach dem Speichern wird das Theme automatisch neu kompiliert.

Logo & Farben

Feld	Beschreibung
Logo	Separate Logos für Desktop, Tablet und Mobil
Primärfarbe	Überschriften und Buttons (Standard: Anthrazit)
Akzentfarbe	Hover-Effekte und Icons (Standard: Taupe)
Seitenhintergrund	Grundfarbe der Seite
Heller / Dezenter Hintergrund	Bereiche, Service-Leiste, Cards und Bildflächen
Fließtext- & Rahmenfarbe	Textfarbe und Linien/Rahmen

Layout & Funktionen

Option	Beschreibung
Fixierter Header	Header bleibt beim Scrollen sichtbar (mit Schatten)
Kaufen-Button bei Hover	Im Listing erscheint der Kaufen-Button erst beim Überfahren (Desktop)
Service-Leiste	Bis zu 4 Texte in der Topbar, je einzeln schaltbar
Produkt-Badges	„Versandkostenfrei" / Lieferzeit-Hinweise
Vertrauenssignale	Bis zu 3 Texte unter dem Kaufen-Button (z. B. „Kostenloser Rückversand")
Zusätzlicher Produkt-Tab	Eigener Tab mit Bezeichnung und frei befüllbarem HTML-Inhalt
Zahlungs-Icons	Im Footer und/oder auf der Artikeldetailseite – je Zahlungsart (Visa, Mastercard, PayPal, Klarna, SEPA u. v. m.) einzeln aktivierbar

Tipp: Die Farben sind als zusammenhängendes System angelegt. Es genügt meist, Primär- und Akzentfarbe an Ihre Marke anzupassen – die übrigen Flächen bleiben harmonisch.

Theme configuration

All options live in the Admin under Content → Themes → LUMA → Edit. After saving, the theme is recompiled automatically.

Logo & colours

Field	Description
Logo	Separate logos for desktop, tablet and mobile
Primary colour	Headlines and buttons (default: anthracite)
Accent colour	Hover effects and icons (default: taupe)
Page background	Base colour of the page
Light / Subtle background	Sections, service bar, cards and image areas
Body text & border colour	Text colour and lines/borders

Layout & features

Option	Description
Sticky header	Header stays visible while scrolling (with shadow)
Buy button on hover	In the listing, the buy button appears on hover (desktop)
Service bar	Up to 4 texts in the top bar, each toggled individually
Product badges	"Free shipping" / delivery-time hints
Trust signals	Up to 3 texts below the buy button (e.g. "Free returns")
Additional product tab	Custom tab with a label and freely editable HTML content
Payment icons	In the footer and/or on the product detail page – each method (Visa, Mastercard, PayPal, Klarna, SEPA and more) can be toggled individually

Tip: The colours form a coherent system. Usually it's enough to adapt the primary and accent colour to your brand – the remaining surfaces stay harmonious.

CMS-Blöcke

LUMA erweitert den Erlebniswelten-Editor um zwei theme-eigene Blöcke. Sie finden sich im Block-Auswahldialog in der Kategorie „LUMA".

LUMA Hero Banner

Ein ruhiger, vollflächiger Banner mit Hintergrundbild, Überschrift und dezentem Button – ideal als erster Eindruck der Startseite.

Hintergrundbild für Desktop und (optional) Mobil
Überschrift, Button-Text und Button-Link
Sanfte Einblend-Animation, automatisch responsiv

LUMA Kategorie-Kacheln

Ein Raster aus drei Kacheln, um Hauptkategorien stilvoll in Szene zu setzen („Nach Kategorie entdecken").

Je Kachel: Bild, Bezeichnung und Link zur Kategorie
Einheitliche Höhe, Hover-Effekt mit eingeblendetem Button

Verwendung

Zu Inhalte → Erlebniswelten wechseln und eine Seite öffnen oder neu anlegen
Auf „Block hinzufügen" klicken und die Kategorie „LUMA" wählen
Den gewünschten Block einfügen und im rechten Panel Bilder, Texte und Links konfigurieren

Der Demodaten-Import setzt beide Blöcke bereits beispielhaft auf der Startseite ein – eine gute Vorlage zum Anpassen.

CMS blocks

LUMA adds two theme-specific blocks to the Shopping Experiences editor. You'll find them in the block picker under the category "LUMA".

LUMA Hero Banner

A calm, full-width banner with a background image, headline and subtle button – perfect as the first impression of the homepage.

Background image for desktop and (optionally) mobile
Headline, button text and button link
Gentle fade-in animation, automatically responsive

LUMA Category Tiles

A grid of three tiles to showcase your main categories in style ("Shop by category").

Per tile: image, label and link to the category
Uniform height, hover effect with a fading-in button

How to use

Go to Content → Shopping Experiences and open or create a page
Click "Add block" and choose the category "LUMA"
Insert the desired block and configure images, texts and links in the right-hand panel

The demo data import already places both blocks on the homepage as examples – a great template to adapt.

Footer-Navigation

Die Linkspalten im Footer werden aus der Footer-Navigation gespeist, die unter Einstellungen → Footer-Navigation konfiguriert wird. Aufbau:

Die direkten Unterkategorien der Footer-Wurzel werden zu den Spaltenüberschriften.
Deren Unterkategorien werden zu den Links innerhalb der Spalte.

Ist keine Footer-Navigation konfiguriert, bleiben die Spalten leer (Shopware-Standardverhalten).

Der Demodaten-Import richtet bereits eine fertige Footer-Navigation ein (Spalten „Rechtliches" und „Service") und weist sie dem Verkaufskanal zu – so ist direkt nach dem Import ein vollständig aufgebauter Footer vorhanden, den Sie nur noch an Ihre Inhalte anpassen.

Footer navigation

The footer link columns are populated from the footer navigation configured under Settings → Footer navigation. Structure:

The direct sub-categories of the footer root become the column headlines.
Their sub-categories become the links within the column.

If no footer navigation is configured, the columns simply stay empty (standard Shopware behaviour).

The demo data import already sets up a ready-made footer navigation ("Legal" and "Service" columns) and assigns it to the sales channel – so a fully built footer is present right after the import, ready for you to adapt to your own content.

E-Mail-Templates

LUMA enthält gebrandete E-Mail-Vorlagen im LUMA-Design für Registrierung, Bestellbestätigung und Versandbenachrichtigung – jeweils in Deutsch und Englisch.

Installation per Konsole:

php bin/console yorg-luma:install-mail-templates

Für den tatsächlichen Versand muss im Shop ein Mail-Transport (SMTP) eingerichtet sein und der Message-Queue-Worker laufen. Beides ist unabhängig vom Theme und gehört zur allgemeinen Shop-Konfiguration.

Email templates

LUMA includes branded email templates in the LUMA design for registration, order confirmation and shipping notification – each in German and English.

Install via console:

php bin/console yorg-luma:install-mail-templates

For actual delivery, a mail transport (SMTP) must be configured in the shop and the message queue worker must be running. Both are independent of the theme and part of the general shop configuration.

Produkt-Zusatzfelder

Bei der Installation registriert LUMA zusätzliche Produktfelder, die das Theme im Storefront darstellt:

Produktvorteile – kurze Pluspunkte, die am Produkt hervorgehoben werden
Badges – Hinweise wie Versandkostenfrei oder Lieferzeit
Zusätzlicher Tab – produktspezifischer HTML-Inhalt

Die Felder werden je Produkt im Reiter „Zusatzfelder" gepflegt. Sollten sie einmal fehlen, lassen sie sich erneut registrieren:

php bin/console yorg-luma:install-fields

Beim Deinstallieren des Themes werden die Felder wieder entfernt – sofern nicht „Benutzerdaten behalten" gewählt wurde.

Product custom fields

On installation, LUMA registers additional product fields that the theme renders in the storefront:

Product benefits – short selling points highlighted on the product
Badges – hints such as free shipping or delivery time
Additional tab – product-specific HTML content

The fields are edited per product in the "Custom fields" tab. Should they ever be missing, they can be re-registered:

php bin/console yorg-luma:install-fields

When the theme is uninstalled, the fields are removed again – unless "keep user data" was selected.

FAQ

Kann ich den Demodaten-Import gefahrlos mehrfach ausführen?

Ja. Der Import ist idempotent – er legt keine Duplikate an und aktualisiert bestehende Beispielinhalte.

Lädt das Theme Schriften von externen Servern?

Nein. Jost und Inter werden lokal mit dem Theme ausgeliefert. Es werden keine Daten an Google Fonts o. Ä. übertragen – DSGVO-konform.

Funktioniert LUMA mit anderen Plugins?

Ja. LUMA nutzt Shopwares Standard-Mechanismen. Plugins wie CMS Erlebniswelten Pro oder Zahlungsanbieter sind kompatibel.

Das Demo-Menü erscheint nach der Installation nicht – was tun?

Den Admin einmal vollständig neu laden (Hard-Refresh) bzw. kurz aus- und wieder einloggen. Bei Bedarf php bin/console cache:clear ausführen.

Wie aktualisiere ich das Theme?

Über den Shopware Store bzw. erneutes Hochladen der ZIP. Nach dem Update wird das Theme neu kompiliert; ein cache:clear stellt sicher, dass alle Änderungen greifen.

FAQ

Can I run the demo data import multiple times safely?

Yes. The import is idempotent – it creates no duplicates and updates existing example content.

Does the theme load fonts from external servers?

No. Jost and Inter are shipped locally with the theme. No data is sent to Google Fonts or similar – GDPR compliant.

Does LUMA work with other plugins?

Yes. LUMA uses Shopware's standard mechanisms. Plugins such as CMS Erlebniswelten Pro or payment providers are compatible.

The demo menu doesn't appear after installation – what should I do?

Fully reload the Admin (hard refresh) or log out and back in. If needed, run php bin/console cache:clear.

How do I update the theme?

Via the Shopware Store or by re-uploading the ZIP. After the update the theme is recompiled; a cache:clear ensures all changes take effect.

Support

Fragen, Anpassungswünsche oder individuelle Erweiterungen? Das Synervia-Team hilft gern weiter.

E-Mail: info@synervia.de
Live-Demo: luma.synervia.de
Support-Seite: synervia.de/support

Support

Questions, customisation requests or individual extensions? The Synervia team is happy to help.

Email: info@synervia.de
Live demo: luma.synervia.de
Support page: synervia.de/support