--- title: "Tags for Laravel — dokumentácia | Roundly" description: "Dokumentácia Tags for Laravel: typované štítky, stromy kategórií, preložiteľné slugy, štítky pre tenantov, query scopes, našepkávanie a JSON API." url: https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel language: sk --- [Všetky balíky](https://roundly-consulting.com/sk/open-source.md) Open source # Tags for Laravel Inštalácia `composer require roundly-consulting/tags-for-laravel` Vyžaduje: PHP ^8.4 · Laravel ^12.0|^13.0 [GitHub](https://github.com/roundly-consulting/tags-for-laravel) [Packagist](https://packagist.org/packages/roundly-consulting/tags-for-laravel) [Prispieť (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Patreon](https://www.patreon.com/cw/roundly) ## Prehľad Typované taxonómie pre akýkoľvek Eloquent model. Každý druh štítkov deklarujete raz — kurátorovaný strom kategórií s jedným žánrom na koncert, voľné označenia najviac päť, strom zručností spoločný pre kandidátov aj pracovné ponuky — a rovnaké pravidlá platia vo vašom kóde, formulároch, úlohách vo fronte aj vo voliteľnom JSON API. Názvy sú preložiteľné so slugom pre každý jazyk, štítky sú globálne alebo patria tímu či tenantovi a čítanie, query scopes, našepkávanie ani počty použitia nikdy nespôsobia N+1 dotazy. Licencia MIT, postavené len na oficiálnych komponentoch Laravelu a vlastných balíkoch Roundly translatable, sluggable, enums a query-builder — bez externého poskytovateľa štítkov. ### Čo získate #### Typované taxonómie Každý druh štítkov deklarujete raz — plochý zoznam alebo strom kategórií, jeden na model alebo do limitu, kurátorovaný alebo voľný. #### Jeden štítok na význam, v každom jazyku Rock, rock a ROCK! sú jeden štítok; C, C++ a C# zostanú tri. Preložiteľné názvy, slug pre každý jazyk a stabilné slugy pre URL, ktoré sa nikdy nepohnú. #### Globálne alebo pre tenanta Štítky spoločné pre všetkých alebo vlastné pre tím, klienta či projekt — jeden rozsah nikdy nevidí, nepoužije ani neupraví štítky iného. #### Stromy kategórií Vnárajte, presúvajte, zoraďujte, mažte s odmietnutím, presunom detí alebo celou vetvou a hľadajte „všetko pod Hudbou“ jedným dotazom. #### Dotazy a objavovanie Scopes pre ktorýkoľvek, všetky aj žiadny štítok vrátane potomkov, stránka modelov so štítkami na dva dotazy, našepkávanie vo všetkých jazykoch a popularita. #### Formuláre, filtre a voliteľné API Validačné pravidlo, filter pre query-builder, súhrnný resource a JSON API, ktoré nikdy neprezradí názov PHP triedy ani štítok iného tenanta. #### Fasáda, DI alebo akcie Jedna fasáda Tags, injektovateľný manažér alebo jednoúčelové akcie — a nahrávací fake, ktorý každé volanie aj tak vykoná. ### Dokumentácia #### [Príklady použitia](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/pouzitie.md) Kde sa balík hodí — podujatia, publikovanie, helpdesky, e-shopy, pracovné portály a SaaS pre viac tenantov — a ktorá dodaná funkcia za tým stojí. #### [Inštalácia](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/instalacia.md) Inštalácia cez Composer, typy kľúčov a názvy tabuliek, publikovanie a spustenie migrácií, kontrola jazykov a model so štítkami. #### [Konfigurácia](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/konfiguracia.md) Každý kľúč konfigurácie s env premennou a predvolenou hodnotou — kľúče, tabuľky, typy, názvy a slugy, limity, aliasy pre API, oprávnenia a routy. #### [Typy štítkov](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/typy-stitkov.md) Typované taxonómie v kóde alebo v konfigurácii — stromy či ploché zoznamy, jeden štítok alebo limit, kurátorované či voľné — a úprava typov iných balíkov. #### [Modely so štítkami](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/modely-so-stitkami.md) Kontrakt Taggable a trait HasTags — tagScope() a tagTypes(), vzťah tags() len na čítanie, factory a čo spraví zmazanie modelu. #### [Fasáda Tags](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/fasada.md) Prehľad fasády Tags — define a types, handle katalógu type(), handle for($model), ploché metódy na označovanie, buildery a dátové objekty. #### [DI a akcie](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/bez-fasady.md) Bez fasády: injektujte TagsManager alebo zavolajte jednoúčelovú akciu — každá akcia so signatúrou execute() a cestou cez fasádu. #### [Označovanie modelov](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/oznacovanie.md) Pripájanie, odpájanie, sync a clear podľa modelu, kľúča, slugu či názvu — limity, kurátorované zoznamy, vznik za behu, TagChanges a čítanie bez N+1. #### [Názvy, slugy a preklady](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/nazvy-a-slugy.md) Jeden štítok na význam — normalizované názvy, slugy pre každý jazyk v reťazi jazykov, duplicity a rezervované názvy, stabilné a ručné slugy, farby a ikony. #### [Správa štítkov](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/sprava-stitkov.md) Vytváranie, opakovateľné seedovanie, hľadanie, premenovanie, zmena farby, mazanie a obnova štítkov cez katalóg — plus stĺpce, vzťahy a scopes modelu Tag. #### [Stromy kategórií](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/stromy-kategorii.md) Vnárajte štítky, presúvajte a zoraďujte ich, mažte s odmietnutím, presunom detí alebo celým podstromom a čítajte stromy aj cesty jedným dotazom. #### [Štítky tenantov](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/stitky-tenantov.md) Štítky, ktoré patria tímu, klientovi či projektu, vedľa spoločných globálnych — katalógy s rozsahom, prísne oddelené zápisy, typy len globálne a dotazy. #### [Vyhľadávanie modelov](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/vyhladavanie.md) withAnyTags, withAllTags, withoutTags a withTagsOf — s potomkami a rozsahmi — plus opačný vzťah taggedModels(). #### [Našepkávanie a populárne štítky](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/naseptavanie-a-popularita.md) suggest() hľadá začiatky slugov vo všetkých jazykoch, potom názvy — popular() radí podľa počtu použití alebo naživo, len zo záznamov, ktoré smiete ukázať. #### [Validácia, filtre a resources](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/validacia-a-filtre.md) TagsRule pre form requesty, TagsFilter pre indexové endpointy s query-builder a TagSummaryResource na vnorenie štítkov do vlastných API resources. #### [JSON API](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/json-api.md) Voliteľné JSON API — typy, zoznamy a stromy, našepkávanie a popularita, správa štítkov s presunmi a radením, za vašimi oprávneniami, bez názvov tried. #### [Súbežné zápisy a integrita](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/subezne-zapisy.md) Ako zápisy štítkov, stromov a katalógu zostanú správne pri súbežných zápisoch — pevné poradie zámkov, jeden prechod podľa kľúčov, savepointy, opakovanie. #### [Udalosti](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/udalosti.md) Osem udalostí po potvrdení — Tagged, Untagged a šesť udalostí katalógu — pre vyhľadávacie indexy, cache, audit a webhooky. #### [Výnimky](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/vynimky.md) Každá TagsException so stabilným chybovým kódom a stavom HTTP — plus ako ich zobraziť cez errorCode(), clientMessage() a status(). #### [Artisan príkazy](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/prikazy.md) tags:types vypíše všetky typy, tags:doctor skontroluje dáta a nastavenie, tags:repair opraví cesty, kľúče rozsahu, osirotené priradenia a počty. #### [Testovanie](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/testovanie.md) Tags::fake() zaznamená každú operáciu a aj tak ju vykoná — každá asercia a jej negatívna dvojička, zaznamenané operácie, matchery pre Pest a factory. #### [Požiadavky](https://roundly-consulting.com/sk/open-source/navody/tags-for-laravel/poziadavky.md) PHP 8.4+, Laravel 12 alebo 13, PostgreSQL 12+ alebo MySQL 8.0.23+ (SQLite pre testy), ext-json, ext-mbstring a päť balíkov Roundly. ## 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)