Cómo construir una migración multilingüe de Shopify a WordPress

Ha pasado meses construyendo una tienda Shopify multilingüe. Las descripciones de sus productos están traducidas al francés, alemán y español. Su flujo de pago funciona en tres idiomas. Entonces, decide migrar a WordPress y WooCommerce para tener más control, mejores márgenes o flexibilidad de plugins.

Los datos del producto se transfieren bien. Las imágenes llegan. ¿Pero sus traducciones? Desaparecen.

Este es el costo oculto de una migración multilingüe de WordPress del que nadie le advierte. Shopify bloquea sus traducciones en su propio sistema propietario, y WordPress utiliza una arquitectura completamente diferente. Sin un plan claro, pasará semanas reconstruyendo lo que ya tenía. Esta guía le proporciona ese plan.

Por qué fallan las migraciones multilingües (y Shopify lo empeora)

Las migraciones de plataforma ya son bastante dolorosas con las tiendas monolingües. Agregue varios idiomas y la complejidad se multiplica. La causa principal es arquitectónica: Shopify y WordPress manejan las traducciones de maneras fundamentalmente diferentes.

El modelo de traducción de Shopify es un jardín amurallado

Shopify almacena las traducciones como metadatos adjuntos a los recursos a través de la API Translate and Adapt. Cada producto, colección y página tiene entradas de traducción vinculadas a los ID de recursos internos de Shopify.

Cuando exporta su tienda utilizando una herramienta de migración como Cart2Cart, LitExtension o una exportación CSV, obtiene el contenido del idioma predeterminado. ¿Las traducciones? Viven en una capa separada que la mayoría de las herramientas de migración ignoran por completo.

Qué se exporta realmente (y qué se pierde)

Esto es lo que transfiere una herramienta típica de migración de Shopify a WordPress:

El patrón es claro. El contenido de su idioma predeterminado migra. Sus traducciones no. E incluso si las extrae manualmente, no puede simplemente pegar las traducciones de Shopify en WordPress. Los sistemas hablan diferentes idiomas, literalmente.

Mapeo de idiomas de Shopify a archivos de traducción de WordPress

Antes de comenzar a reconstruir, debe comprender cómo WordPress maneja el contenido multilingüe. Aquí es donde la mayoría de las guías de migración se quedan cortas.

Comprensión del sistema Gettext

WordPress utiliza el sistema de localización Gettext. En lugar de almacenar las traducciones en una capa de base de datos, las lee de archivos binarios estáticos (archivos .mo) compilados a partir de archivos .po legibles por humanos.

Un archivo .po se ve así:

msgid "Add to Cart"
msgstr "Ajouter au panier"

msgid "Search results for %s"
msgstr "Résultats de recherche pour %s"

Cada tema y plugin de WordPress se envía con un archivo de plantilla .pot que contiene todas las cadenas traducibles. Crea un archivo .po para cada idioma, completa las traducciones, lo compila a .mo y lo coloca en el directorio correcto.

Este es el sistema en el que deben asignarse sus traducciones de Shopify.

El problema de la falta de coincidencia del código de idioma

Shopify utiliza etiquetas de idioma IETF (en, fr, de). WordPress utiliza códigos de configuración regional con variantes de región (fr_FR, de_DE, es_ES). Durante la migración, debe asignar cada idioma de Shopify a la configuración regional correcta de WordPress. Equivocarse en esto significa que WordPress no puede encontrar sus archivos de traducción.

Mapeos comunes que hacen tropezar a la gente:

• Shopify pt se asigna a WordPress pt_PT (Portugal) o pt_BR (Brasil) -- no intercambiables
• Shopify zh-CN se asigna a WordPress zh_CN, pero Shopify zh-TW se asigna a zh_TW
• Shopify nb (Noruego Bokmal) se asigna a WordPress nb_NO

Nombre sus archivos .po y .mo con el código de configuración regional de WordPress: themename-fr_FR.po, woocommerce-de_DE.mo. Un código incorrecto significa que WordPress ignora el archivo silenciosamente.

Un flujo de trabajo paso a paso para la migración multilingüe de WordPress

Aquí está el flujo de trabajo concreto para preservar sus traducciones durante una migración de Shopify a WordPress.

Paso 1: Exporte y audite sus traducciones de Shopify

Antes de tocar WordPress, extraiga todo de Shopify. Utilice la API de administración de Shopify o una herramienta como Shopify Translate CSV Export para extraer sus traducciones en archivos estructurados.

# Using Shopify CLI to export translations
shopify app translate export --locale fr
shopify app translate export --locale de
shopify app translate export --locale es

Audite las exportaciones. Cuente cuántas cadenas tiene por idioma. Identifique cuáles son las traducciones de contenido del producto (manejadas por su CMS o plugin multilingüe en WordPress) frente a las traducciones de cadenas de tema/UI (manejadas por archivos .po).

Paso 2: Configure su estructura de idioma de WordPress y WooCommerce

En su nueva instalación de WordPress, configure su infraestructura de idioma antes de importar cualquier contenido.

1. Vaya a Ajustes > General y configure el idioma de su sitio
2. Instale paquetes de idiomas para cada idioma de destino a través de Ajustes > General > Idioma del sitio
3. Cree la estructura de directorios de traducción:

/wp-content/languages/
/wp-content/languages/plugins/
/wp-content/languages/themes/

Para las traducciones de contenido del producto (títulos, descripciones), necesitará un plugin de contenido multilingüe como WPML o Polylang. Pero para las cadenas de la interfaz de usuario del tema y del plugin (los botones, las etiquetas, los mensajes de error y el flujo de pago), desea archivos estáticos .po/.mo. Este es el enfoque basado en la nube que evita la hinchazón del plugin.

Paso 3: Convierta sus traducciones al formato PO

Sus traducciones de cadenas de temas de Shopify deben convertirse al formato Gettext .po. Aquí es donde la migración se vuelve técnica.

Si sus traducciones de Shopify están en formato JSON o CSV, puede convertirlas a .po utilizando un script o una herramienta. La clave es asignar cada cadena de origen a un par msgid/msgstr:

import csv

with open('shopify_translations_fr.csv', 'r') as infile, \
     open('theme-fr_FR.po', 'w') as outfile:
    outfile.write('msgid ""\nmsgstr ""\n')
    outfile.write('"Language: fr_FR\\n"\n\n')
    reader = csv.DictReader(infile)
    for row in reader:
        outfile.write(f'msgid "{row["key"]}"\n')
        outfile.write(f'msgstr "{row["translation"]}"\n\n')

Esto le da un punto de partida, pero su nuevo tema de WordPress y la instalación de WooCommerce tendrán cientos de cadenas que no existían en Shopify. No puede reutilizar una traducción de Shopify "Añadir al carrito" para WooCommerce porque el contexto del código circundante es diferente. La cadena de WooCommerce podría ser Add to cart (con la "c" en minúscula) o incluir una variable %s para el nombre del producto.

Aquí es donde la mayoría de la gente se atasca. Tiene traducciones parciales de Shopify y una brecha masiva de cadenas específicas de WordPress sin traducir.

Cómo traducir las brechas sin empezar de nuevo

La buena noticia: no necesita traducir 5000 cadenas de WooCommerce a mano. La mala noticia: tampoco puede omitirlas, o su tienda mostrará una mezcla discordante de encabezados en francés y mensajes de error en inglés.

Las cadenas de temas y plugins aún necesitan traducción

Su tema de WordPress tiene su propio archivo .pot. WooCommerce tiene el suyo propio. Cada plugin que instale (pasarelas de pago, calculadoras de envío, creadores de formularios) tiene cadenas traducibles. Estos no existían en su tienda Shopify.

El enfoque más rápido es traducir estos grandes archivos .po en lote en lugar de cadena por cadena. Cargue el archivo .pot de su tema, seleccione el idioma de destino y deje que la IA se encargue del trabajo pesado.

Traducción por lotes de archivos grandes de WooCommerce

El archivo de idioma de WooCommerce es enorme. Con miles de cadenas que cubren todo, desde mensajes de carrito hasta códigos de error de impuestos, es la tarea de traducción más grande en cualquier migración. SimplePoTranslate gestiona esto a través de Smart Batching: dividir archivos de gran tamaño en fragmentos seguros, procesarlos en paralelo y fusionar los resultados de nuevo en un único archivo limpio.

El detalle crítico: sus archivos traducidos deben preservar cada variable de código exactamente como aparece en la fuente. Un marcador de posición %s en una plantilla de correo electrónico de WooCommerce no puede tener un espacio añadido o una posición intercambiada durante la traducción. Aquí es donde el bloqueo de sintaxis evita que las variables rotas lleguen a su tienda de producción.

Con la Salida multiformato de SimplePoTranslate, obtiene archivos .po, .mo, .json, .php y .xliff en una única descarga ZIP. Esto es particularmente útil durante la migración porque diferentes partes de su pila de WordPress pueden consumir traducciones en diferentes formatos. Su tema lee archivos .mo. Una interfaz de front-end sin cabeza podría necesitar .json. Una integración personalizada podría esperar .xliff. Una ejecución de traducción cubre todos ellos.

Evitar los tres errores de traducción de migración más comunes

Incluso con el flujo de trabajo correcto, existen trampas específicas de las migraciones de plataforma que toman por sorpresa a los desarrolladores experimentados.

Variables rotas en correos electrónicos transaccionales

Los correos electrónicos transaccionales de WooCommerce están llenos de marcadores de posición: {order_number}, {customer_name}, %1$s, %2$s. Si su proceso de traducción corrompe incluso uno de estos, los clientes reciben correos electrónicos como "Hola {customer_name}" literalmente, o peor aún, correos electrónicos con datos intercambiados.

Siempre valide sus archivos traducidos con el archivo .pot de origen antes de la implementación. Herramientas como Poedit marcarán las discrepancias de los marcadores de posición, y los traductores basados en la nube con bloqueo de sintaxis eliminan por completo esta clase de error.

Faltan reglas de pluralización

Shopify maneja los plurales de manera simple. WordPress Gettext admite formas plurales complejas que varían según el idioma. El ruso tiene tres formas plurales. El árabe tiene seis. Si su archivo .po traducido no incluye el encabezado Plural-Forms correcto y las entradas msgstr[0], msgstr[1], msgstr[2] correspondientes, WordPress recurre a la cadena sin traducir.

# Correct Russian plural forms header
"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : "
"n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : 2);\n"

msgid "%s item"
msgid_plural "%s items"
msgstr[0] "%s товар"
msgstr[1] "%s товара"
msgstr[2] "%s товаров"

Esto es algo que Shopify nunca le exigió que pensara. En WordPress, importa.

Cadenas huérfanas después de los intercambios de plugins

Cuando migra desde Shopify, no solo está cambiando de plataforma. Está reemplazando todo un ecosistema de plugins. Su pasarela de pago de Shopify se convierte en WooCommerce Payments o Stripe para WooCommerce. Su sistema de revisión se convierte en un plugin de WordPress. Cada intercambio introduce nuevas cadenas traducibles y hace que las traducciones antiguas queden obsoletas.

Cree una lista de verificación de cada plugin que instale después de la migración y verifique que cada uno tenga un archivo .mo traducido correspondiente en /wp-content/languages/plugins/. La falta incluso de un plugin significa que sus clientes ven cadenas en inglés en medio de una interfaz traducida.

Lance su tienda multilingüe en WordPress

Una migración multilingüe de WordPress no es solo una transferencia de datos. Es una re-arquitectura de cómo su tienda se comunica con los clientes internacionales. Las tiendas que hacen esto bien ven tasas de conversión más altas en los mercados que no son de habla inglesa porque la experiencia se siente nativa en lugar de estar parcheada.

El flujo de trabajo es sencillo: exporte sus traducciones de Shopify, asígnelas a los códigos de configuración regional de WordPress, convierta al formato .po, complete las brechas con la traducción de IA por lotes, valide sus variables e implemente archivos .mo estáticos. Sin hinchazón de la base de datos. Sin sobrecarga de traducción en tiempo de ejecución. Simplemente comercio multilingüe rápido y fiable.

Si se enfrenta a una migración con miles de cadenas de WooCommerce sin traducir, el enfoque de SimplePoTranslate para la localización de archivos grandes puede ahorrarle semanas de trabajo manual.

¿Listo para traducir su tienda WooCommerce después de la migración? Pruebe SimplePoTranslate gratis -- no se requiere tarjeta de crédito. Suba su archivo .pot y obtenga traducciones listas para producción en minutos.