symfony: llamando funciones i18n desde las actions

Traducción del original en catalán. Léela en: CatalàEnglish

Una herramienta muy potente de symfony es la de internacionalización (i18n), concretamente la función __() se convierte en una de las más usadas e indispensables en la capa de vista de nuestras aplicaciones. Ya que permite después de forma muy sencilla traducir nuestra aplicación al idioma que sea. El problema es cuando desde la parte del modelo tenemos que cargar información a objetos que después serán directamente mostrados por la vista. Si queremos que esta información sea fácilmente traducible aunque se encuentre en el modelo y no en la capa de vista la cosa se complica un poquito. De hecho, hasta hoy no sabía cómo se hacía y lo he descubierto gracias a un snippet publicado en la web de symfony.

Concretamente symfony trata la función __() como lo que él llama un helper que nos permiten dinamizar y dar muchísima potencia a nuestras templates. Si no sabéis lo que son los helpers os recomiendo que repaséis la documentación de symfony concretamente el View chapter. De hecho, symfony tiene muchos tipos de helpers: url, javascript, form, i18n, etc. incluso podemos programar nuestros propios helpers.

Así que lo que comentaré será cómo usar los helpers de tipo i18n desde el modelo, pero el resto de helpers también se pueden invocar de la misma manera.

Primero hay que pensar en incluir desde el modelo el código donde se declaran las funciones del helper:

include_once('symfony/helper/I18NHelper.php');

Para invocar la función __(), tenemos que hacer:

sfConfig::get('sf_i18n_instance')->__($text, $args, 'messages');

Lo que no sé es si las herramientas de traducción que se dedican a extraer los mensajes de las funciones __() son capaces de recorrer también los ficheros de acciones definidos en el modelo o solo pasan por las templates. Aunque no debe ser muy difícil decirles que también miren los ficheros del modelo.

Aprovechando que hablo del tema de la internacionalización os recomiendo una herramienta para traducir los ficheros de idioma (XLIFF) es una herramienta multiplataforma programada en java: open language tools XLIFF editor. Como podéis ver el aspecto y la simplicidad es inmejorable. Ideal para personas no técnicas que nos pueden hacer las traducciones de las aplicaciones.

open-language-tools.png
Open Language Tools

+ zoom

Para generar los ficheros XLIFF desde symfony os recomiendo: HowToGenerateI18NFiles. Es un pequeño manual que he encontrado en el wiki de symfony.