Metafelder und Metaobjekte einrichten

Die Möbelfunktionen von Tenora lesen Produktdaten aus Metafeldern und Metaobjekten. Auf dieser Seite zeigen wir dir Schritt für Schritt, wie du sie anlegst – mit genau den Namen und Typen, die das Theme erwartet.

• Ein Metafeld ist ein zusätzliches Feld an einem Produkt, zum Beispiel „Breite“.
• Ein Metaobjekt ist ein wiederverwendbarer Eintrag mit eigenen Feldern, zum Beispiel ein Material namens „Massive Eiche“ mit Bild und Pflegehinweisen.

Die Definitionen richtest du einmal ein. Danach füllst du die Werte für jedes Produkt aus.

Bevor du beginnst

• Gib jeden Namespace und jeden Schlüssel genau wie gezeigt ein, in Kleinbuchstaben und mit Unterstrichen. Das Theme liest genau diese Namen. Schon eine kleine Abweichung wie specs.Width oder spec.width führt dazu, dass das Theme den Wert nicht findet.
• Lege zuerst die Metaobjekt-Definition „Material“ an. Das Metafeld specs.materials braucht sie.
• Ist ein Wert leer, wird der passende Block auf der Produktseite ausgeblendet. Du kannst deine Produkte also nach und nach ergänzen.

Funktion	Gelesene Metafelder
Maße	specs.width, specs.depth, specs.height, specs.seat_height, specs.weight
Passt es?	specs.width, specs.depth, specs.height (alle drei sind nötig)
Materialien und Pflege	specs.materials und das Metaobjekt „Material“
Muster bestellen	specs.sample_product (oder die Blockeinstellung Musterprodukt)
Lieferung und Montage	delivery.lead_time, delivery.method, delivery.assembly_required, delivery.assembly_guide

Prüfe zuerst das Einheitensystem deines Shops

Metafelder für Abmessungen und Gewicht verwenden das Einheitensystem deines Shops als Standardeinheit.

1. Öffne in deinem Shopify-Adminbereich Einstellungen → Allgemein.
2. Suche Shop-Standardeinstellungen (Store defaults) → Einheitensystem (Unit system).
3. Prüfe, ob metrisch oder imperial eingestellt ist.

Verwendet dein Shop das imperiale System, wählt der Adminbereich standardmäßig Zoll und Unzen. Ein Wert, den du als 220 eingibst, wird dann als 220 in gespeichert, sofern du die Einheit neben dem Feld nicht änderst. Das Theme rechnet Einheiten korrekt um, aber die Zahlen entsprechen dann nicht dem, was du gemeint hast.

Tipp: Prüfe immer die Einheit neben dem Wert, bevor du ein Produkt speicherst.

Der Block Maße zeigt immer Zentimeter und Zoll sowie Kilogramm und Pfund an – egal, welche der unterstützten Einheiten du im Adminbereich verwendet hast (mm, cm, m, in, ft oder yd für Längen; g, kg, lb oder oz für Gewichte). Kunden können die Einheit wechseln, und ihre Wahl wird auf ihrem Gerät gespeichert.

Schritt 1: Die Metaobjekt-Definition „Material“ anlegen

1. Öffne in deinem Shopify-Adminbereich Einstellungen → Benutzerdefinierte Daten (Custom data).

2. Wähle unter Metaobjekte die Option Definition hinzufügen.

3. Gib als Name ein: Material.

4. Prüfe den Typ. Shopify füllt ihn anhand des Namens aus. Er muss genau material lauten.

5. Wähle Feld hinzufügen und füge diese vier Felder hinzu:

   Feldname	Schlüssel	Typ	Optionen
   Name	name	Einzeiliger Text	Als Pflichtfeld markieren
   Bild	image	Datei, nur Bilder erlaubt	Eine Datei
   Beschreibung	description	Mehrzeiliger Text
   Pflegehinweise	care_instructions	Mehrzeiliger Text

6. Aktiviere bei den Zugriffsoptionen den Zugriff für Storefronts. Ohne ihn kann das Theme das Material nicht lesen.

7. Lass die Option Status Aktiv/Entwurf (Active-draft status) deaktiviert. Aktivierst du sie, musst du jeden Materialeintrag auf Aktiv setzen, sonst erscheint er nicht in deinem Shop.

8. Optional: Lege Name als Anzeigenamen fest, damit du Einträge in Listen leicht findest.

9. Wähle Speichern.

Schritt 2: Deine Materialien hinzufügen

1. Öffne in deinem Shopify-Adminbereich Inhalt → Metaobjekte.

2. Wähle Material.

3. Wähle Eintrag hinzufügen.

4. Fülle die Felder aus. Zum Beispiel:

   Name	Beschreibung	Pflegehinweise
   Massive Eiche	FSC-zertifizierte europäische Eiche mit natürlicher Ölung.	Mit einem weichen, trockenen Tuch abwischen. Einmal im Jahr nachölen. Direkte Hitze vermeiden.
   Leinenmischung	55% Leinen, 45% Baumwolle. Abnehmbare, vorgewaschene Bezüge.	Bezüge sind bei 30°C waschbar. An der Luft trocknen und feucht bügeln.
   Naturrattan	Handgeflochtenes Rattan auf einem Rahmen aus Massivholz.	Mit einer weichen Bürste abstauben. Von Heizkörpern und direkter Sonne fernhalten.

5. Füge für jedes Material ein Bild hinzu, etwa eine Nahaufnahme des Holzes oder Stoffes. Ein quadratisches Bild eignet sich am besten.

6. Wähle Speichern.

Tipps

• Im Layout Karten zeigt der Block nur den ersten Satz der Beschreibung. Schreibe die wichtigste Information in den ersten Satz.
• Zeilenumbrüche in Beschreibung und Pflegehinweisen bleiben erhalten.
• Ein Material ohne Namen wird nicht angezeigt.

Schritt 3: Die Metafeld-Definitionen für Produkte anlegen

1. Öffne in deinem Shopify-Adminbereich Einstellungen → Benutzerdefinierte Daten.
2. Wähle unter Metafelder die Option Produkte.
3. Wähle Definition hinzufügen.
4. Gib den Namen ein und dann Namespace und Schlüssel genau wie unten gezeigt, mit dem Punkt (zum Beispiel specs.width).
5. Wähle den Typ und die Optionen aus der Tabelle.
6. Achte darauf, dass der Zugriff für Storefronts aktiviert ist. Er ist in der Regel standardmäßig aktiviert.
7. Wähle Speichern.
8. Wiederhole das für jede Zeile der Tabelle.

Name	Namespace und Schlüssel	Typ	Optionen
Breite	specs.width	Abmessung	Ein Wert
Tiefe	specs.depth	Abmessung	Ein Wert
Höhe	specs.height	Abmessung	Ein Wert
Sitzhöhe	specs.seat_height	Abmessung	Ein Wert
Gewicht	specs.weight	Gewicht	Ein Wert
Materialien	specs.materials	Metaobjekt, dann Material wählen	Liste von Einträgen
Musterprodukt	specs.sample_product	Produkt	Ein Produkt
Lieferzeit	delivery.lead_time	Einzeiliger Text	Ein Wert
Versandart	delivery.method	Einzeiliger Text	Ein Wert. Optional: Auf vordefinierte Auswahlmöglichkeiten beschränken (Limit to preset choices), zum Beispiel Standard delivery, White-glove delivery, Flat-pack delivery
Montage erforderlich	delivery.assembly_required	Wahr oder falsch
Montageanleitung	delivery.assembly_guide	Datei	PDF-Dateien erlauben (oder alle Dateitypen)

Hinweise

• specs.materials kann statt einer Liste auch ein einzelner Eintrag sein (Ein Eintrag). Das Theme unterstützt beides. Wir empfehlen eine Liste, damit ein Produkt mehrere Materialien haben kann.
• Die Namen in der Spalte Name werden nur im Adminbereich angezeigt. Du kannst sie übersetzen oder ändern. Namespace und Schlüssel müssen genau so bleiben wie gezeigt.
• Tipp: Aktiviere beim Anlegen einer Definition An Produktseiten anheften (Pin to product pages). Die Felder erscheinen dann direkt auf jeder Produktseite im Adminbereich.

Schritt 4: Deine Produkte ausfüllen

1. Öffne in deinem Shopify-Adminbereich Produkte und dann ein Produkt.

2. Scrolle nach unten zu Metafelder.

3. Fülle die Felder für dieses Produkt aus. Zum Beispiel für ein Sofa:

   Metafeld	Beispielwert
   Breite	220 cm
   Tiefe	95 cm
   Höhe	82 cm
   Sitzhöhe	44 cm
   Gewicht	68 kg
   Materialien	Massive Eiche, Leinenmischung
   Musterprodukt	Stoffmuster-Set
   Lieferzeit	Wird auf Bestellung gefertigt, Versand in 6–8 Wochen
   Versandart	Lieferung mit Aufbauservice
   Montage erforderlich	Falsch
   Montageanleitung	Eine PDF-Datei

4. Prüfe vor dem Speichern die Einheit jeder Abmessung und jedes Gewichts.

5. Wähle Speichern.

6. Öffne das Produkt in deinem Onlineshop und prüfe die Blöcke Maße, Materialien und Pflege, Muster bestellen sowie Lieferung und Montage.

Was bei unvollständigen Daten passiert

Du musst nicht jedes Feld ausfüllen. Hat ein Produkt zum Beispiel nur eine Breite, eine Höhe und eine Lieferzeit:

• Die Maßtabelle zeigt nur Breite und Höhe.
• Die Zeichnung wird angezeigt, weil sie nur Breite und Höhe braucht.
• „Passt es?“ ist ausgeblendet, weil es auch die Tiefe braucht.
• Die Blöcke Materialien und Pflege sowie Muster bestellen sind ausgeblendet (es sei denn, im Block Muster bestellen ist im Theme-Editor ein Musterprodukt festgelegt).
• Der Block Lieferung und Montage zeigt nur die Lieferzeit.

Metafeld-Werte per CSV-Datei importieren

Wenn du viele Produkte hast, kannst du Metafelder mit dem Produkt-CSV-Import von Shopify ausfüllen. Lege die Metafeld-Definitionen (Schritt 3) an, bevor du exportierst oder importierst. Die CSV-Datei enthält dann eine Spalte pro Definition.

1. Öffne in deinem Shopify-Adminbereich Produkte und wähle Exportieren, um eine CSV-Datei mit deinen aktuellen Produkten zu erhalten.

2. Öffne die Datei in einem Tabellenkalkulationsprogramm. Suche die Metafeld-Spalten. Ihre Namen enthalten Namespace und Schlüssel, zum Beispiel:

   • Width (product.metafields.specs.width)
   • Weight (product.metafields.specs.weight)
   • Materials (product.metafields.specs.materials)

3. Trage die Werte ein:

   Spalte	Beispielwert	Hinweis
   Breite, Tiefe, Höhe, Sitzhöhe	180cm	Eine Zahl und eine Einheit
   Gewicht	58 kg	Eine Zahl und eine Einheit
   Materialien	solid-oak; linen-blend	Handles der Materialeinträge, getrennt durch Semikolon und Leerzeichen
   Lieferzeit	Made to order, ships in 6–8 weeks	Einfacher Text
   Montage erforderlich	TRUE oder FALSE

4. Speichere die Datei als CSV (UTF-8).

5. Wähle unter Produkte die Option Importieren, wähle die Datei und folge den Schritten.

6. Öffne nach dem Import einige Produkte und prüfe Werte und Einheiten.

Tipps

• Importiere zuerst eine kleine Testdatei mit zwei oder drei Produkten.
• Das Handle eines Materials steht am Materialeintrag unter Inhalt → Metaobjekte → Material. Meist ist es der Name in Kleinbuchstaben mit Bindestrichen, zum Beispiel solid-oak.
• Gib bei Abmessungen und Gewichten immer die Einheit an. Ohne Einheit wird der Wert möglicherweise in der Standardeinheit deines Shops gelesen.

Deine Produktdaten übersetzen

Hat dein Shop mehr als eine Sprache, übersetze die Textwerte (Materialien, Lieferzeiten und Versandarten) mit den Übersetzungstools von Shopify – genauso wie Produktbeschreibungen. Die Beschriftungen, die das Theme hinzufügt, etwa „Breite“, „Pflege“ und „Teilweise Montage erforderlich“, sind bereits übersetzt. Siehe International verkaufen.

Fehlerbehebung

Problem	Was du prüfen solltest
Ein Block erscheint nicht	Namespace und Schlüssel sind genau wie gezeigt, der Zugriff für Storefronts ist aktiviert und das Produkt hat einen Wert. Außerdem ist der Block in der Produktvorlage enthalten, die das Produkt verwendet.
Materialien erscheinen nicht	Der Materialeintrag hat einen Namen. Verwendet die Definition Status Aktiv/Entwurf, ist der Eintrag auf Aktiv gesetzt.
Größen sind falsch	Die Einheit neben jedem Wert. Prüfe das Einheitensystem deines Shops.
„Passt es?“ erscheint nicht	Breite, Tiefe und Höhe haben alle einen Wert, und Passform-Helfer anzeigen ist im Block Maße aktiviert.
Das Muster erscheint nicht	Das Musterprodukt ist aktiv und im Vertriebskanal Onlineshop verfügbar. Das Muster ist nicht das Produkt selbst.

Weitere Hilfe findest du unter Häufige Fragen.