--- title: "Onboarding for Laravel — dokumentácia | Roundly" description: "Vývojárska dokumentácia Onboarding for Laravel: bezstavové toky a kroky, deklaratívne pravidlá, voliteľné kroky, sekcie, middleware, udalosti a testy." url: https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel language: sk --- [Všetky balíky](https://roundly-consulting.com/sk/open-source.md) Open source # Onboarding for Laravel Inštalácia `composer require roundly-consulting/onboarding-for-laravel` Vyžaduje: PHP ^8.4 · Laravel ^12.0|^13.0 [GitHub](https://github.com/roundly-consulting/onboarding-for-laravel) [Packagist](https://packagist.org/packages/roundly-consulting/onboarding-for-laravel) [Prispieť (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Patreon](https://www.patreon.com/cw/roundly) ## Prehľad Onboarding for Laravel opisuje onboarding ako toky zoradených krokov a postup každého používateľa vypočíta za behu z údajov, ktoré už máte — bez tabuliek, migrácií a konfiguračného súboru. Toky zaregistrujete raz a potom sa ktoréhokoľvek modelu opýtate na ďalší krok, percento dokončenia, sekcie alebo súhrn pripravený pre JSON; prístup k routám podmienite dokončením jediným middlewarom a postup ohlásite udalosťami vtedy, keď sa rozhodnete vy. Licencia MIT, bezstavový návrh a postavené len na Laraveli a našom vlastnom balíku package-toolkit — bez závislostí tretích strán. ### Čo získate #### Žiadne tabuľky ani konfigurácia Postup sa počíta za behu z údajov, ktoré už máte — bez migrácií, konfiguračného súboru a zastaraných príznakov. #### Viac tokov, jeden resolver Registrujte toky pod kľúčmi alebo ako znovupoužiteľné triedy a nechajte resolver vybrať správny tok každému používateľovi. #### Deklaratívne kroky completeWhenFilled(), completeWhenTrue() a completeWhenHas() pokryjú bežné prípady; zvyšok vyriešia closures. #### Voliteľné kroky, sekcie a pozícia Voliteľné kroky nikdy neblokujú dokončenie; sekcie, „krok 3 zo 7“ a pokračovanie tam, kde používateľ skončil, sú zabudované. #### Ochrana rout a pripravené pre frontend Middleware onboarding presmeruje nedokončených používateľov na prvý nedokončený povinný krok; toArray() a typované DTO obslúžia vaše UI. #### Udalosti a voliteľná perzistencia record() ohlási StepCompleted a FlowCompleted; s vlastným store získate skryteľné kroky a uložené dokončenia sa už znova neohlasujú. #### Fasáda alebo DI, so skutočným fakom Jedna fasáda Onboarding nad vložiteľným OnboardingManager; Onboarding::fake() zachytí udalosti, zaznamená skrytia krokov a naplní store. ### Dokumentácia #### [Inštalácia](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/instalacia.md) Inštalácia cez Composer — nie je čo publikovať, žiadna konfigurácia, migrácia ani view. Zapojenie overíte cez php artisan about. #### [Základné pojmy](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/zakladne-pojmy.md) Toky, kroky, subjekty a manager — ako sa postup odvodzuje za behu z vašich údajov namiesto ukladania. #### [Fasáda Onboarding](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/fasada.md) Celá fasáda Onboarding — registrácia tokov, kópia pre subjekt cez for(), výber toku resolverom a zapojenie store. #### [Bez fasády](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/bez-fasady.md) Bez fasády: vložte si OnboardingManager a máte to isté API bez statických volaní. Triedy akcií balík nemá. #### [Registrácia tokov](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/registracia-tokov.md) Registrujte predvolené toky aj toky pod kľúčmi, skladajte ich fluentne, balte do tried a spravujte register. #### [Definovanie krokov](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/kroky.md) Skladajte kroky s názvom, CTA, cieľmi, metadátami, kľúčmi a poradím; o dokončení a vylúčení rozhodujú closures. #### [Deklaratívne podmienky](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/deklarativne-podmienky.md) completeWhenFilled(), completeWhenTrue(), completeWhenHas() a ich náprotivky na vylúčenie — pravidlá na jeden riadok bez closures. #### [Voliteľné kroky](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/volitelne-kroky.md) Usmerňujte používateľov krokmi navyše, ktoré sa započítajú do postupu, ale nikdy neblokujú dokončenie. #### [Príprava modelu](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/priprava-modelu.md) Pridajte GetsOnboarded na model — čítajte jeho tok, zvoľte predvolený kľúč a používajte jednoriadkové metódy bezpečné voči null. #### [Čítanie postupu](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/citanie-postupu.md) Dokončenie, aktuálny krok, percentá, pozícia a pokračovanie — celé API na čítanie toku s referenčnou tabuľkou. #### [Viazanie subjektu](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/viazanie-subjektu.md) Vyhodnoťte tok pre konkrétny model alebo prihláseného používateľa — každé volanie Onboarding::for() vráti vlastnú naviazanú kópiu. #### [Výber toku pre subjekt](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/vyber-toku.md) Zaregistrujte jeden resolver, ktorý každému subjektu priradí kľúč toku, s automatickým návratom na predvolený tok. #### [Middleware pre routy](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/middleware.md) Podmieňte routy dokončením onboardingu: nedokončených používateľov presmeruje na prvý nedokončený povinný krok, bez cyklenia. #### [Sekcie](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/sekcie.md) Zoskupte kroky do pomenovaných sekcií s vlastným postupom — základ pre viacdielnych sprievodcov nastavením. #### [Preložiteľné texty](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/lokalizacia.md) Používajte prekladové kľúče ako názvy krokov a CTA — preložia sa pri čítaní a správanie môžete vynútiť alebo vypnúť. #### [Serializácia pre API](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/serializacia.md) Odovzdajte tok frontendu ako pole pripravené pre JSON alebo ako typované DTO FlowData, StepData a SectionData. #### [Udalosti](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/udalosti.md) Ohláste postup cez record() — StepCompleted a FlowCompleted pre analytiku, notifikácie alebo vlastnú perzistenciu. #### [Perzistencia](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/perzistencia.md) Skryteľné voliteľné kroky a žiadne opakované ohlásenia uložených dokončení — stačí cez Onboarding::useStore() zapojiť vlastný OnboardingStore. #### [Rozšírenie a výnimky](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/rozsirenie.md) Pridajte fluentné pomocníky cez makrá, poznajte všetky body rozšírenia a ošetrite typované InvalidFlowException a InvalidStoreException. #### [Artisan príkazy](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/prikazy.md) Vypíšte zaregistrované toky, preskúmajte kroky jedného toku a overte zapojenie balíka z terminálu. #### [Testovanie](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/testovanie.md) Onboarding::fake() zachytí udalosti, zaznamená skrytia krokov a naplní store v pamäti — alebo testujte postup priamo z údajov modelu. #### [Požiadavky](https://roundly-consulting.com/sk/open-source/navody/onboarding-for-laravel/poziadavky.md) PHP 8.4+ a Laravel 12 alebo 13 — bez PHP rozšírení, databázových tabuliek a konfiguračného súboru. ## Prejavte lásku k open source Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať. [Ďalšie spôsoby podpory vrátane kryptomien](https://roundly-consulting.com/sk/podporte-nas.md) Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md). [Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly) ## Chcete to zabudovať do svojho produktu? Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín. [Ponuka do 48 hodín](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source.md)