Translation System

use FacturaScripts\Core\Tools;

// Get translator with default language
$i18n = Tools::lang();

// Get translator for specific language
use FacturaScripts\Core\Translator;
$i18n = new Translator('es_ES');

// Translate a string
$text = $i18n->trans('accept');
// Returns: "Aceptar" (in Spanish)

$text = $i18n->trans('cancel');
// Returns: "Cancelar" (in Spanish)

// If translation not found, returns the key
$text = $i18n->trans('non-existent-key');
// Returns: "non-existent-key"

// Translation with single parameter
$text = $i18n->trans('account-bad-parent', ['%codcuenta%' => '999']);
// Returns: "La cuenta 999 tiene asociada una cuenta padre equivocada."

// Translation with multiple parameters
$text = $i18n->trans('user-greeting', [
    '%name%' => 'John',
    '%role%' => 'Administrator'
]);

Core/Translation/
├── es_ES.json    # Spanish (Spain)
├── en_EN.json    # English
├── fr_FR.json    # French
├── de_DE.json    # German
├── it_IT.json    # Italian
├── pt_PT.json    # Portuguese
└── ...

Plugins/MyPlugin/Translation/
├── es_ES.json
└── en_EN.json

{
  "accept": "Accept",
  "cancel": "Cancel",
  "save": "Save",
  "delete": "Delete",
  "account-bad-parent": "The account %codcuenta% has an incorrect parent account.",
  "user-greeting": "Hello %name%, you are logged in as %role%."
}

{
  "accept": "Aceptar",
  "cancel": "Cancelar",
  "save": "Guardar",
  "delete": "Eliminar",
  "account-bad-parent": "La cuenta %codcuenta% tiene asociada una cuenta padre equivocada.",
  "user-greeting": "Hola %name%, has iniciado sesión como %role%."
}

$languages = $i18n->getAvailableLanguages();
// Returns: ['es_ES' => 'Español', 'en_EN' => 'English', ...]

foreach ($languages as $code => $name) {
    echo "<option value='{$code}'>{$name}</option>";
}

Plugins/MyPlugin/
├── Translation/
│   ├── es_ES.json
│   └── en_EN.json
└── ...

{
  "my-plugin-setting": "Configuración de mi plugin",
  "my-plugin-enabled": "Plugin activado",
  "my-plugin-welcome": "Bienvenido al plugin %name%"
}

{
  "my-plugin-setting": "My plugin setting",
  "my-plugin-enabled": "Plugin enabled",
  "my-plugin-welcome": "Welcome to %name% plugin"
}

// In your plugin controller or model
$text = $this->toolBox()->i18n()->trans('my-plugin-setting');

// With parameters
$text = $this->toolBox()->i18n()->trans('my-plugin-welcome', [
    '%name%' => 'MyPlugin'
]);

use FacturaScripts\Core\Translator;

// Deploy all translations
Translator::deploy();

// Get translation in Spanish regardless of current language
$text = $i18n->customTrans('es_ES', 'welcome-message');

// With parameters
$text = $i18n->customTrans('es_ES', 'user-greeting', [
    '%name%' => 'John'
]);

// Create translator with Spanish
$i18n = new Translator('es_ES');
echo $i18n->trans('accept'); // "Aceptar"

// Switch to English
$i18n->setLang('en_EN');
echo $i18n->trans('accept'); // "Accept"

// Check current language
$current = $i18n->getLang(); // "en_EN"

define('FS_LANG', 'es_ES');

Translator::setDefaultLang('en_EN');

$i18n = new Translator('es_ES');

// Request translations
$i18n->trans('existing-key');
$i18n->trans('missing-key');
$i18n->trans('another-missing-key');

// Get list of missing translations
$missing = $i18n->getMissingStrings();
// Returns: ['missing-key@es_ES' => 'missing-key', 'another-missing-key@es_ES' => 'another-missing-key']

// Get all used translations
$used = $i18n->getUsedStrings();

use FacturaScripts\Core\Base\Controller;

class MyController extends Controller
{
    public function privateCore(&$response, $user, $permissions)
    {
        parent::privateCore($response, $user, $permissions);
        
        // Get translator
        $i18n = $this->toolBox()->i18n();
        
        // Use translations
        $this->title = $i18n->trans('my-page-title');
        $this->addMessage($i18n->trans('operation-successful'));
    }
}

use FacturaScripts\Core\Model\Base\ModelClass;
use FacturaScripts\Core\Tools;

class MyModel extends ModelClass
{
    public function test(): bool
    {
        $i18n = Tools::lang();
        
        if (empty($this->name)) {
            Tools::log()->error($i18n->trans('name-required'));
            return false;
        }
        
        return parent::test();
    }
}

{# Simple translation #}
<h1>{{ i18n.trans('welcome') }}</h1>

{# With parameters #}
<p>{{ i18n.trans('user-greeting', {'%name%': user.nombre}) }}</p>

{# In attributes #}
<button title="{{ i18n.trans('save-and-continue') }}">
    {{ i18n.trans('save') }}
</button>