Metavelden en metaobjecten instellen

De meubelfuncties van Tenora lezen productdata uit metavelden en metaobjecten. Op deze pagina lees je stap voor stap hoe je ze aanmaakt, met de exacte namen en types die het thema verwacht.

• Een metaveld is een extra veld bij een product, bijvoorbeeld "Breedte".
• Een metaobject is een herbruikbaar item met eigen velden, bijvoorbeeld een materiaal met de naam "Massief eiken", met een afbeelding en onderhoudsinstructies.

Je stelt de definities één keer in. Daarna vul je per product de waarden in.

Voordat je begint

• Typ elke naamruimte en sleutel exact zoals hier getoond, in kleine letters en met underscores. Het thema leest precies deze namen. Een klein verschil, zoals specs.Width of spec.width, betekent dat het thema de waarde niet vindt.
• Maak eerst de definitie van het metaobject "Material" aan. Het metaveld specs.materials heeft die nodig.
• Is een waarde leeg, dan wordt het bijbehorende blok op de productpagina verborgen. Je kunt je producten stap voor stap aanvullen.

Functie	Metavelden die worden gelezen
Afmetingen	specs.width, specs.depth, specs.height, specs.seat_height, specs.weight
Past het?	specs.width, specs.depth, specs.height (alle drie zijn nodig)
Materialen en onderhoud	specs.materials en het metaobject "Material"
Staal bestellen	specs.sample_product (of de instelling Staalproduct van het blok)
Bezorging en montage	delivery.lead_time, delivery.method, delivery.assembly_required, delivery.assembly_guide

Controleer eerst het eenhedenstelsel van je winkel

Metavelden voor afmetingen en gewicht gebruiken het eenhedenstelsel van je winkel als standaardeenheid.

1. Ga in je Shopify-beheercentrum naar Instellingen → Algemeen (General).
2. Zoek Winkelstandaarden (Store defaults) → Eenhedenstelsel (Unit system).
3. Controleer of het op metrisch of imperiaal staat.

Gebruikt je winkel het imperiale stelsel, dan kiest het beheercentrum standaard inches en ounces. Een waarde die je als 220 typt, wordt dan opgeslagen als 220 in, tenzij je de eenheid naast het veld wijzigt. Het thema rekent eenheden correct om, maar de getallen zijn dan niet wat je bedoelde.

Tip: controleer altijd de eenheid naast de waarde voordat je een product opslaat.

Het blok Afmetingen toont altijd centimeters en inches, en kilogrammen en ponden, welke ondersteunde eenheid je ook in het beheercentrum hebt gebruikt (mm, cm, m, in, ft of yd voor lengtes; g, kg, lb of oz voor gewicht). Klanten kunnen van eenheid wisselen en hun keuze wordt op hun apparaat onthouden.

Stap 1: De definitie van het metaobject "Material" aanmaken

1. Ga in je Shopify-beheercentrum naar Instellingen → Aangepaste gegevens (Custom data).

2. Selecteer onder Metaobjecten de optie Definitie toevoegen (Add definition).

3. Vul bij Naam in: Material.

4. Controleer het Type. Shopify vult dit in op basis van de naam. Het moet precies material zijn.

5. Selecteer Veld toevoegen (Add field) en voeg deze vier velden toe:

   Veldnaam	Sleutel	Type	Opties
   Name	name	Tekst met één regel (Single line text)	Markeren als verplicht
   Image	image	Bestand (File), met alleen Afbeeldingen toegestaan	Eén bestand
   Description	description	Tekst met meerdere regels (Multi-line text)
   Care instructions	care_instructions	Tekst met meerdere regels (Multi-line text)

6. Schakel bij de toegangsopties toegang voor Storefronts in. Zonder die toegang kan het thema het materiaal niet lezen.

7. Laat de optie Status actief/concept (Active-draft status) uitgeschakeld. Schakel je die in, dan moet je elk materiaalitem op Actief zetten, anders verschijnt het niet in je winkel.

8. Optioneel: stel Name in als weergavenaam, zodat items makkelijk te vinden zijn in lijsten.

9. Selecteer Opslaan.

Stap 2: Je materialen toevoegen

1. Ga in je Shopify-beheercentrum naar Content → Metaobjecten.

2. Selecteer Material.

3. Selecteer Item toevoegen (Add entry).

4. Vul de velden in. Bijvoorbeeld:

   Name	Description	Care instructions
   Massief eiken	FSC-gecertificeerd Europees eiken met een natuurlijke olieafwerking.	Afnemen met een zachte, droge doek. Eén keer per jaar opnieuw oliën. Vermijd directe hitte.
   Linnenmix	55% linnen, 45% katoen. Afneembare, voorgewassen hoezen.	Hoezen kunnen op 30°C worden gewassen. Aan de lucht laten drogen en vochtig strijken.
   Natuurlijk rotan	Handgevlochten rotan op een frame van massief hout.	Afstoffen met een zachte borstel. Uit de buurt houden van radiatoren en direct zonlicht.

5. Voeg voor elk materiaal een Image toe, zoals een close-up van het hout of de stof. Een vierkante afbeelding werkt het best.

6. Selecteer Opslaan.

Tips

• In de opmaak Kaarten toont het blok alleen de eerste zin van de beschrijving. Zet de belangrijkste informatie in de eerste zin.
• Regeleinden in de beschrijving en de onderhoudsinstructies blijven behouden.
• Een materiaal zonder naam wordt niet getoond.

Stap 3: De definities van de productmetavelden aanmaken

1. Ga in je Shopify-beheercentrum naar Instellingen → Aangepaste gegevens (Custom data).
2. Selecteer onder Metavelden de optie Producten.
3. Selecteer Definitie toevoegen (Add definition).
4. Vul de Naam in en vul daarna Naamruimte en sleutel (Namespace and key) precies zo in als hieronder, met de punt (bijvoorbeeld specs.width).
5. Selecteer het Type en de opties uit de tabel.
6. Controleer of toegang voor Storefronts is ingeschakeld. Dat is meestal standaard zo.
7. Selecteer Opslaan.
8. Herhaal dit voor elke rij in de tabel.

Naam	Naamruimte en sleutel	Type	Opties
Breedte	specs.width	Afmeting (Dimension)	Eén waarde
Diepte	specs.depth	Afmeting (Dimension)	Eén waarde
Hoogte	specs.height	Afmeting (Dimension)	Eén waarde
Zithoogte	specs.seat_height	Afmeting (Dimension)	Eén waarde
Gewicht	specs.weight	Gewicht (Weight)	Eén waarde
Materialen	specs.materials	Metaobject, selecteer daarna Material	Lijst met items
Staalproduct	specs.sample_product	Product	Eén product
Levertijd	delivery.lead_time	Tekst met één regel (Single line text)	Eén waarde
Bezorgmethode	delivery.method	Tekst met één regel (Single line text)	Eén waarde. Optioneel: Beperken tot vooraf ingestelde keuzes (Limit to preset choices), bijvoorbeeld Standard delivery, White-glove delivery, Flat-pack delivery
Montage vereist	delivery.assembly_required	Waar of onwaar (True or false)
Montagehandleiding	delivery.assembly_guide	Bestand (File)	Pdf-bestanden toestaan (of alle bestandstypen)

Opmerkingen

• specs.materials kan ook één item zijn (Eén item) in plaats van een lijst. Het thema ondersteunt allebei. We raden een lijst aan, zodat een product meerdere materialen kan hebben.
• De namen in de kolom Naam zie je alleen in het beheercentrum. Je kunt ze vertalen of wijzigen. De naamruimte en sleutel moeten precies blijven zoals getoond.
• Tip: schakel Vastzetten op productpagina's (Pin to product pages) in wanneer je een definitie aanmaakt. De velden verschijnen dan direct op elke productpagina in het beheercentrum.

Stap 4: Je producten invullen

1. Ga in je Shopify-beheercentrum naar Producten en open een product.

2. Scrol omlaag naar Metavelden.

3. Vul de velden voor dit product in. Bijvoorbeeld voor een bank:

   Metaveld	Voorbeeldwaarde
   Breedte	220 cm
   Diepte	95 cm
   Hoogte	82 cm
   Zithoogte	44 cm
   Gewicht	68 kg
   Materialen	Massief eiken, Linnenmix
   Staalproduct	Set stofstalen
   Levertijd	Op bestelling gemaakt, verzonden binnen 6–8 weken
   Bezorgmethode	Bezorging tot in de kamer
   Montage vereist	Onwaar
   Montagehandleiding	Een pdf-bestand

4. Controleer de eenheid van elke afmeting en elk gewicht voordat je opslaat.

5. Selecteer Opslaan.

6. Open het product in je webwinkel en controleer de blokken Afmetingen, Materialen en onderhoud, Staal bestellen en Bezorging en montage.

Wat er gebeurt bij gedeeltelijke data

Je hoeft niet elk veld in te vullen. Heeft een product bijvoorbeeld alleen een breedte, een hoogte en een levertijd:

• De tabel met afmetingen toont alleen breedte en hoogte.
• De tekening wordt getoond, want die heeft alleen breedte en hoogte nodig.
• "Past het?" is verborgen, want daarvoor is ook de diepte nodig.
• De blokken Materialen en onderhoud en Staal bestellen zijn verborgen (tenzij voor het blok Staal bestellen een Staalproduct is ingesteld in de thema-editor).
• Het blok Bezorging en montage toont alleen de levertijd.

Metaveldwaarden importeren met een CSV-bestand

Heb je veel producten? Dan kun je metavelden invullen met de product-CSV-import van Shopify. Maak de definities van de metavelden (stap 3) aan voordat je exporteert of importeert. Het CSV-bestand heeft dan voor elke definitie een kolom.

1. Ga in je Shopify-beheercentrum naar Producten en selecteer Exporteren om een CSV-bestand met je huidige producten te krijgen.

2. Open het bestand in een spreadsheetprogramma. Zoek de kolommen van de metavelden. Hun namen bevatten de naamruimte en sleutel, bijvoorbeeld:

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

3. Vul de waarden in:

   Kolom	Voorbeeldwaarde	Opmerking
   Width, Depth, Height, Seat height	180cm	Een getal en een eenheid
   Weight	58 kg	Een getal en een eenheid
   Materials	solid-oak; linen-blend	Handles van materiaalitems, gescheiden door een puntkomma en een spatie
   Lead time	Made to order, ships in 6–8 weeks	Platte tekst
   Assembly required	TRUE of FALSE

4. Sla het bestand op als CSV (UTF-8).

5. Selecteer in Producten de optie Importeren, kies het bestand en volg de stappen.

6. Open na de import een paar producten en controleer de waarden en eenheden.

Tips

• Importeer eerst een klein testbestand met twee of drie producten.
• De handle van een materiaal staat bij het materiaalitem in Content → Metaobjecten → Material. Meestal is het de naam in kleine letters met koppeltekens, bijvoorbeeld solid-oak.
• Neem bij waarden voor afmetingen en gewicht altijd de eenheid op. Zonder eenheid kan de waarde worden gelezen in de standaardeenheid van je winkel.

Je productdata vertalen

Heeft je winkel meer dan één taal? Vertaal dan de tekstwaarden (materialen, levertijden en bezorgmethoden) met de vertaaltools van Shopify, op dezelfde manier als productbeschrijvingen. De labels die het thema toevoegt, zoals "Breedte", "Onderhoud" en "Enige montage vereist", zijn al vertaald. Zie Wereldwijd verkopen.

Problemen oplossen

Probleem	Wat je controleert
Een blok verschijnt niet	De naamruimte en sleutel zijn precies zoals getoond, toegang voor Storefronts staat aan en het product heeft een waarde. Het blok staat ook in de productsjabloon die het product gebruikt.
Materialen verschijnen niet	Het materiaalitem heeft een Name. Gebruikt de definitie Status actief/concept, dan staat het item op Actief.
Maten kloppen niet	De eenheid naast elke waarde. Controleer het eenhedenstelsel van je winkel.
"Past het?" verschijnt niet	Breedte, diepte en hoogte hebben allemaal een waarde, en Pashulp weergeven staat aan in het blok Afmetingen.
Het staal verschijnt niet	Het staalproduct is actief en beschikbaar in je verkoopkanaal Onlinewinkel. Het staal is niet het product zelf.

Meer hulp vind je bij Veelgestelde vragen.