KalinumX internal manual
KX Product Blocks Manual
Interní manuál pro produktové Liquid bloky KalinumX. Slouží jako rychlý přehled, kam bloky vložit, jaká metapole používají a jak je nastavit v produktových šablonách.
EN: Product page blocks are not filters. They explain product details, personalization, customer files and recommended add-ons.4 Liquid sekceSpecs, Personalization, Upload Guide, Related Add-ons.
3 vrstvy datTheme editor nastavení, produktová metapole, ruční fallback.
CZ / EN / DEBloky si vybírají texty podle request.locale.iso_code.
Luxury stylSvětlé bloky, jemný zlatý akcent, žádné těžké černé paty.
Doporučené pořadí na produktové stránce
Produktová stránka má zákazníka dovést od výběru ke správnému zadání výroby. Proto bloky řaď podle logiky nákupu, ne podle interní techniky.
1
Hlavní produkt
Cena, varianty, nákupní tlačítko, základní popis.
2
Konfigurátor
kx-front, kx-front-back, kx-serial podle šablony.
3
Upload / personalizace
Upload Guide + Personalization Guide podle produktu.
4
Specifikace a důvěra
Product Specs, Related Add-ons, KX Trust.
Přehled 4 produktových bloků
| Blok | Soubor | Účel | Kam vložit | Riziko |
|---|---|---|---|---|
| KX Product Specs | sections/kx-product-specs.liquid | Technická data, materiál, povrch, rozměry, výrobní čas, upozornění. | Pod konfigurátor nebo výše u technických produktů. | Nízké. Při prázdných metapolích se blok může tvářit prázdně. |
| KX Personalization | sections/kx-product-personalization-guide.liquid | Vysvětluje text, logo, foto, sérii, B2B a možnosti gravírování. | Blízko konfigurátoru, před/po textových polích. | Střední. Skrývání podle metapolí zapnout až po naplnění dat. |
| KX Upload Guide | sections/kx-product-upload-guide.liquid | Instrukce pro logo, foto, vlastní grafiku a výrobní soubory. | Nad nebo pod Uploadly pole. | Nízké. Neřeší samotný upload, jen textově navádí zákazníka. |
| KX Related Add-ons | sections/kx-product-related-addons.liquid | Související produkty, doplňky, alternativy, sady a upsell. | Níže na stránce, před nebo po KX Trust. | Střední. Potřebuje reference, handles nebo fallback kolekci. |
Doporučení podle produktové šablony
| Šablona | Nejdůležitější blok | Další bloky | Logika |
|---|---|---|---|
product.kx-front | Personalization | Specs, Upload podle produktu, Related | Jedna hlavní strana gravírování, text/logo/foto podle typu produktu. |
product.kx-front-back | Upload Guide + Personalization | Specs, Related, Trust | Default pro většinu produktů; vysvětlit přední a zadní stranu. |
product.kx-tech-material | Product Specs | Upload Guide, Personalization podle potřeby | Technický zákazník potřebuje rychle materiál, rozměry a limity. |
product.kx-serial-ja / oni | Personalization | Specs, Related | Limitované edice, čísla, série a příběh produktu. |
product.kx-ai-digital | Upload Guide | Personalization, Related | Digitální služba potřebuje podklady, styl, revize a jasný vstup. |
product.18-nsfw | Personalization + Upload Guide | Specs, případně Age Gate | Jemně: private/sensual design, ruční kontrola motivu, ne explicitní obsah. |
Metapole – stromová logika
Metapole nejsou všechno povinná. Slouží jako strukturovaná data, která bloky elegantně převedou do zákaznického textu.
KX Product Specs – technická data
material_text → finish_text → dimensions_text → engraving_area_text → production_time_text → warning_note
diameter_mm / length_mm / width_mm / height_mm / thickness_mm / volume_ml → číselné čipy
food_contact_safe / dishwasher_safe / photo_engraving_allowed / kx_color_marking_available / kx_deep_engraving_available / kx_logo_engraving_suitable / kx_made_to_order → ANO/NE čipy
KX Personalization – zákaznická personalizace
engraving_options + engraving_side + max_text_length → malé informační štítky
kx_serial_number + kx_edition_number → karta série / edice
photo_engraving_allowed + kx_logo_engraving_suitable + kx_deep_engraving_available + kx_color_marking_available → dostupnost technik
KX Upload Guide – zákaznické soubory
upload_required / personalization_required → štítek povinné nebo volitelné
upload_note → hlavní poznámka k podkladům
customer_supplied_item_note → fallback poznámka
artwork_template_url → odkaz na šablonu ke stažení
KX Related Add-ons – související produkty
souvisejici_produkty / related_products → ruční reference produktů
doplnkove_produkty / complementary_products → add-on reference
kx_related_product_handles → fallback přes handles oddělené čárkou nebo středníkem
fallback_collection → nastavuje se ručně v theme editoru
Nastavení – co zapnout jako výchozí
| Blok | Nastavení | Doporučený start | Kdy změnit |
|---|---|---|---|
| Product Specs | show_empty_text | Vypnuto | Zapnout jen při testu nebo na interních šablonách. |
| Personalization | show_default_cards | Zapnuto | Nechat zapnuté, dokud nejsou všechna metapole naplněná. |
| Personalization | use_metafields_to_hide_cards | Vypnuto | Zapnout až po Matrixify importu, aby se karty neschovaly omylem. |
| Upload Guide | show_required_badge | Zapnuto | Vypnout jen tam, kde nechceš řešit povinné/volitelné. |
| Related Add-ons | fallback_collection | Vybrat ručně podle šablony | Hodí se, když ještě nejsou vyplněné reference produktů. |
Kontrolní postup
| Krok | Úkol | Kde | Poznámka |
|---|---|---|---|
| 1 | Vložit 4 sekce | Online Store → Themes → Edit code → Sections | Každý soubor vytvořit jako samostatnou sekci. |
| 2 | Přidat do produktových šablon | Customize → Product template | Pořadí podle typu šablony. |
| 3 | Otestovat produkt s metapoli | Náhled produktu | Zkontrolovat prázdné i vyplněné stavy. |
| 4 | Otestovat Uploadly | Uploadly app + product tags | Guide blok jen vysvětluje, Uploadly řeší samotný upload. |
| 5 | Naplnit Matrixify import | Excel / Matrixify | Materiál, rozměry, engraving_area, warnings, related produkty. |
| 6 | Zkontrolovat CZ/EN/DE | Theme preview | Texty jsou součástí sekcí, překlad se řídí jazykem storefrontu. |
Praktické rozhodnutí: pro live start nech výchozí karty zapnuté a nepřivazuj všechno hned na metapole. Po importu a kontrole produktů můžeš postupně přepnout bloky do přesnějšího režimu podle dat.
