geniv/nette-locale

Locale extension for Nette Framework

Locale

Plural forms documents: http://docs.translatehouse.org/projects/localization-guide/en/latest/l10n/pluralforms.html, _(*1)

In case new item must by added char $ and add brackets (, )! Otherwise function EVAL has problem with correct evaluate plural form., _(*2)

It is recommended change position plurals index number (eg: 0 => 0 oken, 5 oken, 1 => 1 okno, 2 => 2 okna, 3 okna)., _(*3)

Installation

$ composer require geniv/nette-locale

or, _(*4)

"geniv/nette-locale": ">=1.0.0"

require:, _(*5)

"php": ">=7.0.0",
"nette/nette": ">=2.4.0",
"dibi/dibi": ">=3.0.0"

Include in application

available source drivers:

• Dibi (dibi + cache)
• Array (array configure)
• DevNull (ignore locale)

neon configure:, _(*6)

extensions:
    locale: Locale\Bridges\Nette\Extension

neon configure extension:, _(*7)

# locale
locale:
#   debugger: true
#   autowired: true
#   onRequest: application.application
#   driver: Locale\Drivers\DevNullDriver
#   driver: Locale\Drivers\ArrayDriver(%default%, %locales%, %plurals%, %alias%)
    driver: Locale\Drivers\DibiDriver(%tablePrefix%)

neon configure:, _(*8)

parameters:
    default: "cs"
    locales:
       cs: "Čeština"
       en: "English"
       de: "Deutsch"
    plurals:
       cs: "$nplurals=3; $plural=($n==1) ? 1 : (($n>=2 && $n<=4) ? 2 : 0);"
       en: "$nplurals=2; $plural=($n != 1) ? 0 : 1;"
       de: "$nplurals=2; $plural=($n != 1) ? 0 : 1;"
       ru: "$nplurals=3; $plural=($n%10==1 && $n%100!=11 ? 0 : $n%10>=2 && $n%10<=4 && ($n%100<10 || $n%100>=20) ? 1 : 2);"
    alias:
       sk: cs
       pl: en

usage:, _(*9)

use Locale\Locale;
$locale = $this->context->getByType(ILocale::class);

// or

/** @var Locale\ILocale @inject */
public $locale;

// methods implements `ILocale`:
getListName(): array;
getListId(): array;
getLocales(): array;

getCode(bool $upper = false): string
setCode(string $code)

// is correct locale set? with method: setCode()
// true if driver is DevNullDriver
isReady(): bool

getId(): int
getIdDefault(): string

getCodeDefault(bool $upper = false): string
isDefaultLocale(): bool
getPlural(): string
getIdByCode(string $code): int

description

onRequest is default in Nette\Application\Application via application.application:, _(*10)

via: _vendor/nette/application/src/Application/Application.php:41_ (Nette\Application\Application), _(*11)

public function onRequest(Application $application, Request $request) {}