Las traducciones en Plugins

FacturaScripts almacena las traducciones en archivos json en la carpeta Translation del plugin, de esta forma cada plugin puede contener sus propias traducciones.

¿Cómo puedo traducir un texto?

Nuestro traductor se basa en el concepto clave-valor, es decir, no ponemos textos completos sino que usamos cadenas separadas por guiones (generalmente en inglés) que tengan una traducción en los archivos de traducciones. Por ejemplo, para mostrar el texto aceptar, realmente llamamos a traducir 'accept'.

echo $this->toolBox()->i18n()->trans('accept');

Esto funciona porque en los archivos de traducción ya tenemos la cadena accept y su traducción correspondiente:

• Archivo es_ES.json de traducciones al español de España.
• Archivo ca_ES.json de traducciones al catalán.

Traducciones variables

En ocasiones queremos traducir textos incluyendo partes variables, por ejemplo para informar de que falta el plan contable para el ejercicio 2023. Para estos casos pasamos esos valores al traductor en un array como segundo parámetro, y en la traducción reemplazan a las variables correspondientes, que son las que van entre %. Se ve más fácil con un ejemplo:

echo $this->toolBox()->i18n()->trans('accounting-data-missing', ['%exerciseName%' => '2023']);

Esta cadena usará estra traducción, sustituyendo %exerciseName% por el valor asignado.

"accounting-data-missing": "Pla comptable no trobat per a l'exercici %exerciseName%",

¿Puedo usar traducciones existentes?

Si, simplemente ve al listado de traducciones en español y busca la que más se te adapte.

¿Puedo compartir mis traducciones para que me ayuden a traducir?

Si, si publicas tu plugin en la forja (sección mis plugins), en la página del plugin podrás añadir tus traducciones para que el resto de usuarios de la web pueda traducirlas. Después puedes utilizar el script incluido para descargar las traducciones actualizadas.