🌍 Funcion trans() — traducciones en PS 8/9

<?php

// Forma basica
$text = $this->trans('Guardar configuracion', [], 'Modules.Mymodule.Admin');

// Con parametros (interpolacion)
$text = $this->trans(
    'Hay %count% productos en la categoria %name%.',
    ['%count%' => 5, '%name%' => 'Electronica'],
    'Modules.Mymodule.Admin'
);

// Con locale especifico (para emails multilingue)
$text = $this->trans(
    'Tu pedido ha sido confirmado.',
    [],
    'Modules.Mymodule.Shop',
    'fr-FR'  // locale IETF
);

// Deteccion automatica del nuevo sistema
if ($this->isUsingNewTranslationSystem()) {
    $text = $this->trans('Mi texto', [], 'Modules.Mymodule.Admin');
} else {
    $text = $this->l('Mi texto');
}

<?php

// Los parametros usan el formato %nombre%
$text = $this->trans(
    'Bienvenido, %name%! Tienes %count% mensajes nuevos.',
    [
        '%name%'  => $customer->firstname,
        '%count%' => (int) $unreadMessages,
    ],
    'Modules.Mymodule.Shop'
);

// Para el archivo .xlf, la cadena se escribe asi:
// <source>Bienvenido, %name%! Tienes %count% mensajes nuevos.</source>
// <target>Welcome, %name%! You have %count% new messages.</target>

// IMPORTANTE: Los parametros NO se escapan automaticamente.
// Escapa los valores del usuario antes de pasarlos:
$text = $this->trans(
    'Tu busqueda: %query%',
    ['%query%' => htmlspecialchars($userQuery)],
    'Modules.Mymodule.Shop'
);

{# Forma basica #}
{{ 'Save'|trans({}, 'Admin.Actions') }}

{# Con parametros #}
{{ 'Hello %name%'|trans({'%name%': customer.firstname}, 'Modules.Mymodule.Admin') }}

{# Bloque trans para textos largos #}
{% trans into 'Modules.Mymodule.Admin' %}
  Este es un texto largo que sera traducido.
{% endtrans %}

{# Variable de traduccion #}
{% set label = 'Configuration'|trans({}, 'Modules.Mymodule.Admin') %}
<h2>{{ label }}</h2>

{* Sistema legacy - modulos PS 1.7 *}
{l s='Guardar configuracion' mod='mymodule'}

{* Con variables (d=sprintf parameters) *}
{l s='Hola %s, tienes %d mensajes.' sprintf=[$customer.firstname, $count] mod='mymodule'}

{* Para el sistema moderno en Smarty (PS 8 FO) *}
{* Usar $this->trans() en PHP y pasar la string ya traducida a Smarty *}