Laravel Content-Administration

# Localization

The application can be managed multilingual. The translation in the frontend can be done in php using laravel's localization service or in vue using vue-i18n. It uses the syntax of laravel. All translation strings are formatted so they can be used in vue-i18n as well.

In Laravel applications that include the package, there are two different locales, one for your website and one for the admin application. So for example, a user can manage german content in the admin application and still see the interface in the english version.

The following examples refer to the translations which look like this:

// fjord/resources/lang/{locale}/messages.php

return [
    "welcome": "Welcome, :name"
];

# PHP

To compile for the locale of the admin interface the __f() helper method is used, just like __() from laravel's localization.

__f('messages.welcome', ['name', 'Jannes'])

Pluralization can be used with the __f_choice function or the short version __f_c.

'apples' => '{0} There are none|[1,19] There are some|[20,*] There are many',

...

__f_choice('apples', 10)
__f_c('apples', 10)

# Vue

In Vue the vue-i18n format is used.

<template>
    <div>
        {{ $t('messages.welcome', { name: 'Jannes' }) }}
    </div>
</template>

TIP

You can also use the Larvel localization helpers in Vue components.

  • __()
  • trans()
  • trans_choice()

# Determine Locale

To determine the locale the function getLocale can be used on the FjordApp facade like this:

$fjordLocale = FjordApp::getLocale();

if (FjordApp::isLocale('en')) {
    //
}

# Add Path

By default the path fjord/resources/lang is imported for the admin translation. You can register any number of paths with localization files in your service providers. However, it is recommended to keep the translations for the admin application and your website separate.

All translation attributes are merged, which makes it easy to extend existing localizations for parts like validation or others.

use Fjord\Support\Facades\FjordLang;

FjordLang::addPath(base_path('yourpath/lang/'));

← Helpers →