PHPackages mountainclans/livewire-translatable - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Localization & i18n](/categories/localization) 4. / 5. mountainclans/livewire-translatable ActiveLibrary[Localization & i18n](/categories/localization) mountainclans/livewire-translatable =================================== This is my package livewire-translatable 1.1.4(8mo ago)028MITPHPPHP ^8.2CI failing Since Jul 8Pushed 8mo agoCompare [ Source](https://github.com/mountainclans/livewire-translatable)[ Packagist](https://packagist.org/packages/mountainclans/livewire-translatable)[ Docs](https://github.com/mountainclans/livewire-translatable)[ GitHub Sponsors]()[ RSS](/packages/mountainclans-livewire-translatable/feed)WikiDiscussions main Synced 3w ago READMEChangelog (6)Dependencies (11)Versions (7)Used By (0) Livewire Translatable ===================== [](#livewire-translatable) UI компонент для интуитивной работы с переводимыми полями. Опирается на функциональность, предоставляемую пакетом [Spatie Translatable](https://github.com/spatie/laravel-translatable). Установка --------- [](#установка) Установите пакет при помощи Composer: ``` composer require mountainclans/livewire-translatable ``` *Обратите внимание, что для корректной стилизации в вашем проекте должен использоваться TailwindCSS.* Добавьте в `tailwind.config.js` в секцию `content`: ``` './vendor/mountainclans/livewire-translatable/resources/views/**/*.blade.php' ``` Опубликуйте файл конфигурации и задайте в нём нужные языки, на которые переводится ваш сайт: ``` php artisan vendor:publish --tag="livewire-translatable-config" ``` --- Опционально, вы можете опубликовать `views` для их переопределения: ``` php artisan vendor:publish --tag="livewire-translatable-views" ``` Использование ------------- [](#использование) Оберните translatable-поля компонентом ``: ``` Переводимые поля, к примеру ``` Каждому из переводимых полей необходимо добавить атрибут `translatable`. ### Поддерживаемые компоненты переводимых полей [](#поддерживаемые-компоненты-переводимых-полей) - `` из [пакета Livewire UI](https://github.com/mountainclans/livewire-ui?tab=readme-ov-file#input) - `` из [пакета Livewire Tiptap](https://github.com/mountainclans/livewire-tiptap) ### ContentLanguages [](#contentlanguages) Пакет предоставляет сервис-класс `ContentLanguages`, имеющий два статических метода: - `ContentLanguages::all()` - позволяет получить массив всех языков, на которые переводится приложение в формате `ключ` => `название языка`. - `ContentLanguages::default()` - возвращает ключ первого языка, заданного в конфигурации. Трейты ------ [](#трейты) ### Трейт FilledTranslatableFields [](#трейт-filledtranslatablefields) Трейт позволяет задать пустые стартовые значения для всех языков, на которые переводится сайт, для только что инициализированного поля. Полезен при использовании с редактором, который требует строку при инициализации значения. **Использование:** ``` # Your livewire component //... use MountainClans\LivewireTranslatable\Traits\FilledTranslatableFields; public function mount(?string $blogId = null): void { if ($this->blogId) { $this->blog = Blog::findOrFail($this->blogId); $this->content = $this->blog->getAllTranslations('content'); //... } } ``` Поле модели (в данном случае, `content`) обязательно должно быть указано в списке `$translatable` атрибутов модели. ### Трейт RequireTranslations [](#трейт-requiretranslations) Предоставляет Livewire-компоненту метод `requireTranslations`, позволяющий убедиться при валидации поля, что у него есть переводы полей. ``` # Your livewire component public function saveSomething(): void { $this->validate([ 'categoryId' => [ 'nullable', 'exists:blog_categories,id', ], ...$this->requireTranslations('title', true, true, 10, 255), ]); } ``` Метод принимает следующие параметры: - string `$fieldName` - поле компонента, которое валидируем; - bool `$isOptional` - можно ли оставить его пустым; - bool `$requireDefaultLanguage` - требовать ли заполнения хотя бы ключа по умолчанию (получаемого из `ContentLanguages::default()`); - int `$minLength` - минимальная длина поля; - int `$maxLength` - максимальная длина поля. ### Трейт LogTranslatableAttributes [](#трейт-logtranslatableattributes) Позволяет корректно логировать изменения в переводимых полях модели с использованием пакета [Spatie Activitylog](https://github.com/spatie/laravel-activitylog). ``` class YourModel extends Model { use LogsActivity; // обязательно подключите трейт от Spatie use LogTranslatableAttributes; public array $translatable = [ // ... ]; } ``` Использование трейта опционально. Данный пакет не требует использования пакета Spatie Activitylog. Изменения --------- [](#изменения) Получите больше информации об изменениях в пакете, прочитав [CHANGELOG](CHANGELOG.md). Авторы ------ [](#авторы) - [Vladimir Bajenov](https://github.com/mountainclans) - [All Contributors](../../contributors) Лицензия -------- [](#лицензия) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 33 — LowBetter than 72% of packages Maintenance58 Moderate activity, may be stable Popularity7 Limited adoption so far Community6 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~16 days Total 6 Last Release 267d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/d363ad351540061c6f38586e772159863da3cfde29cfbd03c9ff5ba8b6b906aa?d=identicon)[VladimirBazhenov](/maintainers/VladimirBazhenov) --- Top Contributors [![VladimirBazhenov](https://avatars.githubusercontent.com/u/44696748?v=4)](https://github.com/VladimirBazhenov "VladimirBazhenov (3 commits)") --- Tags laravelMountain Clanslivewire-translatable ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/mountainclans-livewire-translatable/health.svg) ``` [![Health](https://phpackages.com/badges/mountainclans-livewire-translatable/health.svg)](https://phpackages.com/packages/mountainclans-livewire-translatable) ``` ### Alternatives [spatie/laravel-pdf Create PDFs in Laravel apps 1.0k4.3M42](/packages/spatie-laravel-pdf)[filament/support Core helper methods and foundation code for all Filament packages. 2328.3M216](/packages/filament-support)[rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3913.7k](/packages/rawilk-profile-filament-plugin)[elegantly/laravel-translator All on one translations management for Laravel 6326.3k](/packages/elegantly-laravel-translator)[finity-labs/fin-mail A powerful email template manager and composer for Filament with dynamic token replacement, template versioning, and inline email sending. 272.7k1](/packages/finity-labs-fin-mail)[osama-98/laravel-enum-translatable A Laravel package that provides translatable enum functionality with easy-to-use methods for working with enum values and their translations 561.1k](/packages/osama-98-laravel-enum-translatable) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)