Design:Variabile

From Katapulta

(Difference between revisions)

Jump to: navigation, search

Revision as of 12:30, 3 May 2011

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; variabila
```
blog.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 valoarea
```
true
```
  dacă articolul curent (item) este inventariat
- ```
item.inventory_policy
```
  - returnează
```
DENY
```
  (produsul este scos de la vanzare când nu mai e în stoc) sau
```
ALLOW
```
  (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 tip
```
variant
```
:
- ```
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 tip
```
image
```
:
- ```
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 tip
```
comment
```
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 pentru
```
atribut
```
- ```
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

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

order

are 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 tip

item

cu 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

@@ Line 9: / Line 9: @@
 Atribute:
 *<pre>blog.all_posts</pre> - lista de articole; fiecare obiect din listă este o variabilă de tip [[Design:Variabile#post|post]]; variabila <pre>blog.all_posts</pre> poate avea următorii ''parametrii'':
-**'''limit''' - valoarea trebuie să fie număr întreg  și reprezintă primele X articole din blog;
+'''limit''' - valoarea trebuie să fie număr întreg  și reprezintă primele X articole din blog;
 <html><div class="highlight"><pre>
 <span class="cp">{{</span> <span class="nv">blog.all_posts</span><span class="o">({</span><span class="s1">'limit'</span><span class="o">:</span> <span class="m">5</span><span class="o">})</span> <span class="cp">}}</span><span class="x"></span>
 </pre></div></html>
 <pre class="output">Returneaza primele 5 articole</pre>
-**'''category_id''' - valoarea este un număr întreg și reprezintă id-ul  unei categorii de articole;
+'''category_id''' - valoarea este un număr întreg și reprezintă id-ul  unei categorii de articole;
 <html><div class="highlight"><pre>
 <span class="cp">{{</span> <span class="nv">blog.all_posts</span><span class="o">({</span><span class="s1">'category_id'</span><span class="o">:</span> <span class="m">1</span><span class="o">})</span> <span class="cp">}}</span><span class="x"></span>

Personal tools

Search

Manual de utilizare

Ghid pentru designeri

Tutoriale

Administrare Wiki

Namespaces

Variants

Views

Actions

Design:Variabile

From Katapulta

Revision as of 12:30, 3 May 2011

Contents

Variabile globale

collections

blog

cart

link_lists

vendors

product_types

pages

active_url

shop

Variabile specifice template-urilor

product

collection

page

post

category

product_type

vendor

catalog

Variabile Email

shop_name

order

items

customer