Download the PHP package abdiwaahid/language-switcher without Composer

Simple and Flexible Language Switcher for Laravel

A simple language switcher for your Laravel applications. This package provides an easy way to allow your users to switch between different languages, with support for both session and cache drivers to store the selected locale. It also includes a ready-to-use Blade component for a seamless frontend integration.

Features

• Easy Language Switching: A straightforward way to let users change their preferred language.
• Multiple Drivers: Supports both session and cache drivers for storing the user's selected language.
• User-Aware Caching: When using the cache driver, the locale is cached specifically for each authenticated user.
• Facade for Convenience: A clean and simple facade for easy interaction with the package's functionality.

Requirements

• PHP 8.3 or higher
• Laravel 10.x, 11.x, 12.x, or 13.x

Installation

You can install the package via composer:

You can publish the config file with:

This is the contents of the published config file:

Optionally, you can publish the views using

You can also publish the translation files to add support for more languages or customize the existing ones:

Finally, to use the provided CSS and JavaScript for the Blade component, publish the assets:

This will place a stylesheet and a script in your public/vendor/language-switcher directory.

Usage

1. Configure Your Languages

First, you need to define the languages you want to support in the config/language-switcher.php file. For example:

or you can simply configure the languages in the AppServiceProvider:

2. Add the Middleware

The package automatically registers the middleware for you. but if you want to add it manually, you can register it manually in your bootstrap/app.php file:

3. Add Styles and Scripts

For the dropdown component to function and look its best, include the published assets in your main layout file (resources/views/layouts/app.blade.php or similar).

The package provides two helpful Blade directives for this:

4. Use the Blade Component

The package comes with a ready-to-use Blade component to display the language switcher in your views. You can use it like this:

This will render a dropdown with the list of available languages. When a user clicks on a language, it will switch the application's locale and store it in the configured driver.

5. Usage with FilamentPHP

To integrate the language switcher with a FilamentPHP admin panel, you can register the component and its assets within the service provider.

First, make sure you have published the package assets:

Then, in the register method of your service provider, add the following:

This will:

1. Load the necessary CSS and JavaScript for the dropdown component.
2. Configure the available languages for the switcher.
3. Render the language switcher component right before the default user menu in the Filament panel.

Advanced Usage

Facade

The package provides a LanguageSwitcher facade for more granular control.

Set the current locale: This will update the locale in the configured storage driver (session or cache).

Get the current locale:

This retrieves the locale from the storage driver.

Get available languages:

This returns a collection of all configured languages, excluding the current one. This is useful for building a custom language switcher UI.

Artisan Command

You can inspect the current locale and all configured languages using the bundled Artisan command:

Driver Configuration

In the config/language-switcher.php file, you can choose the storage driver.

• session: (Default) The locale is stored in the user's session. This is suitable for most web applications.
• cache: The locale is stored in your application's cache. This can be useful for applications that don't use traditional sessions. The cache key is automatically generated based on the authenticated user's ID or the guest's IP address.

Customization

If you need to modify the look and feel of the language switcher, you can publish the views:

The view files will be located in resources/views/vendor/language-switcher. You can edit them as you see fit.

You can also publish the translation files to customize the language names displayed in the dropdown for different locales:

This will create translation files in resources/lang/vendor/language-switcher.

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Abdiwaahid
• All Contributors

License

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