A sablonok kódjai a Brani Print oldalon

Alapvető információk

Amikor a Brani Print oldalon szerkeszt egy sablont, a képernyő tetején információkat talál például arról, hogy milyen rendelési vagy termékadatokkal dolgozhat:

Lehetőség van arra is, hogy egy adott termékre vagy megrendelésre vonatkozó adatokat kérjen le saját tesztadatainak kitöltésével:

Ha a sablonban az adatfából származó változót, például egy terméknevet szeretne használni, akkor ezt a szintaxist használja:

{{ product.name }}

‍

Amennyiben az adatok több beágyazott adatot tartalmaznak, a kulcsokat tömbként kell kezelni. Például a szállító nevének felsorolásához:

{{ product.supplier['name'] }}

‍

Bizonyos esetekben szükség lehet egy ciklus használatára, mert például a paraméterek tetszőleges számú paraméter-érték párt tartalmaznak. Ebben az esetben ez így nézhet ki:

{% for param in product.descriptiveParameters %}
  Nazev param: {{ param['name'] }} 
  Hodnota: {{ param['value'] }} 
{% endfor %}

‍

A ciklusok és általában a paraméterekkel való munka sokkal bonyolultabb lehet, erről később.

Címke méretek

Nagyon fontos, hogy helyesen határozza meg annak a "területnek" a méretét, amelyre az információkat be fogja illeszteni. A címkék és termékek létrehozása például egy olyan folyamat, amelyet úgy finomítunk, hogy fokozatosan próbáljuk ki őket kinyomtatni, különböző betűméreteket tesztelünk, és így tovább. A megfelelő címkeméret beállítása a kulcs.

Kódgenerálás

Különböző típusú 1D és 2D kódokat tudunk generálni. A bemeneti szöveg lehet bármilyen, leggyakrabban használt termékkód vagy EAN. Támogatott kódtípusok (ez befolyásolja, hogyan fog kinézni a végleges kódkép):

qr, barcode_code128, barcode_ean, barcode_ean8, barcode_gtin, barcode_ean14, barcode_jan, barcode_upc, barcode_upca, barcode_isbn, barcode_isbn13, barcode_gs1, barcode_isbn10, barcode_issn, barcode_code39, barcode_pzn, barcode_code128, barcode_itf, barcode_gs1_128

‍

A leggyakrabban használt kódok a következők:

• qr - viszonylag kicsi kód, amely nagy mennyiségű adatot képes tárolni, olvasásához 2D olvasóra van szükség.
• ean - a gyakori 13 számjegyű kódok esetében
• code128 - olyan kódokhoz alkalmas, amelyek nem pontos hosszúságúak, és betűket, kötőjeleket, aláhúzásokat stb. tartalmaznak.
  

A jelölés így néz ki:

<img src="{{ premenna | typ_kodu(argumenty) }}">

‍

Ezt akkor használja, ha a termékkódból egy 128-as von alkódkódot szeretne generálni:

<img src="{{ product.variant.code | barcode_code128(height=10, width=0.5, label=True, font_size=8, text_offset=2.5) }}" >

‍

Lehetőség van a vonalkód magasságát vagy szélességét befolyásoló argumentumok testreszabására. Lehetőség van a "címke" be- vagy kikapcsolására is - ez az a kód, amely a méretét és a behúzását jelenti magától a kódtól.

A QR-kód annyiban különleges, hogy nem ad meg argumentumokat. A QR-kód esetében lehetőség van a kép testreszabására CSS segítségével.

<img src="{{ product.variant.code | qr() }}"  style="width: 4cm">

‍

A kód így néz ki:

A QR-kód segítségével átirányíthatja a webáruház termékkód szerinti keresésére is:

<img style="height: 120px" src="{{ ("https://brani.myshoptet.com/vyhledavani/?string=" + product.variant.code)  | qr  }}" />

‍

Vagy közvetlenül a termék részleteire is hivatkozhat:

<img style="height: 120px" src="{{ product.url  | qr  }}" />

Feltételek és feltételek

A feltétel alapvető szintaxisa a következő:

{% if subminute %}
  // mi a teendő, ha a feltétel igaz
{% else %}
  // mi a teendő, ha a feltétel nem teljesül
{% endif %}

‍

Ha a termék láthatóságán alapuló feltételt szeretne használni, akkor állítsa be:

{% if product.visibility == "hidden" %}
  rejtett termék
{% else %}
  product shown
{% endif %}

Ciklus

A hurkot leggyakrabban akkor használjuk, amikor egy táblázatot kell létrehozni a termékek listájával egy sorrendben vagy termékparaméterekkel.

Megrendelések

A termékek sorrendben történő felsorolásához (például a visszaküldési űrlapokhoz) ezt a ciklust használhatja:

{% for item in order['items'] %}
  {{ item.name }} 

  {{ item.amount }} ks 

  {{ item.itemPrice.withVat }} CZK 

  

{% endfor %}

‍

Egy szebb táblázathoz illessze be például:

      <div class="produkty">
         <div class="produkty-vypis produkty-hlavicka">
            <span>Počet</span>
            <span></span> 
            <span>Produkt</span>
            <span class="text-right">Cena bez DPH</span>
            <span class="text-right">Cena s DPH</span>
         </div>
         {% for item in order['items'] %}
         <div class="produkty-vypis">
            <span>{{ item.amount }} ks</span>
            <span></span> 
            <span>{{ item.name }}</span>
            <span class="text-right">{{ item.itemPrice.withoutVat }}Kč</span>
            <span class="text-right">{{ item.itemPrice.withVat }} Kč</span>
         </div>
         {% endfor  %}
      </div>
      <div class="celkem text-right">
         Celkem:
         <span>{{ order.price.toPay }} Kč</span>
      </div>

‍

És így fog kinézni utána:

Termékek

A termékek esetében a ciklusokat gyakran használják a paraméterek felsorolására.

Árlisták

{{ pricelists[123].price }}

‍

Ahol a "123" az árlista azonosítóját jelöli.

Brani Raktár

Ha a Brani Warehouse-t használja, akkor felsorolhatja azokat az ágazatokat vagy raktárhelyeket, ahol a termék található. Ehhez két változó áll rendelkezésre:

{{ pozíciók }}
{{ szektorok }}

‍

A pozíciók (vagy szektorok) listája vesszővel vagy elválasztójellel a megadott pozícióban kerül kiírásra, például:

A1-1-2, C3-4-8, D5-1-1

‍

Ha a termék egy pozícióban van, csak ez az egy pozíció jelenik meg.

Speciális funkciók

A sablonrendszer támogat néhány Python-módszert.

Változók használata

Ahogy összetettebb sablonokat készít, hasznosnak fogja találni a változók használatát.

{%  set foo = "bar" %}
Vypise bar: {{ foo }} 

{% set foo = product.name %}
Vypise nazov produktu: {{ foo }}

‍

A mezőt is használhatja:

{% set productname = namespace(cz="", de="", sk="",en="") %}
{% set productname.cz = "cesky nazev" %}
{% set productname.de = "nemecky nazev" %}
Vypise cesky nazev: {{ productname.cz }}
Vypise nemecky nazev: {{ productname.de }}

‍

Számok kerekítése

Vypise "123.46": {{ 123.45678 | round }}

‍

Dátum és idő

Aktualni datum a cas:
{{ datetime.now().strftime('%d.%m.%Y %H:%M') }}

Datum a cas za 180 dni:
{{ (datetime.now() + timedelta(days=180)).strftime('%d.%m.%Y %H:%M') }}

‍

Szöveg elemzése

{% if product.internalNote: %}
{% for line in product.internalNote.split("\n"):  %}
    {% if line.startswith("CZ:"): %}
        {% set productname.cz = "
".join(line.split("CZ: ")[1].split(';')) %}
    {% endif %}
      {% if line.startswith("SK:"): %}
        {% set productname.sk = "
".join(line.split("SK: ")[1].split(';')) %}
    {% endif %}
{% endfor %}
{% endif %}

‍

Google Sheets

Ha olyan információkra van szüksége a címkén, amelyek nem szerepelnek a terméken a boltban, akkor ezeket az információkat a Google Sheetsben tárolhatja, és onnan lekérheti a szükséges adatokat.

Ez hasznos lehet például a termék összetételének különböző nyelveken történő feltüntetésére, az adagolásra, a felhasználás módjára, a gyártóra vonatkozó információkra stb. Ha például a táblázatokban minden gyártóhoz tartozik egy leírás, akkor ezek a leírások a címkékre nyomtathatók.

Az alapvető szintaxis a táblázat celláiból való nem kúszás és dumpoláshoz a következő:

{{ vstup | gsheet(
url='https://docs.google.com/spreadsheets/d/hash', 
sheet_name='nazev listu', 
lookup_column_name='sloupec kde hladame ', 
value_column_name='sloupec ktery hledame'
) }}

‍

Ha azt szeretnénk, hogy a "leírás" oszlop tartalma, azon a soron, ahol a "termékkód" oszlop tartalma lesz, a termékünk kódja, ezt töltsük ki:

{{ product.variant.code | gsheet(url='https://docs.google.com/spreadsheets/d/hash', sheet_name='nazev listu', lookup_column_name='kod produktu', value_column_name='popis') }}

‍

Kérjük, vegye figyelembe, hogy a Google Sheet-nek nyilvánosan elérhetőnek kell lennie a megadott URL-címen.