Cómo funciona

Nuestro sistema de traducción instantánea está diseñado para ser lo más fluido posible. Esta guía explica los detalles técnicos detrás de escena para que sepas exactamente qué ocurre cuando alguien visita tu sitio a través de nuestro proxy de traducción.

Configuración de DNS

Para usar nuestro servicio, solo necesitas apuntar tu DNS a nuestro worker de Cloudflare. Esto significa actualizar tus registros A o CNAME para enrutar tu tráfico a través de nuestra capa proxy.

Por ejemplo, si tu sitio estaba alojado originalmente en Vercel o Netlify, simplemente reemplazas el registro DNS que apuntaba a sus servidores edge por uno que apunte al nuestro. No necesitas cambiar tu código ni desplegar nada más.

Si en algún momento quieres dejar de usar nuestro servicio, solo revierte el cambio de DNS y apunta tus registros de vuelta a tu proveedor original—es así de simple.

Cómo funciona el proxy inverso

Cuando un usuario visita tu sitio, todas las solicitudes pasan por el Cloudflare Worker de Frenglish actuando como proxy inverso.

Así es el flujo de la solicitud:

Arquitectura del Worker de Cloudflare

1. Verificación de idioma
   El proxy inspecciona la URL para ver si hay un código de idioma presente (por ejemplo, /fr/about).

2. Detección de idioma original
   Si la solicitud ya está en tu idioma de origen (normalmente inglés), pasamos la solicitud a tu servidor original y devolvemos el contenido tal cual.

3. Flujo de traducción
   Si el idioma solicitado es diferente al original, comprobamos si ya existe una traducción en nuestra caché edge.

   • Si está en caché, la versión traducida se devuelve al instante.
   • Si no está en caché, obtenemos el contenido original, lo ponemos en cola para traducción y servimos la versión sin traducir (normalmente en inglés) mientras tanto. Una vez completada la traducción, los futuros usuarios recibirán la versión traducida y almacenada en caché.
   • Si no está en caché pero ya está traducido, lo recuperamos de Amazon S3, donde todas las traducciones se almacenan con doble cifrado.

4. Caché
   Utilizamos la caché global edge de Cloudflare para asegurar que las traducciones se sirvan rápidamente, sin importar dónde estén tus usuarios. Nuestra caché es “servir mientras se revalida”, así que incluso si una traducción se actualiza, el contenido antiguo se muestra de inmediato mientras se prepara el nuevo en segundo plano.

¿Qué pasa si nuestra API está caída?

Si por alguna razón nuestra API de traducción no está disponible temporalmente, tus usuarios seguirán viendo tu contenido original en su idioma predeterminado. Diseñamos nuestro sistema proxy para que haga una transición suave, así tu sitio siempre funciona aunque los servicios de traducción se interrumpan.

Frenglish Bundle

También inyectamos un pequeño paquete de JavaScript en tu sitio, llamado Frenglish bundle. Este script habilita varias funciones:

• Traducción del lado del cliente: Detecta cualquier contenido nuevo que aparezca después de la carga inicial de la página (por ejemplo, inyectado por JavaScript o cargado vía AJAX) y lo traduce automáticamente usando traducciones en caché.
• UI de selector de idioma: El bundle inyecta automáticamente un widget de cambio de idioma por defecto en tu sitio.
  Puedes personalizar la apariencia y ubicación de este selector usando nuestro language toggle builder.

Configuración del selector de idioma

Alojar el Worker tú mismo

Si prefieres alojar el Cloudflare Worker en tu propia cuenta de Cloudflare para tener control total, podemos orientarte y apoyarte. Contáctanos aquí para saber más.

¿Funciona con frameworks que usan mucho JavaScript como React, Vue o Next.js?

Sí. El paquete de Frenglish detecta cambios en el DOM y traduce el contenido a medida que se renderiza en el cliente. Esto incluye contenido cargado mediante navegación del lado del cliente en frameworks SPA. También ofrecemos traducción del lado del servidor para páginas pre-renderizadas.

¿Esto hará que mi sitio sea más lento?

No. Frenglish está optimizado para la velocidad. Como todo se sirve en el edge a través de Cloudflare y se almacena en caché de forma agresiva, los usuarios experimentarán una latencia mínima. El paquete JavaScript es muy pequeño y no bloquea la carga.

¿Cuánto tiempo se almacenan las traducciones en caché?

El contenido traducido se almacena en caché durante una hora por defecto. Puedes limpiar la caché agregando ?frenglish_cache_bust a cualquier URL. Esto limpiará la caché de traducción de todo tu sitio y forzará la obtención de contenido nuevo. Por ejemplo: https://example.com?frenglish_cache_bust.