Príručka

Ako Fittle používať – od vloženia na web po porez dreva.

Návod pre stolárov a kuchynské štúdiá aj pre zákazníkov, ktorí konfigurátor používajú. Inštaláciu na web nájdete v samostatnom návode na inštaláciu.

1. Začíname

Fittle má dve strany: konfigurátor, ktorý používajú vaši zákazníci na vašom webe (alebo na hostovanej stránke app.getfittle.com/s/vase-meno), a účet stolára na app.getfittle.com/stolar/, kde vidíte dopyty, 3D náhľady, nastavujete integráciu a píšete podpore.

  1. Prihláste sa na app.getfittle.com/prihlasenie/ – e-mailom (odkaz), SMS kódom alebo heslom, ak ste si ho nastavili.
  2. V účte nájdete svoj embed kľúč (FITT-XXXX-XXXX-XXXX) a hotový úryvok kódu. Vloženie na web (WordPress, Wix, Shopify, vlastné HTML) popisuje návod na inštaláciu.
  3. Nemáte web? Pošlite zákazníkom odkaz na hostovanú stránku – funguje rovnako.
Kľúč a doména. Embed kľúč je viditeľný v HTML vášho webu, preto je viazaný na vašu doménu – na cudzom webe nefunguje. Domény si spravujete v účte.

2. Ovládanie konfigurátora

Konfigurátor: vľavo panel nastavení, vpravo 3D scéna s lištou tlačidiel

Scéna a tlačidlá

Myš: ťahaním otáčate, kolieskom približujete, pravým tlačidlom posúvate. Dotyk: jeden prst otáča, dva prsty približujú. Kliknutím na skrinku alebo modul ho vyberiete – v paneli sa otvorí jeho nastavenie a v scéne dostane modrý rámik. Kliknutie dvierka neotvára, na to sú tlačidlá.

Horný riadok tlačidiel je ovládanie pohľadu:

  • Otvoriť dvere otvorí dvierka a zásuvky vybranej skrinky, Otvoriť všetko celej zostavy.
  • Priehľadné – čelá zpriehľadnia, vidno police a zásuvky vo vnútri.
  • Auto-otáčanie, Vycentrovať (návrat kamery), Rozmery (kóty v scéne).
  • Prejsť sa – prechádzka v prvej osobe (kapitola 7); na mobile aj Zobraziť v mojej izbe (AR).

Ľavý stĺpec sú akcie: Náhodná linka / stena / všetky, Vyprázdniť, Export 3D, Porez dreva, AI popis obrázka, Uložiť návrh, Načítať návrh. Na mobile sú tlačidlá v dvoch rolovateľných riadkoch nad scénou.

Ľavý panel

Panel je skladací – každá sekcia sa otvorí kliknutím na jej názov. Na začiatku je blok s nástrojmi, potom tvar zostavy, miestnosť, rozmery, obsah vybraného modulu, dvierka a úchytky, dekory. Na mobile je panel vysúvací zospodu: potiahnite úchyt „Nastavenia" hore.

Pod posuvníkmi rozmerov je oranžový súhrn celkových rozmerov (v kuchyni aj výška pracovnej dosky a spodná hrana horných skriniek) – to sú čísla, ktoré si zákazník má odmerať doma.

Miestnosť

Zapnite Vložiť do miestnosti a zadajte jej šírku, hĺbku a výšku; tvar L má výrez v rohu. Do stien sa dajú pridať okná a dvere (stena, pozícia, šírka, výška, parapet) – nábytok sa im vyhne a pri kolízii vás upozorní. Podlahu vyberáte z katalógu, stropné svetlá majú počet, farbu a intenzitu. Pri rovnej zostave v miestnosti sa dá nastaviť vzdialenosť od ľavej steny; pri L a U ide zostava od steny k stene a šírku určuje miestnosť.

Dekory a materiály

Prepínač nad dekormi určuje, čo farbíte: dvierka, zásuvky, korpus, vnútro, pracovnú dosku, zásterku či police. Viac dekorov otvorí katalóg s vyhľadávaním, kategóriami a výberom dodávateľa; vlastnú farbu zadáte kódom. Hrúbka dosky (0,8–4 cm) prepočíta všetky svetlé rozmery, zadná stena môže byť 3 / 5 / 8 mm alebo plná doska – ovplyvňuje porez.

3. Kuchynská linka

Tvar rovná / L / U; pri L volíte, na ktorú stranu ide bočné rameno. V rohu je vždy skutočná rohová skrinka (spodná aj horná 95 × 95 cm) s dvoma rovnými krídlami – ramená začínajú až za ňou, takže sa dvierka nikdy neprekrývajú.

Linka je rad stĺpcov. Každý má spodnú skrinku (dvierka, zásuvky, drez, varná doska, rúra, sporák, umývačka), hornú (dvierka, presklené, polica, mikrovlnka, digestor, bez) alebo je to vysoká skrinka (chladnička, rúra + mikrovlnka, potravinová, konfigurovateľná). Šírky sú z výrobných radov; spotrebiče majú pevné šírky. V sekcii Skrinka nastavíte police a zásuvky (počet aj výšky), stranu otvárania, sklo s rámom, výšku rúry, šírku drezu.

Ostrov zapnete v tvare linky, v scéne ho ťaháte myšou; má vlastné moduly, drez, dosku, umývačku a barový presah. Výšky a hĺbky: spodné 72 cm, horné 72, zásterka 60, hĺbka 60/35, sokel 10, doska 4 – všetko posuvníkmi.

Rameno A a miestnosť. Pri L/U je dĺžka ramena A daná šírkou miestnosti mínus rohové skrinky; posledná obyčajná skrinka sa doladí ako filler, aby roh sedel presne.

4. Vstavaná skriňa

Skriňa je rad modulov (50–90 cm); každý má sekcie zhora nadol: tyč na vešanie, police, zásuvky – s nastaviteľnými výškami. Dvere sú na úrovni celej skrine: posuvné, krídlové alebo bez; počet dverí a strana otvárania sú v sekcii Dvere. Modul môže byť otvorený (botník s vešiakom pri vchode) alebo posteľový.

Vstavaná posteľ: zaškrtnite pri module, nastavte šírku (90–160), dĺžku a priestor nad hlavou; úložná časť nad posteľou je otvorená alebo s dvierkami. Posteľ vyčnieva do izby, preto nemôže stáť hneď pri rohu v L/U.

Tvar L / U funguje ako v kuchyni – v rohu je rohový diel s vlastným dekorom a úchytkou, bočné ramená majú vlastné moduly.

5. Obývacia stena

Moduly sa skladajú na výšku zo skriniek: dvierka, zásuvky, presklené, otvorená polica, televízor (výklenok s TV, na stene práve jeden) a voľný priestor – vzduch bez korpusu. Práve voľným priestorom vzniknú lowboardy so závesnými skrinkami alebo plávajúce TV stolíky. Každá skrinka má vlastnú výšku a police.

Tlačidlo Náhodná stena vyberá z 30 vzorov pre každý tvar (klasika s vitrínami, plávajúca, vstavaná do stropu, loft, knižnica…). Predvolená stena je „Klasika s vitrínami".

6. Skrinka a umývadlová skrinka

Skrinka: šírka, výška, hĺbka, sokel alebo nožičky, sekcie (dvierka, zásuvky, otvorená, presklené) s nastaviteľnými priehradkami. Umývadlová skrinka: montáž na stenu alebo na nožičky, čelo (zásuvky, dvierka), umývadlo na dosku / zapustené / integrované, tvar a veľkosť umývadla, batéria, zrkadlo, dvojité umývadlo od 110 cm.

7. Prechádzka, VR a AR

Prejsť sa prepne kameru do výšky očí. Na počítači WASD alebo šípky, myš otáča (klik do scény zamkne kurzor, Esc uvoľní). Na mobile je joystick a tlačidlo Gyroskop – otáčate telefónom. Posuvník Výška očí 100–200 cm. Steny a nábytok sú prekážky.

Zobraziť v mojej izbe (AR) na iPhone/iPade otvorí model v reálnej miestnosti cez kameru (Safari), na Androide cez Chrome. S VR okuliarmi (napr. Meta Quest) sa v prechádzke objaví tlačidlo VR.

Prechádzka v prvej osobe

8. Uložiť, načítať, náhodné

  • Uložiť návrh stiahne súbor JSON s celým stavom (aj miestnosť, dekory, hrúbky). Načítať návrh ho vráti do 3D – aj v inom prehliadači či o mesiac.
  • Náhodná linka / stena / všetky postaví nový návrh zo vzorov reálnych zostáv; v sekcii modulu je aj náhodný jeden modul alebo vyprázdnenie.
  • Prepínač jazyka v hlavičke prepne všetky texty (24 jazykov), motív svetlý/tmavý sa dá prepnúť tlačidlom.

9. Odoslanie dopytu

Tlačidlo Odoslať na nacenenie otvorí formulár: meno, e-mail, telefón, špeciálne požiadavky (do 4 000 znakov) a fotky priestoru (do 5, z mobilu kľudne 8 MB – zmenšia sa v prehliadači). Zákazník si môže návrh aj stiahnuť ako JSON. Po odoslaní dostane stolár e-mail so zhrnutím a dopyt je v účte s 3D náhľadom a fotkami.

Žiadne ceny. Konfigurátor zámerne neukazuje odhad ceny – naceňuje stolár podľa skutočného návrhu. Zákazník to vie z textu pri formulári.

10. Porez dreva a export PRO

Porez dreva otvorí zoznam všetkých dosiek v návrhu: rozmery na rezanie (dĺžka × šírka × hrúbka, čisté rozmery bez prídavku na hranu), počet kusov, kde v návrhu sú, nákres v zvolenom dekore. Rovnaké dosky sú zlúčené (30 × 60 = 60 × 30). V súhrne je počet dosiek, plocha podľa hrúbky, materiál na nákup podľa dekoru (m²) a sklo zvlášť. Stiahnuť CSV dá tabuľku pre pílu.

Označiť dosky na 3D modeli zobrazí písmeno každej skupiny priamo na doskách v scéne – stavebný plán pre montáž. Export 3D stiahne model ako .dae (SketchUp, Blender, ArchiCAD) alebo .kmz s textúrami dekorov; rozmery v CAD sedia s porezom.

Porez dreva – zoznam dosiek

11. Účet stolára

Na app.getfittle.com/stolar/:

  • Profil – kľúč, kraj, e-mail pre dopyty, hostovaná stránka, úryvok na vloženie.
  • Dopyty – zoznam s kontaktom, poznámkou a náhľadmi fotiek; Otvoriť 3D načíta návrh do konfigurátora v režime prezerania; Odkaz pre majstra skopíruje odkaz, ktorý funguje bez účtu 30 dní; stav dopytu (nový → videný → oslovený → nacenený → získaný / stratený).
  • Integrácia – webhook a API kľúč (kapitola 12).
  • Podpora – živý chat s nami; odpoveď príde aj e-mailom.
  • Heslo – voliteľné, popri e-mailovom odkaze a SMS kóde.

12. Portály: webhook a API

Pre portály a firmy s vlastným systémom: v účte nastavte Webhook URL a tajný kľúč – pri každom dopyte pošleme podpísaný POST s JSON návrhu (podpis HMAC-SHA256, opakovanie 10 s / 1 min / 5 min). Vydajte si API kľúč a sťahujte dopyty, fotky, meňte stav alebo generujte odkazy na 3D náhľad. Na vlastnom webe dostupné aj HNL.prefill(...) (predvyplnenie kontaktu) a udalosť HNL.on('quote', ...). Podrobnosti: PORTAL.md.

<script src="https://app.getfittle.com/embed.js" data-key="FITT-…"></script>
<script>
  HNL.mount('#konfigurator', { product:'kitchen', prefill:{ name:'Ján Novák', email:'jan@…' } });
  HNL.on('quote', e => console.log('dopyt', e.id));
</script>

13. Dodávatelia dekorov

Výrobcovia a predajcovia dekorov majú vlastný účet na app.getfittle.com/dodavatel/: nahrajú dekory a podlahy (obrázok, kód, kategória, povrch), odošlú na schválenie a po schválení sú v katalógu, ktorý vidia všetci zákazníci všetkých stolárov – s názvom dodávateľa v dropdowne.

14. Časté otázky

Konfigurátor sa na mojom webe neukáže.

Skontrolujte, či je kľúč správny a doména webu pridaná v účte. Pri „Skúšobná verzia" je zablokované odosielanie – kľúč vypršal alebo nie je aktívny.

Zákazník poslal dopyt, ale e-mail neprišiel.

Dopyt je vždy aj v účte v sekcii Dopyty. Skontrolujte e-mail pre dopyty v profile a priečinok spam.

Rozmery v poreze sú bez prídavku na hranu?

Áno – sú to čisté rozmery dielcov tak, ako ich stavia 3D. Prídavok na ABS hranu si pridáva dielňa podľa svojej technológie.

Dá sa načítať starý dopyt do 3D?

Dopyty odoslané od septembra 2026 áno (majú uložený stav). Staršie sa zobrazia len ako text.

Funguje to na tablete a mobile?

Áno, v Safari a Chrome. AR vyžaduje iOS (Safari) alebo Android (Chrome); prechádzka s gyroskopom sa pýta na povolenie pohybových senzorov.