Solucionar problemas con las traducciones de WooCommerce

Identifica primero qué superficie está fallando. El contenido de productos, los mensajes gettext, la configuración regional de la solicitud, las rutas y los campos de correo electrónico usan fuentes distintas.

Falta texto de productos o taxonomías

• Confirma que product y la taxonomía requerida estén habilitados.
• Guarda el producto o término base después de cambiar su fuente.
• Comprueba la configuración regional de destino en Translations → Translate contents.
• Traduce el producto y sus categorías, etiquetas y términos de atributos por separado.
• Limpia las cachés de productos, objetos, páginas y de la API de Store.

Un valor sin traducir recurre a su fuente como alternativa; no crea otro producto ni término.

El carrito, el mini carrito o el pago usan otro idioma

Abre la ruta con el prefijo de destino antes de añadir el artículo. Elimina las líneas antiguas del carrito y refresca los fragmentos. Verifica que las solicitudes AJAX de WC o de la API de Store incluyan un valor lang, una cabecera X-Pom-Translate-Lang, un prefijo de configuración regional o una preferencia guardada.

Si los controles estándar de WooCommerce siguen en el idioma de origen, instala el catálogo gettext de WooCommerce. Las traducciones registradas o de productos no pueden reemplazar los archivos de idioma del software que falten.

Mi cuenta devuelve un 404

Confirma que la página Mi cuenta existe, refresca Settings → Permalinks y limpia las cachés de enrutamiento. Prueba la página de cuenta localizada, el endpoint sin valor y, a continuación, una ruta con un valor al final.

Los endpoints de extensiones deben usar la API de endpoint-página de WordPress. Las URLs construidas manualmente pueden saltarse el asistente de endpoints localizados de WooCommerce.

La confirmación de pedido devuelve un 404

Abre la URL que genera WooCommerce en lugar de escribir un endpoint manualmente. Confirma que la página de pago configurada esté publicada, guarda Settings → Permalinks una vez, limpia las cachés de enrutamiento y prueba tanto la URL legible localizada como su equivalente en cadena de consulta.

Mantén intacta la clave del pedido durante las pruebas. Una clave incorrecta o ausente nunca debe revelar los detalles del pedido, incluso cuando la propia ruta se resuelva correctamente.

Un correo electrónico usa la configuración regional incorrecta

Confirma que el pedido se creó mediante un flujo de pago compatible en el idioma previsto. Para pedidos antiguos, comprueba la configuración regional del cliente vinculado y el comportamiento de las alternativas. Asegúrate de que el objeto de correo electrónico lleve su contexto de pedido o cliente y no sea una pasarela o plantilla PDF excluida.

Los cambios del correo electrónico no se guardaron

La vista previa y Send test email usan campos sin guardar. Selecciona la acción de guardar del formulario y confirma No unsaved changes.

Si el guardado está bloqueado, restaura todos los marcadores de posición obligatorios y elimina los tokens inesperados. Vuelve a generar las vistas previas obsoletas después de cambiar un campo, una plantilla, un pedido o un formato.

Una extensión sigue sin traducirse

Determina si su texto procede de:

• un catálogo gettext;
• una etiqueta registrada;
• contenido de producto o de término;
• un objeto de correo electrónico de WooCommerce;
• un mensaje genérico wp_mail();
• una integración PDF/pasarela con su propio ciclo de vida de configuración regional.

Aplica el flujo de trabajo correspondiente. No registres mensajes renderizados de clientes o pedidos solo para que aparezcan en el Administrador de traducciones.