Zwei Wege, Personalisierung zu erfassen
Shopify besitzt das Storefront und den Checkout, daher wird die Eingabe über Shopify-native Mechanismen hinzugefügt. Wählen Sie einen Pfad.
- Line-Item-Eigenschaft — ein benutzerdefiniertes Feld auf der Produktseite. Funktioniert auf jedem Shopify-Plan. Erfordert eine kleine Theme-Bearbeitung.
- Checkout-UI-Erweiterung — ein benutzerdefinierter Block, der innerhalb des Checkouts gerendert wird. Nur Shopify Plus. Keine Theme-Bearbeitung, aber ein Entwickler stellt eine benutzerdefinierte App bereit.
Beide Methoden erzeugen das gleiche Ergebnis: eine an die Line-Item angehängte Eigenschaft. Solange sie Customization Request heißt, extrahiert Alva den Wert automatisch.
Methode 1 — Line-Item-Eigenschaft
1. Produkt-Vorlage öffnen
Wechseln Sie im Shopify-Admin zu Online-Shop → Themes, klicken Sie auf Code bearbeiten und öffnen Sie sections/main-product.liquid (oder product-template.liquid bei älteren Themes).
Shopify-Theme-Code-Editor. Zeigen Sie den Dateibaum links mit hervorgehobener main-product.liquid und die rechts geöffnete Liquid-Datei, gescrollt zum Produktformular-Block. Keine echten Shop-Daten sichtbar.
2. Eingabe innerhalb des Produktformulars hinzufügen
Fügen Sie innerhalb des {% form 'product' %}-Blocks ein Label und eine Texteingabe hinzu. Das name-Attribut muss die Klammer-Syntax properties[Customization Request] verwenden — das sagt Shopify, den Wert an die Line-Item anzuhängen.
<label for="customization">Personalisation request</label>
<input type="text"
id="customization"
name="properties[Customization Request]"
maxlength="200"
required>3. Pflicht- und Längen-Beschränkungen setzen
Fügen Sie required hinzu, sodass Kunden das Feld nicht leer lassen können, und maxlength="200", sodass sie keinen Absatz einfügen können. Halten Sie das Label konkret — Name zum Sticken schlägt Anpassung.
4. Speichern und eine Testbestellung aufgeben
Speichern Sie die Vorlage, sehen Sie das Produkt im Storefront, füllen Sie die Eingabe aus und geben Sie eine Testbestellung auf. Der Wert erscheint in Shopify unter Bestellung → Line-Items und innerhalb von Alva auf der personalisierten Bestelldetailseite.
Eine Produktseite im Storefront mit der Personalisierungs-Eingabe oberhalb der Schaltfläche In-den-Warenkorb gerendert. Feld beschriftet mit „Name zum Sticken“ mit einem Platzhalter-Beispiel. Kein echtes Shop-Branding nötig.
Methode 2 — Checkout-UI-Erweiterung
Plus-Händler können die Eingabe innerhalb des Checkouts selbst rendern. Alva Digital Downloads liefert diese Erweiterung nicht aus — sie zu bauen ist eine Shopify-Entwickler-Aufgabe. Siehe Shopifys Checkout-UI-Erweiterungs-Referenz für die aktuelle API.
1. Erweiterung scaffolden
Führen Sie aus einer benutzerdefinierten Shopify-App shopify app generate extension aus und wählen Sie Checkout UI extension. Wählen Sie das Ziel purchase.checkout.block.render.
2. Line-Item-Eigenschaft schreiben
Verwenden Sie die Line-Item-Eigenschafts-API aus @shopify/ui-extensions-react/checkout, um den Wert unter dem Schlüssel Customization Request an die Line-Item anzuhängen.
3. Bereitstellen und Block platzieren
Führen Sie shopify app deploy aus, dann legen Sie unter Einstellungen → Checkout → Anpassen den neuen Block in das Layout und geben Sie eine Testbestellung auf.
Wo der Wert in Alva erscheint
Wenn Shopify den orders/paid-Webhook auslöst, liest Alva jede Line-Item-Eigenschaft mit dem genauen Namen Customization Request und speichert sie am Kauf. Die personalisierte Bestelldetailseite rendert den Wert oberhalb des Datei-Uploaders, und derselbe Text ist in der Händler-Benachrichtigungs-E-Mail enthalten.
FAQ
Kann ich das Anpassungsfeld als Pflichtfeld setzen?
Ja. Fügen Sie das HTML-Attribut required hinzu. Shopify blockiert In-den-Warenkorb, bis das Feld einen Wert hat. Die Checkout-UI-Erweiterungs-Methode bietet eine required-Option in den Erweiterungs-Einstellungen.
Kann ich mehr als eine Eingabe pro Produkt erfassen?
Ja, aber Alva extrahiert nur die Eigenschaft mit dem Namen Customization Request automatisch. Andere Line-Item-Eigenschaften erscheinen weiterhin auf der Shopify-Bestellung und sind innerhalb von Alva auf der Bestelldetailseite sichtbar.
Kann der Kunde die Eingabe nach Bezahlung der Bestellung bearbeiten?
Nein. Line-Item-Eigenschaften sind unveränderlich, sobald die Bestellung aufgegeben wurde. Wenn eine Korrektur nötig ist, bitten Sie den Kunden, sie per E-Mail zu schicken, und aktualisieren Sie die Bestellnotizen manuell, bevor Sie die Datei hochladen.
Siehe auch
War das hilfreich?
Zuletzt aktualisiert 2026-05-06