Custom CSS & Custom JavaScript
Beschreibung
Highlights
Über die Erweiterung
Eigenes CSS und eigenes JavaScript in Containern
Mit „CSS und JS hinzufügen“ bekommst du die Seite „CSS/JS Container“ unter Erweiterungen > Add CSS/JS. Dort sammelst du deinen Code in Containern: Jeder hat einen Namen, ein Code-Feld „CSS/SCSS“, ein Code-Feld „JavaScript“ und die Checkbox „Aktiv“, und nur aktive Container erreichen die Storefront.
- Ein Container ohne ausgewählten Verkaufskanal gilt für alle, und die Liste zeigt „alle“
- Wähle Verkaufskanäle, um einen Container auf sie zu begrenzen
- Die Liste zeigt Name, Status, Verkaufskanäle und Seiteneinschränkung deiner Container
- Mehrere aktive Container werden alphabetisch nach ihren Namen zusammengeführt
So wird eigenes CSS Teil deines Themes
Bei einer Theme-Kompilierung wird das eigene CSS der aktiven Container an die Styles deines Themes angehängt und zusammen mit dessen SCSS kompiliert. Du kannst also SCSS schreiben und die Variablen deines Themes nutzen.
- „SCSS Variable hinzufügen“ fügt eine von 135 Theme-Variablen, etwa $primary, $border-radius oder $font-family-base, an der Cursorposition ein
- Ein Farbwähler fügt einen Hex-Code an der Cursorposition ein
- „Speichern & Kompilieren“ speichert den Container und kompiliert die Themes deiner Verkaufskanäle, mit „Speichern“ allein gespeicherte Änderungen kommen mit der nächsten Theme-Kompilierung in der Storefront an
- Das Löschen eines Containers in der Liste kompiliert die Themes ebenfalls neu
Eigenes JavaScript mit mitgelieferten Bibliotheken
Das eigene JavaScript der aktiven Container wird bei der Kompilierung in eine eigene Skriptdatei des Themes geschrieben, und die Storefront lädt sie zusammen mit dem Theme.
- Beide Code-Felder nutzen einen Code-Editor mit Syntaxhervorhebung für CSS und JavaScript
- „JavaScript Bibliothek hinzufügen“ setzt eine library-Zeile, zum Beispiel library(jquery);, an den Anfang deines Codes
- Beim Kompilieren wird diese Zeile durch die mitgelieferte Bibliothek ersetzt, die einmal am Anfang der Skriptdatei steht, außerhalb der Einwilligungs- und Seitenprüfung
- Zur Auswahl stehen Cesium JS, D3, Dojo, Ext Core, Hammer JS, jQuery, List JS und Model Viewer
Eigenes CSS und eigenes JavaScript auf ausgewählte Seiten begrenzen
In der Karte „Seiteneinschränkung“ wählst du unter „Ausliefern“: „Auf allen Seiten“ (Standard), „Nur auf ausgewählten Seiten“ oder „Auf allen Seiten außer den ausgewählten“. Eine Seite gilt als ausgewählt, sobald ein Kriterium zutrifft:
- Seitentypen, insgesamt 17, etwa Startseite, Kategorie-Listing, Produktdetailseite, Suchergebnisse, Warenkorb und Kontoseiten
- URLs mit * als Platzhalter, zum Beispiel /aktion/* oder *sale*
- Detailseiten ausgewählter Produkte (ein Hauptprodukt umfasst auch seine Varianten), Listing-Seiten ausgewählter Kategorien samt Unterkategorien (abschaltbar, standardmäßig aktiv) und Landingpages
- Eingeschränktes CSS greift über eine Klasse am body-Element (@font-face, @keyframes und @include-Blöcke auf oberster Ebene bleiben global), und eingeschränktes JavaScript läuft nur auf passenden Seiten
- Neue Kriterien wirken sofort, ein neuer Auslieferungsmodus braucht dagegen eine Theme-Kompilierung
Eigenes JavaScript erst nach Cookie-Einwilligung
In der Karte „Cookie-Einwilligung“ kannst du ein „Erforderliches Cookie“ eintragen. Das eigene JavaScript des Containers läuft dann erst, wenn dieses Cookie mit einem Wert vorhanden ist, und es kann direkt nach der Zustimmung starten, ohne dass die Seite neu geladen werden muss.
- Optional: „Im Cookie-Consent-Manager registrieren“ zeigt den Container unter seinem Namen als eigenen Eintrag in der Gruppe „Individuelle Inhalte“ des Cookie-Consent-Managers der Storefront
- Bei Zustimmung wird das Cookie mit dem Wert 1 für 30 Tage gesetzt
- Ohne diese Option läuft das JavaScript nur, wenn ein anderes Tool das Cookie mit einem Wert setzt (spätestens beim nächsten Seitenaufruf)
- Das eigene CSS eines Containers ist nicht an die Einwilligung gebunden und wird immer geladen
Versionshistorie für eigenes CSS und eigenes JavaScript
Speicherst du Änderungen an einem Container, wird sein Stand mit Datum, Name und Benutzer in der Karte „Versionshistorie“ abgelegt. Pro Container bleiben die letzten 20 Versionen erhalten.
- „Wiederherstellen“ lädt eine Version in die Felder, in der Storefront kommt sie nach Speichern und Kompilieren an
- Eine Version umfasst den Namen, den Code, den Status, die Seiteneinschränkung und die Cookie-Einstellungen, aber nicht die Verkaufskanäle
- Ohne Benutzer gespeicherte Stände, etwa von einer Integration über die API, erscheinen als „Unbekannt“
Berechtigungen für eigenes CSS und eigenes JavaScript
Die Berechtigung „Add CSS/JS“ hat in den Rollen die Stufen Ansehen, Bearbeiten, Erstellen und Löschen.
- Ansehen: Container und ihre Versionshistorie durchsehen
- Bearbeiten: Container ändern und Versionen wiederherstellen
- Erstellen: neue Container anlegen (schließt Bearbeiten ein)
- Löschen: Container in der Liste entfernen
Details
- Verfügbar in: Englisch, Deutsch
- Zuletzt aktualisiert: 18. November 2026
- Veröffentlicht: 20. August 2024
- Version: 2.1.0
- Kategorie: Sonderfunktionen
Ressourcen
Bewertungen (3)
Super Plugin
Einfacher geht nicht
Super Plugin
Über den Extension Partner
weedesign
Partner Status
-
Shopware
Extension Partner
Details
- Ø-Bewertung: 4.9
- Partner seit: 2019
- Erweiterungen: 71
Support
- Land: Germany
- Spricht: Deutsch, Englisch
- Reaktionszeit: Sehr schnell