Filament Language Switch

https://github.com/bezhansalleh/filament-language-switch
Admin
Filament Language Switch provides zero-config language switching for Filament Panels with automatic...
Tokens:77,392
Snippets:588
Trust Score:9.5
License:MIT
Update:1 week ago
Show doc for...
Tokens:
Raw
### Install with Composer

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Install the plugin via Composer.

```bash
composer require bezhansalleh/filament-language-switch
```

--------------------------------

### Full configuration example for Filament Language Switch

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Use this in a service provider to configure the plugin globally. It sets locales, flags, display mode, trigger style, and more. The example uses `configureUsing` and includes a user-preferred locale callback.

```php
use BezhanSalleh\LanguageSwitch\Enums\DisplayMode;
use BezhanSalleh\LanguageSwitch\Enums\TriggerStyle;
use BezhanSalleh\LanguageSwitch\LanguageSwitch;
use Filament\Support\Icons\Heroicon;

LanguageSwitch::configureUsing(function (LanguageSwitch $switch) {
    $switch
        ->locales(['en', 'fr', 'ar', 'de', 'es'])
        ->flags([
            'en' => asset('flags/us.svg'),
            'fr' => asset('flags/fr.svg'),
            'ar' => asset('flags/sa.svg'),
            'de' => asset('flags/de.svg'),
            'es' => asset('flags/es.svg'),
        ])
        ->displayMode(DisplayMode::Modal)
        ->columns(2)
        ->modalWidth('lg')
        ->circular()
        ->nativeLabel()
        ->trigger(
            style: TriggerStyle::FlagLabel,
            icon: Heroicon::GlobeAlt,
        )
        ->excludes(['admin'])
        ->userPreferredLocale(fn () => auth()->user()?->locale);
});
```

--------------------------------

### Quick Start - Configure LanguageSwitch

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Add this to any service provider's boot() method to configure the plugin. The switch appears in the topbar automatically, or in the sidebar if no topbar exists.

```php
use BezhanSalleh\LanguageSwitch\LanguageSwitch;

public function boot(): void
{
    LanguageSwitch::configureUsing(function (LanguageSwitch $switch) {
        $switch->locales(['en', 'fr', 'ar']);
    });
}
```

--------------------------------

### trigger() usage example — both style and icon

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-appearance.md

Example of setting both the trigger style and icon. Requires importing TriggerStyle enum and Heroicon class.

```php
use BezhanSalleh\LanguageSwitch\Enums\TriggerStyle;
use Filament\Support\Icons\Heroicon;

$switch->trigger(
    style: TriggerStyle::IconLabel,
    icon: Heroicon::GlobeAlt,
);
```

--------------------------------

### visible() example - fully conditional

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch.md

Demonstrates using closures for conditional visibility, e.g., enabled for guests only. The closure is evaluated lazily.

```php
$switch->visible(
    insidePanels: fn () => auth()->check() || app()->isLocal(),
    outsidePanels: true,
);
```

--------------------------------

### make() - Basic LanguageSwitch setup

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch.md

Creates a fresh LanguageSwitch instance with default visibility, locale, and routes. Use this to configure locales and flags for the switch.

```php
use BezhanSalleh\LanguageSwitch\LanguageSwitch;

$switch = LanguageSwitch::make()
    ->locales(['en', 'fr', 'ar'])
    ->flags([
        'en' => asset('flags/us.svg'),
        'fr' => asset('flags/fr.svg'),
        'ar' => asset('flags/sa.svg'),
    ]);
```

--------------------------------

### Opt-in live mode example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-control-panel.md

Enables the control panel in live mode using configureUsing. Requires importing LanguageSwitch.

```php
use BezhanSalleh\LanguageSwitch\LanguageSwitch;

LanguageSwitch::configureUsing(function (LanguageSwitch $switch) {
    $switch
        ->locales(['en', 'fr', 'ar'])
        ->controlPanel();
});
```

--------------------------------

### Configure LanguageSwitch visibility and render hooks

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-visibility.md

Use this example to configure the LanguageSwitch plugin with locales, exclusions, render hooks, and visibility settings. It sets the switch to render as a user-menu item inside panels and at the body start on simple-layout pages.

```php
use BezhanSalleh\LanguageSwitch\LanguageSwitch;
use Filament\View\PanelsRenderHook;

LanguageSwitch::configureUsing(function (LanguageSwitch $switch) {
    $switch
        ->locales(['en', 'fr', 'ar'])
        ->excludes(['admin'])
        ->renderHook(PanelsRenderHook::USER_MENU_PROFILE_AFTER) // render as user-menu item
        ->visible(insidePanels: true, outsidePanels: true)
        ->outsidePanelsRenderHook(PanelsRenderHook::BODY_START);
});

// language-switch-component is registered at:
//   - PanelsRenderHook::USER_MENU_PROFILE_AFTER inside panels
//   - PanelsRenderHook::BODY_START on simple-layout pages
```

--------------------------------

### columns() usage example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-appearance.md

Sets the modal display with 3 columns and a width of 'lg'.

```php
$switch->displayMode(DisplayMode::Modal)->columns(3)->modalWidth('lg');
```

--------------------------------

### Force pinned overlay with BODY_START render hook

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Use this PHP snippet to force a pinned overlay at the body start even when a user menu is present, overriding the automatic docking behavior. It sets the outside panel placement to TopEnd with Pinned mode and specifies the BODY_START render hook.

```php
use Filament\View\PanelsRenderHook;

// Force a body-start overlay even when a user menu is present
$switch
    ->outsidePanelPlacement(Placement::TopEnd, PlacementMode::Pinned)
    ->outsidePanelsRenderHook(PanelsRenderHook::BODY_START);
```

--------------------------------

### Queueable listener class and registration

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/locale-changed.md

Dedicated listener implementing ShouldQueue for async handling, plus its registration in EventServiceProvider. Two files shown together as one setup.

```php
// app/Listeners/SetUserLocale.php
use BezhanSalleh\LanguageSwitch\Events\LocaleChanged;
use Illuminate\Contracts\Queue\ShouldQueue;

class SetUserLocale implements ShouldQueue
{
    public function handle(LocaleChanged $event): void
    {
        auth()->user()?->update(['locale' => $event->locale]);
    }
}
```

```php
// app/Providers/EventServiceProvider.php
protected $listen = [
    LocaleChanged::class => [
        SetUserLocale::class,
    ],
];
```

--------------------------------

### dropdownPlacement() usage example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-appearance.md

Sets the dropdown placement to 'top-end'.

```php
$switch->dropdownPlacement('top-end');
```

--------------------------------

### Example: reading layout state in a custom view

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/trigger-layout.md

Shows how to obtain the TriggerLayout and inspect its properties like triggerShell, renderContext, and sidebarVariant to conditionally render UI elements.

```php
use BezhanSalleh\LanguageSwitch\LanguageSwitch;

$layout = LanguageSwitch::make()->getTriggerLayout();

if ($layout->triggerShell === 'dropdown-list-item') {
    // render a user-menu-style item
}

if ($layout->renderContext === 'sidebar' && $layout->sidebarVariant === 'nav-item') {
    // render a sidebar nav item with x-show="$store.sidebar.isOpen" label
}
```

--------------------------------

### displayMode() usage example - modal for many languages

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-appearance.md

Configures the switch to use a modal display with multiple locales, a width of 'lg', and 2 columns.

```php
use BezhanSalleh\LanguageSwitch\Enums\DisplayMode;

$switch
    ->locales(['en', 'fr', 'ar', 'de', 'es', 'pt', 'ja'])
    ->displayMode(DisplayMode::Modal)
    ->modalWidth('lg')
    ->columns(2);
```

--------------------------------

### Flag component usage example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/blade-components.md

Shows how to use the <x-language-switch::flag /> component with a flag URL from the locale service, alt text, and custom CSS classes.

```blade
<x-language-switch::flag
    :src="$ls->getFlag('en')"
    alt="English"
    class="h-7 w-11 rounded-sm object-cover"
/>
```

--------------------------------

### trigger() usage example — icon only with fallback

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-appearance.md

Example of overriding only the icon with any Blade Icons string. The style remains auto-detected.

```php
$switch->trigger(icon: 'heroicon-o-globe-alt'); // any Blade Icons string works
```

--------------------------------

### modalHeading() usage example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-modal.md

Configures the modal heading to 'Choose Language' when using DisplayMode::Modal.

```php
$switch
    ->displayMode(DisplayMode::Modal)
    ->modalHeading('Choose Language');
```

--------------------------------

### itemStyle() usage example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-appearance.md

Example of setting the item style to FlagOnly for a compact flag grid in modal mode. Requires importing the ItemStyle enum.

```php
use BezhanSalleh\LanguageSwitch\Enums\ItemStyle;

$switch->itemStyle(ItemStyle::FlagOnly); // compact flag grid in modal mode
```

--------------------------------

### Example: using getFlag(), getAvatar(), getLabel()

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-locales.md

Shows how to set flags and call getFlag(), getAvatar(), and getLabel() with different locales. Demonstrates fallback behavior: getFlag('fr') returns 'FR' when not in flags map, getAvatar('pt_BR') returns 'PT', and getLabel('fr') returns 'French' with default display locale.

```php
$switch->flags(['en' => asset('flags/us.svg')]);
$switch->getFlag('en');    // "https://..." (asset URL)
$switch->getFlag('fr');    // "FR"            (fallback, no exception)
$switch->getAvatar('pt_BR'); // "PT"
$switch->getLabel('fr');   // "French" (default display locale)
```

--------------------------------

### Staged (manual) mode example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-control-panel.md

Enables the control panel with live mode disabled, staging changes until Apply button is clicked. Shows equivalent call.

```php
$switch->controlPanel(live: false);        // enabled + staged changes with Apply button
// equivalent to:
$switch->controlPanel(true, live: false);
```

--------------------------------

### Single inline embed example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/blade-components.md

Embeds a single language switch instance using the inline component with default key.

```blade
<x-language-switch::inline />
```

--------------------------------

### Full behavioral example for outside panel placement

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-outside-panel.md

Configures the language switch to be visible only on auth pages outside panels, with a pinned top-center placement and a forced body anchor render hook.

```php
use BezhanSalleh\LanguageSwitch\Enums\Placement;
use BezhanSalleh\LanguageSwitch\Enums\PlacementMode;

$switch
    ->visible(insidePanels: false, outsidePanels: true)   // only auth pages
    ->outsidePanelPlacement(Placement::TopCenter, PlacementMode::Pinned)
    ->outsidePanelsRenderHook(\Filament\View\PanelsRenderHook::BODY_START); // force body anchor

```

--------------------------------

### locales() example with dynamic Closure

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-locales.md

Sets locales dynamically from a configuration array using a Closure, evaluated lazily.

```php
$switch->locales(fn () => array_keys(config('app.supported_locales')));
```

--------------------------------

### maxHeight() usage examples

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-appearance.md

Sets the dropdown max-height to '30rem' or 'max-content' to disable scrolling.

```php
$switch->maxHeight('30rem');
$switch->maxHeight('max-content'); // no scroll
```

--------------------------------

### outsidePanelPlacement() example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-outside-panel.md

Enables the switch on outside panels and pins it to the top center of the viewport. Uses Placement::TopCenter and PlacementMode::Pinned.

```php
use BezhanSalleh\LanguageSwitch\Enums\Placement;
use BezhanSalleh\LanguageSwitch\Enums\PlacementMode;

$switch
    ->visible(outsidePanels: true)
    ->outsidePanelPlacement(Placement::TopCenter, PlacementMode::Pinned);
```

--------------------------------

### outsidePanelsRenderHook() example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-outside-panel.md

Docks the language switch into the user menu dropdown as a profile item using the PanelsRenderHook::USER_MENU_PROFILE_AFTER hook.

```php
use Filament\View\PanelsRenderHook;

$switch->outsidePanelsRenderHook(PanelsRenderHook::USER_MENU_PROFILE_AFTER);
```

--------------------------------

### Error handling example for getFlags()

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-locales.md

Shows how to catch the Exception thrown by getFlags() when a flag URL is invalid. The comment notes that filters are validated here, not in flags(), and advises fixing the offending URL in the flags(['en' => ...]) call.

```php
try {
    $flags = $switch->getFlags();
} catch (Exception $e) {
    // "Invalid flag url" — filters are validated here, not in flags()
    // Fix the offending URL in your flags(['en' => ...]) call.
}
```

--------------------------------

### Locale item component include example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/blade-components.md

Shows how to include the locale-item partial with all its props: locale, label, flag, avatar, and layout options. Used to render a locale row or card.

```blade
@include('language-switch::components.locale-item', [
    'locale' => $locale,
    'label' => $ls->getLabel($locale),
    'flag' => $showFlag ? $ls->getFlag($locale) : null,
    'avatar' => $showAvatar ? $ls->getAvatar($locale) : null,
    'isCompact' => $isCompact,
    'isCircular' => $isCircular,
    'isModal' => $isModal,
    'flagHeight' => $flagHeight,
    'avatarHeight' => $avatarHeight,
])
```

--------------------------------

### Example: reading the resolution with getPreferredLocale()

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-locales.md

Shows how to call getPreferredLocale() on a LanguageSwitch instance to get the active locale in your own code.

```php
$current = LanguageSwitch::make()->getPreferredLocale();
```

--------------------------------

### Override outside panels render hook

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Allows explicit override of the render hook anchor. The first example docks the switcher as a profile item inside the user menu dropdown; the second forces body-level anchoring for an in-flow mode.

```php
use Filament\View\PanelsRenderHook;

// Dock as a profile item inside the user menu dropdown
$switch->outsidePanelsRenderHook(PanelsRenderHook::USER_MENU_PROFILE_AFTER);
```

```php
// Or force body-level anchoring for an in-flow mode
$switch
    ->outsidePanelPlacement(Placement::BottomCenter, PlacementMode::Static)
    ->outsidePanelsRenderHook(PanelsRenderHook::BODY_END);
```

--------------------------------

### Build theme with npm

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Build your theme after adding the source line.

```bash
npm run build
```

--------------------------------

### LanguageSwitch::boot()

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch.md

Statically bootstraps the switch by building an instance and registering a Filament render hook if the switch is visible. The render hook renders the Livewire component.

```APIDOC
## LanguageSwitch::boot()

### Description
Statically bootstraps the switch by building an instance and registering a Filament render hook if the switch is visible. The render hook renders the Livewire component.

### Method
Static method

### Signature
```php
public static function boot(): void
```

### Parameters
None

### Returns
- **void**

### Behavior
- Builds an instance with `make()`.
- If `isVisible()` is `true`, registers a render hook at `getResolvedRenderHook()` that renders the Livewire component with key `fls`.
- If invisible, does nothing.

### Visibility Conditions
- `isVisibleInsidePanels()` is `true`
- `count($this->getLocales()) > 1`
- `isCurrentPanelIncluded()` is `true` (panel not in `excludes`)

### Example
```php
use BezhanSalleh\LanguageSwitch\LanguageSwitch;
use Filament\Facades\Filament;

Filament::serving(function (): void {
    LanguageSwitch::boot(); // idempotent: no-op when not visible
});
```
```

--------------------------------

### LanguageSwitch::boot()

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch.md

Boots the plugin, auto-registering the Livewire component at the best Filament render hook for the current panel. Called automatically by Filament.

```APIDOC
## LanguageSwitch::boot()

### Description
Boots the plugin, auto-registering the Livewire component at the best Filament render hook for the current panel. Called automatically by Filament.

### Method
Static method

### Signature
```php
public static function boot(): void
```

### Parameters
None

### Return Value
- **void** - No return value

### Example
```php
// Called automatically by Filament, no need to call manually.
```
```

--------------------------------

### boot() - Manual trigger inside Filament serving

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch.md

Statically bootstraps the switch, registering a render hook only if visible. Use this inside a Filament serving callback to manually trigger boot.

```php
use BezhanSalleh\LanguageSwitch\LanguageSwitch;
use Filament\Facades\Filament;

Filament::serving(function (): void {
    LanguageSwitch::boot(); // idempotent: no-op when not visible
});
```

--------------------------------

### flagHeight() and avatarHeight() usage example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-appearance.md

Example of setting custom heights for the flag and avatar in modal display mode. The flag default is 'h-16' and avatar default is 'size-8'.

```php
$switch
    ->displayMode(DisplayMode::Modal)
    ->flagHeight('h-20')       // default: 'h-16'
    ->avatarHeight('size-10'); // default: 'size-8'
```

--------------------------------

### mount() method

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch-control-panel.md

Initializes the control panel component. Sets topbar and live properties, loads session overrides, copies display mode and modal slide-over values, and normalizes invalid session values for outsidePanelsRenderHook and outsidePanelPlacementMode.

```php
public function mount(): void
```

--------------------------------

### modalWidth() usage example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-modal.md

Sets the modal width to 'lg'.

```php
$switch->displayMode(DisplayMode::Modal)->modalWidth('lg');
```

--------------------------------

### Configure modal display with flags and item style

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Set up a modal display mode with flags, item style `FlagOnly`, three columns, and a large modal width. This configuration is used when flags are configured and modal mode is selected.

```php
$switch
    ->flags([...])
    ->itemStyle(ItemStyle::FlagOnly)
    ->displayMode(DisplayMode::Modal)
    ->columns(3)
    ->modalWidth('lg');
```

--------------------------------

### modalIcon() usage example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-modal.md

Sets the modal header icon to 'heroicon-o-language'.

```php
$switch->modalIcon('heroicon-o-language');
```

--------------------------------

### modalIconColor() usage example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-modal.md

Sets the modal header icon color to 'primary'.

```php
$switch->modalIconColor('primary');
```

--------------------------------

### LanguageSwitch::make()

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch.md

Static factory method to create a new LanguageSwitch instance. Use this to configure the plugin in a service provider's boot() method via configureUsing().

```APIDOC
## LanguageSwitch::make()

### Description
Static factory method to create a new LanguageSwitch instance. Use this to configure the plugin in a service provider's boot() method via configureUsing().

### Method
Static method

### Signature
```php
public static function make(): static
```

### Parameters
None

### Return Value
- **static** - A new LanguageSwitch instance

### Example
```php
use BezhanSalleh\LanguageSwitch\LanguageSwitch;

LanguageSwitch::make()
    ->visible()
    ->locales(['en', 'fr']);
```
```

--------------------------------

### LanguageSwitchServiceProvider class declaration

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch-service-provider.md

The service provider bootstraps the package by registering Livewire components, injecting locale middleware into panels, and booting the control panel. It extends Spatie's PackageServiceProvider and is auto-discovered via Composer.

```php
class LanguageSwitchServiceProvider extends PackageServiceProvider
{
    public static string $name = 'language-switch';

    public function configurePackage(Package $package): void
    {
        $package
            ->name(static::$name)
            ->hasViews();
    }

    public function packageBooted(): void
    {
        $this->registerPluginMiddleware();

        Livewire::component('language-switch-component', LanguageSwitchComponent::class);
        Livewire::component('language-switch-control-panel', LanguageSwitchControlPanel::class);

        Filament::serving(function (): void {
            LanguageSwitch::boot();
        });

        $this->bootControlPanel();
    }

    public function registerPluginMiddleware(): void;

    protected function reorderCurrentPanelMiddlewareStack(Panel $panel): void;

    protected function bootControlPanel(): void;
}
```

--------------------------------

### circular() usage example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-appearance.md

Enables circular flags and avatars on the switch.

```php
$switch->circular();
```

--------------------------------

### Enable switcher on outside panels with placement

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Shows the switcher on Filament's simple-layout pages (login, register, etc.) and sets its placement to TopEnd. The `visible()` method accepts two independent toggles: `insidePanels` (default true) and `outsidePanels` (default false).

```php
use BezhanSalleh\LanguageSwitch\Enums\Placement;

$switch
    ->visible(outsidePanels: true)
    ->outsidePanelPlacement(Placement::TopEnd);
```

--------------------------------

### packageBooted() method signature

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch-service-provider.md

Method signature for post-boot orchestration. Runs after the package's boot() and handles middleware injection, Livewire component registration, Filament::serving() callback, and bootControlPanel().

```php
public function packageBooted(): void
```

--------------------------------

### Enable Control Panel

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Opt in explicitly via controlPanel(). Disabled by default. When enabled and the app runs with APP_ENV=local and APP_DEBUG=true, a language-icon button appears at the bottom-end of every panel page.

```php
LanguageSwitch::configureUsing(function (LanguageSwitch $switch) {
    $switch
        ->locales(['en', 'fr', 'ar'])
        ->controlPanel();
});
```

--------------------------------

### nativeLabel() example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-locales.md

Enables native labels so locale names appear in their own language, e.g., 'Français', 'Português'.

```php
$switch->nativeLabel(); // "Français", "Português", ...
```

--------------------------------

### configurePackage() method signature

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch-service-provider.md

Method signature for configuring the package. Accepts a Spatie\LaravelPackageTools\Package instance and returns void. Registers the package name and hasViews() with the publishable tag 'language-switch-views'.

```php
public function configurePackage(Package $package): void
```

--------------------------------

### Control Panel Manual Mode

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Stage multiple changes and commit them together by passing live: false. In manual mode, changes are accumulated and an Apply button appears in the panel footer.

```php
$switch->controlPanel(live: false);          // enabled + staged (Apply button)
$switch->controlPanel(true, live: false);    // same thing, explicit
```

--------------------------------

### bootControlPanel() method signature

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch-service-provider.md

Protected method signature for booting the control panel. Registers a configurator that replays session overrides and, when enabled and in local debug mode, registers a render hook at PanelsRenderHook::BODY_END.

```php
protected function bootControlPanel(): void
```

--------------------------------

### Render switch inside user menu

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Set the render hook to `USER_MENU_PROFILE_AFTER` to display the switch as a menu item in the user menu.

```php
$switch->renderHook(PanelsRenderHook::USER_MENU_PROFILE_AFTER);
```

--------------------------------

### Change display locale for labels

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Change the language used for auto-generated labels. For example, setting `displayLocale('fr')` generates labels in French (e.g., "Anglais" for English).

```php
// Labels generated in French (e.g., "Anglais" for English)
$switch->displayLocale('fr');
```

--------------------------------

### flags()

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Associates each locale with a flag image URL. This method is used to configure the flag images displayed for each locale in the language switch.

```APIDOC
## flags()

### Description
Associates each locale with a flag image URL.

### Method
flags

### Parameters
- **flags** (array) - Required - An associative array mapping locale codes to flag image URLs.

### Request Example
```php
$switch->flags([
    'en' => asset('flags/us.svg'),
    'fr' => asset('flags/fr.svg'),
    'ar' => asset('flags/sa.svg'),
]);
```

### Response
No return value; configures the switch instance.
```

--------------------------------

### displayLocale() example with French

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-locales.md

Sets the display locale to French so auto-generated labels appear in French, e.g., 'Anglais' instead of 'English'.

```php
$switch->displayLocale('fr'); // "Anglais" instead of "English"
```

--------------------------------

### render() method

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch-control-panel.md

Returns the control panel view with hasTopbar variable exposed.

```php
public function render(): View
```

--------------------------------

### excludes() example with dynamic Closure

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-visibility.md

Dynamically excludes the 'admin' panel only when the application environment is production. Uses a Closure to evaluate config('app.env').

```php
$switch->excludes(fn () => config('app.env') === 'production' ? ['admin'] : []);
```

--------------------------------

### dropdownPlacement(?string|Closure)

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/configuration.md

Sets an explicit dropdown placement; `null` means classified per context.

```APIDOC
## dropdownPlacement(?string|Closure)

### Description
Sets an explicit dropdown placement; `null` means classified per context.

### Method
Fluent setter on `LanguageSwitch`

### Parameters
- **dropdownPlacement** (?string) - Optional - The dropdown placement. Defaults to `null`.

### Returns
`static` - The `LanguageSwitch` instance for chaining.

### Example
```php
LanguageSwitch::configureUsing(function (LanguageSwitch $switch) {
    $switch->dropdownPlacement('bottom-end');
});
```
```

--------------------------------

### trigger()

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Configures the language switch trigger with a style and/or icon. Both parameters are optional; pass whichever you want to override.

```APIDOC
## trigger()

### Description
Configures the language switch trigger with a style and/or icon. Both parameters are optional; pass whichever you want to override.

### Method
N/A (PHP method)

### Parameters
- **style** (TriggerStyle) - Optional - The visual style of the trigger. Accepts enum cases: Icon, Flag, Avatar, IconLabel, FlagLabel, AvatarLabel, Label.
- **icon** (string|Heroicon) - Optional - The icon to display. Can be a Blade Icons string or a Heroicon enum case.

### Request Example
```php
$switch->trigger(style: TriggerStyle::Icon);
$switch->trigger(icon: Heroicon::GlobeAlt);
$switch->trigger(style: TriggerStyle::IconLabel, icon: Heroicon::GlobeAlt);
```

### Response
No return value specified.
```

--------------------------------

### Modal Heading and Icon

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Customize the modal heading, icon, and icon color.

```php
$switch
    ->displayMode(DisplayMode::Modal)
    ->modalHeading('Choose Language')
    ->modalIcon('heroicon-o-language')
    ->modalIconColor('primary');
```

--------------------------------

### Programmatic locale switch example

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-locales.md

Calls LanguageSwitch::switchLocale('fr') to switch to French. Persists the locale in the session, queues a forever cookie, and dispatches a LocaleChanged event.

```php
use BezhanSalleh\LanguageSwitch\LanguageSwitch;

LanguageSwitch::switchLocale('fr');
// session('locale') === 'fr'
// cookie 'filament_language_switch_locale' queued forever
// LocaleChanged('fr') event dispatched
```

--------------------------------

### LanguageSwitch::make()

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch.md

Creates a new LanguageSwitch instance, primed with default visibility, locale, and route settings. It also triggers the Filament configure hook and any registered configurators.

```APIDOC
## LanguageSwitch::make()

### Description
Creates a new LanguageSwitch instance, primed with default visibility, locale, and route settings. It also triggers the Filament configure hook and any registered configurators.

### Method
Static method

### Signature
```php
public static function make(): static
```

### Parameters
None

### Returns
- **static** - A fresh `LanguageSwitch` instance resolved from the container.

### Behavior
- Sets visibility defaults: `insidePanels = true`, `outsidePanels = false`.
- Sets `displayLocale` to `app()->getLocale()`.
- Sets default outside-panel routes: `['auth.login', 'auth.profile', 'auth.register']`.
- Dispatches the Filament `configure()` hook and runs `configureUsing()` configurators.

### Example
```php
use BezhanSalleh\LanguageSwitch\LanguageSwitch;

$switch = LanguageSwitch::make()
    ->locales(['en', 'fr', 'ar'])
    ->flags([
        'en' => asset('flags/us.svg'),
        'fr' => asset('flags/fr.svg'),
        'ar' => asset('flags/sa.svg'),
    ]);
```
```

--------------------------------

### registerPluginMiddleware() method signature

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch-service-provider.md

Method signature for registering plugin middleware. Iterates over non-excluded panels from LanguageSwitch::make()->getPanels() and calls reorderCurrentPanelMiddlewareStack() for each.

```php
public function registerPluginMiddleware(): void
```

--------------------------------

### renderHook()

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Places the language switch at a specified Filament render hook location.

```APIDOC
## renderHook()

### Description
Places the language switch at a specified Filament render hook location.

### Method
renderHook()

### Parameters
- **hook** (PanelsRenderHook) - Required - The render hook location (e.g., PanelsRenderHook::SIDEBAR_NAV_END).

### Request Example
```php
use Filament\View\PanelsRenderHook;

$switch->renderHook(PanelsRenderHook::SIDEBAR_NAV_END);
```

### Response
No return value (void).
```

--------------------------------

### Set trigger icon with Heroicon or Blade Icons

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

The trigger uses the language icon by default. Pass any icon from installed Blade Icons packages or a Heroicon enum case. You can change just the icon, use a Blade Icons string, or change both style and icon in one call.

```php
use Filament\Support\Icons\Heroicon;

// Just change the icon (style stays as default)
$switch->trigger(icon: Heroicon::GlobeAlt);

// Any Blade Icons string works too
$switch->trigger(icon: 'heroicon-o-globe-alt');
$switch->trigger(icon: 'phosphor-translate');

// Or change both in one call
$switch->trigger(
    style: TriggerStyle::IconLabel,
    icon: Heroicon::GlobeAlt,
);
```

--------------------------------

### Render hook registration for control panel

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch-service-provider.md

Registers the control panel Livewire component at the BODY_END render hook. Only executes when isControlPanelEnabled(), app()->isLocal(), and config('app.debug') are all true, preventing production rendering even if controlPanel(true) is set.

```php
FilamentView::registerRenderHook(
    name: PanelsRenderHook::BODY_END,
    hook: fn (): string => Blade::render('<livewire:language-switch-control-panel />'),
);
```

--------------------------------

### visible() method signature

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch.md

Defines the visible() method with parameters for controlling visibility inside and outside panels. Returns static for chaining.

```php
public function visible(
    bool | Closure $insidePanels = true,
    bool | Closure $outsidePanels = false,
): static
```

--------------------------------

### controlPanel(enabled=true, live=true)

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/configuration.md

Enables an opt-in floating dev configurator for the language switch. The control panel only renders when APP_ENV=local and APP_DEBUG=true. The live option controls whether changes apply live or require an Apply button.

```APIDOC
## controlPanel(enabled=true, live=true)

### Description
Enables an opt-in floating dev configurator for the language switch. The control panel only renders when APP_ENV=local and APP_DEBUG=true.

### Method
controlPanel

### Parameters
- **enabled** (bool) - Optional - Default: `true` - Enable the control panel.
- **live** (bool) - Optional - Default: `true` - Live apply vs staged changes with an Apply button.

### Options Set
- **controlPanelEnabled** (bool) - Default: `false`
- **controlPanelLive** (bool) - Default: `true`
```

--------------------------------

### outsidePanelRoutes()

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Overrides the list of routes where the outside-panel switcher appears. Accepts an array of route names. Default is ['auth.login', 'auth.profile', 'auth.register'].

```APIDOC
## outsidePanelRoutes()

### Description
Overrides the list of routes where the outside-panel switcher appears. Accepts an array of route names. Default is ['auth.login', 'auth.profile', 'auth.register'].

### Method
Configuration method

### Parameters
- **routes** (array) - Required - Array of route names where the switcher should appear.

### Example
```php
$switch->outsidePanelRoutes([
    'auth.login',
    'auth.register',
    'auth.password-reset.request',
    'auth.password-reset.reset',
]);
```
```

--------------------------------

### Modal Display Mode

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Opens a modal dialog instead of a dropdown. Better for many languages.

```php
use BezhanSalleh\LanguageSwitch\Enums\DisplayMode;

$switch
    ->locales(['en', 'fr', 'ar', 'de', 'es', 'pt', 'ja', 'ko', 'zh'])
    ->displayMode(DisplayMode::Modal)
    ->modalWidth('lg');
```

--------------------------------

### Override outside panel routes

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Replaces the default list of routes where the switcher appears on outside panels. The default is `['auth.login', 'auth.profile', 'auth.register']`; the profile route is excluded unless the panel uses a simple profile page.

```php
$switch->outsidePanelRoutes([
    'auth.login',
    'auth.register',
    'auth.password-reset.request',
    'auth.password-reset.reset',
]);
```

--------------------------------

### Show native locale names

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Display each locale name in its own language (e.g., "Français" instead of "French") using the `nativeLabel` method.

```php
$switch->nativeLabel();
```

--------------------------------

### handle() method signature

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/switch-language-locale.md

The handle method signature for the middleware. It accepts the incoming HTTP request and the next middleware closure, returning the downstream response.

```php
public function handle(Request $request, Closure $next): mixed
```

--------------------------------

### getColumns()

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-appearance.md

Returns the number of columns for the language switch layout. Evaluates the stored integer value.

```APIDOC
## getColumns()

### Description
Returns the number of columns for the language switch layout. Evaluates the stored integer value.

### Method
`getColumns()`

### Returns
- **int** - The number of columns.

```

--------------------------------

### Slide-over Modal

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Use a slide-over panel instead of a centered modal.

```php
$switch
    ->displayMode(DisplayMode::Modal)
    ->modalSlideOver();
```

--------------------------------

### isCircular(), getDisplayMode(), getDropdownPlacement(), getColumns(), getMaxHeight(), getFlagHeight(), getAvatarHeight() signatures

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/has-appearance.md

Plain resolvers that evaluate stored values, casting to bool/int/string where needed, with no side effects.

```php
public function isCircular(): bool
public function getDisplayMode(): DisplayMode
public function getDropdownPlacement(): ?string
public function getColumns(): int
public function getMaxHeight(): string
public function getFlagHeight(): string
public function getAvatarHeight(): string
```

--------------------------------

### LanguageSwitch::configureUsing() registration in service provider

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch.md

Canonical registration of the LanguageSwitch configurator in a service provider's boot() method. Sets locales, flags, and display options.

```php
use BezhanSalleh\LanguageSwitch\LanguageSwitch;

public function boot(): void
{
    LanguageSwitch::configureUsing(function (LanguageSwitch $switch) {
        $switch
            ->locales(['en', 'fr', 'ar', 'de', 'es'])
            ->flags([
                'en' => asset('flags/us.svg'),
                'fr' => asset('flags/fr.svg'),
                'de' => asset('flags/de.svg'),
            ])
            ->nativeLabel()
            ->circular()
            ->displayMode(\BezhanSalleh\LanguageSwitch\Enums\DisplayMode::Modal)
            ->trigger(style: \BezhanSalleh\LanguageSwitch\Enums\TriggerStyle::FlagLabel);
    });
}
```

--------------------------------

### Set item style options

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Control what each locale item shows in the dropdown or modal. The default auto-detects: `FlagWithLabel` when flags are configured, `AvatarWithLabel` otherwise. Compact styles use tooltips; in modal mode, `FlagOnly` renders as a showcase grid, `AvatarOnly` falls back to label-only cards.

```php
use BezhanSalleh\LanguageSwitch\Enums\ItemStyle;

$switch->itemStyle(ItemStyle::FlagOnly);        // flag images only, tooltips on hover
$switch->itemStyle(ItemStyle::AvatarOnly);      // abbreviations only (EN, FR), tooltips on hover
$switch->itemStyle(ItemStyle::LabelOnly);       // text labels only, no visual
$switch->itemStyle(ItemStyle::FlagWithLabel);    // flag + locale name (default with flags)
$switch->itemStyle(ItemStyle::AvatarWithLabel);  // abbreviation + locale name (default without flags)
```

--------------------------------

### displayMode()

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Sets the display mode for the language switch, controlling how flags and avatars are shown in modal radio cards.

```APIDOC
## displayMode()

### Description
Sets the display mode for the language switch, controlling how flags and avatars are shown in modal radio cards.

### Method
displayMode()

### Parameters
- **mode** (DisplayMode) - Required - The display mode to use (e.g., DisplayMode::Modal).

### Request Example
```php
$switch->displayMode(DisplayMode::Modal);
```

### Response
No return value (void).
```

--------------------------------

### Middleware registration insertion

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/switch-language-locale.md

The service provider inserts the middleware into each panel's middleware stack immediately before DispatchServingFilamentEvent, or at index 0 if that class is absent. The insertion is idempotent.

```php
$position = array_search(DispatchServingFilamentEvent::class, $middlewareStack, true);
$position = $position !== false ? $position : 0;

array_splice($middlewareStack, $position, 0, [SwitchLanguageLocale::class]);
```

--------------------------------

### Place switch at a Filament render hook

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Use `renderHook()` with a `PanelsRenderHook` constant to position the switch at any supported render hook. The trigger adapts its design based on the hook location.

```php
use Filament\View\PanelsRenderHook;

$switch->renderHook(PanelsRenderHook::SIDEBAR_NAV_END);
```

--------------------------------

### columns(int|Closure)

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/configuration.md

Sets the modal grid columns.

```APIDOC
## columns(int|Closure)

### Description
Sets the modal grid columns.

### Method
Fluent setter on `LanguageSwitch`

### Parameters
- **columns** (int) - Optional - Number of columns. Defaults to `1`.

### Returns
`static` - The `LanguageSwitch` instance for chaining.

### Example
```php
LanguageSwitch::configureUsing(function (LanguageSwitch $switch) {
    $switch->columns(2);
});
```
```

--------------------------------

### Associate flags with locales

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Configure flag images for each locale using the `flags` method. The array maps locale codes to asset paths.

```php
$switch->flags([
    'en' => asset('flags/us.svg'),
    'fr' => asset('flags/fr.svg'),
    'ar' => asset('flags/sa.svg'),
]);
```

--------------------------------

### Placement enum with isTop method

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/types.md

String-backed enum with six placement cases and isTop() method. Placements are RTL-aware; TopEnd is the default for outside-panel rendering.

```php
enum Placement: string
{
    case TopStart = 'top-start';

    case TopCenter = 'top-center';

    case TopEnd = 'top-end';

    case BottomStart = 'bottom-start';

    case BottomCenter = 'bottom-center';

    case BottomEnd = 'bottom-end';

    public function isTop(): bool
    {
        return in_array($this, [self::TopStart, self::TopCenter, self::TopEnd], true);
    }
}
```

--------------------------------

### outsidePanelPlacement()

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Sets the placement of the language switcher on simple-layout pages. Accepts a Placement enum value and an optional PlacementMode enum value to control how the switcher is attached to the page.

```APIDOC
## outsidePanelPlacement()

### Description
Sets the placement of the language switcher on simple-layout pages. Accepts a Placement enum value and an optional PlacementMode enum value to control how the switcher is attached to the page.

### Method
Configuration method

### Parameters
- **placement** (Placement) - Required - The placement of the switcher. One of: TopStart, TopCenter, TopEnd, BottomStart, BottomCenter, BottomEnd.
- **mode** (PlacementMode) - Optional - The placement mode. One of: Static (default), Pinned, Relative.

### Example
```php
use BezhanSalleh\LanguageSwitch\Enums\Placement;
use BezhanSalleh\LanguageSwitch\Enums\PlacementMode;

$switch->outsidePanelPlacement(Placement::TopCenter, PlacementMode::Pinned);
```
```

--------------------------------

### applyOverrides() method

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch-control-panel.md

Manual-mode commit: sets isDirty to false and redirects to Referer or current URL, reloading with staged overrides applied.

```php
public function applyOverrides(): void
```

--------------------------------

### visible()

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Controls where the language switcher appears. Accepts two boolean toggles: insidePanels (default true) and outsidePanels (default false). Use to enable the switcher on simple-layout pages (login, register, etc.) or hide it inside panels.

```APIDOC
## visible()

### Description
Controls where the language switcher appears. Accepts two boolean toggles: insidePanels (default true) and outsidePanels (default false). Use to enable the switcher on simple-layout pages (login, register, etc.) or hide it inside panels.

### Method
Configuration method

### Parameters
- **insidePanels** (bool) - Optional - Whether to show the switcher inside Filament panels. Default: true.
- **outsidePanels** (bool) - Optional - Whether to show the switcher on simple-layout pages (outside panels). Default: false.

### Example
```php
$switch->visible(outsidePanels: true);
$switch->visible(insidePanels: false, outsidePanels: true);
```
```

--------------------------------

### Listen to LocaleChanged Event

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Fires whenever the locale switches. Use this event to update user data or perform side effects.

```php
use BezhanSalleh\LanguageSwitch\Events\LocaleChanged;
use Illuminate\Support\Facades\Event;

Event::listen(function (LocaleChanged $event) {
    auth()->user()?->update(['locale' => $event->locale]);
});
```

--------------------------------

### modalHeading(?string|Closure)

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/configuration.md

Sets the modal title.

```APIDOC
## modalHeading(?string|Closure)

### Description
Sets the modal title.

### Method
Fluent setter on `LanguageSwitch`

### Parameters
- **modalHeading** (?string) - Optional - The modal title. Defaults to `'Languages'`.

### Returns
`static` - The `LanguageSwitch` instance for chaining.

### Example
```php
LanguageSwitch::configureUsing(function (LanguageSwitch $switch) {
    $switch->modalHeading('Choose Language');
});
```
```

--------------------------------

### reorderCurrentPanelMiddlewareStack() method signature

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch-service-provider.md

Protected method signature for reordering middleware. Uses Laravel's invade() helper to access the protected $panel->middleware array, inserts SwitchLanguageLocale before DispatchServingFilamentEvent, and writes the stack back.

```php
protected function reorderCurrentPanelMiddlewareStack(Panel $panel): void
```

--------------------------------

### resetOverrides() method

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch-control-panel.md

Forgets the session key and redirects to Referer/current URL, wiping all accumulated overrides and restoring defaults.

```php
public function resetOverrides(): void
```

--------------------------------

### LocaleChanged Constructor

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/locale-changed.md

Creates a new LocaleChanged event instance with the locale the user switched to. The locale is available as a public property on the event object.

```APIDOC
## LocaleChanged Constructor

### Description
Creates a new LocaleChanged event instance with the locale the user switched to.

### Method
Constructor

### Signature
```php
public function __construct(
    public string $locale
) {}
```

### Parameters
- **$locale** (string) - Required - The locale the user switched to.

### Notes
- The promoted public property `$event->locale` is directly readable.
- The class has no methods or constants; it is a plain event payload.
```

--------------------------------

### Show switcher only on outside panels

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Renders the switcher only on simple-layout pages and hides it inside the panel by setting `insidePanels` to false and `outsidePanels` to true.

```php
$switch->visible(insidePanels: false, outsidePanels: true);
```

--------------------------------

### Package name property declaration

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch-service-provider.md

Declares the static package name used by the underlying Package object. configurePackage() calls ->name($name)->hasViews() to set the language-switch:: view namespace; no config file or migrations are included, only views.

```php
public static string $name = 'language-switch';
```

--------------------------------

### applyIcon() method

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/_autodocs/api-reference/language-switch-control-panel.md

Commits the trigger icon text input by calling updated('triggerIcon'). Returns void.

```php
public function applyIcon(): void
```

--------------------------------

### Disable Control Panel Explicitly

Source: https://github.com/bezhansalleh/filament-language-switch/blob/main/README.md

Disable the control panel explicitly, e.g., in a shared configuration.

```php
$switch->controlPanel(false);
```
Tokens:
Raw