backpack/langfilemanager

An interface to edit language files, for Laravel Backpack.

5.0.1 2024-01-22 09:21 UTC

README

Deprecation note

Backpack team has just released a new package: Translation Manager. This new package uses Spatie Translation Loader and it works in a more predictable way using the database to store translations.

We highly recommend you to switch to Translation Manager.

Latest Version on Packagist Software License Build Status Coverage Status Quality Score Style CI Total Downloads

A quick interface to edit language files, for Laravel Backpack.

Note: this interface allows the admin to directly edit the language files stored in resources/lang. Which might not be a great idea in production, if you have those files commited to git and/or use auto-deployment.

Security updates and breaking changes

Please subscribe to the Backpack Newsletter so you can find out about any security updates, breaking changes or major features. We send an email every 1-2 months.

Install in Backpack v6.x

Step 1. Install via Composer

composer require backpack/langfilemanager

Step 2. Run the migration, seed and file publishing

php artisan vendor:publish --provider="Backpack\LangFileManager\LangFileManagerServiceProvider" --tag="migrations" #publish the migration file
php artisan migrate
php artisan db:seed --class="Backpack\LangFileManager\database\seeds\LanguageTableSeeder"
php artisan vendor:publish --provider="Backpack\LangFileManager\LangFileManagerServiceProvider" --tag="config" #publish the config file
php artisan vendor:publish --provider="Backpack\LangFileManager\LangFileManagerServiceProvider" --tag="lang" #publish the lang files

Step 3. Add menu items for it

Add a menu item for it in resources/views/vendor/backpack/ui/inc/menu_items.blade.php:

<x-backpack::menu-dropdown title="Translations" icon="la la-globe">
    <x-backpack::menu-dropdown-item title="Languages" icon="la la-flag-checkered" :link="backpack_url('language')" />
    <x-backpack::menu-dropdown-item title="Site texts" icon="la la-language" :link="backpack_url('language/texts')" />
</x-backpack::menu-dropdown>

Upgrading from 4.x to 5.x

You should have no problems upgrading, there have been no breaking changes. Just require the new version.

Upgrading from 3.x to 4.x

  • Flags are no longer supported on the Language CRUD, until version 3 admins could browse an image for the language flag, we now recommend developers to setup those images in advance, having them in a public folder like public\flags\en.svg public\flags\ro.svg.

Usage

Tell LangFileManager what langfiles NOT to show, in config/backpack/langfilemanager.php:

// Language files to NOT show in the LangFileManager
//
'language_ignore' => ['admin', 'pagination', 'reminders', 'validation', 'log', 'crud'],

Or just try at your-project-domain/admin/language/texts

Screenshots

See https://backpackforlaravel.com/

Change log

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email tabacitu@backpackforlaravel.com instead of using the issue tracker.

Please subscribe to the Backpack Newsletter so you can find out about any security updates, breaking changes or major features. We send an email every 1-2 months.

Credits

License

The MIT License (MIT). Please see License File for more information.

Hire us

We've spend more than 10.000 hours creating, polishing and maintaining administration panels on Laravel. We've developed e-Commerce, e-Learning, ERPs, social networks, payment gateways and much more. We've worked on admin panels so much, that we've created one of the most popular software in its niche - just from making public what was repetitive in our projects.

If you are looking for a developer/team to help you build an admin panel on Laravel, look no further. You'll have a difficult time finding someone with more experience & enthusiasm for this. This is what we do. Contact us - let's see if we can work together.