Convención traducciones en symfony2

gistfile1.txt

Convenciones sobre traducciones en symfony2.

Se utilizarán claves para crear mensajes traducibles, no se admitirán frases.
Las claves deben escribirse en ingles y utilizando notación underscore.

Para proyectos se utilizará el dominio por defecto (messages y validators).
En bundles reutilizabes se utilizará el underscore del bundle en cuestión.
Por ejemplo para WebFactoryUserBundle utilizamos web_factory_user.

Se utilizará el formato yml dada su estructura de facil lectura y organización.

Ejemplos:

En templates:

{{ 'web_factory_user.form.username.label'|trans }}
{{ 'web_factory_user.form.username.help'|trans }}
{{ 'web_factory_user.flash.edit_success'|trans }}
{{ 'web_factory_user.message.locked_user'|trans }}

{{ 'web_factory_user.roles.ROLE_ADMIN.name'|trans }}
{{ 'web_factory_user.roles.ROLE_ADMIN.description'|trans }}

Para validaciones (en entidades con anotaciones por ejemplo)

/**
 * @Assert\Length(
 * ...
 * min_message="web_factory_user.validation.plain_password.lenght.min"
 * ...
 * )
 */

Para definirlas, si estamos usando un bundle como WebFactoryUserBundle,
archivo: web_factory_user.es.yml

web_factory_user:
    form:
        username:
            label: Nombre de usuario
            help: El identificador que se usará para autenticar al usuario
    flash:
        edit_success: La actualización del usuario ha sido completada exitosamente
    message:
        locked_user: Tu usuario está bloqueado y no puede ingresar al sistema
    roles:
        ROLE_ADMIN:
            name: Administrador
            description: Encargado de gestionar todo el sitio

Las validaciones van en un archivo separado (utilizaremos el dominio por defecto en este caso) validators.es.yml

web_factory_user:
    validation:
        plain_password:
            length:
                min: La contraseña debe tener al menos {{ limit }} caracteres