Translations

  1. Home
  2. Docs
  3. Translations

Documentation

Overview Installation Configuration Layout Menu Components Plugins Scaffolding Authentication Commands Translations Demo pages Deployment Contributing

Translations (i18n)

All package views — the auth screens, navbar dropdowns, user menu, command palette, and components — use Laravel's translation helper with the adminlte group, e.g. __('adminlte.search') or __('adminlte.sign_out'). The package ships about 130 keys (143 entries in the English file) per locale.

Bundled locales

Nine locales ship under resources/lang/, each with a single adminlte.php file:

Code Language
en English
de German
es Spanish
fr French
it Italian
pt_BR Portuguese (Brazil)
ru Russian
zh Chinese
ja Japanese

How keys resolve

AdminLteServiceProvider::registerTranslations() registers the package lang directory two ways:

  1. As a namespaced source via loadTranslationsFrom($langPath, 'adminlte'), so the keys are reachable as __('adminlte::adminlte.key').
  2. As an additional default-namespace path by calling addPath() on the translation FileLoader. This makes the same keys resolve as plain __('adminlte.key') — i.e. the adminlte group in the default namespace — with no publishing step required.
$this->loadTranslationsFrom($langPath, 'adminlte');

$loader = $this->app->make('translator')->getLoader();
if ($loader instanceof FileLoader) {
    $loader->addPath($langPath);
}

Both forms work out of the box:

__('adminlte.search');            // default namespace (used throughout the views)
__('adminlte::adminlte.key');     // explicit package namespace

Publishing and overriding translations

To customize wording or add keys, publish the language files into your app:

php artisan adminlte:install --only=lang

This copies resources/lang to lang/vendor/adminlte (the publish tag is adminlte-lang, mapping to lang_path('vendor/adminlte')). Files placed there override the package's defaults for matching locales and keys. You can also add a locale the package doesn't ship by creating lang/vendor/adminlte/{locale}/adminlte.php.

Setting the application locale

Translations follow Laravel's active locale. Set the default in config/app.php ('locale' => 'de'), or change it at runtime:

App::setLocale('de');

The master layout reflects the active locale on the <html lang="..."> attribute (converting underscores to hyphens, e.g. pt_BR → pt-BR).