
Labely APP Dokumentáció
A Labely az Appmify-tól egy dinamikus eszköz a készlet- és szállítási idő címkék kezelésére a Shopify boltodban. Lehetővé teszi a testreszabást szabályok és stílusok alapján, hogy javítsd boltod funkcionalitását és a felhasználói élményt.
Alapvetően a rendszerünk lehetővé teszi, hogy annyi szabályt hozz létre, amennyire csak szükséged van a boltod számára. Ezek a szabályok biztosítják a testreszabott üzenetek megjelenítését a termékek különböző készletállapotai alapján.

APP Dokumentáció
Első lépések:
1) Előkészületek. Miután telepítetted az alkalmazást az áruházadba, ha nem találod, engedélyezd a Labely-t a Shopify témádban az alábbi lépések követésével:
- Lépj a Labely alkalmazás főoldalára.
- Kattints a gombra az alkalmazás blokkjának engedélyezéséhez a témádban.
- Alternatív megoldásként manuálisan is aktiválhatod a blokkot a Téma testreszabóban, ha kiválasztod az „Alkalmazás beágyazása” opciót, majd a „Labely”-t.
Ahhoz, hogy a Labely megfelelően működjön, szükséges az alkalmazás beágyazási blokk engedélyezése a témádban. Ez azonban csak a Store 2.0 típusú témákban működik, ahol a termékek részletes információi megjelennek.
2) Szabályok áttekintése:
Az alkalmazás beállításai között lehetőséged van konfigurálni, hogy mely címkék jelenjenek meg különböző helyzetekben. A címkék hatékony kezelése és priorizálása érdekében, különösen akkor, ha több címke is vonatkozik egyetlen termékre, az alkalmazás hierarchikus szabályrendszert alkalmaz. Ez a rendszer biztosítja a hatékony betöltést és feldolgozást azáltal, hogy egyértelmű precedenciát állít fel a címkék között. Vedd figyelembe ezt a priorizálást:
- A termékre vonatkozó szabályok rendelkeznek a legnagyobb prioritással.
- A szállítói szabályok felülírhatják a gyűjtemények és metafield-ek szabályait.
- A gyűjteményszabályok csak a metafield-szabályokat írják felül.
- A metafield-szabályok a legszélesebb körűek, és rendelkeznek a legalacsonyabb prioritással.
3) Szabályok metafield-ek használatával:
A sebesség növelése érdekében a metafield értékeket a Storefront-tól kérjük le, majd ezeket átadjuk az alkalmazásnak. Ennek érdekében néhány feltételnek teljesülnie kell:
- Minden metafield-et láthatóvá kell tenni a Storefront számára.
- A metafield névtereket hozzá kell adni a blokk beállításaihoz. Ennek megkönnyítésére az alkalmazás főoldalán találsz egy eszközt, amely felsorolja az összes szükséges névteret. Csak másold ki a listát, és illeszd be a blokk beállításaiba.
- Sajnos nem lehetséges egységesíteni ezt a beállítást. Így minden egyes blokk használatakor – például különböző terméksablonok vagy gyűjteménysablonok esetén – külön-külön meg kell adnod ezt a listát.
Ezeket a feltételeket figyelembe véve azt javasoljuk, hogy a 'stocktime' névteret használd az értékek biztosítására. Ez a névtér már szerepel a listában, amikor új blokkot hozol létre, így megkönnyíti a blokkok karbantartását a Storefront-on.
Azonban van lehetőség arra is, hogy gyűjteményeket hozz létre metafield értékek alapján. Ez akkor lehet hasznos, ha nem szeretnéd megjeleníteni a metafield-eket a Storefront-on. Ilyenkor egyszerűen létrehozhatsz egy új, gyűjteményalapú szabályt a termékek kezelésére. Bár több lépést igényel, de egy jó alternatívát jelent.
4) Szabály létrehozása:
Szabály szerkesztésekor az alábbi részekkel fogsz találkozni:
- Rule Name: Ez az azonosítója a szabálynak. Azt javasoljuk, hogy a lehető leginformatívabb nevet adj neki, hogy elkerüld a félreértéseket, amikor több szabályt kezelsz.
- Stock Options: Ez egy legördülő menü, amiből bármikor kiválaszthatod, melyik címkét szerkeszted. A kiválasztás a termék aktuális készletállománya alapján történik:
Minden szabálynak az alábbi készletopciói vannak a címkék üzeneteinek megjelenítésére:

1. In stock: a termékből több van raktáron
2. Out of stock: akkor jelenik meg, amikor a termék készlete elfogy
3. Continue selling: akkor jelenik meg, amikor a terméket úgy állították be, hogy folytatható a értékesítés akkor is, ha nincs készlet
4. Low Stock: a címkék akkor jelennek meg, amikor a termék készlete az általad megadott küszöbérték alá csökken, amely az adott opció kiválasztásakor fog megjelenni:

Preview: itt láthatod a címkék valós idejű előnézetét, azokat a stílusokat figyelembe véve, amelyeket az alábbi “Edit Style” blokkban tudunk kezelni.
Condition: nagyon fontos blokk, mert itt határozzuk meg, hogy mikor vagy milyen esetekben jelenik meg ez a konkrét szabály a termékoldalakon. A feltételek a következők szerint vannak meghatározva:
- 1. Type: itt fogjuk kiválasztani a szabály típusát: Metafield-ek, gyűjtemény, szállító vagy termék. A kiválasztott típus alapján különböző lehetőségek állnak rendelkezésre:
-
- A Termék és a Gyűjtemény esetén lehetőségünk lesz választani egy listából.
- Szállító esetén a következő lehetőségek lesznek:
-
-
- Check mode: equals (egyenlő), contains (tartalmazza), starts with (kezdődik), end with (végződik), doesn’t contain (nem tartalmazza)
- Value: ez a szállító neve lesz, amely a kiválasztott "Check mode" szabálya szerint fog működni
-
- Metafield-ek esetén a következő lehetőségek lesznek:
-
- Check mode: equals (egyenlő), contains (tartalmazza), starts with (kezdődik), end with (végződik), doesn’t contain (nem tartalmazza)
- Value: melyik értéknek kell egyeznie a típushoz, hogy alkalmazzuk ezt a szabályt a kiválasztott “Check mode” opció szerint
- Metafiled path: Azt javasoljuk, hogy használd a „stocktime” és „labelay” értékeket
Például, ha azt szeretnénk, hogy a szabály akkor jelenjen meg, amikor a metafield értéke „superA”, és a metafield elérési útja „stocktime.labely”, akkor az alábbiak szerint kell beállítani:
- A Type-nak Metafield értéket kell megadni
- Check mode = Equal
- Value = superA (ezt az értéket be kell állítani a termék metafield-jeiben, amelyeket ehhez az alkalmazáshoz hoztunk létre. A metafield-ek beállításához kérlek, defináld őket a következő helyen: “Settings > Custom data > Product > Add definition”)


5) A "Delivery Time" nevű Labely blokk kezelése:
A blokk hozzáadása és engedélyezése:
- Lépj a Theme Customizer-be, válaszd ki a terméksablont, és válaszd ki azt a szekciót, ahová hozzá szeretnéd adni a "Delivery Time" blokkot.
- A blokkok elrendezése:
- 1. Húzd a "Delivery Time" blokkot a kívánt pozícióba.
- A blokk beállításainak módosítása:
- 1. A beállítások elérhetőek a Theme Customizer-ban, és az alkalmazásban található Rule editor szerkesztő oldalon.
- 2. Állítsd be a betűméretet, színt, szöveget, és csatolj képeket.
Beállítás utáni lépések:
- A beállítások elvégzése után látogass vissza a termékoldalra, hogy megtekintsd a módosításokat.
6) További források:
Nézd meg a Beállítások bemutató videóját, hogy vizuális útmutatót kapj a Szabály opciók használatához.
7) Ikonok:
Annak érdekében, hogy az alkalmazás a lehető legkisebb terhelést jelentsen, integráltuk a képek/ikonok kezelését, amelyek a címkékhez adhatók a Shopify alapértelmezett fájlkezelő rendszerével. Az ikonok használatához kövesd az alábbi lépéseket:
- Töltsd fel az ikonokat a Shopify áruházadba ugyanúgy, mint bármely más képet.
- A feltöltés után másold ki a kép URL-jét.
- Illeszd be ezt az URL-t az alkalmazás megfelelő mezőjébe.


8) A blokk eltávolítása vagy letiltása:
- Eltávolításhoz: Válaszd ki a "Delivery Time" blokkot, majd kattints az „Blokk eltávolítása” gombra.
- Letiltáshoz: Nyisd meg a Theme Customizer menüben az a ‘App embeds’ részt, majd kapcsold ki a Labely beágyazást.