PHPackages                             efabrica/translatte - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization & i18n](/categories/localization)
4. /
5. efabrica/translatte

ActiveLibrary[Localization & i18n](/categories/localization)

efabrica/translatte
===================

Translator for Nette framework

1.6.2(7mo ago)874.5k↓32.5%6[1 issues](https://github.com/efabrica-team/translatte/issues)MITPHPPHP >= 7.4

Since Apr 26Pushed 4mo ago3 watchersCompare

[ Source](https://github.com/efabrica-team/translatte)[ Packagist](https://packagist.org/packages/efabrica/translatte)[ RSS](/packages/efabrica-translatte/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependencies (6)Versions (14)Used By (0)

Translatte
==========

[](#translatte)

[![Build Status](https://camo.githubusercontent.com/9fd11f9059367dfa60f2c2edb3d4b1aa76c59fdfab98e83b5f0c932b668cdcbf/68747470733a2f2f7472617669732d63692e6f72672f65666162726963612d7465616d2f7472616e736c617474652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/efabrica-team/translatte)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/3182a3e7ee63e496f11156e4c6be33423a06ab8105dd345ad5415f07a0b8190b/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f65666162726963612d7465616d2f7472616e736c617474652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/efabrica-team/translatte/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/0e9b90ddfe8ea720f2a9d06b82b9ffb41962e229d0cf03abe8120323cbb7c0c4/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f65666162726963612d7465616d2f7472616e736c617474652f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/efabrica-team/translatte/?branch=master)

Translator for Nette framework.

Usage
-----

[](#usage)

```
use Efabrica\Translatte\Translator;
use Efabrica\Translatte\Resource\NeonDirectoryResource;

// Create new translator with default language
$translator = new Translator('sk_SK');

// Register new resources where translations are stored
$translator->addResource(new NeonDirectoryResource([__DIR__ . '/lang', __DIR__ . '/another/lang']));
$translator->addResource(new NeonResource(__DIR__ . '/dictionary.sk_SK.neon', 'sk_SK'));

// Translate basic string
$translator->translate('dictionary.forms.error']);

// Translate with pluralization
$translator->translate('key', 10);

// Translate with parameters
$translator->translate('key', ['name' => 'Peter']);

// Translate with pluralization and parameters
$translator->translate('key', 10, ['page' => 'login']);

// Select translation language on the fly
$translator->translate('key', 1, [], 'en_US');
```

### Nette extension

[](#nette-extension)

```
extensions:
	translation: Efabrica\Translatte\Bridge\Nette\TranslationExtension

# Minimal configuration
translation:
    default: 'sk_SK' # mandatory

# Full configuration
translation:
    default: 'sk_SK' # mandatory
    fallback: # optional
        - 'en_US'
        - 'en_UK'
    dirs:
        - %appDir%/lang
    cache: Efabrica\Translatte\Cache\NullCache() # optional
    resolvers: # optional
        - Efabrica\Translatte\Resolver\StaticResolver('sk_Sk')
    resources: # optional
        - Efabrica\Translatte\Resource\NeonDirectoryResource(%appDir%/localize)
    recordTranslate: # optional
        -  Efabrica\Translatte\Record\NullRecord()

```

### Syntactic sugar

[](#syntactic-sugar)

**dictionary.sk\_SK.neon**:

```
cart:
    products_in_cart: 'V košíku je jeden produkt|V košíku sú %count% produkty|V košíku je %count% produktov'

```

**Source: src/PluralForm.php**

```
Example of count syntax:
sk: '1|2-4|0,5-Inf'
cz: '1|2-4|0,5-Inf'
en: '1|0,2-Inf'

Example of special count syntax (https://symfony.com/doc/3.1/components/translation/usage.html#pluralization):
en: '[-Inf,-10]big negative count|]-10,0[negative count|{0}zero count|{1}one count|{2,3,4}two,three,four count|]4,Inf]more than four count'
sk: '[-Inf,-10]veľký negatívny počet|]-10,0[negatívny počet|{0}nula počet|{1}jedna počet|{2,3,4}dva,tri,štyri počet|]4,Inf]viac ako štyri počet'

```

**index.php**:

```
// Translator setup
$translator = ...

// To params array is set count variable
$translator->translate('dictionary.cart.products_in_cart', 2); // V košíku sú 2 produkty

// Param count from params array is used to select right plural form
$translator->translate('dictionary.cart.products_in_cart', ['count' => 2]); // V košíku sú 2 produkty

// If we set both params nothing is override
$translator->translate('dictionary.cart.products_in_cart', 10, ['count' => 2]); // V košíku je 2 produktov

```

Main classes
------------

[](#main-classes)

### Resolver

[](#resolver)

Resolves which language has translator to use.
Available resolvers:

- **StaticResolver** - Resolves to given static lang.
- **ChainResolver** - Multiple resolvers can be registered to this resolver. First resolver which returns non empty string is used.

### Resource

[](#resource)

Represents "storage" with translation strings. It can be anything - directory with translation files, database, redis or external api call.
Available resources:

- **NeonResource** - One neon file.
- **NeonDirectoryResource** - Multiple directories in which resource search neon files in format "{prefix}.{lang}.neon".

### Cache

[](#cache)

Used for cache generated directory.

###  Health Score

51

—

FairBetter than 95% of packages

Maintenance67

Regular maintenance activity

Popularity38

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 50% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~218 days

Recently: every ~68 days

Total

12

Last Release

226d ago

PHP version history (2 changes)1.0.0PHP >= 7.1

1.6.1PHP >= 7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/72f58e3d494056872274a7cd14323f13cc76e52c966eade5dec3129ea378c182?d=identicon)[kelemen.samuel](/maintainers/kelemen.samuel)

![](https://www.gravatar.com/avatar/25289c62a88df1c404543693ba52e44748dbce486bcfab91fc8c5931a6bb38e1?d=identicon)[dev-efabrica](/maintainers/dev-efabrica)

---

Top Contributors

[![tonop01](https://avatars.githubusercontent.com/u/29866948?v=4)](https://github.com/tonop01 "tonop01 (20 commits)")[![ricco24](https://avatars.githubusercontent.com/u/1409647?v=4)](https://github.com/ricco24 "ricco24 (14 commits)")[![lulco](https://avatars.githubusercontent.com/u/9377319?v=4)](https://github.com/lulco "lulco (5 commits)")[![rasstislav](https://avatars.githubusercontent.com/u/9253113?v=4)](https://github.com/rasstislav "rasstislav (1 commits)")

---

Tags

nette-frameworktranslatornettetranslator

### Embed Badge

![Health badge](/badges/efabrica-translatte/health.svg)

```
[![Health](https://phpackages.com/badges/efabrica-translatte/health.svg)](https://phpackages.com/packages/efabrica-translatte)
```

###  Alternatives

[contributte/translation

Symfony/Translation integration for Nette Framework.

781.9M60](/packages/contributte-translation)[kdyby/translation

Integration of Symfony/Translation into Nette Framework

921.2M24](/packages/kdyby-translation)[nette/code-checker

✅ Nette CodeChecker: A simple tool to check source code against a set of Nette coding standards.

911.7M6](/packages/nette-code-checker)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)