Cómo importar contenido multilingüe a WordPress: WooCommerce, CSV y XML

Exportación e importación de WPML funciona junto con el plugin de importación de WordPress que ya utilice. El plugin de importación mueve sus datos. Exportación e importación de WPML añade la información de idioma al final para que cada fila acabe en el idioma correcto y cada traducción se enlace a su origen.

Antes de empezar

Instale y active estos plugins en el sitio al que va a importar:

Un plugin de importación: WP All Import Pro, WP All Export Pro, el importador de CSV nativo de WooCommerce o el importador estándar de WordPress.
WPML y WPML Traducción de cadenas.
Exportación e importación de WPML (el complemento que trata esta página).
WPML Multilingual & Multicurrency for WooCommerce si va a importar productos de WooCommerce.

En el sitio de importación, configure WPML con cada idioma que tenga previsto importar. Los idiomas de destino ya deben existir en WPML > Configuración > Idiomas antes de que ejecute la importación.

Dos caminos: elija el que coincida con su origen

Existen dos caminos de importación, dependiendo de dónde provengan los datos multilingües:

Plugin de importación compatible. Si está extrayendo contenido de un sitio de WordPress existente con WP All Export Pro (u otra herramienta de exportación compatible), Exportación e importación de WPML ya está en el archivo de exportación; la información de idioma se incluye automáticamente. Pase al paso Ejecutar la importación de WPML a continuación.
CSV o XML personalizado. Si mantiene datos multilingües en una hoja de cálculo o su origen es un sistema ajeno a WordPress (PIM, MLS, ERP, plataforma de reservas), deberá añadir tres columnas de idioma a su archivo manualmente. Continúe con Prepare su CSV o XML a continuación.

Prepare su CSV o XML con tres columnas de idioma

Para importaciones personalizadas, añada tres columnas a cada fila de su hoja de cálculo. Así es como WPML empareja las traducciones y etiqueta cada fila con el idioma correcto:

_wpml_import_translation_group. Un valor único compartido por todas las versiones de idioma de un mismo contenido. Para los productos, utilice el SKU. Para todo lo demás, genere su propio ID y reutilícelo para la fila de origen y cada una de sus traducciones.
_wpml_import_language_code. El código de idioma ISO para la fila (en para inglés, es para español, fr para francés, pt-pt para portugués europeo, etc.).
_wpml_import_source_language_code. Solo en las filas de traducción; el código de idioma del original. Déjelo en blanco para las filas del idioma de origen.

Para WP All Import Pro y herramientas similares, prepare dos hojas de cálculo: una para taxonomías (categorías, etiquetas, categorías de productos) y otra para entradas y productos. El importador de CSV nativo de WooCommerce utiliza una sola hoja de cálculo porque las categorías de productos se encuentran dentro de las filas de los productos.

Atributos personalizados de WooCommerce para productos variables

Si tiene productos variables con atributos personalizados, añada una cuarta columna a las filas de productos traducidos: _wpml_import_wc_local_attribute_labels. El valor es un objeto JSON de pares slug:translation. Para un producto variable en francés con los atributos Size y Color:

{"size":"Taille","color":"Couleur"}

El slug es el nombre del atributo en minúsculas y con los espacios sustituidos por guiones.

Orden de importación

Importe siempre las taxonomías primero cuando tenga un archivo separado para ellas. Las categorías, etiquetas y cualquier otra taxonomía deben existir antes de que las entradas y los productos puedan hacer referencia a ellas. A continuación, importe entradas, páginas, productos y otros tipos de contenido.

Si divide sus datos en un archivo por idioma, importe todos los archivos de idioma antes de ejecutar el paso de conexión de WPML.

Asignar las columnas de idioma en su plugin de importación

Cada plugin de importación gestiona las columnas personalizadas a su manera. El paso crítico es asignar las tres columnas de WPML a campos personalizados (o metadatos de términos, para taxonomías). En WP All Import Pro, esto se hace en el Paso 3 del asistente de importación:

Para entradas y productos. Abra Campos personalizados, añada tres campos, arrastre las columnas de idioma a las casillas Value y utilice los nombres de las columnas sin corchetes en las casillas Name.
Para taxonomías. Abra Metadatos de términos, añada tres campos de metadatos de términos y asigne las columnas de idioma de la misma manera.

Si las columnas no están asignadas, WPML no tendrá nada que leer cuando ejecute el paso de conexión.

Qué verá entre la importación y el paso de conexión

Hasta que ejecute Exportación e importación de WPML, todo el contenido importado se ubicará en su idioma predeterminado y WPML mantendrá automáticamente las entradas y los productos en estado Borrador para evitar que haya contenido en varios idiomas en el front-end. Este es el estado intermedio esperado, no una señal de que la importación haya fallado.

Para los plugins de importación no compatibles, deberá publicar las entradas manualmente una vez finalizado el paso de conexión.

Ejecutar la importación de WPML

Una vez que el plugin de importación haya terminado:

Abra WPML > Exportación e importación en el panel de administración de WordPress.
Haga clic en Ejecutar la importación de WPML.

WPML lee las columnas de idioma de cada fila, asigna el idioma a esa fila y enlaza las traducciones a su origen. En catálogos grandes, esto puede tardar varios minutos. Cuando haya terminado, su contenido importado se publicará en el idioma correcto con cada traducción conectada a su origen.

Haga una comprobación rápida en el panel de administración y en el front-end:

Abra la lista de tipos de contenido o productos: confirme que cada fila se muestra bajo la bandera de idioma correcta.
Visite el front-end y cambie de idioma: cada página traducida debería cargar su versión traducida, no recurrir al original.

Si la traducción de una taxonomía no se ha enlazado, abra el término en el panel de administración de WordPress y utilice la caja Idiomas del término para conectarlo al término del idioma predeterminado.

Automatícelo: ejecute la importación de WPML después de cada importación programada

Para sincronizaciones nocturnas, feeds de proveedores o cualquier importación programada, el paso de conexión de WPML puede ejecutarse automáticamente justo después de que termine el plugin de importación. Hay dos formas de conectarlo:

Opción 1: Endpoint de URL (para importaciones basadas en cron como las acciones programadas de WP All Import)

Añada una clave secreta segura a wp-config.php:

define( 'WPML_IMPORT_KEY', 'your-strong-secret-key-here' );

A continuación, añada una segunda URL de cron a su configuración de importación programada:

https://yoursite.com/?wpml_import_trigger=your-strong-secret-key-here

Para la programación manual de WP All Import Pro, añada la URL como un segundo comando wget justo después de la URL de importación.

Opción 2: Hook de acción (para importaciones programadas en PHP)

Si está programando importaciones desde PHP con Action Scheduler o wp_schedule_single_event, active el paso de WPML con una llamada de acción:

do_action( 'wpml_import_process' );

Para ejecutarlo como una tarea en segundo plano puntual justo después de su acción de importación:

wp_schedule_single_event( time(), 'wpml_import_process' );

Si algo falla en cualquiera de los caminos, active WP_DEBUG_LOG en wp-config.php para capturar el error en el registro de errores de PHP.

Ejecutar la importación de WPML desde la línea de comandos

Para scripts de despliegue, construcciones de contenedores o cualquier flujo de trabajo donde la interfaz de administración no esté disponible, ejecute el paso de conexión desde WP-CLI:

wp wpml import process

El comando informa cuántas traducciones se han conectado. Es un reemplazo directo del botón Ejecutar la importación de WPML.

Errores comunes

Faltan las tres columnas de idioma en el archivo de importación. El contenido se importa, pero queda como filas del idioma de origen sin etiquetar; Ejecutar la importación de WPML no tiene nada que conectar. Solución: añada las columnas a sus datos de origen, vuelva a exportar y vuelva a importar.
Se omitió la asignación de Campos personalizados / Metadatos de términos de WP All Import. El mismo problema que si faltaran las columnas. Los datos están en el archivo, pero el plugin de importación no los guardó en la entrada. Vuelva a ejecutar la importación con los campos asignados.
Los idiomas de destino no están configurados en el sitio de importación. Las filas importadas para un idioma no configurado acaban en el idioma predeterminado. Añada primero los idiomas que falten en WPML > Configuración > Idiomas y luego vuelva a ejecutar.
Plugin de importación no compatible. Las entradas importadas permanecen en Borrador después del paso de conexión. Publíquelas manualmente o cambie a un plugin compatible.
Scripts de importación personalizados que no transmiten los datos de idioma. La solución está a nivel del script. Las tres columnas de idioma (y la columna de atributos de WooCommerce cuando proceda) deben llegar a la fila.

Si las importaciones siguen tropezando con el mismo problema, el equipo de soporte de WPML responde a las consultas de importación las 24 horas del día, los 7 días de la semana.

Si buscaba el plugin WPML All Import

WPML All Import es el plugin heredado anterior a Exportación e importación de WPML. Ya no es compatible ni se recomienda. El procedimiento anterior es la forma actualizada de importar contenido multilingüe a un sitio de WordPress: utilícelo en lugar de cualquier flujo de trabajo descrito en la documentación del antiguo plugin.