Design:Variabile

From Katapulta

(Difference between revisions)

Jump to: navigation, search

Revision as of 09:44, 2 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
```
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
```
- returnează numele și URL-ul imaginii principale; se folosește astfel:

<img src="{{ product.featured_photo('large')['src'] }}" alt="{{ product.featured_photo('large')['alt'] }}"/>

collection.id *

collection.title

*

collection.collection_type

*

collection.description

*

collection.products

- lista de obiecte de tip [[Design:Variabile#product|product]] *

collection.url

*

collection.product_count

===page=== Returnează pagina statică curentă. Această variabilă este folosită în template-ul [[Design:Page.html|page.html]]. Atribute: *

page.id

*

page.title

*

page.content

*

page.url

===post=== Returnează articolul curent din blogul magazinului tău. Această variabilă este folosită în template-ul [[Design:Post.html|post.html]]. Atribute: *

post.id

*

post.title

*

post.author

*

post.content

*

post.last_update_time

*

post.creation_time

*

post.handle

*

post.url

*

post.comment_count

*

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

*

post.comments_denied

===category=== Returnează categoria de articole curentă. Această variabilă este folosită în template-ul [[Design:Postcategory.html|postcategory.html]]. Atribute: *

category.id

*

category.title

*

category.url

*

category.posts

- conține lista de articole; fiecare element din listă este o variabilă de tip [[Design:Variabile#post|post]] ===product_type=== Returnează tipul de produs curent. Această variabilă este folosită în template-ul [[Design:Collection-by-type.html|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 [[Design:Variabile#product|product]] ===vendor=== Returnează producătorul curent. Această variabilă este folosită în template-ul [[Design:Collection-by-vendor.html|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 [[Design:Variabile#product|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 [[Design:Catalog.html|catalog.html]]. Atribute: *

catalog.products

- conține lista de produse; fiecare obiect din lista este o variabilă de tip [[Design:Variabile#product|product]].

@@ Line 116: / Line 116: @@
 ** <pre>image.thumb_url</pre> - URL-ul imaginii thumbnail curente
 * <pre>product.collections</pre> - lista colecțiilor din care face produsul curent; fiecare obiect din listă este o variabilă de tip [[Design:Variabile#collection|collection]]
-* <pre>product.price_varies</pre> -
+* <pre>product.price_varies</pre> - returnează <pre>true</pre> dacă prețul variantelor produsului curent diferă (adică, variantele produsului curent nu au același preț)
-* <pre>product.price</pre>
+* <pre>product.price</pre> - prețul produsului curent
-* <pre>product.price_min</pre>
+* <pre>product.price_min</pre> - prețul minim al variantelor acestui produs
-* <pre>product.compare_price</pre>
+* <pre>product.price_max</pre> - prețul maxim al variantelor acestui produs
-* <pre>product.compare_price_min</pre>
+* <pre>product.compare_price</pre> - prețul comparativ
-* <pre>product.compare_price_max</pre>
+* <pre>product.compare_price_min</pre> - prețul comparativ minim al variantelor acestui produs
-* <pre>product.compare_price_varies</pre>
+* <pre>product.compare_price_max</pre> - prețul comparativ maxim al variantelor acestui produs
+* <pre>product.compare_price_varies</pre> - returnează <pre>true</pre> dacă prețul comparativ al variantelor produsului curent diferă
 * <pre>product.requires_shipping</pre>
-* <pre>product.type</pre>
+* <pre>product.type</pre> - tipul produsului curent
-* <pre>product.vendor</pre>
+* <pre>product.vendor</pre> - producătorul produsului curent
-* <pre>product.featured_photo</pre>
+* <pre>product.featured_photo</pre> - returnează numele și URL-ul imaginii principale; se folosește astfel:
+<html><div class="highlight"><pre>
+<span class="x">&lt;img src="</span><span class="cp">{{</span> <span class="nv">product.featured_photo</span><span class="o">(</span><span class="s1">'large'</span><span class="o">)[</span><span class="s1">'src'</span><span class="o">]</span> <span class="cp">}}</span><span class="x">" alt="</span><span class="cp">{{</span> <span class="nv">product.featured_photo</span><span class="o">(</span><span class="s1">'large'</span><span class="o">)[</span><span class="s1">'alt'</span><span class="o">]</span> <span class="cp">}}</span><span class="x">"/&gt;</span>
+</pre></div></html
 ===collection===

Personal tools

Search

Manual de utilizare

Ghid pentru designeri

Tutoriale

Administrare Wiki

Namespaces

Variants

Views

Actions

Design:Variabile

From Katapulta

Revision as of 09:44, 2 May 2011

Contents

Variabile globale

collections

blog

cart

link_lists

vendors

product_types

pages

active_url

shop

Variabile specifice template-urilor

product