Un sitio Velk puede responder en varios idiomas. Tú eliges el idioma principal, el predeterminado, y agregas los demás en el panel. Cada idioma adicional tiene su propio prefijo en la dirección (/en, /pt), cada editor del panel muestra una pestaña por idioma, y los textos fijos del tema —botones, etiquetas, “Leer más”— tienen su propia pantalla de traducción.
Úsalo cuando el mismo sitio atiende a personas que hablan más de un idioma: un hotel con huéspedes extranjeros, una escuela con un programa en inglés, una empresa que vende en toda América Latina. Es parte del motor: no hay nada que instalar.
Pídele a la IA
Haz bilingüe el sitio del Hotel Brisa del Mar. El español es el idioma principal, con el nombre “Español”; después viene el inglés, en /en. Prepara todos los textos fijos del tema (botones, etiquetas, pie de página, mensajes de los formularios) para traducirlos y pon un selector de idioma en el encabezado. No hace falta traducir las habitaciones ni las entradas del blog: la dueña lo hará en el panel. Ejecuta schema:validate al final y dime qué tengo que completar.
La IA activa los idiomas en site.json, prepara los textos del tema y arma el selector. El inglés en sí se registra en la pantalla Idiomas del panel, y las traducciones también se escriben en el panel.
Cómo se configura
-
El idioma principal vive en el tema
La IA activa los idiomas en
site.jsoncon el código del idioma principal y el nombre que el visitante ve para él (default_label: “Español”, “ES”).schema:validaterechaza el bloque sin ese nombre. El panel no cambia el idioma principal: todo campo sin traducción vuelve a él. -
Los otros idiomas se agregan en el panel
En Ajustes, abre Idiomas y haz clic en “+ Nuevo idioma”: el código (
en,pt), el nombre que aparece en el selector, el prefijo de la dirección (/en), el orden de visualización y si el idioma está activo en el sitio público. -
Los textos del tema se preparan
La IA envuelve cada texto fijo de las plantillas en
t(), la función de traducción del tema, escrito en el idioma principal.i18n:scanlos registra en la pantalla de traducción. -
Selector y etiquetas para buscadores
Velk no trae un selector de idioma: la IA arma uno en el tema a partir de los idiomas activos. También agrega a cada página las etiquetas
hreflang, que indican a los buscadores qué dirección es la traducción de cuál.
Traducir el contenido
Con los idiomas activos, cada editor —páginas, entradas y demás contenidos, categorías y etiquetas, páginas de opciones— muestra una pestaña por idioma arriba. La primera es el idioma principal; las demás repiten los mismos campos, con el texto principal como pista. Un solo Guardar guarda todos los idiomas, y un punto verde marca las pestañas que ya tienen contenido.
- Cada pestaña tiene su propio título, dirección y campos. La dirección traducida (slug) se escribe a mano: Velk no la genera a partir del título traducido.
- Un campo en blanco significa “sin traducir” y muestra el texto del idioma principal. Desde la v3.9.0 esto incluye un campo de texto con formato dejado vacío, que antes imprimía un párrafo vacío en la página traducida.
- Obligatorio, una sola vez. Un campo obligatorio pide valor solo en la pestaña principal (desde la v3.7.4).
- La dirección de una sección se traduce con el botón Traducciones de la lista de un contenido o de una categoría:
/blogpuede pasar a ser/en/news. - Las entradas nuevas no pierden sus pestañas. Desde la v3.9.0, lo que escribes en las otras pestañas de una entrada nueva se guarda en el primer guardado.
Una dirección por idioma
| Situación | Dirección |
|---|---|
| Idioma principal | /nosotros, /blog/mi-articulo — sin prefijo |
| Inglés, todavía sin dirección en inglés | /en/nosotros — la página abre en su dirección principal, bajo el prefijo (desde la v3.9.0; antes, un 404) |
| Dirección en inglés completada | /en/about — y /en/nosotros deja de responder, así que cada página tiene una dirección por idioma |
| Dos contenidos quieren la misma dirección | Se la queda el que tiene la dirección traducida, y uno publicado siempre gana a un borrador. El panel avisa al guardar y dice quién quedó sin dirección en ese idioma (desde la v3.9.0). |
En el sitio
El selector lleva al visitante a la misma página en el otro idioma. El sitemap.xml incluye todos los idiomas de cada dirección. Desde la v3.9.0 las etiquetas canonical y hreflang ya no repiten el prefijo (/en/en/…), y el selector funciona en entradas y categorías anidadas a tres niveles o más. Las páginas de opciones —textos del pie, datos de contacto— también tienen pestañas de idioma, y desde la v3.9.1 siguen el idioma del visitante sin importar cómo las lea el tema.
Los textos fijos del tema
Lo que está escrito en las plantillas es parte del tema, no del contenido. Se traduce en la pantalla Traducciones de la interfaz, que se abre desde Idiomas: una fila por texto, editada en el mismo lugar, con un filtro para lo pendiente. El idioma principal siempre muestra el texto tal como lo escribió el tema, así que solo traduces a los idiomas adicionales. Desde la v3.7.8 esto vale también para el visitante en inglés: antes, un tema escrito en español mostraba español en /en, sin consultar la traducción registrada.
Los mensajes de los formularios y del área de miembros son palabras que el tema les da a los códigos que Velk devuelve, y pueden pasar por esta misma pantalla.
Pídele a la IA
En /en, el botón “Reservar” del encabezado y el “Síguenos” del pie de página siguen en español. Hazlos traducibles y muéstrame dónde escribo el inglés.
La IA envuelve los dos textos en t(), ejecuta i18n:scan y te señala sus filas en la pantalla Traducciones de la interfaz. Un texto que el tema imprime sin t() nunca se traduce.
Preguntas
¿El sitio elige solo el idioma del visitante?
No. Velk no lee el idioma del navegador ni redirige. El visitante elige en el selector, y las etiquetas hreflang ayudan a los buscadores a mostrar la versión correcta a cada persona.
¿Puedo quitar un idioma del sitio?
Sí: desmarca “Idioma activo” en su pantalla y sale del sitio público; lo traducido queda guardado. Eliminar el idioma también conserva las traducciones en la base de datos, pero ya nada llega a ellas.
¿Los correos siguen el idioma?
Todavía no. Los correos que Velk envía a los miembros (cambio de contraseña, código de acceso) salen en un solo idioma, el predeterminado del panel, definido en ADMIN_LOCALE.
¿El idioma del panel es lo mismo?
No. El panel habla inglés, portugués o español, según cada usuario, con ADMIN_LOCALE en .env como valor predeterminado. Cambia los botones del panel, nunca los idiomas del sitio.