Un sitio de Framer se conecta a Universally con una etiqueta de script agregada en el código personalizado del sitio. La etiqueta renderiza el selector de idioma y traduce cada página en el navegador del visitante, por lo que tus URL permanecen iguales en cada idioma y no hay que cambiar DNS. El modo de servicio de JavaScript explica cómo funciona la traducción y qué omite.
Antes de empezar
- Un plan de pago de Framer. El código personalizado necesita uno.
- El rol de Propietario o Administrador en tu espacio de trabajo de Universally, para crear el proyecto y ver su fragmento. Los editores ven "Pídele a un administrador del proyecto el fragmento de instalación de este proyecto" en lugar de la línea.
- Un sitio publicado en tu propio dominio. La verificación de conexión solo ve el sitio publicado.
Crear el proyecto
- Inicia un nuevo proyecto. En Selecciona tu tecnología, elige Framer.
- Completa Dominio, el dominio completo en el que está publicado tu sitio, como
ejemplo.com. Si el dominio aún no se resuelve, verás una advertencia y podrás continuar. - Completa Nombre del proyecto, verifica Idioma de origen (Inglés (EE. UU.) por defecto) y haz clic en Siguiente.
Los proyectos de Framer no tienen modo de servicio para elegir, por lo que la siguiente pantalla es Agrega el fragmento. Los subdominios de idioma aún no están disponibles para los sitios de Framer: tu sitio es traducido por el fragmento, en sus propias direcciones.
Añadir el fragmento
El paso Agregar el fragmento muestra tu línea dentro de una página de ejemplo. El panel completa la clave de tu proyecto:
<script src="https://scripts.universally.com/p/YOUR_PUBLIC_KEY/s.js" async></script>
- Haz clic en Copiar línea. Copia solo la etiqueta de script y el botón cambia a Copiado.
- En Framer, abre Configuración del sitio › Código › Agregar.
- Establece Ubicación en Inicio de
<head>, Páginas en Todas y Ejecutar en Una vez. - Pega la línea y guarda.
Páginas: Todas es lo que hace que el script se cargue en cada página. Los botones Marcar como completo en la pantalla se almacenan en tu navegador y no bloquean nada.
Publica y verifica la conexión
- Haz clic en Publicar en Framer. La verificación solo ve el sitio publicado.
- De vuelta en Universally, haz clic en Verificar conexión.
La verificación carga tu página de inicio y busca la línea. Encontrado significa que la línea está en tu dominio, pertenece a este proyecto y no hay nada más que instalar.
Nada cambia para tus visitantes todavía. La línea solo carga el archivo de Universally y tu sitio comienza a servir traducciones una vez que agregas idiomas en el siguiente paso.
Continuar y Lo haré más tarde avanzan a Agregar idiomas, y nada queda pendiente en la verificación. La línea permanece en la página Configuración del proyecto, bajo La línea que tu sitio necesita.
Añadir idiomas
- En Agregar idiomas, responde "¿A qué idiomas quieres traducir?" con al menos un idioma de destino.
- Haz clic en Finalizar. Permanece deshabilitado hasta que el proyecto tenga un idioma.
El diálogo de idioma todavía muestra Formato de URL, pero el valor no se utiliza en Framer porque tus URL nunca cambian. Cada fila de idioma en Todos los idiomas tiene un interruptor En vivo. Consulta Agregar y quitar idiomas.
Verificar que funcionó
- Abre tu sitio publicado en una ventana privada. Un visitante por primera vez se empareja automáticamente con el idioma de su navegador, por lo que un navegador configurado en uno de tus idiomas de destino ve la página traducida.
- Encuentra el selector de idioma en la esquina superior derecha, con banderas y nombres de idiomas.
- Elige un idioma. La página se recarga en ese idioma, en la misma dirección.
- Navega entre algunas páginas publicadas. Cada una está traducida y hay un solo selector en cada página.
Para ver cuánto de una página se tradujo, añade ?uni_debug=1 a su URL y abre la consola del navegador.
Si no funciona
- Cargamos tu dominio pero la línea no estaba en la página: el cambio no se guardó, o el sitio no se publicó desde entonces. Publica de nuevo y vuelve a comprobar. Una copia en caché en tu host o CDN también puede ocultar la línea durante un tiempo, y la comprobación solo mira tu página de inicio.
- Esa línea pertenece a un proyecto diferente: la línea de otro proyecto está en el sitio. Reemplázala con la línea de la página Configuración de este proyecto, y luego vuelve a comprobar.
- No aparece ningún selector: el proyecto aún no tiene ningún idioma de destino activo. Añade uno, o activa su interruptor Activo.
- El selector aparece pero parte del texto permanece en el idioma de origen: la página está detrás de un inicio de sesión o una contraseña, o JavaScript añade el texto después de que la página se carga. Consulta Modo de servicio de JavaScript.
Hay más casos en Las traducciones no aparecen y El selector no es visible.