Design:Variabile
From Katapulta
Contents |
Variabile globale
Variabilele globale sunt variabilele disponibile în toate template-urile sau widget-urile Katapulta. Cu alte cuvinte aceste variabile pot fi apelate în oricare dintre template-uri, indiferent de context. Acestea sunt următoarele:
collections
Conține lista de colecții de produse. Fiecare obiect din listă este o variabilă de tip collection.
blog
Conține lista de articole din blog-ul magazinului tău.
Atribute:
blog.all_posts
- lista de articole; fiecare obiect din listă este o variabilă de tip post; variabilablog.all_posts
poate avea următorii parametrii:
limit - valoarea trebuie să fie număr întreg și reprezintă primele X articole din blog;
{{ blog.all_posts({'limit': 5}) }}
Returneaza primele 5 articole
category_id - valoarea este un număr întreg și reprezintă id-ul unei categorii de articole;
{{ blog.all_posts({'category_id': 1}) }}
returnează doar articolele din categoria cu id-ul 1
blog.categories
- lista categorii de articole; fiecare obiect din listă este o variabilă de tip category
cart
Returnează coșul de cumpărături activ. Această variabilă poate fi folosită atât global cât și în template-ul cart.html.
Atribute:
cart.items
- conține lista de produse din coșul de cumpărături. Fiecare obiect din listă (item) are următoarele atribute:-
item.cart
- coșul de cumpărături în care se aflăitem
-
item.id
- id item -
item.quantity
- cantitatea -
item.price
- prețul -
item.variant
- varianta acestui articol din coș; obiect de tip variant -
item.product
- obiect de tip product -
item.property1_value
- valoarea caracteristicii 1 a produsului (variantei) -
item.property2_value
- valoarea caracteristicii 2 a produsului (variantei) -
item.property3_value
- valoarea caracteristicii 3 a produsului (variantei) -
item.compare_price
- prețul comparativ -
item.sku
- codul de inventar SKU -
item.weight
- greutatea -
item.total
- totalul articolului curent din coș (preț*cantitate) -
item.available_quantity
- cantitatea disponibilă -
item.track_inventory
- are valoareatrue
dacă articolul curent (item) este inventariat -
item.inventory_policy
- returneazăDENY
(produsul este scos de la vanzare când nu mai e în stoc) sauALLOW
(produsul poate fi cumpărat chiar dacă nu mai e în stoc)
-
-
cart.item_count
- numărul de produse din coșul de cumpărături -
cart.total_price
- prețul total al produselor aflate în coșul de cumpărături curent -
cart.total_weight
- greutatea totală a produselor din coșul de cumpăraturi curent -
cart.note
- nota pe care cumpărătorul o atașează -
cart.total_cart
- totalul coșului de cumpărături (inclusiv costul transportului)
link_lists
Conține listele de linkuri (meniurile definite în secțiunea Navigare).
Apelarea unei liste de linkuri se face astfel:
<ul>
{% for link in link_lists['main-menu'].links %}
<li><a href="{{ link.url }}">{{ link.title|e }}</a></li>
{% endfor %}
</ul>
Fiecare obiect din lista link_lists are următoarele atribute:
-
link_list.id
- id-ul listei de linkuri -
link_list.title
- denumirea listei de linkuri -
link_list.links
- link-urile listei; fiecare obiect din această listă are următoarele atribute:-
link.id
- id link -
link.title
- denumire link -
link.target
- target link -
link.url
- URL link
-
vendors
Lista de producători. Fiecare obiect din listă este o variabilă de tip vendor.
product_types
Lista de tipuri de produse. Fiecare obiect din listă este o variabilă de tip product_type.
pages
Lista de pagini statice. Fiecare obiect din listă este o variabilă de tip page.
active_url
URL-ul activ
shop
Conține informații despre magazinul tău așa cum au fost definite în secțiunea setări magazin.
Atribute:
-
shop.name
- numele magazinului -
shop.url
- adresa web a magazinului -
shop.email
- email-ul magazinului
Variabile specifice template-urilor
product
Returnează produsul curent. Această variabilă este folosită în template-ul product.html.
Atribute:
-
product.id
- id-ul produsului curent -
product.title
- titlul produsului curent -
product.description
- descrierea produsului curent -
product.is_physical
- produsul curent este palpabil? -
product.has_variants
- produsul curent are variante? -
product.property1
- caracteristica 1 -
product.property2
- caracteristica 2 -
product.property3
- caracteristica 1 -
product.tags
- etichetele produsului curent (separate prin virgulă) -
product.creation_time
- data/ora la care a fost creat produsul -
product.url
- URL-ul produsului -
product.variants
- variantele produsului curent; fiecare obiect din listă este o variabilă de tipvariant
:-
variant.id
- id-ul variantei -
variant.price
- prețul -
variant.product
- produsul din care face parte varianta curentă -
variant.property1_value
- valoarea caracteristicii 1 -
variant.property2_value
- valoarea caracteristicii 2 -
variant.property3_value
- valoarea caracteristicii 3 -
variant.property_values
- returnează valorile caracteristicilor sub forma: property1/propery2/property3 -
variant.compare_price
- prețul comparativ -
variant.sku
- codul de inventar SKU -
variant.weight
- greutatea -
variant.quantity
- cantitatea din stoc a variantei curente -
variant.track_inventory
- varianta curentă este inventariată? -
variant.inventory_policy
- politica de inventariere: ALLOW (varianta poate fi cumpărată chiar dacă produsul nu mai e în stoc) sau DENY (dacă varianta nu mai e în stoc, atunci nu mai poate fi cumpărată)
-
-
product.images
- lista cu imaginile produsului; fiecare obiect din listă este o variabilă de tipimage
:-
image.filename
- numele fișierului imagine -
image.image_url
- URL-ul imaginii curente -
image.thumb_url
- URL-ul imaginii thumbnail curente
-
-
product.collections
- lista colecțiilor din care face produsul curent; fiecare obiect din listă este o variabilă de tip collection -
product.price_varies
- returneazătrue
dacă prețul variantelor produsului curent diferă (adică, variantele produsului curent nu au același preț) -
product.price
- prețul produsului curent -
product.price_min
- prețul minim al variantelor acestui produs -
product.price_max
- prețul maxim al variantelor acestui produs -
product.compare_price
- prețul comparativ -
product.compare_price_min
- prețul comparativ minim al variantelor acestui produs -
product.compare_price_max
- prețul comparativ maxim al variantelor acestui produs -
product.compare_price_varies
- returneazătrue
dacă prețul comparativ al variantelor produsului curent diferă -
product.requires_shipping
-
product.type
- tipul produsului curent -
product.vendor
- producătorul produsului curent -
product.featured_photo
- funcție care returnează numele (alt) și URL-ul (src) imaginii principale;
Parametrii:
{{ product.featured_photo('small')['src'] }}
{{ product.featured_photo('small')['alt'] }}
{{ product.featured_photo('medium')['src'] }}
{{ product.featured_photo('medium')['alt'] }}
{{ product.featured_photo('large')['src'] }}
{{ product.featured_photo('large')['alt'] }}
Exemplu:
<img src="{{ product.featured_photo('large')['src'] }}" alt="{{ product.featured_photo('large')['alt'] }}"/>
collection
Returnează colecția de produse curentă. Această variabilă este folosită în template-ul collection.html.
Atribute:
-
collection.id
- id-ul coleției -
collection.title
- denumirea colecției -
collection.collection_type
- tipul colecției (automată sau manuală) -
collection.description
- descrierea colecției -
collection.products
- lista de produselor care fac parte din coleția curentă; fiecare obiect din listă este o variabilă de tip product -
collection.url
- ULR-ul colecției -
collection.product_count
- numărul de produse din colecția curentă
page
Returnează pagina statică curentă. Această variabilă este folosită în template-ul page.html.
Atribute:
-
page.id
- id-ul paginii -
page.title
- titlul paginii -
page.content
- conținutul paginii -
page.url
- URL-ul paginii
post
Returnează articolul curent din blogul magazinului tău. Această variabilă este folosită în template-ul post.html.
Atribute:
-
post.id
- id-ul articolului -
post.title
- tiltul articolului -
post.author
- autorul -
post.content
- conținutul -
post.last_update_time
- ultima data/oră de actualizare a articolului -
post.creation_time
- data/ora creării articolului -
post.handle
- identificatorul unic articolului -
post.url
- URL-ul articolului -
post.comment_count
- numărul de comentarii ale articolului curent -
post.comments
- lista de comentarii; fiecare obiect din lista de comentarii este o variabilă de tipcomment
cu următoarele atribute:-
comment.id
- id-ul comentariului -
comment.post_id
- id-ul articolului din care face parte comentariul -
comment.author
- autorul comentariului -
comment.content
- conținutul comentariului -
comment.creation_time
- data creării comentarilui -
comment.has_error(atribut)
- funcție care testează dacăatribut
are erori -
comment.display_error(atribut)
- funcție care afișează eroarea pentruatribut
-
comment.url
- URL comentariu
-
-
post.category
- categoria din care face parte articolul curent -
post.comments_denied
- returneazătrue
dacă comentariile asupra articolului curent nu sunt permise
category
Returnează categoria de articole curentă. Această variabilă este folosită în template-ul postcategory.html.
Atribute:
-
category.id
- id-ul categoriei -
category.title
- titlul -
category.url
- URL-ul categoriei -
category.posts
- conține lista de articole; fiecare element din listă este o variabilă de tip post
product_type
Returnează tipul de produs curent. Această variabilă este folosită în template-ul collection-by-type.html.
Atribute:
-
product_type.title
- denumirea tipului de produs curent -
product_type.url
- URL-ul tipul de produs curent -
product_type.products
- lista de produse a tipului de produs curent; fiecare obiect din listă este o variabilă de tip product
vendor
Returnează producătorul curent. Această variabilă este folosită în template-ul collection-by-vendor.html.
Atribute:
-
vendor.title
- denumirea producătorului curent -
vendor.url
- URL-ul producătorului curent -
vendor.products
- lista de produse a producătorului curent; fiecare obiect din listă este o variabilă de tip product
catalog
Returnează produsele din colecția cu identificatorul catalog. Dacă această colecție nu este definită va returna toate produsele din magazin.
Această variabilă este folosită în template-ul catalog.html.
Atribute:
-
catalog.products
- conține lista de produse; fiecare obiect din lista este o variabilă de tip product.
Variabile Email
Template-urile pentru trimiterea emailurilor se găsesc în secțiunea Setări -> Șabloane email a părții de administrare. Următoarele email-uri pot fi personalizate folosind tag-urile Twig:
- Confirmare comandă
- Confirmare livrare
- Contactează cumpărător
- Notificare comandă nouă
shop_name
Returnează numele magazinului așa cum a fost definit la secțiunea Setări magazin.
order
Returnează comanda curentă făcută de un cumpărător. Variabilaorderare următoarele atribute:
-
order.id
- numărul comenzii -
order.order_date
- data plasării comenzii -
order.subtotal
- valoarea totală a produselor din comanda curentă -
order.shipping
- costul transportului pentru comanda curentă -
order.total
- valoarea totală a comenzii curente (subtotal+shipping) -
order.payment_method
- metoda de plată -
order.shipping_method
- metoda de livrare
items
Lista articolelor (produselor) din comanda curentă. Fiecare element din lista este o variabilă de tipitemcu următoarele atribute:
-
item.sku
- codul de inventar -
item.name
- numele produsului din comandă -
item.quantity
- cantitatea comandată -
item.price
- prețul produsului din comandă
customer
Această variabilă conține informații despre cumpărător.
Are următoarele atribute:
-
customer.name
- numele complet al cumpărătorului (nume+prenume) - informații livrare
-
customer.shipping_firstname
- prenume -
customer.shipping_lastname
- nume -
customer.shipping_address_line1
- adresa linia 1 -
customer.shipping_address_line2
- adresa linia 2 -
customer.shipping_city
- localitate -
customer.shipping_province
- judet (provincie) -
customer.shipping_zip
- cod poștal -
customer.shipping_phone
- telefon
-
- informații facturare
-
customer.billing_firstname
- prenume -
customer.billing_lastname
- nume -
customer.billing_address_line1
- adresa linia 1 -
customer.billing_address_line2
- adresa linia 2 -
customer.billing_city
- localitate -
customer.billing_province
- judet (provincie) -
customer.billing_zip
- cod poștal -
customer.billing_phone
- telefon
-