Vender en varios idiomas

Tu catálogo traducido, con la IA haciendo el trabajo pesado y tú revisando.

Está en Panel → Idiomas.

El idioma base

El primero que añades es el idioma base: aquel en el que ya está escrito tu catálogo. No se traduce — se traduce contra él. Por eso no se puede quitar.

Todos los demás son traducciones suyas.

Añadir un idioma

El desplegable trae los idiomas que el motor conoce. Si el tuyo no está, escribe su código a mano: funcionan igual.

Catalán	ca-ES
Euskera	eu-ES
Gallego	gl-ES

Esos tres no salen en la lista del motor, y para una tienda en Terrassa o en Bilbao no son un detalle.

Traducir

Cada idioma muestra cuánto lleva traducido de cada cosa: productos, categorías, variantes, opciones y etiquetas. La pregunta que contesta la pantalla es qué te falta, no qué has hecho ya.

El botón traduce de 25 en 25. No hay ningún «traducir la tienda entera» a propósito: cada tanda son llamadas a un modelo de pago, y quien decide si sigue eres tú, viendo lo que ha salido y lo que ha costado.

Usa la IA que tengas configurada en Panel → IA, con tu clave y contra tu tope de gasto diario.

Lo que no toca

Lo ya traducido se queda como está. Puede haberlo corregido una persona, y pisarlo sería tirar el único trabajo revisado que hay.

Traduce, no reescribe. Se traduce el texto que ya aprobaste. Si cada idioma se generara de cero, cada versión diría cosas distintas y solo estaría revisada la original.

Revisa también las afirmaciones prohibidas. Un modelo puede colar en inglés lo que en español no coló, y de lo que dice la ficha responde quien la publica. Lo que huela a promesa de salud o de garantía sale marcado en el informe.

Cómo lo pide la tienda

Un escaparate pide el idioma de dos maneras, y la primera manda:

curl "https://tu-tienda/store/products?locale=en-US" \
  -H 'x-publishable-api-key: pk_...'

o con la cabecera Accept-Language: en-US, que es la que manda el navegador solo. ?locale= gana si van las dos.

Vale para cualquier ruta de la tienda, no solo productos. Y traduce la ficha entera: un producto trae dentro sus variantes y sus categorías, y media ficha traducida se ve peor que ninguna.

Lo que no esté traducido vuelve en el idioma original. Es preferible una ficha en español dentro de una web en inglés que una ficha vacía.

Encenderlo en el escaparate

Traducir el catálogo no basta: el tema tiene que saber pedirlo. En el tema que viene de serie se hace con una variable:

THEME_LOCALES=es,en

Sin ella el escaparate no cambia en nada. Ni prefijo, ni selector, ni hreflang: exactamente las mismas URLs de antes. Es a propósito — una tienda que ya está vendiendo no puede amanecer con una versión en inglés de un catálogo que todavía no está traducido.

Cómo quedan las URLs

Idioma	URL
El principal	/tienda, /producto/lo-que-sea
Los demás	/en/tienda, /en/producto/lo-que-sea

El idioma principal NO lleva prefijo, y esto importa más de lo que parece: tus URLs actuales están indexadas en Google, enlazadas desde fuera y pegadas en mensajes. Mandarlas todas a /es/… cuesta el posicionamiento entero a cambio de nada. Si alguien entra por /es/tienda, se le redirige a /tienda para que la misma página no exista en dos direcciones.

El cambio de idioma lleva a la misma página en el otro idioma, no a la portada. Quien está mirando una ficha no quiere perderla por cambiar de idioma.

Lo que traduce el tema y lo que traduce la tienda

• La tienda traduce el catálogo: nombres de producto, descripciones, categorías, variantes. Llega ya traducido y es igual para todos los temas.
• El tema traduce su interfaz: botones, avisos, el checkout, el aviso de edad y sus páginas de texto (aviso legal, preguntas frecuentes, «sobre nosotros»).

Las reseñas no se traducen, y no es un olvido: una reseña es lo que dijo una persona, y reescribirla en otro idioma es inventarse una cita y firmarla con su nombre.

Si añades un idioma al panel que el tema no sabe escribir, el catálogo saldrá traducido y los botones en el idioma principal. Para que el tema lo hable hay que traducirlo — está todo en un fichero (src/lib/i18n.ts) y si falta una frase no compila, así que no se puede publicar a medias.

Quitar un idioma

Deja de venderse, pero sus traducciones se conservan. Es una decisión reversible, y tirar el trabajo por si acaso convertiría un clic en horas de volver a pagar a la IA.

Detalles que conviene saber

• Las traducciones viven aparte del producto. Cada una es su propia fila. El catálogo no se toca, así que puedes añadir un idioma, mirarlo con calma y quitarlo sin ningún riesgo para lo que estás vendiendo.
• Si algo falla al traducir, la tienda sigue. El visitante ve el idioma original, que es exactamente lo que vería sin nada de esto.
• Los precios y las monedas van por regiones, no por idioma: son cosas distintas y se configuran en Ajustes → Regiones.