--- title: "Translatable for Laravel — dokumentácia | Roundly" description: "Vývojárska dokumentácia Translatable for Laravel: JSON mapy jazykov, fallback režimy, validácia, query scopy, stav prekladov a slugy pre každý jazyk." url: https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel language: sk --- [Všetky balíky](https://roundly-consulting.com/sk/open-source.md) Open source # Translatable for Laravel Inštalácia `composer require roundly-consulting/translatable-for-laravel` Vyžaduje: PHP ^8.4 · Laravel ^12.0|^13.0 [GitHub](https://github.com/roundly-consulting/translatable-for-laravel) [Packagist](https://packagist.org/packages/roundly-consulting/translatable-for-laravel) [Prispieť (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Patreon](https://www.patreon.com/cw/roundly) ## Prehľad Natívna vrstva prekladateľných atribútov pre Eloquent. Každý prekladateľný atribút je obyčajná mapa jazykov uložená v jednom stĺpci json/jsonb a čítanie vráti hodnotu pre aktuálny jazyk cez konfigurovateľný fallback reťazec, takže obsah nikdy nezostane prázdny. K tomu zabezpečený zápis, fasáda Translatable s validačnými a vyhľadávacími pomocníkmi pre administračné formuláre, prehľad stavu prekladov, voliteľné udalosti zmien a slugy pre každý jazyk cez sluggable-for-laravel. Licencia MIT, postavené len na Laraveli a vlastných balíkoch Roundly — bez závislostí tretích strán. ### Čo získate #### Jeden stĺpec na atribút Každý prekladateľný atribút je obyčajná JSON mapa jazykov v jednom stĺpci jsonb — nový jazyk pridáte bez migrácie. #### Fallback reťazec Režimy None, Fallback alebo Any — čítanie prejde na záložný jazyk a potom na akúkoľvek hodnotu, takže obsah nikdy nezostane prázdny. #### Zabezpečený zápis Kľúče jazykov sa overujú pri každom zápise, hodnoty musia byť skalárne a striktný režim odmietne nepodporované jazyky. #### Jedna fasáda, injektovateľný manager Jazyky, vyhodnotenie fallbacku, normalizácia vstupu, validačné pravidlá, čiastočné aktualizácie a vyhľadávanie na jednej fasáde — alebo injektujte jej manager. #### Stav prekladov Chýbajúce jazyky pre každé pole, miera úplnosti pre progress bar, scope pre chýbajúce jazyky a hotový Blade odznak. #### Slugy podľa jazyka sluggable-for-laravel vytvorí slug pre každý jazyk z rovnakého zdroja jazykov — dva traity, žiadny cast. #### Voliteľné udalosti zmien Jedna udalosť TranslationsChanged pri uložení — zaraďte AI doplnenie chýbajúcich jazykov do fronty bez úprav modelu. ### Dokumentácia #### [Inštalácia](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/instalacia.md) Inštalácia cez Composer, voliteľné publikovanie konfigurácie a validačných textov — žiadne migrácie na publikovanie. #### [Konfigurácia](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/konfiguracia.md) Každý konfiguračný kľúč, jeho predvolená hodnota a env premenná — záložný jazyk, fallback režim, striktné jazyky a zdroj jazykov. #### [Schéma a ukladanie](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/schema-a-ukladanie.md) Pridajte stĺpce jsonb s mapou jazykov cez Blueprint makro translatable(); hodnoty sa ukladajú ako obyčajný JSON objekt bez obalu. #### [Prekladateľné modely](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/prekladatelne-modely.md) Pridajte trait HasTranslations a kontrakt Translatable, vymenujte atribúty v $translatable a voliteľne prepíšte fallback pre model. #### [Fasáda Translatable](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/fasada-a-pomocnici.md) Všetky pomocníky pre mapy jazykov na jednej fasáde — podporované jazyky, overenie jazyka, fallback, vstup, pravidlá, vyhľadávanie a usingLocale(). #### [DI a akcie](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/bez-fasady.md) Namiesto fasády injektujte TranslationManager — rovnaké API ako explicitná závislosť. Akčné triedy balík nemá: ide o čisté výpočty. #### [Čítanie a zápis](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/citanie-a-zapis.md) Čítajte aktuálny jazyk cez fallback reťazec, zvoľte jazyk explicitne a zapisujte jednotlivé hodnoty alebo celé mapy jazykov. #### [Fallback režimy](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/fallback-rezimy.md) Určte, kam až čítanie prejde — len presný jazyk, záložný jazyk alebo akákoľvek hodnota — globálne alebo pre konkrétny model. #### [Vstup a validácia](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/vstup-a-validacia.md) Zabezpečený zápis, normalizácia cez fromInput(), overenie jedného jazyka, validačné pravidlá, celý formulár či čiastočná aktualizácia a súbežné úpravy. #### [Serializácia](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/serializacia.md) toArray(), toJson(), JSON odpovede a API Resources vracajú pre každý atribút vyhodnotenú hodnotu jazyka, nie surovú mapu. #### [Stav prekladov](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/stav-prekladov.md) Chýbajúce jazyky pre každé pole, úplnosť celého modelu pre progress bar, vylúčenie atribútov a hotový Blade odznak stavu. #### [Dopyty a vyhľadávanie](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/dopyty-a-vyhladavanie.md) Scopy pre jednotlivé jazyky nezávislé od databázy, scope pre chýbajúce jazyky a doslovné vyhľadávanie bez ohľadu na veľkosť písmen. #### [Udalosti](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/udalosti.md) Zapnite jednu udalosť TranslationsChanged pri uložení — zaraďte AI doplnenie chýbajúcich jazykov či vyčistenie cache bez úprav modelu. #### [Slugy podľa jazyka](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/slugy-podla-jazyka.md) Slugy pre každý jazyk cez sluggable-for-laravel — dva traity, dve rozhrania, žiadny cast — s rovnakým zdrojom jazykov. #### [Artisan about](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/prikaz-about.md) Sekcia balíka v php artisan about — počet a zdroj jazykov, fallback režim a prepínače, nikdy nie zoznam vašich jazykov. #### [Výnimky](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/vynimky.md) Všetky chyby balíka dedia z TranslatableException — chybné kľúče jazykov, neskalárne hodnoty, nenačítané stĺpce a neprekladateľné atribúty. #### [Testovanie](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/testovanie.md) Zámerne bez fake — jazyky a fallback zafixujete konfiguráciou či výmenou managera, asertujete Pestom, sadu spustíte na SQLite, PostgreSQL či MySQL. #### [Požiadavky](https://roundly-consulting.com/sk/open-source/navody/translatable-for-laravel/poziadavky.md) PHP 8.4+ s ext-json, Laravel 12 alebo 13, PostgreSQL 12+ alebo MySQL 8.0.23+; tri balíky Roundly sa nainštalujú automaticky. ## 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)