Shopify-Entwickler in Nürnberg

#Wenn ein Produkt mehr Wahlmöglichkeiten hat, als Shopify Varianten kennt

Ein Tisch in drei Hölzern, vier Größen und zwei Beinformen ergibt 24 Kombinationen. Kommt eine Gravur hinzu, ist die Zahl der Kombinationen praktisch unbegrenzt. Shopify behandelt beides unterschiedlich: Was Sie lagern, bepreisen und mit einer Artikelnummer verkaufen, gehört in Varianten. Was der Kunde frei eingibt, gehört an die Bestellposition. Diese Seite sortiert die Mittel dafür und nennt die Grenzen, so wie Shopify sie dokumentiert.

Hinter dieser Seite steht Mariusz Szatkowski, Einzelentwickler aus Gdynia, seit 2006 mit WordPress befasst. Die Zusammenarbeit läuft remote und schriftlich; Termine vor Ort und Telefonate gibt es nicht. Gestaltung, Mockups und Wireframes bringen Sie mit; ich setze sie als Theme um.

Foto: Fred Romero from Paris, France, CC BY 2.0, Wikimedia Commons.

#Die Grenzen bei Optionen und Varianten

Die Shopify-Hilfe zum Anlegen von Varianten nennt zwei Zahlen: Ein Produkt kann bis zu drei Optionen haben und bis zu 2.048 Varianten. Für die Zahl der Werte je Option nennt die Seite keine Grenze.

Zwei Hinweise aus derselben Quelle sind für die Planung wichtiger als die Zahlen:

• Einige Themes von Drittanbietern unterstützen laut Seite nicht mehr als 100 Varianten, und das gilt auch für manche Apps. Die Seite nennt Stocky und die frühere App Order Printer.
• Für mehr als drei Optionen oder mehr als 2.048 Varianten verweist die Seite auf Apps aus dem Shopify App Store, auf Anpassungen am Theme-Code und für Plus-Shops auf die App Combined Listings.

In der GraphQL Admin API tauchen die Grenzen als Felder des Shops auf: maxProductOptions und maxProductVariants. Die Dokumentation nennt keine Standardwerte. Lesen Sie die Werte Ihres Shops aus, bevor Sie ein Datenmodell festlegen, statt sich auf eine Zahl aus einem Blogbeitrag zu verlassen, auch aus diesem.

Die Obergrenze von 2.048 Varianten ist nicht dasselbe wie die Zahl, die ein Besucher noch bedienen kann. Ein Produkt mit 400 Varianten braucht einen Varianten-Wähler, der Nicht-Kombinationen ausblendet. Dieser Teil des Themes ist meist der, den ich zuerst anfasse.

#Combined Listings: mehrere Produkte unter einer Seite

Combined Listings fassen bestehende Produkte, die sich in einer Option unterscheiden, auf einer Produktseite zusammen. Jedes Kindprodukt behält Bilder, Handle und eigene Varianten. Das Elternprodukt wird beim Anlegen erzeugt.

Das Theme muss Combined Listings unterstützen, und das Elternprodukt muss veröffentlicht werden. Ein Händler mit einem Modell in vielen Ausführungen, die jeweils eigene Fotos und eine eigene Artikelnummer haben, kommt damit weiter als mit einer einzigen Variantenliste. Ein Shop ohne Plus-Tarif braucht einen anderen Weg.

#Metafelder und Metaobjekte für Produktdaten

Nicht jede Eigenschaft eines Produkts ist eine Option. Maße, Material, Pflegehinweise oder ein Prüfzeichen sind Daten, die der Kunde liest, aber nicht auswählt. Dafür gibt es Metafelder: Sie erweitern das Datenmodell der Plattform um eigene Angaben. Unterstützt Ihr Theme dynamische Quellen, lassen sich die meisten Metafelder im Theme-Editor anbinden. Bei älteren Themes oder nicht unterstützten Typen ist Theme-Code nötig.

Metaobjekte sind für Daten gedacht, die mehrere Felder haben. Die Definition legt die Struktur fest und lässt sich um Validierungsregeln wie Zeichenlimits, Mindest- und Höchstwerte oder vorgegebene Werte ergänzen. Die Einträge sind der Inhalt. Ein Metafeld kann auf ein Metaobjekt verweisen. Ein Beispiel: Eine Tabelle möglicher Materialien mit Name, Bild und Pflegehinweis liegt einmal als Metaobjekt vor, und jedes Produkt verweist darauf. Ändert sich ein Pflegehinweis, ändern Sie ihn an einer Stelle.

Das entlastet die Varianten: Was nur beschreibt, bleibt außerhalb der drei Optionen.

#Textfelder und Uploads: Line Item Properties

Will ein Kunde einen Namen oder einen Gravurtext angeben, passt keine Variante. Dafür gibt es Line Item Properties. Laut Dokumentation sind sie ein Name-Wert-Paar an der Bestellposition, das ein Eingabefeld im Produktformular oder die AJAX Cart API setzt. Die AJAX-Referenz beschreibt properties bei /cart/add.js als Objekt aus Schlüssel-Wert-Paaren.

Ein Unterstrich am Anfang des Namens macht die Eigenschaft privat. Sie ist dann im Checkout ausgeblendet, aber auf der Seite mit den Bestelldetails im Admin sichtbar. Die Dokumentation warnt: Wer private Eigenschaften auf der Storefront verbergen will, muss das Theme anpassen, denn Liquid und die AJAX-API geben sie weiterhin aus. Im Theme-Code filtere ich deshalb Schlüssel, die mit _ beginnen.

<label for="gravur">Gravurtext</label>
<input id="gravur" type="text" name="properties[Gravur]" maxlength="24">

Was die Definition nicht sagt: Sie nennt Name und Wert, nichts zu Preis oder Lagerbestand. Einen Aufpreis für die Gravur plane ich deshalb nicht über die Eigenschaft, sondern über eine Variante oder ein Bundle. Auch eine Datei ist kein Name-Wert-Paar. Ein Foto-Upload braucht eine Ablage außerhalb der Bestellposition, in der nur ein Verweis steht, und damit meist eine App. Das kläre ich schriftlich mit Ihnen, bevor etwas gebaut wird.

#Personalisierte Ware, Widerruf und Daten Ihrer Kunden

Wer nach Maß oder mit Gravur verkauft, stellt sich die Frage nach dem Widerruf. § 312g Absatz 2 Nummer 1 BGB nimmt Verträge über Waren aus, die nicht vorgefertigt sind und für deren Herstellung eine individuelle Auswahl oder Bestimmung durch den Verbraucher maßgeblich ist, oder die eindeutig auf die persönlichen Bedürfnisse des Verbrauchers zugeschnitten sind. Ob ein bestimmtes Produkt darunterfällt, entscheidet nicht der Theme-Code. Ich gebe keine Rechtsberatung; die Formulierung auf der Produktseite stimmen Sie mit Ihrer Rechtsberatung ab, und ich baue sie ein.

Hochgeladene Fotos und eingegebene Namen sind personenbezogene Daten. Die zuständige Aufsicht für Unternehmen in Bayern ist das Bayerische Landesamt für Datenschutzaufsicht (BayLDA) mit Sitz in Ansbach. Auf seiner Startseite verweist es auf eine Checkliste für Soloselbstständige und kleine und mittlere Unternehmen aus dem Handel. Für Ihren Shop heißt das praktisch: Ich halte schriftlich fest, wo eine Eingabe gespeichert wird und wer sie sieht. Was darüber hinaus nötig ist, klärt Ihre Datenschutzberatung. Wie ich mit solchen Daten bei der Wartung umgehe, steht auf der Seite zur Wartung in Nürnberg.

#Bundles: wenn mehrere Produkte zusammen verkauft werden

Ein Bundle ist nach Shopify ein Set aus zwei oder mehr Produkten, oft mit Rabatt. Dafür muss eine Bundles-App installiert sein. In der Hilfe zu Shopify Bundles stehen die Grenzen:

• feste Bundles bis zu 30 Komponenten, dynamische bis zu 150
• je Komponente bis zu 2.000 Einheiten
• höchstens drei Optionen und 100 Varianten je Bundle

Außerdem führen Bundles den Bestand insgesamt und nicht je Standort. Ändert sich der Preis eines enthaltenen Produkts, ändert sich der Bundle-Preis nicht von selbst. In Bestellungen erscheinen die Artikelnummern der einzelnen Artikel, nicht die des Bundles. Für ein Set aus Grundprodukt und Zubehör taugt das gut. Für ein Produkt, dessen Teile der Kunde frei kombiniert, taugt es nur, wenn die Zahl der Möglichkeiten im Rahmen bleibt. Ein Bundle ist außerdem nicht dasselbe wie ein Abo, dazu steht mehr auf der Seite für Bonn.

#Wann ein Konfigurator oder ein eigener Theme-Block nötig wird

Die Mittel oben decken viel ab. Ein Konfigurator wird sinnvoll, wenn mindestens eines davon zutrifft:

Bei der letzten Zeile prüfe ich zuerst, ob eine App die Regeln abbildet. Eine App bringt ihre Laufzeit, ihre Datenhaltung und ihre Updates mit; mehr dazu auf der Seite für Wuppertal. Einen eigenen Theme-Block baue ich, wenn die Regeln einfach sind und im Theme leben sollen: Er hat ein Schema mit Einstellungen und Presets, erscheint nur im Block-Picker, wenn Presets definiert sind, und eine Section nimmt ihn auf, wenn ihr Schema @theme zulässt. Wie ich Theme-Änderungen über einen Entwicklungszweig und eine Vorschau einspiele, beschreibt die Seite für Münster.

Wenn der Konfigurator Preise nach Kundengruppe ändern soll, geht es in Richtung B2B-Preislisten. Soll die Oberfläche als eigenes Frontend laufen, finden Sie das unter Headless in Karlsruhe. Für die Ladezeit der Produktseite, die mit vielen Optionen schnell leidet, lesen Sie die Seite für Dresden. Die Messlatte sind die Schwellen von web.dev: LCP bis 2,5 s, INP bis 200 ms, CLS bis 0,1.

#Was ich vor einem Projekt von Ihnen brauche

• die Adresse des Shops und, wenn vorhanden, das aktuelle Theme
• eine Beispielkonfiguration mit allen Wahlmöglichkeiten, möglichst als Tabelle
• die Regeln dahinter: Welche Kombinationen sind ausgeschlossen, was ändert den Preis, was bleibt frei?
• eine Liste, welche Eingaben später in der Fertigung oder im Versand ankommen müssen
• die Gestaltung der Ansichten oder ein Layout-Dokument (auf Wunsch schicke ich die Tabellenvorlage)

Ich antworte schriftlich mit Rückfragen. Danach liegt der Umfang als Dokument vor: Leistungen, Annahmen und Ausschlüsse. Ich beginne nach Ihrer schriftlichen Bestätigung. Jeder Stand läuft auf einer Vorschau-Version des Shops, bevor er live geht. Wünsche außerhalb des Umfangs bepreise ich getrennt, bevor ich sie anfasse.

#Häufige Fragen

#Wie viele Varianten und Optionen darf ein Shopify-Produkt haben?

Nach der Shopify-Hilfe bis zu drei Optionen und bis zu 2.048 Varianten je Produkt. Die GraphQL-API nennt zusätzlich ein Shop-Limit für Produktoptionen und Varianten (maxProductOptions, maxProductVariants), ohne Standardwerte anzugeben. Prüfen Sie die Werte Ihres Shops, bevor Sie ein Datenmodell festlegen.

#Was mache ich, wenn drei Optionen nicht reichen?

Die Hilfeseite nennt drei Wege: Apps aus dem Shopify App Store, Anpassungen am Theme-Code und, nur mit Shopify Plus, die App Combined Listings. Welcher passt, hängt davon ab, ob die Kombinationen echte Lagerartikel sind oder Eingaben des Kunden.

#Kann ein Kunde einen Gravurtext oder Namen eingeben?

Ja, über ein Eingabefeld im Produktformular, dessen Wert als Line Item Property an der Bestellposition landet. Die Eigenschaft ist ein Name-Wert-Paar. Ein Aufpreis, eine Prüfung der Zeichenzahl oder eine Datei brauchen zusätzliche Logik oder eine App.

#Ist ein personalisiertes Produkt vom Widerruf ausgeschlossen?

§ 312g Absatz 2 Nummer 1 BGB nimmt Waren aus, die nicht vorgefertigt sind und bei deren Herstellung die individuelle Auswahl oder Bestimmung durch den Verbraucher maßgeblich ist, oder die eindeutig auf seine persönlichen Bedürfnisse zugeschnitten sind. Ob Ihr Produkt darunterfällt, klären Sie mit Ihrer Rechtsberatung; ich gebe keine Rechtsberatung.

#Wann lohnt ein Konfigurator statt Varianten und Textfeldern?

Wenn das Ergebnis eine Vorschau, eine Preisberechnung aus Maßen oder abhängige Auswahlregeln braucht. Dann prüfe ich zuerst eine App und baue einen eigenen Theme-Block nur, wenn keine App die Regeln abbildet.

#Welche Angaben helfen bei einer ersten Einschätzung zu meinem Shop?

Die Adresse des Shops, eine Beispielkonfiguration mit allen Wahlmöglichkeiten, die Regeln dahinter und den Termin, falls es einen gibt. Die erste schriftliche Einschätzung zu Ihrem Shop erhalten Sie ohne Rechnung.

#Schreiben Sie mir

Schicken Sie mir über die Kontaktseite die Adresse Ihres Shops, ein Produkt mit all seinen Wahlmöglichkeiten, das Ziel und den Termin, falls es einen gibt, dazu die aktuelle Plattform. Ich lese es und antworte schriftlich an Werktagen mit einer ersten Einschätzung, welches Mittel aus der Tabelle oben passt und was noch offen ist. Diese erste Einschätzung ist unverbindlich und ohne Rechnung. Wer für Nürnberg zusätzlich eine laufende Betreuung sucht, findet sie unter Wartung in Nürnberg.