Kódok a Brani Tisku sablonokhoz

Alapvető információk

A sablon szerkesztésekor a Brani Tiskban a képernyő felső részén megtalálhatók a rendeléssel vagy termékkel kapcsolatos adatok, amelyekkel dolgozhat, például:

Ugyanakkor lehetséges egy adott termékhez vagy megrendeléshez tartozó adatokat betölteni, ha kitölti a saját tesztadatait:

Ha a sablonban a adatfa változóját szeretné használni, például a termék nevét, akkor a következő szintaxist használja:

{{ product.name }}

‍

Ha az adatok többszintűek, akkor a kulcsokat tömbként kell kezelni. Például a szállító nevének kinyomtatásához:

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

‍

Bizonyos esetekben előfordulhat, hogy ciklust kell használni, mert például a paraméterek tetszőleges számú paraméter-érték párost tartalmaznak. Ebben az esetben ez például í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 bővebben később írunk.

Címke méretek

Nagyon fontos, hogy pontosan meghatározza a „felület” méretét, amelyre az információkat fel fogja helyezni. Például a címkék és termékek készítése olyan folyamat, amelyet fokozatosan finomítunk azzal, hogy kipróbáljuk a nyomtatást, teszteljük a különböző betűméreteket és hasonlókat. Az alap a címke megfelelő méretének beállítása.

Kódok generálása

Különböző típusú 1D és 2D kódokat tudunk generálni. A bemeneti szöveg tetszőleges lehet, leggyakrabban termék- vagy EAN-kódot használnak. Támogatott kódtípusok (ez befolyásolja a kód végső képének megjelenését):

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:

• qr – egy viszonylag kicsi kód, amely nagy mennyiségű adatot képes tárolni, ehhez 2D-olvasóra van szükség
• ean – a szokásos 13 számjegyű kódokhoz
• code128 – alkalmas olyan kódokhoz, amelyeknek nincs pontos hossza, és betűket, kötőjeleket, aláhúzásokat és hasonlókat tartalmaznak
  

A bejegyzés ezután így néz ki:

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

‍

Ezt akkor használja, ha a termék kódjából code128 vonalkó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. Ugyanakkor be- vagy kikapcsolható az úgynevezett „label” – ez egy kód, amely a vonalkód méretét és a kódtól való eltolását jelzi.

A QR-kód különlegessége, hogy nem határozza meg az argumentumokat. A QR-kód esetében a kép CSS segítségével testreszabható.

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

‍

A kód a következőképpen néz ki:

A QR-kódot használhatja az e-shop keresőjébe történő átirányításra is a termék kódja alapján:

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

‍

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

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

Feltételek

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

{% if feltétel %}
  // mit kell végrehajtani, ha a feltétel teljesül
{% else %}
  // mit kell végrehajtani, ha a feltétel nem teljesül
{% endif %}

‍

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

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

Ciklus

A ciklus leggyakrabban olyan esetekben használatos, amikor táblázatot kell létrehozni a megrendelésen szereplő termékek listájával vagy a termékek paramétereivel.

Megrendelések

A megrendelésen szereplő termékek felsorolásához (például visszaküldési űrlapok esetén) használhatja ezt a ciklust:

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

  {{ item.amount }} db 

  {{ item.itemPrice.withVat }} Kč 

  

{% endfor  %}

‍

A szebb táblázat érdekében például a következőket írja be:

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

‍

Így fog ez kinézni:

Termékek

A termékeknél a ciklusokat gyakran használják a paraméterek felsorolásához.

Árlisták

{{ pricelists[123].price }}

‍

Ahol „123” az árlista azonosítója.

Brani Sklad

Ha Ön a Brani Sklad, akkor a termékekhez felveheti azokat a szektorokat vagy raktári pozíciókat, ahol a termék található. Ehhez két változó szolgál:

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

‍

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

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

‍

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

Fejlett funkciók

A sablonrendszer támogatja a Python nyelv egyes módszereit.

Változók használata

Ha bonyolultabb sablont készít, akkor hasznos lehet a változók használata.

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

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

‍

A következő mezőket 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övegelemzés

{% 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 Táblázatok

Ha olyan információkat kell feltüntetnie a címkén , amelyek nem szerepelnek a termék e-shopban, akkor ezeket az információkat elmentheti a Google táblázatokba, é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éhez, az adagoláshoz, a használati utasításhoz, a gyártóval kapcsolatos információkhoz és hasonlóakhoz. Ha például a táblázatokban minden gyártóhoz tartozik egy leírás, ezeket a leírásokat később címkére is kinyomtathatja.

Az alapvető szintaxis a táblázat cellájának kereséséhez és kiírásához:

{{ 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é, hogy a „leírás” oszlop tartalma a „termékkód” oszlop tartalmát tartalmazza, akkor a következőket írja be:

{{ 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') }}

‍

Figyelj arra, hogy a Google táblázatnak nyilvánosan hozzáférhetőnek kell lennie a megadott URL-címen.