Zum Inhalt springen
App installieren
Deutsch

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üsselAttribut-HookWas die App damit tut
formdata-gpo-product-formDas 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
addToCartButtondata-gpo-product-atcDie 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
unitPricedata-gpo-product-unit-priceDer angezeigte Preis. Wird umgeschrieben, wenn der Kunde Optionen mit Preis wählt
compareAtPricedata-gpo-product-compare-at-priceDer Vergleichspreis, der zusammen damit aktualisiert wird
variantSelectordata-gpo-product-variant-selectorDas versteckte Eingabefeld mit der ID der gewählten Variante. Wird ausgelesen, um zu erkennen, welche Variante ausgewählt ist
variantActivatordata-gpo-product-variant-activatorDie Bedienelemente, die der Kunde anklickt, um die Variante zu wechseln. Werden überwacht, damit Variantenbedingungen reagieren können
variantWrapperdata-gpo-product-variant-wrapperDer Block mit der Variantenauswahl. Wird verwendet, um das Widget relativ dazu zu positionieren
imageContainerdata-gpo-product-image-containerDer Hauptbildbereich. Hier zeichnet der Personalisierer seine Live-Vorschau
imagedata-gpo-product-imageDas Hauptproduktbild selbst
imagesdata-gpo-product-imagesDie Galeriebilder, für die Einstellung Anwenden auf der Vorschau
imageButtondata-gpo-product-image-buttonDie Galerie-Miniaturansichten oder -Pfeile. Werden überwacht, damit die Vorschau dem angezeigten Bild folgt
sticky.atcButtondata-gpo-sticky-atcDie Schaltfläche „In den Warenkorb“ in einer Sticky-Leiste, damit sie wie die eigentliche Schaltfläche prüft
sticky.variantActivatordata-gpo-sticky-variant-activatorDas Variantenbedienelement in einer Sticky-Leiste

collection

Wird für Schnellansicht-Pop-ups auf Kollektionsseiten verwendet.

SchlüsselAttribut-HookWas die App damit tut
wrapperdata-gpo-collection-wrapperDer Kollektionsabschnitt, also der Bereich, den die App überwacht
itemdata-gpo-collection-itemEine Produktkarte darin
productLinkdata-gpo-collection-productLinkDer Link zum Produkt. Wird ausgelesen, um zu erkennen, zu welchem Produkt eine Karte gehört
quickViewActivatordata-gpo-collection-qvActivatorDas Bedienelement, das die Schnellansicht öffnet. Wird überwacht, damit die App weiß, wann sie rendern muss
quickViewProductFormdata-gpo-collection-qvFormDas 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üsselAttribut-HookWas die App damit tut
formdata-gpo-cart-formDas Warenkorbformular. Nimmt ein Array an, das der Reihe nach durchprobiert wird
pagesiehe untenWie eine Artikelposition auf der Warenkorbseite ausgelesen wird. Nimmt ein Array von Strukturen an, das der Reihe nach durchprobiert wird
drawersiehe untenDasselbe für die Warenkorb-Schublade

page und drawer enthalten jeweils ein lineItem, das die Teile einer Warenkorbzeile beschreibt:

TeilAttribut-Hook (Warenkorbseite)Was es ist
keydata-gpo-cart-item-keyDie Zeile selbst, die den Schlüssel der Artikelposition trägt
imagedata-gpo-cart-item-imageDie Miniaturansicht der Zeile
detailsdata-gpo-cart-item-detailsDer Block mit Titel und Eigenschaften, in dem Optionen bearbeiten hinzugefügt wird
quantity.wrapperdata-gpo-cart-item-qty-wrapperDas Mengenbedienelement, das bei Add-on-Positionen ausgeblendet wird
quantity.inputdata-gpo-cart-item-qtyDas Mengenfeld
quantity.decrease / increasedata-gpo-cart-item-qty-decrease / -increaseDie Minus- und Plus-Schaltflächen
removeButtondata-gpo-cart-item-remove-buttonDer 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?

Problem melden