KalinumX Internal Manual

Manuál metapolí, bloků a Liquid návazností

Přehled aktuálních KalinumX metapolí, produktových bloků, tagů, Liquid návazností a importního workflow. Tato stránka je určená jako interní mapa: co se vyplňuje v produktu, co patří do Excelu / Matrixify, co je ruční nastavení v Shopify a co přímo ovlivňuje zákaznický vzhled. Internal guide for metafields, product blocks, Liquid behavior, Matrixify/Excel import and manual Shopify setup.

Liquid ANO Metapole nebo tag přímo mění blok, upozornění, formulář, age gate nebo zákaznický výpis.
Excel / Matrixify Hodnota se dá připravit ve master tabulce a importovat hromadně.
Ručně v Shopify Vhodné pro výběr reference produktu, speciální template, ruční kontrolu nebo výjimky.
Volný text Lze dopsat vlastní hodnotu. U skupin je dobré držet jednotný slovník.
Produkt – základní identita, materiál, popis Pole, která popisují typ výrobku, materiál, povrch, barvu a zákaznické základní informace. ⌄

Tato pole jsou nejvhodnější pro Excel / Matrixify import. U textových polí se může psát vlastní text, ale u skupin doporučuji držet jednotné hodnoty, aby šly později použít pro filtry, kolekce a přehledy.

Metapole Co znamená Co lze zapsat Příklady hodnot Liquid / zákazník Import / ručně
KX Product group Interní produktová skupina pro řízení katalogu, filtrování a orientaci. Volný krátký text, ideálně jednotný slovník. dogtag coin keychain thermo slate b2b slothana Nepřímo Může později řídit Liquid nebo filtry. Excel Doporučeno importovat.
Material group Materiálová skupina pro filtr, interní třídění a budoucí kolekce. Volný krátký text, držet konzistentní hodnoty. stainless-steel aluminum brass wood glass ceramic slate plastic Nepřímo Vhodné pro filtry a budoucí Liquid podmínky. Excel Doporučeno.
Material text Zákaznický text k materiálu produktu. Volný text, premium styl, bez zbytečné technické omáčky. Nerezová ocel s čistým povrchem vhodným pro laserové značení. Ano Vhodné zobrazovat ve specifikacích. Excel Text připravovat v masteru.
Finish text Popis povrchu / vzhledu. Volný text. Matný povrch, kartáčovaný kov, lesklý povrch, elox, přírodní kresba. Ano Zákaznické specifikace. Excel
Color text Popis barvy produktu. Volný text. Černá, stříbrná, zlatá, přírodní dřevo, kouřové sklo, bílá keramika. Ano Vhodné u variant nebo specifikací. Excel
Dimensions text Zákaznický text pro rozměry. Volný text včetně jednotek. 50 × 29 mm / 1.97 × 1.14 in. Objem 500 ml / 16.9 fl oz. Ano Nejlepší pro zákazníka. Excel Připravit i EN/US jednotky podle potřeby.
Production time text Zákaznický text k době výroby. Volný text, ne tvrdý závazek, spíš orientační formulace. Obvykle 2–5 pracovních dnů podle náročnosti personalizace. Ano Zobrazovat u produktu / accordion. Excel
KX Made to order Označuje, že produkt se vyrábí nebo upravuje až po objednávce. True / false. truefalse Ano Může řídit upozornění a texty. Excel
Warning note
custom.warning_note		 Důležité produktové upozornění. Pouze produkt-level, ne kolekce. Víceřádkový text. Jen důležité limity, rizika, omezení nebo výjimky. U přírodního materiálu se kresba a odstín mohou kus od kusu lišit. Ano Čte custom warning block a může jej číst také kx-front-back. Excel Vyplňovat jen kde má smysl.
Produkt – gravírování, personalizace, Liquid Metapole pro front/back, texty, logo, foto, barevné značení a limity personalizace. ⌄

Tato skupina má největší vazbu na produktové snippety. Blok kx-front-back aktuálně čte hlavně: max_text_length, engraving_options, engraving_side, engraving_area_text, warning_note, photo_engraving_allowed, kx_logo_engraving_suitable, kx_color_marking_available, kx_deep_engraving_available.

Metapole Co znamená Co lze zapsat Příklady hodnot Liquid / zákazník Import / ručně
Max text length
custom.max_text_length		 Doporučený limit znaků pro vlastní text. Číslo, bez jednotky. 203560 Ano kx-front-back jej používá jako maxlength. Excel
Engraving side
custom.engraving_side		 Informace, zda se gravíruje přední, zadní nebo obě strany. Volný text, ale držet jednotné hodnoty. front back front-back one-side Ano Zobrazuje se v kx-front-back meta přehledu. Excel
Engraving area text
custom.engraving_area_text		 Popis gravírovací plochy. Volný text. Přední plocha cca 35 × 18 mm. Logo doporučeno bez jemných vlasových linek. Ano Zákazníkovi pomůže pochopit možnosti. Excel
Engraving options
custom.engraving_options		 Souhrn možností personalizace. Volný text nebo krátký seznam. Text, iniciály, datum, logo, jednoduchý symbol, QR kód. Ano Čte kx-front-back. Excel
Photo engraving allowed
custom.photo_engraving_allowed		 Zda je produkt vhodný pro fotogravírování. True / false. truefalse Ano kx-front-back ukáže Ano/Ne. Excel
KX Logo engraving suitable
custom.kx_logo_engraving_suitable		 Zda je produkt vhodný pro logo. True / false. truefalse Ano kx-front-back ukáže Ano/Ne. Excel
KX Color marking available
custom.kx_color_marking_available		 Zda je možné barevné značení, typicky MOPA na vybraných kovech. True / false. truefalse Ano kx-front-back ukáže Ano/Ne. Excel
KX Deep engraving available
custom.kx_deep_engraving_available		 Zda je vhodné hlubší gravírování. True / false. truefalse Ano kx-front-back ukáže Ano/Ne. Excel
Food contact safe Vhodnost pro styk s potravinami. True / false. truefalse Ano Vhodné u kuchyňských produktů, hrnků, lahví. Excel
Dishwasher safe Zda je produkt vhodný do myčky. True / false. truefalse Ano Vhodné u kuchyně, skla, keramiky, lahví. Excel
Produkt – rozměry, objem, číselná data Číselná metapole pro budoucí filtry, technické přehledy, převody jednotek a import. ⌄

Číselná pole vyplňovat čistě jako číslo. Bez „mm“, bez „ml“. Zákaznický krásný text patří do Dimensions text.

Metapole Typ hodnoty Co lze zapsat Příklady Liquid / zákazník Import / ručně
Length mm Číslo / mm Délka v milimetrech. 50100210 Nepřímo Pro tabulky, filtry, budoucí výpočty. Excel
Width mm Číslo / mm Šířka v milimetrech. 2985 Nepřímo Excel
Height mm Číslo / mm Výška v milimetrech. 120180 Nepřímo Excel
Thickness mm Číslo / mm Tloušťka v milimetrech. 1.523 Nepřímo Excel
Diameter mm Číslo / mm Průměr kulatého produktu. 253250 Nepřímo Excel
Volume ml Číslo / ml Objem nádoby, termohrnku, lahve apod. 350500750 Nepřímo Excel
Produkt – serial / edice / číslování Pole pro limitované série, ID výrobky, číslované kusy a speciální serial blok. ⌄

Tato pole se hodí pro produkty typu série „1 z 50“, unikátní kódy, firemní ID, technické štítky nebo umělecké edice. Zákaznický vstup ve snippetu kx-serial se ukládá jako line item property v objednávce, ne jako produktové metapole.

Metapole Co znamená Co lze zapsat Příklady Liquid / zákazník Import / ručně
KX Serial number Předvyplněné výrobní nebo sériové číslo produktu. Volný krátký text. SN-001, KX-2026-001, ID-4587 Ano Vhodné pro serial šablony. Excel
KX Edition number Číslo edice nebo limitované série. Volný text nebo číslo. 1/50, 07/100, Founder Edition Ano Vhodné pro ediční produkty. Excel
KX Serial text CS Český zákaznický text k sérii / číslu. Volný text. Každý kus je označen vlastním výrobním číslem. Ano Pro vícejazyčný výpis. Excel
KX Serial text EN Anglický zákaznický text k sérii / číslu. Volný text. Each piece can be marked with an individual serial number. Ano Pro EN jazyk. Excel
KX Serial text DE Německý zákaznický text k sérii / číslu. Volný text. Jedes Stück kann mit einer individuellen Seriennummer versehen werden. Ano Pro DE jazyk. Excel
Produkt – interní výroba, Google, workflow Pole, která nejsou primárně pro zákazníka, ale pomáhají řídit výrobu, proces a kanály. ⌄

Interní pole nedávat zbytečně do zákaznického výpisu. Slouží hlavně pro tebe, výrobu, kontrolu a budoucí import.

Metapole Co znamená Co lze zapsat Příklady Liquid / zákazník Import / ručně
KX Production method Interní metoda výroby. Volný text / interní slovník. fiber-laser, mopa-marking, co2-laser, 3d-print, manual-finish Ne Interní pole, nezobrazovat zákazníkovi. Excel
KX Laser process Interní laserový proces. Volný text / interní slovník. annealing, deep-engraving, coating-removal, color-marking, surface-marking Ne Interní pole. Excel
Google: Custom Product Google / Merchant informace, že produkt je zakázkový. True / false podle Shopify Google metafieldu. truefalse Ne Nezobrazovat zákazníkovi. Ručně / import Podle exportu Google polí.
Produkt – související a doplňkové produkty Reference na produkty, doplňky, upsell a starší nastavení souvisejících produktů. ⌄

Reference produktů je často bezpečnější nastavovat ručně v Shopify, protože vybíráš konkrétní produkt. Pokud Matrixify podporuje export/import daného reference metafieldu, lze to později řídit i tabulkou.

Metapole Co znamená Co lze zapsat Příklady Liquid / zákazník Import / ručně
Související produkty Produkty, které se mají zobrazit jako related / doporučené. Reference produktu nebo seznam referencí podle nastavení v Shopify. Podobný dogtag, stejná série, jiný materiál. Ano Pokud je napojené v theme / Shopify recommendations. Ručně Nejbezpečnější ruční výběr.
Doplňkové produkty Produkty jako doplněk / add-on. Reference produktu nebo seznam referencí. Řetízek, dárkové balení, další štítek, karabina. Ano Dává smysl pro upsell. Ručně
Nastavení souvisejících produktů Starší / textové nastavení souvisejících produktů. Vyplňovat jen pokud ho konkrétní Liquid stále čte. Nechat prázdné, pokud reference pole fungují. Ověřit Pravděpodobně legacy. Ručně Zatím neplnit automaticky.
Kolekce – aktuálně ponechaná metapole Po čištění zůstala jen jednoduchá kolekční sada. Ostatní rozsáhlé kolekční texty se nebudou duplikovat v metapolích. ⌄

Kolekce mají být lehké. Dlouhé SEO texty, popisy a marketing můžeš řešit přímo v Shopify popisu kolekce, v šabloně nebo v budoucím obsahovém systému. Metapole držet pouze tam, kde opravdu řídí layout, filtrování nebo krátké údaje.

Metapole kolekce Co znamená Co lze zapsat Příklady Liquid / zákazník Import / ručně
KX Collection group Interní skupina kolekce. Volný krátký text, jednotný slovník. metal, gifts, b2b, slothana, kitchen, stone, ai-digital Nepřímo Pro třídění / budoucí layout. Ručně / import
Primary KX template Hlavní zamýšlená šablona kolekce nebo vizuální logika. Volný text podle názvu template / stylu. kx-default, kx-luxury, kx-grid, kx-slothana Podle šablony Jen pokud Liquid čte. Ručně
Krátký podnadpis Krátký text pod názvem kolekce. Volný krátký text. Personalizované kovové produkty s čistým detailem. Ano Pokud ho kolekční šablona vypisuje. Ručně / import
Materiály Souhrn materiálů v kolekci. Volný krátký text. Nerezová ocel, hliník, mosaz, břidlice. Ano Vhodné jako stručná kolekční informace. Ručně / import
Bloky / snippety – co ovlivňuje Liquid Mapa hlavních KX bloků na produktové stránce: co dělají, co ukládají a co čtou. ⌄
Blok / snippet Účel Co čte Co ukládá do objednávky Ručně / automaticky Poznámka
snippets/kx-front-back.liquid Text pro přední a zadní stranu + poznámka k provedení. max_text_length, engraving_options, engraving_side, engraving_area_text, warning_note, photo_engraving_allowed, kx_logo_engraving_suitable, kx_color_marking_available, kx_deep_engraving_available Line item properties: text přední strany, text zadní strany, poznámka k provedení. Blok ručně v templateMetapole import Default pro většinu importovaných produktů: tag kx-template:kx-front-back.
snippets/kx-one-text.liquid Jedno textové pole pro produkt, kde stačí pouze přední / jednoduchý text. Primárně texty ve snippetu. Volitelně může později číst limit nebo warning. Line item property: text na výrobek + poznámky. Ručně / template Uživatel bude některé produkty přepínat ručně na front-only template.
snippets/kx-serial.liquid Vstup pro výrobní číslo / ID / kód. Texty ve snippetu, případně serial metapole podle budoucí úpravy. Line item properties: serial number / ID / code + poznámka. Ručně / template Vhodné pro technické štítky, ID, série, edice.
snippets/kx-inquiry.liquid Nezávazná poptávka na produktu / službě. Kontext produktu / stránky. Odesílá contact form, ne line item property. Blok ručně Vhodné pro služby, B2B, 3D tisk, nestandardní výrobu.
snippets/kx-trust.liquid Krátký trust box: zakázková výroba, detail, balení. Nečte produktová metapole. Nic. Blok ručně Bezpečný informační blok.
snippets/kx-age-gate.liquid 18+ / adult content upozornění. Tag kx-age-18, template suffix obsahující 18-nsfw nebo nsfw. Nic. Tag importTemplate ručně Neřeší pornografii. Pouze upozornění pro sensual/adult design.
Warning note custom liquid Samostatné upozornění na produktu. custom.warning_note Nic. Metapole import Vyplňovat jen u konkrétních produktů, ne obecně.
Uploadly app block Nahrávání souborů zákazníkem. Řízení hlavně v Uploadly app podle tags / kolekcí. Soubor / odkaz podle Uploadly do objednávky. App nastaveníTagy import Cílit podle tagů, ne podle názvu produktu.
Tagy / templates / Uploadly / age gate Tohle nejsou metapole, ale zásadně ovlivňují šablony, uploady, age gate a importní workflow. ⌄
Tag / template Co dělá Kdy použít Liquid / zákazník Import / ručně Poznámka
kx-template:kx-front-back Default logika pro produkty s přední a zadní stranou. Většina běžných personalizovaných produktů. Ano Určuje použití front/back šablony. Excel default Základní výchozí tag pro import.
kx-template:kx-front Front-only / jedno textové pole. Jen produkty, kde nechceš zadní stranu. Ano Ručně Uživatel chce přepínat vybrané produkty ručně v Shopify.
kx-template:kx-tech-material Technický / materiálový produkt. Průmysl, materiály, technické značení. Ano Excel Speciální produkty, ne default.
kx-template:kx-ai-digital AI / digitální služba nebo výstup. Hudba, AI video, grafika, digitální tvorba. Ano Excel Neplést s fyzickým produktem.
kx-template:kx-serial-ja / kx-template:kx-serial-oni Serial / ID šablony. Číslované produkty, ID, série. Ano Ručně / výběrově Používat jen tam, kde má serial význam.
kx-template:18-nsfw Template/tag pro sensual/adult design. Erotický / smyslný design, nikoli automaticky explicitní obsah. Ano Může spustit age gate podle template suffix. Ručně / kontrola Produkty držet Draft, dokud nejsou zkontrolované.
kx-age-18 Spouští age gate na produktu. Jen u produktů, kde chceš 18+ upozornění. Ano Čte kx-age-gate. Excel Nepoužívat plošně bez důvodu.
kx-review:sensual Měkký review tag. Sensual design, který potřebuje ruční kontrolu. Nepřímo Excel Není automatický zákaz kanálů.
kx-status:manual-check Produkt vyžaduje ruční kontrolu před publikací. Nejistý produkt, citlivý motiv, chybějící data. Nepřímo Excel Dobré pro filtr v Shopify adminu.
kx-upload:logo Uploadly má nabídnout logo upload. Produkty vhodné pro firemní logo. Ano Přes Uploadly app. Excel Cílit v Uploadly podle tagu.
kx-upload:photo Uploadly má nabídnout foto upload. Fotogravírování / obrázek zákazníka. Ano Excel Kombinovat s Photo engraving allowed.
kx-upload:artwork / kx-upload:custom-file Upload grafiky, výkresu, PDF nebo jiného souboru. Zakázková výroba, B2B, technická data. Ano Excel Nezahlcovat zákazníka moc poli.
kx-upload:required / kx-upload:optional Určuje, zda je upload povinný. Required jen tam, kde bez souboru nejde objednávku vyrobit. Ano Přes Uploadly pravidla. Excel Raději optional, pokud si nejsi jistý.
kx-upload:crop-round / crop-square / crop-portrait Pomocné crop pravidlo pro Uploadly. Kulaté medailony, čtvercové dlaždice, portrétní motivy. Ano Excel Nastavit v Uploadly podle možností appky.
Smazané / nepoužívat / legacy Přehled polí, která byla smazána nebo nemají být znovu zbytečně zakládána. ⌄

Tato část je důležitá, aby se při budoucím importu nebo čištění Shopify znovu nezakládala stará pole.

Položka Stav Proč Co používat místo toho
Collection: SEO block Smazáno Duplicitní vůči Shopify SEO / popisu kolekce. Shopify SEO title, meta description, collection description.
Collection: Order info text Smazáno Příliš obecné, lépe řešit šablonou / popisem. Produktové texty, accordions, informační sekce.
Collection: Care note Smazáno Péče patří spíš ke konkrétnímu produktu / materiálu. Product description, Material text, Warning note.
Collection: Production note Smazáno Výroba je individuální podle produktu. Production time text, Made to order, product page text.
Collection: Personalization text Smazáno Personalizace je řízená produktovými bloky a šablonou. kx-front-back, kx-one-text, engraving_options.
Collection: Use cases text Smazáno Lépe jako obsah v popisu kolekce. Collection description / page copy.
Collection: Techniques text Smazáno Technika se liší podle produktu. KX Production method, KX Laser process, product description.
Collection Warning note Smazáno Warning má být produktový, ne kolekční. Product Warning note.
Product Size text Smazáno Bylo duplicitní. Dimensions text + číselná rozměrová pole.
KX Photo engraving suitable Smazáno Duplicitní vůči ponechanému poli. Photo engraving allowed.
KX Lead time in days Smazáno Pevný počet dnů je méně vhodný pro zakázkovou výrobu. Production time text.
Nastavení souvisejících produktů Legacy / ověřit Možná už není potřeba, pokud fungují reference metapole. Související produkty + Doplňkové produkty.