V Napojse je možné na některých místech, typicky v definici vlastního exportu či v pravidlech, využívat tzv. proměnné. Jsou to zástupné značky, za které se při aplikaci pravidla nahradí skutečné hodnoty. Proměnné se zapisují do dvojitých složených závorek, např. {{ manufacturer }} . Následuje seznam proměnných, které lze použít včetně jejich typu. Informace pro práci s objekty jsou uvedeny dále v článku.
Vlastnost | Proměnná | Typ |
Dodací lhůta | deliveryTime | string |
Doplňkový název produktu | additionalTitle | string |
Export/Import ID | exportOrImportId | integer |
Extended Title | extendedTitle | string |
Hloubka | depth | float |
Hmotnost | weight | float |
Jazyk | language | string |
Jednotka | unit | string |
Maximální množství | maximalQuantity | float |
Meta název | metaTitle | string |
Meta popis | metaDescription | string |
Minimální množství | minimalQuantity | float |
Množství v balení | quantityPerPackage | float |
Název produktu | title | string |
Podrobný popis | description | string |
Poznámka | note | string |
Stručný popis | perex | string |
Šířka | width | width |
Celkový počet položek ze všech skladů | totalQuantity | float |
Typ produktu | type | string |
URL | url | objekt typu "url" |
Viditelnost | visible | bool |
Výrobce | manufacturer | string |
Výška | height | float |
Záruční doba | warranty | string |
Ceny
Vlastnost | Proměnná | Typ |
Akční cena | actionPrice | objekt typu "price" |
Autorské poplatky | authorFee | objekt typu "price" |
Běžná cena | commonPrice | objekt typu "price" |
Cena (prodejní) | price | objekt typu "price" |
Sazba DPH | taxRate | float |
Nákupní cena | purchasePrice | objekt typu "price" |
Recyklační poplatek | recyclingFee | objekt typu "price" |
Minimální cena | minimalPrice | objekt typu "price" |
Sazba DPH pro nákupní cenu | purchaseTaxRate | float |
Kódy
Vlastnost | Proměnná | Typ |
EAN | ean | string |
External Code | externalCode | string |
External ID | externalId | string |
ID produktu v Napojse | id | string |
ISBN | isbn | string |
Kód | code | string |
Párovací kód | pairCode | string |
Product Number | productNumber | string |
Part Number | partNumber | string |
PLU | plu | string |
Serial Number | serialNumber | string |
Vícenásobné elementy
Vlastnost | Proměnná | Typ |
Dostupnosti | availabilities | pole objektů typu "availability" |
Kategorie | categories | pole objektů typu "category" |
Možnosti doručení | deliveries | pole objektů typu "delivery" |
Obrázky | images | pole objektů typu "image" |
Obrázky variant | variantImages | pole objektů typu "image" |
Parametry | parameters | pole objektů typu "parameter" |
Parametry variant | variantParameters | pole objektů typu "parameter" |
Podobné produkty | alternativeProducts | pole řetězců |
Proměnné | variables | pole objektů typu "variable" |
Přílohy | attachments | pole objektů typu "attachment" |
Příznaky | tags | pole objektů typu "tag" |
Související produkty | relatedProducts | pole řetězců |
Varianta | variant | pole objektů typu "product" |
Videa | videos | pole objektů typu "video" |
Ceníky | priceLists | pole objektů typu "priceList" |
Objekty
Objekty jsou proměnné s více atributy. Např. objekt typu "priceList" obsahuje název ceníku, koeficient a další objekt typu cena (který sám o sobě obsahuje hodnotu a měnu). Objekty se zapisuji ve tvaru {{ objekt.atribut }} , konkrétně se na ně podíváme dále v článku.
Objekt typu "availabilities"
Hodnotu konkrétní proměnné, v příkladu níže např. skladové množství na skladu "Výchozí sklad" lze načíst následovně:
{{ availabilities["Výchozí sklad"].quantity }}Název skladu | availability.stock | stock |
Skladové množství | availability.quantity | quantity |
Počet dní k dodání | availability.days | days |
Datum naskladnění | availability.inStockAt | inStockAt |
Objekt typu "price"
Hodnota ceny | price.price | amount |
Kód měny | price.currency | currencyCode |
Příklad - hodnota akční ceny:
{{ actionPrice.price }}Objekt typu "relatedProducts"
Vlastnost u odkazovaného produktu | relatedProducts['?'].element | element |
Hodnota vlastnosti | relatedProducts['?'].value | value |
Objekt typu "image"
URL adresa, kde se obrázek nachází | image.url | url |
Alternativní text | image.alt | alt |
Variantní obrázek | image.variant | variant |
Objekt typu "priceList"
Název ceníku | priceList['?'].title | title |
Koeficient výpočtu | priceList['?'].ratio | ratio |
Výchozí cena | priceList['?'].price | objekt typu "price" |
Objekt typu "tag"
Název příznaku | tag.title | title |
Skupina příznaků | tag.group | group |
Platný od | tag.validFrom | validFrom |
Platný do | tag.validTill | validTill |
Objekt typu "parameter"
Název parametru | parameter.title | title |
Hodnota parametru | parameter.value | values |
Skupina parametrů | parameter.group | group |
Použití proměnné parametr
Při získávání hodnoty konkrétního parametru je nutné definovat jeho skupinu a název.
Skupina může být "default", pokud parametr žádnou nemá přiřazenu, "filter" pokud se jedná o filtrovací parametr nebo "variant", pokud je variantní. Případně jakoukoliv další uživatelskou.
V názvu je potřeba nahradit velká písmena malými, odstranit diakritiku, mezery nahradit podtržítkem a vynechat speciální znaky. Níže několik příkladů.
Variantní parametr "Barva":
{{ variantParameters["default"]["barva"].value }}Parametr "Rozměr [cm]":
{{ parameters["default"]["rozmer_cm"].value }}Filtrovací parametr "Typ střihu":
{{ parameters["filter"]["typ_strihu"].value }}Objekt typu "attachment"
Název přílohy | attachment.title | title |
URL adresa s přílohou | attachment.url | url |
Objekt typu "stock"
Sklad | stock.stock | string |
Název skladu | stock.title | string |
Skladové množství | stock.quantity | quantity |
Počet dní | stock.days | int |
Datum naskladnění | stock.inStockAt | inStockAt |
Objekt typu "category"
Cesta kategorie | category.path | string |
Název kategorie | category.title | string |
ID kategorie | category.id | string |
Objekt typu "variable"
Hodnotu konkrétní proměnné lze získat např. takto:
{{ variables["kod_promenne"].value }}Kód proměnné | variable.code | string |
Hodnota proměnné | variable.value | string |
Objekt typu "delivery"
Název doručení | delivery.title | title |
Cena doručení | delivery.price | float |
Hodnota dobírky | delivery.cashOnDeliveryPrice | cashOnDeliveryPrice |
Měna | delivery.currency | currency |
Ostatní proměnné
Kromě výše popsaných produktových proměnných lze v twigu pracovat ještě s těmito proměnnými. Zapisují se stejně jako produktové proměnné, tzn. do dvojitých složených závorek:
{{ space }}space | Znak mezery, který nebude automaticky odstraněn např. na konci názvu apod. |
currentValue | Aktuální hodnota vlastnosti, která vstupuje do pravidla. Hodí se zejména pro vícenásobné vlastnosti (kategorie, parametry....) |