setInternalProperties teilst du dem Warenkorb mit, dass sie eine Einheit sind.
Der Warenkorb gruppiert Positionen anhand von zwei kanonischen Properties. Er kennt die Property-Namen deiner Bundle-App nicht, du übersetzt also: Lies, was die App geschrieben hat, und stemple das kanonische Paar mit einer Line-Transform auf jede Position.
Diese laufen über
setInternalProperties, nicht über Shopify. Sie sind ein reines Render-Overlay: Sie erreichen nie properties, werden nie in Shopify gespeichert und erscheinen nie auf der Bestellung.
Jede Bundle-App benennt ihre Properties anders, beginne also mit einem Blick in einen echten Warenkorb. Füge in deinem Storefront ein Bundle hinzu und führe dann Folgendes in der Browser-Konsole aus:
_), die eine ID, eine Referenz oder den Namen des Bundles enthält. Typisch ist etwas wie _bundle_id, _bundle_ref oder _parent_id. Notiere dir den exakten Schlüssel und ob eine Position als Hauptprodukt markiert ist.
Füge Folgendes in Cart settings → Custom script → Initialization ein und ersetze die Property-Namen durch die, die du gefunden hast:
Wenn deine App kein Hauptprodukt markiert, lass
_aftersell_cart_bundle_role komplett weg. Der Warenkorb wählt dann einen Anker für dich.bundle-Objekt, und der Drawer rendert das Bundle als einen einzelnen Artikel:
- Kinder werden unter dem Anker verschachtelt, statt als separate Zeilen zu erscheinen.
- Die Menge ist atomar. Eine Änderung der Bundle-Menge skaliert alle Mitglieder gemeinsam, anhand des
perAnchorQty-Verhältnisses jedes Kindes — ein Bundle mit zwei Stück einer Komponente behält also dieses Zwei-zu-eins-Verhältnis. - Das Entfernen ist atomar. Das Entfernen des Bundles entfernt jede Mitgliedsposition in einem einzigen Request, statt verwaiste Komponenten zurückzulassen.
- Eine Preiszeile. Was sie zeigt, folgt der Bundle-Preis-Einstellung am Cart items-Block: die Summe aller Mitglieder oder nur der Preis des Hauptprodukts.
- Die Position mit
_aftersell_cart_bundle_roleaufparent. - Andernfalls das Mitglied mit dem höchsten Preis.
- Andernfalls das erste Mitglied im Warenkorb.
- Ein Bundle braucht mindestens zwei Positionen. Eine einzelne Position mit einer Bundle-ID bleibt unangetastet und rendert normal.
- Native Shopify-Bundles sind bereits abgedeckt. Positionen, die Shopify selbst als componentized markiert, werden von dieser Gruppierung übersprungen und automatisch angepasst. Du brauchst das nur für Apps, die separate Positionen hinzufügen.
- Die Transform läuft bei jedem Render. Halte sie günstig und frei von Nebeneffekten. Rufe darin keine Actions auf und mache keine Fetches.
- Das Mergen ist additiv. Deine Properties werden mit denen anderer Transforms zusammengeführt. Bei einem echten Konflikt um denselben Schlüssel gewinnt die zuletzt registrierte Transform.
- Die Gruppierung läuft nach dem Ausblenden und Umbenennen und vor dem Sortieren. Eine Position, die du mit
setHiddenausblendest, wird also nie Teil eines Bundles, und ein Comparator sieht den Anker, nicht die Kinder.
bundle.memberKeys, das den key jedes Mitglieds inklusive des Ankers enthält.
Bundle-Gruppierung ist der Zweck, für den setInternalProperties gebaut wurde, aber das Overlay ist ein allgemeiner Kanal für rein anzeigebezogene Daten, die du aus einer Position ableitest. Alles, was du dort ablegst, ist unter line.internalProperties und in einem Custom-Code-Block lesbar, ohne den echten Warenkorb anzufassen:
properties[...]-Input im Produktformular gesetzt wird, sodass sie Shopify erreichen, egal wer das Hinzufügen ausführt.
registerLineTransform: der Hook, über den das läuft.- Cart-Objekt: die Struktur von
bundleund seinen Kindern. - Cart-items-Block: die Bundle-Preis-Einstellung.