Proměnné

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....)