Guida sviluppo temi

Benvenuto nella sezione dedicata
allo sviluppo dei temi Storeden

  1. TSC - Themes
  2. Funzioni e librerie

Prodotti

Segui
bestBuy

Restituisce i prodotti più venduti dal negozio.

bestBuy(count)
param type note default
count int Numero massimo di prodotti correlati automatici 4

*Funzione PRO: solo per temi con funzione dynamics. Contattaci per saperne di più

 
countProductsByParams

Ritorna il numero di prodotti in base ai parametri passati alla funzione

countProductsByParams(categoryUID,brandUID,filterArray)
param type note default
categoryUID int UID di una categoria  
brandUID int UID di un brand  
filterArray array Array associativo per applicare altri parametri di ricerca [] 
{% set filterArray = [] %}
{% set filterArray = filterArray | merge({"tags" : "new" }) %}
 
getCompleteItem

Recupare l'anagrafica prodotto completa, nella lingua corrente.

getCompleteItem(itemUID,getParams,getVariants,getImg,getBrandName)
param type note default
itemUID int UID (unique id) del prodotto  
getParams bool TRUE per recuperare anche i valori dei filtri associati FALSE
getVariants bool TRUE per recuperare le varianti del prodotto TRUE
getImg bool TRUE per recuperare tutte le immagini del prodotto FALSE
getBrandName bool TRUE per recuperare il nome del brand FALSE 
{
   "_id":{
      "$id":"5c5c62e816f46a045670090a"
   },
   "uid":1231285,
   "groupUID":114501,
   "title":"Scarpe eleganti con tacco",
   "slug":"scarpe-eleganti-con-tacco",
   "description":"Scarpe con tacco, struttura in pelle con suola antiscivolo e traspirante.",
   "taxable":0,
   "taxprofile":"5795bdb716f46a787c34ed8d",
   "brandUID":598,
   "brandName":"Glamour",
   "categoryUID":[
   	256,995,2684
   ],
   "stockCount":0,
   "price":100,
   "final_price":90,
   "sale":10,
   "weight":0.5,
   "dimension":{
      "w":30,
      "h":21,
      "z":15
   },
   "highview":1,
   "parameters":[
   	"tacco":"0",
   	"suola":"3",
   	"materiale":"2"
   ],
   "downloadfile":false,
   "shipping_cost":0,
   "code":"13167",
   "tags":[
   	"tacco","elegante"
   ],
   "status":1,
   "update_at":{
      "sec":1550566011,
      "usec":830000
   },
   "services":{
      "facebook":{
         "enable":1
      }
   },
   "seo":{
      "title":"Scarpa elegante con tacco",
      "description":"",
      "keywords":"scarpa,elegante,tacco",
      "url":"",
      "robots":""
   },
   "socialCategory":"",
   "data":{
      "ean13":"8536984523651",
      "mpn":"8058",
      "unlimited":true,
      "minQuantity":1,
      "step":1,
      "productType":"physical"
   },
   "packageTime":"1_3",
   "usevariants":1,
   "vars":{
      "taglia":{
         "title":"Scegli la taglia",
         "options":[
            {
               "title":"35",
               "option":"35"
            },
            {
               "title":"36",
               "option":"36"
            },
            {
               "title":"37",
               "option":"37"
            },
            {
               "title":"38",
               "option":"38"
            },
            {
               "title":"39",
               "option":"39"
            },
            {
               "title":"40",
               "option":"40"
            },
            {
               "title":"41",
               "option":"41"
            },
            {
               "title":"34",
               "option":"34"
            },
            {
               "title":"42",
               "option":"42"
            }
         ]
      },
      "colore":{
         "title":"Scegli il colore",
         "options":[
            {
               "title":"Marrone",
               "option":"marrone"
            },
            {
               "title":"Nero",
               "option":"nero"
            }
         ]
      }
   },
   "variants":[
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"35_marrone",
         "sku":"109178",
         "image":"https:\/\/tcdn.storeden.com\/gallery\/5c5c62fb16f46abf6370090a",
         "variants":{
            "Taglia":"35",
            "Colore":"marrone"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"35_nero",
         "sku":"109185",
         "image":"https:\/\/tcdn.storeden.com\/gallery\/5c5c631c16f46a776670090a",
         "variants":{
            "Taglia":"35",
            "Colore":"nero"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"36_marrone",
         "sku":"109179",
         "image":"",
         "variants":{
            "Taglia":"36",
            "Colore":"marrone"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"36_nero",
         "sku":"109186",
         "image":"",
         "variants":{
            "Taglia":"36",
            "Colore":"nero"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"37_marrone",
         "sku":"109180",
         "image":"",
         "variants":{
            "Taglia":"37",
            "Colore":"marrone"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"37_nero",
         "sku":"109187",
         "image":"",
         "variants":{
            "Taglia":"37",
            "Colore":"nero"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"38_marrone",
         "sku":"109181",
         "image":"",
         "variants":{
            "Taglia":"38",
            "Colore":"marrone"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"38_nero",
         "sku":"109188",
         "image":"",
         "variants":{
            "Taglia":"38",
            "Colore":"nero"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"39_marrone",
         "sku":"109182",
         "image":"",
         "variants":{
            "Taglia":"39",
            "Colore":"marrone"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"39_nero",
         "sku":"109189",
         "image":"",
         "variants":{
            "Taglia":"39",
            "Colore":"nero"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"40_marrone",
         "sku":"109183",
         "image":"",
         "variants":{
            "Taglia":"40",
            "Colore":"marrone"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"40_nero",
         "sku":"109190",
         "image":"",
         "variants":{
            "Taglia":"40",
            "Colore":"nero"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"41_marrone",
         "sku":"",
         "image":"",
         "variants":{
            "Taglia":"41",
            "Colore":"marrone"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"41_nero",
         "sku":"109191",
         "image":"",
         "variants":{
            "Taglia":"41",
            "Colore":"nero"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"34_marrone",
         "sku":"",
         "image":"",
         "variants":{
            "Taglia":"34",
            "Colore":"marrone"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"34_nero",
         "sku":"109184",
         "image":"",
         "variants":{
            "Taglia":"34",
            "Colore":"nero"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"42_marrone",
         "sku":"",
         "image":"",
         "variants":{
            "Taglia":"42",
            "Colore":"marrone"
         }
      },
      {
         "price":100,
         "final_price":100,
         "unlimited":true,
         "available":0,
         "superkey":"42_nero",
         "sku":"109192",
         "image":"",
         "variants":{
            "Taglia":"42",
            "Colore":"nero"
         }
      }
   ],
   "attributes":{
      "5b3c86c416f46ade5b0a0a47":"65",
      ...
   },
   "socialActive":1,
   "image_id":"5c5c62a016f46a365a70090a",
   "related":[
      {
         "original":"https://egress.storeden.net/jpg/5c5c62a016f46a365a70090a",
         "small":"https://static-cdn.storeden.com/secache/5c5c62a016f46a365a70090a"
      },
      ...
   ]
}
 
getCompleteItemBySKU

Anagrafica prodotto completa, nella lingua corrente.

getCompleteItemBySKU(sku,getParams,getVariants,getImg,getBrandName)
param type note default
sku string SKU del prodotto  
getParams bool TRUE per recuperare anche i valori dei filtri associati FALSE
getVariants bool TRUE per recuperare le varianti del prodotto TRUE
getImg bool TRUE per recuperare tutte le immagini del prodotto FALSE
getBrandName bool TRUE per recuperare il nome del brand FALSE

Vedi output di getCompleteItem.

 
getEstimatedDelivery

Usata in product.html per ottenere la possibile data di consegna del prodotto

getEstimatedDelivery(packageTime,shippingDelivery)
param type note default
packageTime string Tempo di preparazione alla spedizione del prodotto**  
shippingDelivery string Tempo di spedizione in base alla spedizione calcolata per il prodotto**  

*Funzione PRO: solo per negozi con packageTime abilitato. Contattaci per saperne di più
** Il calcolo si basa sull'indirizzo IP dell'utente

{% set ext_del = getEstimatedDelivery(product.packageTime, product.shipping_delivery_calculated) %}

{{ lang('estimated.delivery') }} {{ lang('from.delivery') }}
 {{ lang(ext_del.fromID)}} {{ ext_del.from }} 
{{ lang('to.delivery') }} {{ lang(ext_del.toID)}} {{ ext_del.to }}
 
getHighview

Lista dei prodotti in primo piano, se associati nel negozio

getHighview(limit,randomize)
param type note default
limit int Numero massimo di prodotti restituiti, 0 equivale a nessun limite 0
randomize bool TRUE per ordinamento casuale, FALSE naturale  
 
getItemTabDescription

Ottenere le descrizioni inserite nelle tab aggiuntive, nella lingua corrente, comprensive di titolo.

getItemTabDescription(itemUID)
param type note default
itemUID int UID (unique id) del prodotto  

Tutte le tab per cui esiste un contenuto nella lingua corrente.

{
	{
		"title" : "Scheda tecnica"
		"description" : "Testo della scheda tecnica..."
	},
	{
		"title" : "Composizione"
		"description" : "TTesto della tab composizione..."
	},
	...
}
 
getItemsByFilter

Cerca i prodotti in base ai parametri passati alla funzione

getItemsByFilter(categoryUID,brandUID,filterArray,orderArray,skip,limit)
param type note default
categoryUID int UID di una categoria  
brandUID int UID di un brand  
filterArray array Array associativo per applicare altri parametri di ricerca []
orderArray array Array associativo per ordinare i prodotti []
limit int Numero massimo di prodotti, 0 per non impostare un limite 0
skip int Skip prodotti, 0 per non impostare uno skip 0 
Parametri di ricerca: filterArray

{% set filterArray = [] %}

per categorie multiple o la categoria comprese le sottocategorie 

Passare categoryUID a null e:

{% set categoryUID = 123456 %}
// recupero le categorie figlie
{% set list_cat = getAllChildrenCategories(categoryUID, categorytree(categoryUID)) %}
{% set in_cat_array = [] |  merge({ '$in' : list_cat }) %}
{% set filterArray = filterArray | merge({ 'categoryUID' : in_cat_array }) %}

per filtro 

{% set filter_key = 'colore-principale' %}
{% set filterName = 'parameters.' ~ filter_key %}
{% set filterOptionIndex = '02' %} // index of option, not the value, see filters functions.
{% set filterArray = filterArray | merge({ (filterName) : (filterOptionIndex) }) %}

per tag

{% set tag = 'spring' %}
{% set filterArray = filterArray | merge({ 'tags' : tag }) %}

ottenere prodotti in primo piano 

{% set filterArray = filterArray | merge({ 'highview' : 1 }) %}

Ordinamento: sortArray

Può essere composto usando questi parametri:
uid, price, final_price, sale, title, highview (flag in primo piano)
con valori: 1 e -1

{% set sortArray = [] %}
{% set sortArray = sortArray | merge({"price" : -1 }) %}
 
getNumberOfSells

Restituisce il numero di volte in cui il prodotto è stato acquistato negli ultimi N giorni.

getNumberOfSells(itemUID,days)
param type note default
itemUID int UID (unique id) del prodotto  
days int Numero di giorni 7

*Funzione PRO: solo per temi con funzione dynamics. Contattaci per saperne di più

 
getParamValue

Ottiene i dettagli di un filtro applicato al prodotto

getParamValue(item,key,index)
param type note default
item object Oggetto item che rappresenta il prodotto  
key string Chiave del filtro  
index string Indice dell'opzione filtro associata al prodotto [] 
{
	"key" : "material",
	"entry_value" : "Materiale",
	"entry_key" : "Metallo"
}
 
getParticular

Ritorna i dettagli relativi alle opzioni di una variante: etichetta nella lingua corrente, etichette e immagini per le opzioni. Utile da usare quando si vogliono far comparire i quadratini colore nella scelta varianti del prodotto

getParticular(itemUID,key,values)
param type note default
itemUID int UID (unique id) del prodotto  
key string Nome della variante, es: taglia  
values array Opzioni della variante [] 
{
	"colore" : {
		"title" : "Colore principale",
		"options" : [
			{
				"title" : "Nero",
	      "option" : "black"
	      "image" : "http://static-cdn.storeden.com/..."
			},
			{
				"title" : "Bianco",
	      "option" : "white"
	      "image" : "http://static-cdn.storeden.com/..."
			},
			...
		]
	}
}
 
getRelatedImages

Ottenere le immagini correlate del prodotto

getRelatedImages(itemUID)
param type note default
itemUID int UID (unique id) del prodotto   
[
   {
      "original":"http://resource-cdn.storeden.com\/gallery\/5c5c62a016f46a365a70090a",
      "small":"http://static-cdn.storeden.com\/secache\/5c5c62a016f46a365a70090a"
   },
   {
      "original":"http://resource-cdn.storeden.com\/gallery\/5c6a8f0916f46a0a435bcc19",
      "small":"http://static-cdn.storeden.com\/secache\/5c6a8f0916f46a0a435bcc19"
   },
   ...
]
 
getRelatedItems

Lista dei prodotti correlati, se associati.

getRelatedItems(itemUID)
param type note default
itemUID int UID (unique id) del prodotto  

Lista di UID prodotto

{
	12467,5670,56783,...
}
 
getSpokenProductUrl

Ottiene l'url personalizzata del prodotto.

getSpokenProductUrl(itemUID,slug)
param type note default
itemUID int UID (unique id) del prodotto  
slug string SLUG inserita nel prodotto, da usare nel caso in cui non ci sia una url personalizzata  

*Funzione PRO: solo per negozi con funzione canonical URL attiva. Contattaci per saperne di più

 
getTaxProfile

Ottenere i dettagli di un profilo di spedizione.

getTaxProfile(tax_profile_id)
param type note default
tax_profile_id string product.taxprofile or item.taxprofile   
{
   "_id":{
      "$id":"5795bdb716f46a787c34ed8d"
   },
   "groupUID":114501,
   "countries":[
      15,
      24,
      35,
      37,
      61,
      63,
      64,
      65,
      75,
      81,
      82,
      91,
      95,
      111,
      117,
      119,
      137,
      143,
      144,
      152,
      175,
      197,
      198,
      202,
      220,
      221,
      226,
      233,
      253
   ],
   "value":22, // tax value
   "offvalue":0, // exclusion value
   "notes":"IVA 22%", // tax profile name
   "default":1, // 1 for main tax profile, 0 otherwise
   "deps":[]
}
 
getValidVars

Restituisce la lista delle varianti disponibili; Restituisce tutte le varianti se il prodotto è impostato come sempre disponibile.

getValidVars(itemUID,unlimited)
param type note default
itemUID int UID (unique id) del prodotto  
unlimited int Valore unlimited sul prodotto  
 
getVariantImages

Non standard. Utilizzabile solo nei negozi abilitati.
Restituisce le immagini prodotto associate alla SKU variante, altrimenti restituisce la singola immagine abbinata alla variante

getVariantImages(itemUID,variant_sku,variant)
param type note default
itemUID int UID (unique id) di un prodotto  
variant_sku string SKU abbinata alla variante  
variant array array della variante corrente (un elmento dell'array product.variants)  
 
getVariantOptionDetails

Ottenere i dettagli di una opzione di una variante del prodotto

getVariantOptionDetails(itemUID,variant,value)
param type note default
itemUID int UID (unique id) del prodotto  
variant string Nome variante (key)  
value string Nome opzione (key)  

I dettagli vengono restituiti se è stata aggiunta un'immagine in Catalogo > Varianti e un'etichetta in Strumenti > Traduzioni > Varianti

{% set details = getVariantOptionDetails(product.uid, "color", "black") %}
{
   "image":"https://tcdn.storeden.com/gallery/5c6bce1216f46a73325bcc1b",
   "name":"Nero"
}
 
getVariantOptions

Restituisce tutte le opzioni di una variante nel negozio

getVariantOptions(variant,sort)
param type note default
variant string Nome (key) della variante  
sort bool TRUE per ordinare alfabeticamente FALSE 
{% set options = getVariantOptions("colore", true) %}

{
	"variant_title":"Colore",
	"variant_key":"colore",
	"options":{
		"azzurro":{
			"option_title":"Azzurro",
			"option_image":"https:\/\/tcdn.storeden.com\/gallery\/5c0e4b5316f46a4419bc5f8d"
		},
		"marrone":{
			"option_title":"Marrone",
			"option_image":"https:\/\/tcdn.storeden.com\/gallery\/5c6bce1216f46a73325bcc1b"
		},
		"nero-nero":{
			"option_title":"Nero",
			"option_image":"https:\/\/tcdn.storeden.com\/gallery\/5c6bce0f16f46a73325bcc19"
		},
		"rosa":{
			"option_title":"Rosa ciliegia",
			"option_image":""
		},
		"rosso":{
			"option_title":"Rosso",
			"option_image":""
		},
		"verde-acqua":{
			"option_title":"Verde acqua",
			"option_image":""
		}
	}
}
 
getVariantOptionsSimple

Restituisce tutte le opzioni id una variante, rispetto a tutto il catalogo

getVariantOptionsSimple(variant,sort)
param type note default
variant string Nome della variante (colore, taglia, ... )  
sort bool Ordina le varianti false

Attenzione: tutte le varianti dovrebbero essere scritte nello stesso modo nel catalogo: Taglia è diverso da taglia ed è diverso da TAGLIA.

{% set taglie = getVariantOptionsSimple('taglia', true); %}

["35","36","37","38","39","40"]
 
hasWish

Restituisce TRUE se l'utente collegato ha inserito il prodotto in wishlist, FALSE altrimenti.

hasWish(itemUID)
param type note default
itemUID int UID (unique id) del prodotto  
 
selledWith

Restituisce i prodotti venduti insieme ad un altro prodotto.

selledWith(itemUID,count)
param type note default
itemUID int UID (unique id) del prodotto  
count int Numero massimo di prodotti correlati automatici 4

*Funzione PRO: solo per temi con funzione dynamics. Contattaci per saperne di più

 
Questo articolo ti è stato utile?
Utenti che ritengono sia utile: 0 su 0

Commenti

Questa è una guida per gli sviluppatori.

Se hai bisogno di aiuto per configurare il tuo tema

Visita questa sezione
Powered by Zendesk