PHPackages                             zaszczyk/translatable - 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. zaszczyk/translatable

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

zaszczyk/translatable
=====================

Manage translatable fields with Phalcon models. Forked from https://github.com/ovide/translatable

1.0.1(8y ago)05.3kPHP

Since Oct 20Pushed 8y ago1 watchersCompare

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

READMEChangelog (2)Dependencies (2)Versions (3)Used By (0)

translatable
============

[](#translatable)

Manage translatable fields with Phalcon models

Example
-------

[](#example)

You have a database table `MyModel` with columns `id`, `value`, `timestamp` and `description`; but `description` must be a translatable field.

You can add a`Translation` table as

```
CREATE TABLE `translation` (
  `table` varchar(255) NOT NULL,
  `field` varchar(255) NOT NULL,
  `row` varchar(255) NOT NULL,
  `lang` char(2) NOT NULL,
  `text` text NOT NULL,
  PRIMARY KEY (`table`,`field`,`row`,`lang`)
)
```

```
use \Ovide\Lib\Translate as Translate;

/**
 * Your translatable model
 * @property string $description
 */
class MyModel extends Translate\Model
{
    public $id;
    public $value;
    public $timestamp;
    protected $_translatable = ['description'];
}

/**
 * This is a default basic abstract model, but you can add yours
 */
class Translation extends Translate\Adapter\Model\AbstractModel{}

$di = new \Phalcon\DI\FactoryDefault();
$di->setShared('db', function () {
    return new \Phalcon\Db\Adapter\Pdo\Mysql([/* my config */]);
});

/**
 *             HERE WE SET THE TRANSLATOR
 */
$di->setShared('translator', function() {
    $service = new Translate\Service();
    //All translatable models from 'db'
    //will use 'Translation' to manage the translations
    $service->attachAdapter(
        'db',
        Translate\Adapter\Model\Manager::class,
        ['backendModel' => 'Translation']
    );
    //You can use a default language resolver
    Translate\Model::setLanguageResolver(function() use($di){
        //You can put anything here
        if (isset($_COOKIE['lang'])) return $_COOKIE['lang'];
        return 'en';
    });
});
```

Now you can use translatable fiels as normal properties

```
$model = new MyModel();
$model->value = 'foo';
//Will set the text using the default language
$model->description = 'my description';
//You can change the current language
$model->setCurrentLang('es');
$model->description = 'mi descripción';
//Or use setter/getter
$model->setTranslation('description', 'la meva descipció', 'ca');
$model->save();
```

Adapters
--------

[](#adapters)

You can use any addapter to store translations. By now there's a Model (SQL) and Collection (Mongo) adapter. Just implement `TranslationInterface` to create your own.

```
interface TranslationInterface
{
    public static function retrieve(Model $model, $pk, array $options = null);
    public function get($field, $language);
    public function set($field, $language, $value);
    public function persist(array $records = null);
    public function remove();
}
```

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 76.9% 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 ~550 days

Total

2

Last Release

2939d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/22179dc477c563cf77ca4f9dd6600b9d90bf6d24469146eb957b2e8d8e0aeaf2?d=identicon)[MateuszBlaszczyk](/maintainers/MateuszBlaszczyk)

---

Top Contributors

[![Zaszczyk](https://avatars.githubusercontent.com/u/7737337?v=4)](https://github.com/Zaszczyk "Zaszczyk (10 commits)")[![ovide](https://avatars.githubusercontent.com/u/3451025?v=4)](https://github.com/ovide "ovide (3 commits)")

###  Code Quality

TestsCodeception

### Embed Badge

![Health badge](/badges/zaszczyk-translatable/health.svg)

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

###  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.4M494](/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)