Introducción Versión 2.8 / Última actualización: 02/06/2026
Bienvenido al manual de Conword.
En esta página encontrarás respuestas a preguntas frecuentes y todo lo que necesitas para poner en marcha Conword en
o en la página web de tu cliente.
Idiomas disponibles
La lista de idiomas disponibles actualmente y sus códigos de idioma («en», «fr», «de», ...) se puede consultar aquí: https://conword.io/sprachen/
Requisitos previos
La interfaz de usuario de Conword está escrita en JavaScript puro, por lo que no depende de ningún marco de trabajo. Aunque no depende de código de terceros, funciona bien con jQuery y otras herramientas de uso común.
Conword ofrece traducciones en tiempo real sin almacenar ningún dato en el servidor del cliente. Esto hace que Conword sea independiente del CMS subyacente.
Resumen:
Conword funciona con cualquier CMS en cualquier servidor.
Instalación
Para ejecutar Conword, es necesario incluir la configuración básica de JavaScript, tal y como se indica en la siguiente sección. Una vez cargado el JavaScript básico, estarán disponibles varias funciones y objetos.
Configuración básica
Inserta el código JS en tu HTML
Conword funciona en tu sitio web con esta única línea de código:
Debes disponer de una licencia válida para tu dominio para poder utilizar Conword. Si tu dominio no figura en la lista de dominios autorizados, Conword no funcionará en tu sitio web.
Opciones de configuración
Si quieres configurar Conword, hay un objeto JavaScript llamado «conword_config» que puedes utilizar para pasar tus ajustes a la instancia de Conword.
Conword funciona en tu sitio web con esta única línea de código:
Desactiva el atributo rtl en la <html> etiqueta, si se utiliza un idioma con la característica rtl (por ejemplo, el árabe). Conword establece automáticamente <html lang="rtl"> si esta opción no se establece en false.</html></html>
false
verdadero, falso
desactivar_selector_de_idioma
Si instalas Conword, aparecerá un menú desplegable para cambiar de idioma en la esquina inferior izquierda. Si estableces «disable_language_switcher» en «true», desaparecerá ese menú desplegable.
false
verdadero, falso
Nota
Puedes utilizar Conword sin el objeto de configuración.
Ejemplo: Desactivación del widget estándar de cambio de idioma
<script>
var conword_config={
disable_language_switcher:true
};
</script>
<script id="conword-root" charset="utf-8" src="https://static.conword.io/js/v2/[client-id]/conword.js"></script>
API de JavaScript de Conword
Si quieres incorporar la funcionalidad de Conword a tu diseño, puedes utilizar la API de JavaScript de Conword. Para utilizar la API, solo tienes que integrar el archivo conword.js en tu página. Consulta Configuración básica
Punto de conexión de la API
Puedes utilizar el objeto JavaScript «Conword» para invocar métodos de la API. Consulta el capítulo siguiente para obtener más información.
Métodos de la API
Conword.translate(language_key)
Inicia el proceso de traducción.
Probablemente esta sea la función más importante que necesitas.
Nota: Al llamar a Conword.translate, también se llama a Conword.set_user_language(), lo que guarda automáticamente el idioma en el almacenamiento local.
El siguiente ejemplo traduce la página actual al español:
Conword.translate('es');
Conword.retranslate()
Hay algunos sitios web en los que el contenido se añade a la página de forma dinámica. Aunque Conword es consciente de ello y detecta los cambios, a veces surgen problemas y es necesario volver a generar las traducciones.
El método «retranslate» intenta traducir la página de nuevo al idioma seleccionado.
Si la página no se ha traducido anteriormente, este método no hará nada.
Ejemplo:
Conword.retranslate();
Conword.set_user_language(language_key)
Este método guarda el idioma del usuario en el almacenamiento local. Se ejecuta automáticamente cuando se activa Conword.translate().
Utiliza esta función únicamente cuando quieras guardar el idioma del usuario sin traducir la página.
Cuando se configure el idioma del usuario, Conword traducirá la página automáticamente la próxima vez que se cargue.
En el siguiente ejemplo se configura el idioma de la interfaz de usuario en español:
Conword.set_user_language('es');
Conword.unset_user_language()
Desactiva (borra) la configuración del idioma del usuario.
Ejemplo:
Conword.unset_user_language();
Conword.get_current_language()
Este método devuelve la clave de idioma actual (por ejemplo, «en», «es» o «fr»).
Ejemplo:
var current_langauge = Conword.get_current_language();
Conword.get_available_languages()
Este método devuelve el objeto del lenguaje JavaScript (véase Objeto de idioma).
var language_data = Conword.get_available_languages();
Eventos personalizados
Conword dispara eventos personalizados, a los que se puede dar respuesta utilizando un EventLister personalizado.
document.addEventListener("Conword:ready", function(){
/* your code here */
});
Lista de eventos personalizados
«Conword:ready»: se activará cuando se cargue e inicialice Conword.
«Conword:translation_started»: se activará cuando Conword comience a traducir.
«Conword:translation_done»: se activará cuando Conword haya terminado una traducción.
«Conword:translation_failed»: se activará cuando falle un intento de traducción.
Objeto de idioma
La API de Conword proporciona un objeto que contiene todos los idiomas disponibles y sus metadatos. El objeto se puede recuperar de la siguiente manera:
let languages=Conword.get_available_languages();
El objeto tiene este aspecto:
(Dependiendo de los idiomas disponibles con tu licencia.)
{
"de": {
"name_en": "German",
"name_de": "Deutsch",
"name": "Deutsch",
"rtl": false,
"text_title": "Sprache wählen:",
"text_1": "Die Seite wird gerade übersetzt …",
"text_2": "Einen Moment bitte.",
"text_error": "Beim Übersetzen der Seite ist ein Fehler ist aufgetreten."
},
"en": {
"name_en": "English",
"name_de": "Englisch",
"name": "English",
"rtl": false,
"text_title": "Select language:",
"text_1": "The page is being translated ...",
"text_2": "One moment please.",
"text_error": "An error occurred while translating the page."
},
"tr": {
"name_en": "Turkish",
"name_de": "Türkisch",
"name": "Türkçe",
"rtl": false,
"text_title": "Dil seçin:",
"text_1": "Sayfa çevriliyor ...",
"text_2": "Bir dakika lütfen.",
"text_error": "Sayfa çevrilirken bir hata oluştu."
},
"it": {
"name_en": "Italian",
"name_de": "Italienisch",
"name": "Italiano",
"rtl": false,
"text_title": "Selezionare la lingua:",
"text_1": "La pagina è in corso di traduzione ...",
"text_2": "Un momento, per favore.",
"text_error": "Si è verificato un errore durante la traduzione della pagina."
}
}
Excluir contenido
Formularios
Conword ignorará los datos introducidos por el usuario en campos de formulario como y
El atributo «translate»
Si no quieres que se traduzcan determinados elementos, puedes utilizar el atributo «translate». Al establecer su valor en «no», Conword ignorará ese elemento y todos sus elementos secundarios.
Ejemplo:
<div>
<p>I will be translated</p>
<p translate="no">
I will NOT be translated.
<small>Me neither, since my parent element uses the transate attrube.</small>
</p>
I will be translated as well
</div>
La clase «cnw_skip_translation»
Conword omitirá todas las etiquetas HTML que contengan la clase «cnw_skip_translation».
Ejemplo:
<div>
<p>I will be translated</p>
<p class="cnw_skip_translation">
I will NOT be translated.
<small>Me neither, since my parent element uses the cnw_skip_translation class.</small>
</p>
I will be translated as well
</div>
Nota: Las etiquetas vacías se omitirán automáticamente.
Es posible excluir páginas completas sin cargar Conword. Esto debe hacerlo el programador que integra Conword en el sitio web.
Ejemplos
Ejemplo: Enlace HTML para empezar a traducir la página al inglés
<a href="javascript:Conword.translate('en');">Translate to english</a>
Integración personalizada de Conword en tu página:
document.addEventListener("Conword:ready", function(){
my_languages=Conword.get_available_languages();
for (var langkey in my_languages) {
language_meta=my_languages[langkey];
// now you can make use of the language object - see the chapter above.
// eg: language_meta.name or language_meta.name_en ...
console.debug(language_meta.name,language_meta.name_en);
// to check if the langkey is the currently active language:
active=false;
if(Conword.get_current_language()==langkey) active=true;
// jquery example of adding menu items
$language_dropdown.append('<li><a class="'+active+'" href="javascript:start_conwordio_translation(\''+langkey+'\');" data-lang="'+langkey+'" data-langname="'+language_meta.name+'" title="Diese Seite auf \''+language_meta.name+'\' übersetzen">'+language_meta.name+'</a></li>');
}
});
// example of a wrapper to call multiple actions (translation, menu controls, tracking, ...) at the same time
function start_conwordio_translation(lang){
Conword.translate(lang);
hide_menu();
matomo_track('Translation',lang);
}
Desplazar el selector de idioma predeterminado hacia la derecha, con CSS
<style>
body .cnw_translationbox {
right: 30px;
left: auto;
}
</style>
Evita que se traduzcan todos los enlaces «mailto:» utilizando JavaScript y la clase cnw_skip_translation
document.addEventListener("DOMContentLoaded", function() {
var mailto_links = document.querySelectorAll('a[href^="mailto:"]');
for(var i = 0; i < mailto_links.length; i++){
if(mailto_links[i].innerHTML.indexOf('@')>-1) mailto_links[i].classList.add('cnw_skip_translation');
}
});
Mostrar imágenes diferentes (u otro contenido) para cada idioma
Por motivos de localización, es posible que desees cambiar el contenido de tu sitio web al cambiar el idioma.
Hay varias formas de hacerlo: por ejemplo, mediante atributos HTML. A continuación te mostramos un ejemplo de cómo cambiar las imágenes.
En primer lugar, crea una imagen con atributos de datos como esta:
Como alternativa, el seguimiento se puede realizar utilizando los eventos personalizados de Conword. A continuación se muestra un ejemplo de cómo realizar un seguimiento de las traducciones de Conword con Piwik (Matomo):