Theme-Selektoren
Alle Selektoren, mit denen die App Elemente in Ihrem Theme findet, und die zwei Möglichkeiten, einen davon zu ändern.
Die App findet Ihr Produktformular, den Preis, die Variantenauswahl und die Warenkorbpositionen über CSS-Selektoren. Sie bringt für jedes unterstützte Theme einen abgestimmten Satz mit und für alle anderen einen breiten Standardsatz. Deshalb funktioniert sie in den meisten Themes ohne Hilfe.
Ein stark angepasstes Theme kann trotzdem etwas an einer Stelle platzieren, die die Standardwerte nicht erreichen. Es gibt zwei Möglichkeiten, das zu beheben, und die erste ist fast immer die bessere.
1. Das eigene Attribut der App hinzufügen
Fast jeder Selektor beginnt mit einem data-gpo-…-Attribut, das ausschließlich als Ansatzpunkt für Sie existiert. Setzen Sie dieses Attribut auf das Element in Ihrem Theme, und die App findet es – ohne Selektor, den Sie pflegen müssen, und ohne etwas, das ein Theme-Update umbenennen kann.
<form action="/cart/add" method="post" data-gpo-product-form> … <button type="submit" data-gpo-product-atc>Add to cart</button></form>Das Attribut für jeden Selektor finden Sie in den Tabellen unten.
2. Den Selektor überschreiben
Verwenden Sie diese Möglichkeit, wenn Sie das Markup nicht bearbeiten können – ein Abschnitt, den Sie nicht kontrollieren, oder eine App, die das Formular rendert. Legen Sie die Werte fest, bevor das Skript der App läuft, in theme.liquid oberhalb von </body>:
<script> window.GPOConfigs = window.GPOConfigs || {}; window.GPOConfigs.theme = window.GPOConfigs.theme || {}; window.GPOConfigs.theme.product = { ...(window.GPOConfigs.theme.product || {}), form: ['#my-product-form'], addToCartButton: '.my-atc-button' };</script>Ihre Werte werden mit denen der App zusammengeführt, sodass Sie nur die Schlüssel überschreiben, die Sie angeben.
product
Wird auf Produktseiten verwendet und in Abschnitten mit hervorgehobenen Produkten auf anderen Seiten.
| Schlüssel | Attribut-Hook | Was die App damit tut |
|---|---|---|
form | data-gpo-product-form | Das Produktformular. Es ist der Anker für alles andere – die Optionen werden darin gerendert und beim Absenden geprüft. Nimmt ein Array an, das der Reihe nach durchprobiert wird |
addToCartButton | data-gpo-product-atc | Die Schaltfläche „In den Warenkorb“. Wird verwendet, um das Widget darüber zu platzieren und das Absenden zu blockieren, wenn die Prüfung fehlschlägt |
paymentButton | — | Die Schaltfläche für beschleunigte Zahlung. Wird bei Produkten mit Optionen ausgeblendet, weil sie das Formular überspringen würde |
quantity | — | Das Mengenfeld. Wird ausgelesen, damit Add-on-Mengen der Menge des Hauptprodukts folgen können |
unitPrice | data-gpo-product-unit-price | Der angezeigte Preis. Wird umgeschrieben, wenn der Kunde Optionen mit Preis wählt |
compareAtPrice | data-gpo-product-compare-at-price | Der Vergleichspreis, der zusammen damit aktualisiert wird |
variantSelector | data-gpo-product-variant-selector | Das versteckte Eingabefeld mit der ID der gewählten Variante. Wird ausgelesen, um zu erkennen, welche Variante ausgewählt ist |
variantActivator | data-gpo-product-variant-activator | Die Bedienelemente, die der Kunde anklickt, um die Variante zu wechseln. Werden überwacht, damit Variantenbedingungen reagieren können |
variantWrapper | data-gpo-product-variant-wrapper | Der Block mit der Variantenauswahl. Wird verwendet, um das Widget relativ dazu zu positionieren |
imageContainer | data-gpo-product-image-container | Der Hauptbildbereich. Hier zeichnet der Personalisierer seine Live-Vorschau |
image | data-gpo-product-image | Das Hauptproduktbild selbst |
images | data-gpo-product-images | Die Galeriebilder, für die Einstellung Anwenden auf der Vorschau |
imageButton | data-gpo-product-image-button | Die Galerie-Miniaturansichten oder -Pfeile. Werden überwacht, damit die Vorschau dem angezeigten Bild folgt |
sticky.atcButton | data-gpo-sticky-atc | Die Schaltfläche „In den Warenkorb“ in einer Sticky-Leiste, damit sie wie die eigentliche Schaltfläche prüft |
sticky.variantActivator | data-gpo-sticky-variant-activator | Das Variantenbedienelement in einer Sticky-Leiste |
collection
Wird für Schnellansicht-Pop-ups auf Kollektionsseiten verwendet.
| Schlüssel | Attribut-Hook | Was die App damit tut |
|---|---|---|
wrapper | data-gpo-collection-wrapper | Der Kollektionsabschnitt, also der Bereich, den die App überwacht |
item | data-gpo-collection-item | Eine Produktkarte darin |
productLink | data-gpo-collection-productLink | Der Link zum Produkt. Wird ausgelesen, um zu erkennen, zu welchem Produkt eine Karte gehört |
quickViewActivator | data-gpo-collection-qvActivator | Das Bedienelement, das die Schnellansicht öffnet. Wird überwacht, damit die App weiß, wann sie rendern muss |
quickViewProductForm | data-gpo-collection-qvForm | Das Produktformular in der Schnellansicht, in das die Optionen eingefügt werden |
cart
Wird auf der Warenkorbseite und in der Warenkorb-Schublade verwendet, um Optionen zu bearbeiten und Add-on-Positionen mit ihrem übergeordneten Artikel verknüpft zu halten.
| Schlüssel | Attribut-Hook | Was die App damit tut |
|---|---|---|
form | data-gpo-cart-form | Das Warenkorbformular. Nimmt ein Array an, das der Reihe nach durchprobiert wird |
page | siehe unten | Wie eine Artikelposition auf der Warenkorbseite ausgelesen wird. Nimmt ein Array von Strukturen an, das der Reihe nach durchprobiert wird |
drawer | siehe unten | Dasselbe für die Warenkorb-Schublade |
page und drawer enthalten jeweils ein lineItem, das die Teile einer Warenkorbzeile beschreibt:
| Teil | Attribut-Hook (Warenkorbseite) | Was es ist |
|---|---|---|
key | data-gpo-cart-item-key | Die Zeile selbst, die den Schlüssel der Artikelposition trägt |
image | data-gpo-cart-item-image | Die Miniaturansicht der Zeile |
details | data-gpo-cart-item-details | Der Block mit Titel und Eigenschaften, in dem Optionen bearbeiten hinzugefügt wird |
quantity.wrapper | data-gpo-cart-item-qty-wrapper | Das Mengenbedienelement, das bei Add-on-Positionen ausgeblendet wird |
quantity.input | data-gpo-cart-item-qty | Das Mengenfeld |
quantity.decrease / increase | data-gpo-cart-item-qty-decrease / -increase | Die Minus- und Plus-Schaltflächen |
removeButton | data-gpo-cart-item-remove-button | Der Entfernen-Link, der bei Add-on-Positionen ausgeblendet wird |
Die Schublade verwendet dieselben Teile mit data-gpo-drawer-item-… statt data-gpo-cart-item-….
Hinweise
- Schlüssel, die ein Array annehmen, werden der Reihe nach durchprobiert, und der erste Treffer gilt. Sie können Ihre Selektoren also vor den Standardwerten einfügen, statt diese zu ersetzen.
- Das Überschreiben eines Selektors ändert nur, wo die App sucht. Es ändert nicht, was die Optionen erfassen oder wie sie berechnet werden.
- Eine Überschreibung gilt für jede Produktseite des Shops. Um ein einzelnes Produkt anzusprechen, grenzen Sie es im Selektor selbst ein.
War diese Seite hilfreich?
Danke für Ihr Feedback! Sagen Sie uns, was gefehlt hat
Problem melden