WebshopProducten

Eigen productvelden toevoegen

Voeg via het gegevensmodel velden toe die Nimbu niet standaard op een product heeft.

Doelgroep: Beheerder, OntwikkelaarVereiste toegang: Producten, DatamodelleringGecontroleerd op Taal: Nederlands

Nimbu geeft elk product een naam, een prijs, afbeeldingen en voorraad. Wat daarna komt, verschilt per winkel. Een koffiebrander wil branding en herkomst kunnen invullen, een kledingzaak wil de samenstelling van de stof kwijt. Daarvoor bestaat het gegevensmodel.

Je vindt het via ProductenGegevensmodel. Bovenaan staat Producten / Gegevensmodel, met daaronder de sectie Productvelden.

Het scherm Producten / Gegevensmodel met de sectie Productvelden en vier velden in de kolommen Veldlabel, Veldnaam en Gegevenstype.Volledig formaat bekijken
Bij Productvelden staat elk eigen veld met zijn label, zijn API-naam en zijn type; rechtsboven bewaar je met Structuur bijwerken.

Een veld toevoegen

  1. Open ProductenGegevensmodel.
  2. Kies Een nieuw veld toevoegen.
  3. Vul het Veldlabel in. Dat is de naam die redacteuren op het productformulier zien.
  4. Vul de Veldnaam in. Die naam gebruikt je thema of een koppeling.
  5. Kies bij Gegevenstype wat voor soort gegeven het is.
  6. Kies rechtsboven Structuur bijwerken.

De veldnaam kies je één keer goed. Wie hem later verandert, breekt elk stukje thema of koppeling dat er al naar verwijst. Het veldlabel mag je gerust aanpassen.

De soorten velden

Deze types kun je kiezen:

TypeWaarvoor
stringKorte tekst op één regel
textLangere tekst over meerdere regels
emailEen e-mailadres
integerEen heel getal
floatEen getal met decimalen
booleanJa of nee
fileEén bestand, bijvoorbeeld een handleiding
date, time, date_timeEen datum, een tijdstip of allebei
selectEén keuze uit een lijst
multi_selectMeerdere keuzes uit een lijst
calculatedEen waarde die uit andere velden volgt
belongs_toEen verwijzing naar één ander item
belongs_to_manyEen verwijzing naar meerdere items
customerEen verwijzing naar een klant
galleryEen reeks afbeeldingen
geoEen locatie
jsonGestructureerde gegevens voor ontwikkelaars

In de keuzelijst Gegevenstype staan de Nederlandse namen van die types. string heet er Tekenreeks, select heet er Enkelvoudige selectie.

Twijfel je tussen string en select, kies dan select zodra de antwoorden op een korte lijst passen. Dat scheelt later opruimwerk aan spelfouten.

De extra instellingen

Achter Veldinstellingen tonen/verbergen zit de rest van het veld: een Beschrijving die als hint bij het veld komt te staan, en de vinkjes Verplicht veld, Vertaalbaar veld en Uniek veld. Afhankelijk van het type komen daar nog instellingen bij.

Rechtsboven staat de taalknop. Daar wissel je van taal om de labels van je velden te vertalen.

Keuzemogelijkheden bij een select-veld

De opties van een select-veld kun je pas toevoegen nadat je het veld één keer bewaard hebt. De volgorde is dus:

  1. Maak het veld aan met type select en kies Structuur bijwerken.
  2. Open bij dat veld Veldinstellingen tonen/verbergen.
  3. Kies onder Enkelvoudige opties de link Een nieuwe keuzemogelijkheid toevoegen en vul de naam van de optie in.
  4. Kies opnieuw Structuur bijwerken.
De veldinstellingen van een keuzeveld, met de vinkjes Verplicht veld, Vertaalbaar veld en Uniek veld en de keuzemogelijkheden Licht, Medium en Donker.Volledig formaat bekijken
De keuzemogelijkheden van een select-veld voeg je toe onder Enkelvoudige opties, via de link Een nieuwe keuzemogelijkheid toevoegen.

Voeg je meerdere opties toe, bewaar dan tussendoor. Toen we er drie in één keer toevoegden, kwam er één niet mee.

Waar je velden daarna terechtkomen

Op het productformulier verschijnen je eigen velden in de sectie Aangepaste attributen. Een select-veld wordt er een keuzelijst met de opties die je hebt ingesteld.

Het productformulier met de sectie Aangepaste attributen, waarin Herkomst en Branding staan, en daaronder de sectie Collecties.Volledig formaat bekijken
Eigen productvelden verschijnen op het productformulier onder Aangepaste attributen; daaronder staat bij Collecties in welke collecties het product zit.

Vul de waarde van een select-veld in via dit formulier. Via de API bleek dat in onze tests niet te bewaren.

Velden uitsluiten van zoeken

Onder Zoekopties staat Velden uitgesloten van zoeken. Zet daar velden in waarvan de inhoud zoekresultaten vertroebelt, bijvoorbeeld interne codes of een technisch json-veld. Laat je het leeg, dan indexeert Nimbu alle velden.

Klanten hebben hetzelfde gegevensmodel, met dezelfde veldtypes. Zie Eigen klantvelden toevoegen.