--- title: Archivos .xlf — traducciones XLIFF en modulos section: i18n slug: xlf-files description: "Como crear, organizar y usar archivos XLIFF (.xlf) para traducciones en modulos PrestaShop 8/9: estructura, extraccion con CLI, importacion en el BO y herramienta de traduccion." keywords: prestashop xlf xliff traducciones modulo archivo PS8 PS9 extraccion CLI crowdin last_updated: 2024-12-01 source_url: "https://ayudaprestashop.es/i18n/xlf-files" --- # Archivos .xlf — traducciones XLIFF en modulos > Como crear, organizar y usar archivos XLIFF (.xlf) para traducciones en modulos PrestaShop 8/9: estructura, extraccion con CLI, importacion en el BO y herramienta de traduccion. El sistema moderno de traducciones de PrestaShop 8+ usa el formato **XLIFF 1.2** (.xlf). Cada modulo guarda sus traducciones en `modules/mymodule/translations/` con archivos nombrados por locale (es-ES, en-US, fr-FR...). ## Estructura del directorio de traducciones *Estructura de archivos de traduccion de un modulo* ```bash modules/mymodule/ ├── translations/ │ ├── es-ES.xlf # Español (España) — todos los dominios │ ├── en-US.xlf # Ingles (EEUU) │ ├── fr-FR.xlf # Frances │ ├── de-DE.xlf # Aleman │ └── index.php # Seguridad:

Save configuration Guardar configuracion

API Key Clave API

Settings saved successfully. Configuracion guardada correctamente.

Customer Reviews Opiniones de Clientes

``` ## Extraer cadenas con bin/console *Extraer cadenas trans() a archivos .xlf con Symfony CLI* ```bash # Extraer cadenas de traduccion del modulo # (genera los archivos .xlf en translations/) php bin/console prestashop:translation:extract mymodule # Especificar locale php bin/console prestashop:translation:extract mymodule --locale=es-ES # Solo un dominio especifico php bin/console prestashop:translation:extract mymodule --domain=Modules.Mymodule.Admin # Ver cadenas sin traducir php bin/console prestashop:translation:extract mymodule --untranslated-only # Limpiar cache de traducciones despues de editar archivos php bin/console cache:clear ``` ## Traducir desde el Back Office Las traducciones de modulos tambien se pueden gestionar desde el BO sin tocar archivos .xlf: | Paso | Accion | | --- | --- | | 1 | BO > Internacional > Traducciones | | 2 | Tipo de traduccion: 'Traducciones de modulos instalados' | | 3 | Seleccionar el modulo y el idioma | | 4 | Editar las cadenas en la interfaz visual | | 5 | Guardar — PS escribe los archivos .xlf automaticamente | ## Fallback al idioma por defecto *Comportamiento del fallback cuando falta traduccion* ```php trans('Save configuration', [], 'Modules.Mymodule.Admin'); // Resultado: 'Save configuration' (cadena fuente en ingles) // Para garantizar el fallback a espanol: // 1. Incluir siempre el archivo es-ES.xlf con todas las cadenas // 2. O configurar el idioma por defecto del sitio en espanol // Verificar si el modulo usa el nuevo sistema: if ($this->isUsingNewTranslationSystem()) { // El modulo tiene translations/*.xlf — usar trans() return $this->trans('Mi texto', [], 'Modules.Mymodule.Admin'); } else { // Modulo legacy sin .xlf — usar l() return $this->l('Mi texto'); } ``` > **[TIP] Activar el nuevo sistema de traducciones** > > Para que PrestaShop detecte el sistema moderno, el modulo debe devolver `true` en `isUsingNewTranslationSystem()` (disponible en PS 1.7.6+). Esto se activa automaticamente si existe el directorio `translations/` con archivos .xlf. --- *Fuente: [https://ayudaprestashop.es/i18n/xlf-files](https://ayudaprestashop.es/i18n/xlf-files). Version Markdown generada automaticamente para consumo por LLMs.*