PHPackages                             tonop/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. tonop/translatte

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

tonop/translatte
================

Translator for Nette framework

028PHP

Since Feb 17Pushed 1y agoCompare

[ Source](https://github.com/tonop01/translatte)[ Packagist](https://packagist.org/packages/tonop/translatte)[ RSS](/packages/tonop-translatte/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)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)

```

### 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

17

—

LowBetter than 6% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity16

Early-stage or recently created project

 Bus Factor2

2 contributors hold 50%+ of commits

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/f432dd38490310c638ab0b4970475a94710d13dd1c4531c2abbaa3353bac1847?d=identicon)[tonop01](/maintainers/tonop01)

---

Top Contributors

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

### Embed Badge

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

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

###  Alternatives

[symfony/translation

Provides tools to internationalize your application

6.6k836.5M2.1k](/packages/symfony-translation)[nesbot/carbon

An API extension for DateTime that supports 281 different languages.

169661.4M4.8k](/packages/nesbot-carbon)[joedixon/laravel-translation

A tool for managing all of your Laravel translations

717911.4k11](/packages/joedixon-laravel-translation)[illuminate/translation

The Illuminate Translation package.

6936.4M495](/packages/illuminate-translation)[lajax/yii2-translate-manager

Translation management extension for Yii 2

227578.8k13](/packages/lajax-yii2-translate-manager)[larswiegers/laravel-translations-checker

Make sure your laravel translations are checked and are included in all languages.

256423.2k2](/packages/larswiegers-laravel-translations-checker)

PHPackages © 2026

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